xref: /netbsd-src/external/ibm-public/postfix/dist/html/smtp-source.1.html (revision 059c16a85b0b39d60ad6d18f53c09510815afa2b)
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=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>NAME</b>
11       smtp-source - parallelized SMTP/LMTP test generator
12
13<b>SYNOPSIS</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>DESCRIPTION</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@<a href="postconf.5.html#myhostname">myhostname</a>&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><a href="postconf.5.html#myhostname">myhostname</a></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>     Prepend  a  non-repeating  sequence  number  to  each  recipient
74              address. This avoids the artificial 100% hit rate in the resolve
75              and rewrite client caches and exercises the trivial-rewrite dae-
76              mon, better approximating Postfix  performance  under  real-life
77              work-loads.
78
79       <b>-o</b>     Old mode: don't send HELO, and don't send message headers.
80
81       <b>-r</b> <i>recipient</i><b>_</b><i>count</i>
82              Send   the   specified  number  of  recipients  per  transaction
83              (default: 1).  Recipient names are  generated  by  prepending  a
84              number to the recipient address.
85
86       <b>-R</b> <i>interval</i>
87              Wait for a random period of time 0 &lt;= n &lt;= interval between mes-
88              sages.  Suspending one thread does  not  affect  other  delivery
89              threads.
90
91       <b>-s</b> <i>session</i><b>_</b><i>count</i>
92              Run  the specified number of SMTP sessions in parallel (default:
93              1).
94
95       <b>-S</b> <i>subject</i>
96              Send mail with the named subject line (default: none).
97
98       <b>-t</b> <i>to</i>  Use the specified recipient address (default: &lt;foo@<a href="postconf.5.html#myhostname">myhostname</a>&gt;).
99
100       <b>-T</b> <i>windowsize</i>
101              Override  the default TCP window size. To work around broken TCP
102              window scaling implementations, specify a value &gt; 0 and &lt; 65536.
103
104       <b>-v</b>     Make the program more verbose, for debugging purposes.
105
106       <b>-w</b> <i>interval</i>
107              Wait  a fixed time between messages.  Suspending one thread does
108              not affect other delivery threads.
109
110       [<b>inet:</b>]<i>host</i>[:<i>port</i>]
111              Connect via TCP to host <i>host</i>, port <i>port</i>.  The  default  port  is
112              <b>smtp</b>.
113
114       <b>unix:</b><i>pathname</i>
115              Connect to the UNIX-domain socket at <i>pathname</i>.
116
117<b>BUGS</b>
118       No SMTP command pipelining support.
119
120<b>SEE ALSO</b>
121       <a href="smtp-sink.1.html">smtp-sink(1)</a>, SMTP/LMTP message dump
122
123<b>LICENSE</b>
124       The Secure Mailer license must be distributed with this software.
125
126<b>AUTHOR(S)</b>
127       Wietse Venema
128       IBM T.J. Watson Research
129       P.O. Box 704
130       Yorktown Heights, NY 10598, USA
131
132       Wietse Venema
133       Google, Inc.
134       111 8th Avenue
135       New York, NY 10011, USA
136
137                                                                SMTP-SOURCE(1)
138</pre> </body> </html>
139