external/ibm-public/postfix/dist/man/man1/smtp-source.1

   1 .\"     $NetBSD$
   2 .\"
   3 .TH SMTP-SOURCE 1
   4 .ad
   5 .fi
   6 .SH NAME
   7 smtp-source
   8 \-
   9 multi-threaded SMTP/LMTP test generator
  10 .SH "SYNOPSIS"
  11 .na
  12 .nf
  13 .fi
  14 \fBsmtp-source\fR [\fIoptions\fR] [\fBinet:\fR]\fIhost\fR[:\fIport\fR]
  15
  16 \fBsmtp-source\fR [\fIoptions\fR] \fBunix:\fIpathname\fR
  17 .SH DESCRIPTION
  18 .ad
  19 .fi
  20 \fBsmtp-source\fR connects to the named \fIhost\fR and TCP \fIport\fR
  21 (default: port 25)
  22 and sends one or more messages to it, either sequentially
  23 or in parallel. The program speaks either SMTP (default) or
  24 LMTP.
  25 Connections can be made to UNIX-domain and IPv4 or IPv6 servers.
  26 IPv4 and IPv6 are the default.
  27
  28 Note: this is an unsupported test program. No attempt is made
  29 to maintain compatibility between successive versions.
  30
  31 Arguments:
  32 .IP \fB-4\fR
  33 Connect to the server with IPv4. This option has no effect when
  34 Postfix is built without IPv6 support.
  35 .IP \fB-6\fR
  36 Connect to the server with IPv6. This option is not available when
  37 Postfix is built without IPv6 support.
  38 .IP "\fB-A\fR"
  39 Don't abort when the server sends something other than the
  40 expected positive reply code.
  41 .IP \fB-c\fR
  42 Display a running counter that is incremented each time
  43 an SMTP DATA command completes.
  44 .IP "\fB-C \fIcount\fR"
  45 When a host sends RESET instead of SYN|ACK, try \fIcount\fR times
  46 before giving up. The default count is 1. Specify a larger count in
  47 order to work around a problem with TCP/IP stacks that send RESET
  48 when the listen queue is full.
  49 .IP \fB-d\fR
  50 Don't disconnect after sending a message; send the next
  51 message over the same connection.
  52 .IP "\fB-f \fIfrom\fR"
  53 Use the specified sender address (default: <foo@myhostname>).
  54 .IP "\fB-F \fIfile\fR"
  55 Send the pre-formatted message header and body in the
  56 specified \fIfile\fR, while prepending '.' before lines that
  57 begin with '.', and while appending CRLF after each line.
  58 .IP "\fB-l \fIlength\fR"
  59 Send \fIlength\fR bytes as message payload. The length does not
  60 include message headers.
  61 .IP \fB-L\fR
  62 Speak LMTP rather than SMTP.
  63 .IP "\fB-m \fImessage_count\fR"
  64 Send the specified number of messages (default: 1).
  65 .IP "\fB-M \fImyhostname\fR"
  66 Use the specified hostname or [address] in the HELO command
  67 and in the default sender and recipient addresses, instead
  68 of the machine hostname.
  69 .IP "\fB-N\fR"
  70 Prepend a non-repeating sequence number to each recipient
  71 address. This avoids the artificial 100% hit rate in the
  72 resolve and rewrite client caches and exercises the
  73 trivial-rewrite daemon, better approximating Postfix
  74 performance under real-life work-loads.
  75 .IP \fB-o\fR
  76 Old mode: don't send HELO, and don't send message headers.
  77 .IP "\fB-r \fIrecipient_count\fR"
  78 Send the specified number of recipients per transaction (default: 1).
  79 Recipient names are generated by prepending a number to the
  80 recipient address.
  81 .IP "\fB-R \fIinterval\fR"
  82 Wait for a random period of time 0 <= n <= interval between messages.
  83 Suspending one thread does not affect other delivery threads.
  84 .IP "\fB-s \fIsession_count\fR"
  85 Run the specified number of SMTP sessions in parallel (default: 1).
  86 .IP "\fB-S \fIsubject\fR"
  87 Send mail with the named subject line (default: none).
  88 .IP "\fB-t \fIto\fR"
  89 Use the specified recipient address (default: <foo@myhostname>).
  90 .IP "\fB-T \fIwindowsize\fR"
  91 Override the default TCP window size. To work around
  92 broken TCP window scaling implementations, specify a
  93 value > 0 and < 65536.
  94 .IP \fB-v\fR
  95 Make the program more verbose, for debugging purposes.
  96 .IP "\fB-w \fIinterval\fR"
  97 Wait a fixed time between messages.
  98 Suspending one thread does not affect other delivery threads.
  99 .IP [\fBinet:\fR]\fIhost\fR[:\fIport\fR]
 100 Connect via TCP to host \fIhost\fR, port \fIport\fR. The default
 101 port is \fBsmtp\fR.
 102 .IP \fBunix:\fIpathname\fR
 103 Connect to the UNIX-domain socket at \fIpathname\fR.
 104 .SH BUGS
 105 .ad
 106 .fi
 107 No SMTP command pipelining support.
 108 .SH "SEE ALSO"
 109 .na
 110 .nf
 111 smtp-sink(1), SMTP/LMTP message dump
 112 .SH "LICENSE"
 113 .na
 114 .nf
 115 .ad
 116 .fi
 117 The Secure Mailer license must be distributed with this software.
 118 .SH "AUTHOR(S)"
 119 .na
 120 .nf
 121 Wietse Venema
 122 IBM T.J. Watson Research
 123 P.O. Box 704
 124 Yorktown Heights, NY 10598, USA