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 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266
|
.TH SSMTP 8 "Last change: 23 October 1998"
.SH NAME
ssmtp, sendmail \- send a message using smtp
.SH SYNOPSIS
.B ssmtp
.RI "[ " flags " ] [ " address " " ... " ]"
.br
.B /usr/lib/sendmail
.RI "[ " flags " ] [ " address " " ... " ]"
.br
.SH DESCRIPTION
.I ssmtp
is a send-only sendmail emulator for machines which normally pick their mail
up from a centralized mailhub (via pop, imap, nfs mounts or other means).
It provides the functionality required for humans and programs to send
mail via the standard or /usr/bin/mail user agents.
.PP
It accepts a mail stream on standard input with recipients specified on the
command line and synchronously forwards the message to the mail transfer
agent of its mailhub for the mailhub MTA to process. Failed messages are
placed in dead.letter in the sender's home directory.
.PP
A config file allows one to specify the person to receive mail for root,
daemon, etc. One can also specify the mailhub's name and optionaly the domain
to be used in From: lines.
.sp
.PP
It does not attempt to provide all the functionality of sendmail: it is
intended for use where other programs are the primary means of at last mail
delivery. It is usefull with pop/imap, or to simulate the Sun shared mail
spool option for non-Sun machines, for machines whose sendmails are too
difficult (or various) to configure, for machines with known disfeatures in
their sendmails or for ones where there are ``mysterious problems''.
.PP
It does not do aliasing, which must be done either in the user agent
or on the mailhub. Nor does it honor .forwards, which have to be done
on the recieving host. It especially does not deliver to pipelines.
.SH OPTIONS
Most sendmail options are irrelevent to sSMTP. Those marked ``ignored'' or
``default'' have no effect on mail transfer. Those marked ``unsupported''
are fatal errors. Those marked ``simulated'' are not errors, but the result
is for the program to exit with an informative message. A sort of fatal
non-error.
.TP
.B \-ba
(unsupported) ARPANET mode. All input lines must end with a LINEFEED, and
all messages will be generated with a CR-LF at the end. Also, the ``From:''
and ``Sender:'' fields are examined for the name of the sender.
.TP
.B \-bd
(unsupported) Run as a daemon.
.TP
.B \-bi
(ignored) Initialize the alias database.
.TP
.B \-bm
(default) Deliver mail in the usual way.
.TP
.B \-bp
(simulated) Print a summary of the mail queue.
.TP
.B \-bs
(unsupported) Read SMTP commands from stdin.
.TP
.B \-bt
(unsupported) Run in address test mode.
.TP
.B \-bv
(unsupported) Verify names only.
.TP
.B \-bz
(unsupported) Create the configuration freeze file.
.TP
\fB\-C\fP\fIfile\fP
(ignored) Use alternate configuration file.
.TP
\fB\-d\fP\fIX\fP
Set debugging value to X.
.TP
.B \-E
(ignored) Don't trust userid of sender.
.TP
\fB\-F\fP\fIfullname\fP
Set the full name of the sender.
.TP
\fB\-f\fP\fIname\fP
Sets the name of the ``from'' person. This option is valid only if no
From: line is specified within the header of the email.
.TP
\fB\-h\fP\fI\fN\fP
(ignored) Set the hop count to N.
.TP
.B \-m
(ignored) Ignore originator in alias.
.TP
\fB\-M\fP\fIid\fP
(ignored) Attempt to deliver the queued message with message-id id.
.TP
\fB\-N\fP \fIdsn\fP
(ignored) Set delivery status notification conditions to dsn.
.TP
.B \-n
(default) Do not do aliasing.
.TP
\fB\-oA\fP\fIfile\fP
(ignored) Use alternate alias file.
.TP
.B \-oc
(ignored) Delay ``expensive'' connections.
.TP
\fB\-od\fP\fx\fP
(ignored) Set the delivery mode to interactive/synchronous, background or queue
(Always interactive).
.TP
.B \-oD
(ignored) Run newaliases if required.
.TP
\fB\-oe\fP\fx\fP
(ignored) Set error processing to mail, write, print or quit. (Always print).
.TP
\fB\-oF\fP\fImode\fP
(ignored) The mode to use when creating temporary files.
.TP
.B \-of
(ignored) Save UNIX-system-style ``From'' lines at the front of messages.
.TP
\fB\-og\fP\fIN\fP
(ignored) Set group ID to use when calling mailers.
.TP
\fB\-oH\fP\fIfile\fP
(ignored) Set SMTP help file.
.TP
.B \-oi
(default) Do not take dots on a line by themselves as a message terminator.
.TP
\fB\-oL\fP\fIn\fP
(ignored) The log level.
.TP
.B \-om
(default) Send to ``me'' (the sender) also if in an alias.
.TP
.B \-oo
(unsupported) If set, this message may have old style headers.
.TP
\fB\-oQ\fP\fIqueuedir\fP
(ignored) Select the directory in which to queue messages.
.TP
\fB\-or\fP\fItimeout\fP
(ignored) The timeout on reads.
.TP
\fB\-oS\fP\fIfile\fP
(ignored) Save statistics in the named file.
.TP
.B \-os
(ignored) Always instantiate the queue.
.TP
\fB\-oT\fP\fItime\fP
(ignored) Set timeout on messages.
.TP
\fB\-ot\fP\fIstz,dtz\fP
(ignored) Set the name of the time zone.
.TP
\fB\-ou\fP\fIN\fP
(ignored) Set the default user id for mailers.
.TP
\fB\-q\fP\fI[time]\fP
(simulated) Process the queue.
.TP
\fB\-r\fP\fIname\fP
Same as -f.
.TP
\fB\-R\fP\fIstring\fP
(ignored) Process queue for recipient.
.TP
\fB\-R\fP \fIreturn\fP
(ignored) Set the amount of the message to be returned if the message bounces.
.TP
.B \-t
Read message, searching for recipients. ``To:'', `Cc:'', and ``Bcc:'' lines
will be scanned for people to send to. Any addresses in the argument list
will be suppressed (not supported).
.TP
.B \-v
Go into verbose mode.
.TP
.B \-V
Say version and quit.
.SH REVERSE ALIASES
A reverse alias is used for out-going mails. If the From: line has not been
specified and if an entry exists for the user sending the mail, the From:
field is set to the value indicated in the revaliases file. Example:
.sp
.RS +.3i
.ta 1.0i
.nf
root: user@your.domain
.fi
.RE
.sp
Every mail sent by root will have a From: user@your.domain line in the header.
.SH FILES
/etc/ssmtp/ssmtp.conf - configuration file
/etc/ssmtp/revaliases - reverse aliases file
.SH SEE ALSO
RFC 821, RFC 822.
.SH DIAGNOSTICS
.SH AUTHORS
Hugo Haas (hugo@debian.org)
Christoph Lameter (clameter@debian.org)
Dave Collier-Brown (davecb@hobbes.ss.org)
.SH BUGS
sSMTP does not support exception lists to the -t option (never seen it
used). Header size is limited to 4K and a max of 100 addresses.
|