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