xref: /netbsd-src/external/ibm-public/postfix/dist/html/smtp-source.1.html (revision 181254a7b1bdde6873432bffef2d2decc4b5c22f)
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 - parallelized 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       Wietse Venema
132       Google, Inc.
133       111 8th Avenue
134       New York, NY 10011, USA
135
136                                                                SMTP-SOURCE(1)
137</pre> </body> </html>
138