{ "content": [ { "type": "text", "text": "# SMTP-SINK(1) (man)\n\n**Summary:** smtp-sink - parallelized SMTP/LMTP test server\n\n**Synopsis:** smtp-sink [options] [inet:][host]:port backlog\nsmtp-sink [options] unix:pathname backlog\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -4 | — | — | port. |\n| -6 | — | — | support. |\n| -8 | — | — | |\n| -a | — | — | |\n| -A | — | — | Wait delay seconds after responding to DATA, then abort prematurely with a 550 reply status. Do not read further input f |\n| -b | — | — | Use soft-bounce-reply for soft reject responses. The default reply is \"450 4.3.0 Er‐ ror: command failed\". |\n| -B | — | — | Use hard-bounce-reply for hard reject responses. The default reply is \"500 5.3.0 Er‐ ror: command failed\". |\n| -c | — | — | mand is executed, or when \".\" is received. |\n| -C | — | — | |\n| -d | — | — | Dump each mail transaction to a single-message file whose name is created by expanding the dump-template via strftime(3) |\n| -D | — | — | Append mail transactions to a multi-message dump file whose name is created by expand‐ ing the dump-template via strftim |\n| -e | — | — | |\n| -E | — | — | |\n| -f | — | — | Reject the specified commands with a hard (5xx) error code. This option implies -p. Examples of commands are CONNECT, HE |\n| -F | — | — | |\n| -h | — | — | Use hostname in the SMTP greeting, in the HELO response, and in the EHLO response. The default hostname is \"smtp-sink\". |\n| -H | — | — | Delay the first read operation after receiving DATA (time in seconds). Combine with a large test message and a small TCP |\n| -L | — | — | |\n| -m | — | — | An upper bound on the maximal number of simultaneous connections that smtp-sink will handle. This prevents the process f |\n| -M | — | — | Terminate after receiving count messages. |\n| -n | — | — | Terminate after count sessions. |\n| -N | — | — | |\n| -p | — | — | |\n| -P | — | — | plies -e. |\n| -q | — | — | Disconnect (without replying) after receiving one of the specified commands. Examples of commands are CONNECT, HELO, EHL |\n| -Q | — | — | Send a 421 reply and disconnect after receiving one of the specified commands. Examples of commands are CONNECT, HELO, E |\n| -r | — | — | Reject the specified commands with a soft (4xx) error code. This option implies -p. Examples of commands are CONNECT, HE |\n| -R | — | — | Change the process root directory to the specified location. This option requires su‐ per-user privileges. See also the |\n| -s | — | — | Log the named commands to syslogd. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, |\n| -S | — | — | An optional string that is prepended to each message that is written to a dump file (see the dump file format descriptio |\n| -t | — | — | Limit the time for receiving a command or sending a response. The time limit is spec‐ ified in seconds. |\n| -T | — | — | Override the default TCP window size. To work around broken TCP window scaling imple‐ mentations, specify a value > 0 an |\n| -u | — | — | Switch to the specified user privileges after opening the network socket and option‐ ally changing the process root dire |\n| -v | — | — | |\n| -w | — | — | Wait delay seconds before responding to a DATA command. |\n| -W | — | — | Wait delay seconds before responding to command. If odds is also specified (a number between 1-99 inclusive), wait for a |\n\n## See Also\n\n- smtp-source(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (16 lines) — 36 subsections\n - -4 (2 lines)\n - -6 (2 lines)\n - -8 (1 lines)\n - -a (1 lines)\n - -A (4 lines)\n - -b (3 lines)\n - -B (3 lines)\n - -c (2 lines)\n - -C (1 lines)\n - -d (8 lines)\n - -D (7 lines)\n - -e (1 lines)\n - -E (1 lines)\n - -f (6 lines)\n - -F (1 lines)\n - -h (3 lines)\n - -H (4 lines)\n - -L (1 lines)\n - -m (4 lines)\n - -M (2 lines)\n - -n (2 lines)\n - -N (1 lines)\n - -p (1 lines)\n - -P (2 lines)\n - -q (6 lines)\n - -Q (6 lines)\n - -r (6 lines)\n - -R (3 lines)\n - -s (6 lines)\n - -S start-string (6 lines)\n - -t (3 lines)\n - -T (3 lines)\n - -u (4 lines)\n - -v (1 lines)\n - -w (2 lines)\n - -W (16 lines)\n- **DUMP FILE FORMAT** (50 lines)\n- **SEE ALSO** (2 lines)\n- **LICENSE** (16 lines)\n\n## Full Content\n\n### NAME\n\nsmtp-sink - parallelized SMTP/LMTP test server\n\n### SYNOPSIS\n\nsmtp-sink [options] [inet:][host]:port backlog\n\nsmtp-sink [options] unix:pathname backlog\n\n### DESCRIPTION\n\nsmtp-sink listens on the named host (or address) and port. It takes SMTP messages from the\nnetwork and throws them away. The purpose is to measure client performance, not protocol\ncompliance.\n\nsmtp-sink may also be configured to capture each mail delivery transaction to file. Since\ndisk latencies are large compared to network delays, this mode of operation can reduce the\nmaximal performance by several orders of magnitude.\n\nConnections can be accepted on IPv4 or IPv6 endpoints, or on UNIX-domain sockets. IPv4 and\nIPv6 are the default. This program is the complement of the smtp-source(1) program.\n\nNote: this is an unsupported test program. No attempt is made to maintain compatibility be‐\ntween successive versions.\n\nArguments:\n\n#### -4\n\nport.\n\n#### -6\n\nsupport.\n\n#### -8\n\n#### -a\n\n#### -A\n\nWait delay seconds after responding to DATA, then abort prematurely with a 550 reply\nstatus. Do not read further input from the client; this is an attempt to block the\nclient before it sends \".\". Specify a zero delay value to abort immediately.\n\n#### -b\n\nUse soft-bounce-reply for soft reject responses. The default reply is \"450 4.3.0 Er‐\nror: command failed\".\n\n#### -B\n\nUse hard-bounce-reply for hard reject responses. The default reply is \"500 5.3.0 Er‐\nror: command failed\".\n\n#### -c\n\nmand is executed, or when \".\" is received.\n\n#### -C\n\n#### -d\n\nDump each mail transaction to a single-message file whose name is created by expanding\nthe dump-template via strftime(3) and appending a pseudo-random hexadecimal number\n(example: \"%Y%m%d%H/%M.\" expands into \"2006081203/05.809a62e3\"). If the template con‐\ntains \"/\" characters, missing directories are created automatically. The message dump\nformat is described below.\n\nNote: this option keeps one capture file open for every mail transaction in progress.\n\n#### -D\n\nAppend mail transactions to a multi-message dump file whose name is created by expand‐\ning the dump-template via strftime(3). If the template contains \"/\" characters, miss‐\ning directories are created automatically. The message dump format is described be‐\nlow.\n\nNote: this option keeps one capture file open for every mail transaction in progress.\n\n#### -e\n\n#### -E\n\n#### -f\n\nReject the specified commands with a hard (5xx) error code. This option implies -p.\n\nExamples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET,\nNOOP, and QUIT. Separate command names by white space or commas, and use quotes to\nprotect white space from the shell. Command names are case-insensitive.\n\n#### -F\n\n#### -h\n\nUse hostname in the SMTP greeting, in the HELO response, and in the EHLO response. The\ndefault hostname is \"smtp-sink\".\n\n#### -H\n\nDelay the first read operation after receiving DATA (time in seconds). Combine with a\nlarge test message and a small TCP window size (see the -T option) to test the Postfix\nclient writewait() implementation.\n\n#### -L\n\n#### -m\n\nAn upper bound on the maximal number of simultaneous connections that smtp-sink will\nhandle. This prevents the process from running out of file descriptors. Excess connec‐\ntions will stay queued in the TCP/IP stack.\n\n#### -M\n\nTerminate after receiving count messages.\n\n#### -n\n\nTerminate after count sessions.\n\n#### -N\n\n#### -p\n\n#### -P\n\nplies -e.\n\n#### -q\n\nDisconnect (without replying) after receiving one of the specified commands.\n\nExamples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET,\nNOOP, and QUIT. Separate command names by white space or commas, and use quotes to\nprotect white space from the shell. Command names are case-insensitive.\n\n#### -Q\n\nSend a 421 reply and disconnect after receiving one of the specified commands.\n\nExamples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET,\nNOOP, and QUIT. Separate command names by white space or commas, and use quotes to\nprotect white space from the shell. Command names are case-insensitive.\n\n#### -r\n\nReject the specified commands with a soft (4xx) error code. This option implies -p.\n\nExamples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET,\nNOOP, and QUIT. Separate command names by white space or commas, and use quotes to\nprotect white space from the shell. Command names are case-insensitive.\n\n#### -R\n\nChange the process root directory to the specified location. This option requires su‐\nper-user privileges. See also the -u option.\n\n#### -s\n\nLog the named commands to syslogd.\n\nExamples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET,\nNOOP, and QUIT. Separate command names by white space or commas, and use quotes to\nprotect white space from the shell. Command names are case-insensitive.\n\n#### -S start-string\n\nAn optional string that is prepended to each message that is written to a dump file\n(see the dump file format description below). The following C escape sequences are\nsupported: \\a (bell), \\b (backspace), \\f (formfeed), \\n (newline), \\r (carriage re‐\nturn), \\t (horizontal tab), \\v (vertical tab), \\ddd (up to three octal digits) and \\\\\n(the backslash character).\n\n#### -t\n\nLimit the time for receiving a command or sending a response. The time limit is spec‐\nified in seconds.\n\n#### -T\n\nOverride the default TCP window size. To work around broken TCP window scaling imple‐\nmentations, specify a value > 0 and < 65536.\n\n#### -u\n\nSwitch to the specified user privileges after opening the network socket and option‐\nally changing the process root directory. This option is required when the process\nruns with super-user privileges. See also the -R option.\n\n#### -v\n\n#### -w\n\nWait delay seconds before responding to a DATA command.\n\n#### -W\n\nWait delay seconds before responding to command. If odds is also specified (a number\nbetween 1-99 inclusive), wait for a random multiple of delay. The random multiplier is\nequal to the number of times the program needs to roll a dice with a range of 0..99\ninclusive, before the dice produces a result greater than or equal to odds.\n\n[inet:][host]:port\nListen on network interface host (default: any interface) TCP port port. Both host and\nport may be specified in numeric or symbolic form.\n\nunix:pathname\nListen on the UNIX-domain socket at pathname.\n\nbacklog\nThe maximum length the queue of pending connections, as defined by the listen(2) sys‐\ntem call.\n\n### DUMP FILE FORMAT\n\nEach dumped message contains a sequence of text lines, terminated with the newline character.\nThe sequence of information is as follows:\n\n• The optional string specified with the -S option.\n\n• The smtp-sink generated headers as documented below.\n\n• The message header and body as received from the SMTP client.\n\n• An empty line.\n\nThe format of the smtp-sink generated headers is as follows:\n\nX-Client-Addr: text\nThe client IP address without enclosing []. An IPv6 address is prefixed with \"ipv6:\".\nThis record is always present.\n\nX-Client-Proto: text\nThe client protocol: SMTP, ESMTP or LMTP. This record is always present.\n\nX-Helo-Args: text\nThe arguments of the last HELO or EHLO command before this mail delivery transaction.\nThis record is present only if the client sent a recognizable HELO or EHLO command be‐\nfore the DATA command.\n\nX-Mail-Args: text\nThe arguments of the MAIL command that started this mail delivery transaction. This\nrecord is present exactly once.\n\nX-Rcpt-Args: text\nThe arguments of an RCPT command within this mail delivery transaction. There is one\nrecord for each RCPT command, and they are in the order as sent by the client.\n\nReceived: text\nA message header for compatibility with mail processing software. This three-line\nheader marks the end of the headers provided by smtp-sink, and is formatted as fol‐\nlows:\n\nfrom helo ([addr])\nThe HELO or EHLO command argument and client IP address. If the client did not\nsend HELO or EHLO, the client IP address is used instead.\n\nby host (smtp-sink) with proto id random;\nThe hostname specified with the -h option, the client protocol (see\nX-Client-Proto above), and the pseudo-random portion of the per-message capture\nfile name.\n\ntime-stamp\nA time stamp as defined in RFC 2822.\n\n### SEE ALSO\n\nsmtp-source(1), SMTP/LMTP message generator\n\n### LICENSE\n\nThe Secure Mailer license must be distributed with this software.\n\nAUTHOR(S)\nWietse Venema\nIBM T.J. Watson Research\nP.O. Box 704\nYorktown Heights, NY 10598, USA\n\nWietse Venema\nGoogle, Inc.\n111 8th Avenue\nNew York, NY 10011, USA\n\n\n\nSMTP-SINK(1)\n\n" } ], "structuredContent": { "command": "SMTP-SINK", "section": "1", "mode": "man", "summary": "smtp-sink - parallelized SMTP/LMTP test server", "synopsis": "smtp-sink [options] [inet:][host]:port backlog\nsmtp-sink [options] unix:pathname backlog", "flags": [ { "flag": "-4", "long": null, "arg": null, "description": "port." }, { "flag": "-6", "long": null, "arg": null, "description": "support." }, { "flag": "-8", "long": null, "arg": null, "description": "" }, { "flag": "-a", "long": null, "arg": null, "description": "" }, { "flag": "-A", "long": null, "arg": null, "description": "Wait delay seconds after responding to DATA, then abort prematurely with a 550 reply status. Do not read further input from the client; this is an attempt to block the client before it sends \".\". Specify a zero delay value to abort immediately." }, { "flag": "-b", "long": null, "arg": null, "description": "Use soft-bounce-reply for soft reject responses. The default reply is \"450 4.3.0 Er‐ ror: command failed\"." }, { "flag": "-B", "long": null, "arg": null, "description": "Use hard-bounce-reply for hard reject responses. The default reply is \"500 5.3.0 Er‐ ror: command failed\"." }, { "flag": "-c", "long": null, "arg": null, "description": "mand is executed, or when \".\" is received." }, { "flag": "-C", "long": null, "arg": null, "description": "" }, { "flag": "-d", "long": null, "arg": null, "description": "Dump each mail transaction to a single-message file whose name is created by expanding the dump-template via strftime(3) and appending a pseudo-random hexadecimal number (example: \"%Y%m%d%H/%M.\" expands into \"2006081203/05.809a62e3\"). If the template con‐ tains \"/\" characters, missing directories are created automatically. The message dump format is described below. Note: this option keeps one capture file open for every mail transaction in progress." }, { "flag": "-D", "long": null, "arg": null, "description": "Append mail transactions to a multi-message dump file whose name is created by expand‐ ing the dump-template via strftime(3). If the template contains \"/\" characters, miss‐ ing directories are created automatically. The message dump format is described be‐ low. Note: this option keeps one capture file open for every mail transaction in progress." }, { "flag": "-e", "long": null, "arg": null, "description": "" }, { "flag": "-E", "long": null, "arg": null, "description": "" }, { "flag": "-f", "long": null, "arg": null, "description": "Reject the specified commands with a hard (5xx) error code. This option implies -p. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT. Separate command names by white space or commas, and use quotes to protect white space from the shell. Command names are case-insensitive." }, { "flag": "-F", "long": null, "arg": null, "description": "" }, { "flag": "-h", "long": null, "arg": null, "description": "Use hostname in the SMTP greeting, in the HELO response, and in the EHLO response. The default hostname is \"smtp-sink\"." }, { "flag": "-H", "long": null, "arg": null, "description": "Delay the first read operation after receiving DATA (time in seconds). Combine with a large test message and a small TCP window size (see the -T option) to test the Postfix client writewait() implementation." }, { "flag": "-L", "long": null, "arg": null, "description": "" }, { "flag": "-m", "long": null, "arg": null, "description": "An upper bound on the maximal number of simultaneous connections that smtp-sink will handle. This prevents the process from running out of file descriptors. Excess connec‐ tions will stay queued in the TCP/IP stack." }, { "flag": "-M", "long": null, "arg": null, "description": "Terminate after receiving count messages." }, { "flag": "-n", "long": null, "arg": null, "description": "Terminate after count sessions." }, { "flag": "-N", "long": null, "arg": null, "description": "" }, { "flag": "-p", "long": null, "arg": null, "description": "" }, { "flag": "-P", "long": null, "arg": null, "description": "plies -e." }, { "flag": "-q", "long": null, "arg": null, "description": "Disconnect (without replying) after receiving one of the specified commands. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT. Separate command names by white space or commas, and use quotes to protect white space from the shell. Command names are case-insensitive." }, { "flag": "-Q", "long": null, "arg": null, "description": "Send a 421 reply and disconnect after receiving one of the specified commands. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT. Separate command names by white space or commas, and use quotes to protect white space from the shell. Command names are case-insensitive." }, { "flag": "-r", "long": null, "arg": null, "description": "Reject the specified commands with a soft (4xx) error code. This option implies -p. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT. Separate command names by white space or commas, and use quotes to protect white space from the shell. Command names are case-insensitive." }, { "flag": "-R", "long": null, "arg": null, "description": "Change the process root directory to the specified location. This option requires su‐ per-user privileges. See also the -u option." }, { "flag": "-s", "long": null, "arg": null, "description": "Log the named commands to syslogd. Examples of commands are CONNECT, HELO, EHLO, LHLO, MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT. Separate command names by white space or commas, and use quotes to protect white space from the shell. Command names are case-insensitive." }, { "flag": "-S", "long": null, "arg": null, "description": "An optional string that is prepended to each message that is written to a dump file (see the dump file format description below). The following C escape sequences are supported: \\a (bell), \\b (backspace), \\f (formfeed), \\n (newline), \\r (carriage re‐ turn), \\t (horizontal tab), \\v (vertical tab), \\ddd (up to three octal digits) and \\\\ (the backslash character)." }, { "flag": "-t", "long": null, "arg": null, "description": "Limit the time for receiving a command or sending a response. The time limit is spec‐ ified in seconds." }, { "flag": "-T", "long": null, "arg": null, "description": "Override the default TCP window size. To work around broken TCP window scaling imple‐ mentations, specify a value > 0 and < 65536." }, { "flag": "-u", "long": null, "arg": null, "description": "Switch to the specified user privileges after opening the network socket and option‐ ally changing the process root directory. This option is required when the process runs with super-user privileges. See also the -R option." }, { "flag": "-v", "long": null, "arg": null, "description": "" }, { "flag": "-w", "long": null, "arg": null, "description": "Wait delay seconds before responding to a DATA command." }, { "flag": "-W", "long": null, "arg": null, "description": "Wait delay seconds before responding to command. If odds is also specified (a number between 1-99 inclusive), wait for a random multiple of delay. The random multiplier is equal to the number of times the program needs to roll a dice with a range of 0..99 inclusive, before the dice produces a result greater than or equal to odds. [inet:][host]:port Listen on network interface host (default: any interface) TCP port port. Both host and port may be specified in numeric or symbolic form. unix:pathname Listen on the UNIX-domain socket at pathname. backlog The maximum length the queue of pending connections, as defined by the listen(2) sys‐ tem call." } ], "examples": [], "see_also": [ { "name": "smtp-source", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/smtp-source/1/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 4, "subsections": [] }, { "name": "DESCRIPTION", "lines": 16, "subsections": [ { "name": "-4", "lines": 2, "flag": "-4" }, { "name": "-6", "lines": 2, "flag": "-6" }, { "name": "-8", "lines": 1, "flag": "-8" }, { "name": "-a", "lines": 1, "flag": "-a" }, { "name": "-A", "lines": 4, "flag": "-A" }, { "name": "-b", "lines": 3, "flag": "-b" }, { "name": "-B", "lines": 3, "flag": "-B" }, { "name": "-c", "lines": 2, "flag": "-c" }, { "name": "-C", "lines": 1, "flag": "-C" }, { "name": "-d", "lines": 8, "flag": "-d" }, { "name": "-D", "lines": 7, "flag": "-D" }, { "name": "-e", "lines": 1, "flag": "-e" }, { "name": "-E", "lines": 1, "flag": "-E" }, { "name": "-f", "lines": 6, "flag": "-f" }, { "name": "-F", "lines": 1, "flag": "-F" }, { "name": "-h", "lines": 3, "flag": "-h" }, { "name": "-H", "lines": 4, "flag": "-H" }, { "name": "-L", "lines": 1, "flag": "-L" }, { "name": "-m", "lines": 4, "flag": "-m" }, { "name": "-M", "lines": 2, "flag": "-M" }, { "name": "-n", "lines": 2, "flag": "-n" }, { "name": "-N", "lines": 1, "flag": "-N" }, { "name": "-p", "lines": 1, "flag": "-p" }, { "name": "-P", "lines": 2, "flag": "-P" }, { "name": "-q", "lines": 6, "flag": "-q" }, { "name": "-Q", "lines": 6, "flag": "-Q" }, { "name": "-r", "lines": 6, "flag": "-r" }, { "name": "-R", "lines": 3, "flag": "-R" }, { "name": "-s", "lines": 6, "flag": "-s" }, { "name": "-S start-string", "lines": 6, "flag": "-S" }, { "name": "-t", "lines": 3, "flag": "-t" }, { "name": "-T", "lines": 3, "flag": "-T" }, { "name": "-u", "lines": 4, "flag": "-u" }, { "name": "-v", "lines": 1, "flag": "-v" }, { "name": "-w", "lines": 2, "flag": "-w" }, { "name": "-W", "lines": 16, "flag": "-W" } ] }, { "name": "DUMP FILE FORMAT", "lines": 50, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "LICENSE", "lines": 16, "subsections": [] } ] } }