xref: /netbsd-src/external/ibm-public/postfix/dist/html/smtp-source.1.html (revision f14316bcbc544b96a93e884bc5c2b15fd60e22ae)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5<title> Postfix manual - smtp-source(1) </title>
6</head> <body> <pre>
7SMTP-SOURCE(1)                                                  SMTP-SOURCE(1)
8
9<b>NAME</b>
10       smtp-source - multi-threaded SMTP/LMTP test generator
11
12<b>SYNOPSIS</b>
13       <b>smtp-source</b> [<i>options</i>] [<b>inet:</b>]<i>host</i>[:<i>port</i>]
14
15       <b>smtp-source</b> [<i>options</i>] <b>unix:</b><i>pathname</i>
16
17<b>DESCRIPTION</b>
18       <b>smtp-source</b>  connects to the named <i>host</i> and TCP <i>port</i> (default: port 25)
19       and sends one or more messages to it, either sequentially or in  paral-
20       lel. The program speaks either SMTP (default) or LMTP.  Connections can
21       be made to UNIX-domain and IPv4 or IPv6 servers.  IPv4 and IPv6 are the
22       default.
23
24       Note:  this is an unsupported test program. No attempt is made to main-
25       tain compatibility between successive versions.
26
27       Arguments:
28
29       <b>-4</b>     Connect to the server with IPv4. This option has no effect  when
30              Postfix is built without IPv6 support.
31
32       <b>-6</b>     Connect  to  the  server with IPv6. This option is not available
33              when Postfix is built without IPv6 support.
34
35       <b>-A</b>     Don't abort when the  server  sends  something  other  than  the
36              expected positive reply code.
37
38       <b>-c</b>     Display  a running counter that is incremented each time an SMTP
39              DATA command completes.
40
41       <b>-C</b> <i>count</i>
42              When a host sends RESET instead  of  SYN|ACK,  try  <i>count</i>  times
43              before giving up. The default count is 1. Specify a larger count
44              in order to work around a problem with TCP/IP stacks  that  send
45              RESET when the listen queue is full.
46
47       <b>-d</b>     Don't  disconnect after sending a message; send the next message
48              over the same connection.
49
50       <b>-f</b> <i>from</i>
51              Use the specified sender address (default: &lt;foo@<a href="postconf.5.html#myhostname">myhostname</a>&gt;).
52
53       <b>-F</b> <i>file</i>
54              Send the pre-formatted message header and body in the  specified
55              <i>file</i>, while prepending '.' before lines that begin with '.', and
56              while appending CRLF after each line.
57
58       <b>-l</b> <i>length</i>
59              Send <i>length</i> bytes  as  message  payload.  The  length  does  not
60              include message headers.
61
62       <b>-L</b>     Speak LMTP rather than SMTP.
63
64       <b>-m</b> <i>message</i><b>_</b><i>count</i>
65              Send the specified number of messages (default: 1).
66
67       <b>-M</b> <i><a href="postconf.5.html#myhostname">myhostname</a></i>
68              Use  the specified hostname or [address] in the HELO command and
69              in the default sender and recipient addresses,  instead  of  the
70              machine hostname.
71
72       <b>-N</b>     Prepend  a  non-repeating  sequence  number  to  each  recipient
73              address. This avoids the artificial 100% hit rate in the resolve
74              and rewrite client caches and exercises the trivial-rewrite dae-
75              mon, better approximating Postfix  performance  under  real-life
76              work-loads.
77
78       <b>-o</b>     Old mode: don't send HELO, and don't send message headers.
79
80       <b>-r</b> <i>recipient</i><b>_</b><i>count</i>
81              Send   the   specified  number  of  recipients  per  transaction
82              (default: 1).  Recipient names are  generated  by  prepending  a
83              number to the recipient address.
84
85       <b>-R</b> <i>interval</i>
86              Wait for a random period of time 0 &lt;= n &lt;= interval between mes-
87              sages.  Suspending one thread does  not  affect  other  delivery
88              threads.
89
90       <b>-s</b> <i>session</i><b>_</b><i>count</i>
91              Run  the specified number of SMTP sessions in parallel (default:
92              1).
93
94       <b>-S</b> <i>subject</i>
95              Send mail with the named subject line (default: none).
96
97       <b>-t</b> <i>to</i>  Use the specified recipient address (default: &lt;foo@<a href="postconf.5.html#myhostname">myhostname</a>&gt;).
98
99       <b>-T</b> <i>windowsize</i>
100              Override  the default TCP window size. To work around broken TCP
101              window scaling implementations, specify a value &gt; 0 and &lt; 65536.
102
103       <b>-v</b>     Make the program more verbose, for debugging purposes.
104
105       <b>-w</b> <i>interval</i>
106              Wait  a fixed time between messages.  Suspending one thread does
107              not affect other delivery threads.
108
109       [<b>inet:</b>]<i>host</i>[:<i>port</i>]
110              Connect via TCP to host <i>host</i>, port <i>port</i>.  The  default  port  is
111              <b>smtp</b>.
112
113       <b>unix:</b><i>pathname</i>
114              Connect to the UNIX-domain socket at <i>pathname</i>.
115
116<b>BUGS</b>
117       No SMTP command pipelining support.
118
119<b>SEE ALSO</b>
120       <a href="smtp-sink.1.html">smtp-sink(1)</a>, SMTP/LMTP message dump
121
122<b>LICENSE</b>
123       The Secure Mailer license must be distributed with this software.
124
125<b>AUTHOR(S)</b>
126       Wietse Venema
127       IBM T.J. Watson Research
128       P.O. Box 704
129       Yorktown Heights, NY 10598, USA
130
131                                                                SMTP-SOURCE(1)
132</pre> </body> </html>
133