summaryrefslogtreecommitdiffstats
path: root/html/smtp-source.1.html
blob: 63119715d0d899ac8c1bcaefa1171839a436d90d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - smtp-source(1) </title>
</head> <body> <pre>
SMTP-SOURCE(1)                                                  SMTP-SOURCE(1)

<b>NAME</b>
       smtp-source - parallelized SMTP/LMTP test generator

<b>SYNOPSIS</b>
       <b>smtp-source</b> [<i>options</i>] [<b>inet:</b>]<i>host</i>[:<i>port</i>]

       <b>smtp-source</b> [<i>options</i>] <b>unix:</b><i>pathname</i>

<b>DESCRIPTION</b>
       <b>smtp-source</b>  connects to the named <i>host</i> and TCP <i>port</i> (default: port 25)
       and sends one or more messages to it, either sequentially or in  paral-
       lel. The program speaks either SMTP (default) or LMTP.  Connections can
       be made to UNIX-domain and IPv4 or IPv6 servers.  IPv4 and IPv6 are the
       default.

       Note:  this is an unsupported test program. No attempt is made to main-
       tain compatibility between successive versions.

       Arguments:

       <b>-4</b>     Connect to the server with IPv4. This option has no effect  when
              Postfix is built without IPv6 support.

       <b>-6</b>     Connect  to  the  server with IPv6. This option is not available
              when Postfix is built without IPv6 support.

       <b>-A</b>     Don't abort when the  server  sends  something  other  than  the
              expected positive reply code.

       <b>-c</b>     Display  a running counter that is incremented each time an SMTP
              DATA command completes.

       <b>-C</b> <i>count</i>
              When a host sends RESET instead  of  SYN|ACK,  try  <i>count</i>  times
              before giving up. The default count is 1. Specify a larger count
              in order to work around a problem with TCP/IP stacks  that  send
              RESET when the listen queue is full.

       <b>-d</b>     Don't  disconnect after sending a message; send the next message
              over the same connection.

       <b>-f</b> <i>from</i>
              Use the specified sender address (default: &lt;foo@my-hostname&gt;).

       <b>-F</b> <i>file</i>
              Send the pre-formatted message header and body in the  specified
              <i>file</i>, while prepending '.' before lines that begin with '.', and
              while appending CRLF after each line.

       <b>-l</b> <i>length</i>
              Send <i>length</i> bytes  as  message  payload.  The  length  does  not
              include message headers.

       <b>-L</b>     Speak LMTP rather than SMTP.

       <b>-m</b> <i>message</i><b>_</b><i>count</i>
              Send the specified number of messages (default: 1).

       <b>-M</b> <i>my-hostname</i>
              Use  the specified hostname or [address] in the HELO command and
              in the default sender and recipient addresses,  instead  of  the
              machine hostname.

       <b>-N</b>     Generate  each  recipient  address  by  appending  a  number  (a
              per-process recipient counter) to the recipient  address  local-
              part specified with the <b>-t</b> option.

              Note:  to  use  the  number  as an address extension, specify an
              explicit address delimiter at the end of  the  recipient  local-
              part, as in "<b>-t localpart+@domain</b>" or "<b>-t localpart+</b>", where "<b>+</b>"
              is a Postfix recipient address delimiter.

              Benefits:

              <b>o</b>      A non-constant recipient address  avoids  an  unrealistic
                     100% cache hit rate in clients of the Postfix trivial-re-
                     write service,  better  approximating  performance  under
                     real-life work-loads.

              <b>o</b>      A  fixed recipient address local-part with a non-constant
                     address extension avoids the need to  configure  a  large
                     number  of  valid  recipient  addresses  in the receiving
                     Postfix server.

       <b>-o</b>     Old mode: don't send HELO, and don't send message headers.

       <b>-r</b> <i>recipient</i><b>_</b><i>count</i>
              Send  the  specified  number  of  recipients   per   transaction
              (default:  1),  and  generate  recipient  addresses as described
              under the <b>-N</b> option.

       <b>-R</b> <i>interval</i>
              Wait a random time (0 &lt;= n &lt;= <i>interval</i>) between messages.   Sus-
              pending one thread does not affect other delivery threads.

       <b>-s</b> <i>session</i><b>_</b><i>count</i>
              Run  the specified number of SMTP sessions in parallel (default:
              1).

       <b>-S</b> <i>subject</i>
              Send mail with the named subject line (default: none).

       <b>-t</b> <i>to</i>  Use the  specified  recipient  address  (default:  &lt;foo@my-host-
              name&gt;).

       <b>-T</b> <i>windowsize</i>
              Override  the default TCP window size. To work around broken TCP
              window scaling implementations, specify a value &gt; 0 and &lt; 65536.

       <b>-v</b>     Make the program more verbose, for debugging purposes.

       <b>-w</b> <i>interval</i>
              Wait  a fixed time between messages.  Suspending one thread does
              not affect other delivery threads.

       [<b>inet:</b>]<i>host</i>[:<i>port</i>]
              Connect via TCP to host <i>host</i>, port <i>port</i>.  The  default  port  is
              <b>smtp</b>.

       <b>unix:</b><i>pathname</i>
              Connect to the UNIX-domain socket at <i>pathname</i>.

<b>BUGS</b>
       No SMTP command pipelining support.

<b>SEE ALSO</b>
       <a href="smtp-sink.1.html">smtp-sink(1)</a>, SMTP/LMTP message dump

<b>LICENSE</b>
       The Secure Mailer license must be distributed with this software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

                                                                SMTP-SOURCE(1)
</pre> </body> </html>