1SSMTP(8)                    System Manager's Manual                   SSMTP(8)
2
3
4

NAME

6       ssmtp, sendmail - send a message using smtp
7

SYNOPSIS

9       ssmtp [ flags ] [ address ... ]
10       /usr/lib/sendmail [ flags ] [ address ... ]
11

DESCRIPTION

13       ssmtp is a send-only sendmail emulator for machines which normally pick
14       their mail up from a centralized mailhub (via pop, imap, nfs mounts  or
15       other  means).   It  provides the functionality required for humans and
16       programs to send mail via the standard or /usr/bin/mail user agents.
17
18       It accepts a mail stream on standard input with recipients specified on
19       the  command  line  and  synchronously forwards the message to the mail
20       transfer agent of a mailhub for the mailhub MTA to process. Failed mes‐
21       sages are placed in dead.letter in the sender's home directory.
22
23       Config  files  allow  one  to  specify the address to receive mail from
24       root, daemon, etc.; a default mailhub; a default domain to be  used  in
25       From: lines; and per-user From: addresses and mailhub names.
26
27
28       It does not attempt to provide all the functionality of sendmail: it is
29       intended for use where other programs are the primary means of at  last
30       mail  delivery.   It  is  usefull with pop/imap, or to simulate the Sun
31       shared mail spool option for non-Sun machines, for machines whose send‐
32       mails  are  too  difficult (or various) to configure, for machines with
33       known disfeatures in their sendmails or for ones where there are ``mys‐
34       terious problems''.
35
36       It does not do aliasing, which must be done either in the user agent or
37       on the mailhub. Nor does it honor .forwards, which have to be  done  on
38       the recieving host.  It especially does not deliver to pipelines.
39
40

OPTIONS

42       Most sendmail options are irrelevent to sSMTP. Those marked ``ignored''
43       or ``default'' have no effect on mail transfer.  Those marked  ``unsup‐
44       ported''  are fatal errors.  Those marked ``simulated'' are not errors,
45       but the result is for the program to exit with an informative  message.
46       A sort of fatal non-error.
47
48
49       -4     Forces ssmtp to use IPv4 addresses only.
50
51
52       -6     Forces ssmtp to use IPv6 addresses only.
53
54
55       -auusername
56              Specifies username for SMTP authentication.
57
58
59       -appassword
60              Specifies password for SMTP authentication.
61
62
63       -ammechanism
64              Specifies  mechanism  for  SMTP  authentication. (Only LOGIN and
65              CRAM-MD5)
66
67
68       -ba    (unsupported) ARPANET mode. All input  lines  must  end  with  a
69              LINEFEED, and all messages will be generated with a CR-LF at the
70              end. Also, the ``From:'' and ``Sender:'' fields are examined for
71              the name of the sender.
72
73
74       -bd    (unsupported) Run as a daemon.
75
76
77       -bi    (ignored) Initialise the alias database.
78
79
80       -bm    (default) Deliver mail in the usual way.
81
82
83       -bp    (simulated) Print a summary of the mail queue.
84
85
86       -bs    (unsupported) Read SMTP commands from stdin.
87
88
89       -bt    (unsupported) Run in address test mode.
90
91
92       -bv    (unsupported) Verify names only.
93
94
95       -bz    (unsupported) Create the configuration freeze file.
96
97
98       -Cfile Use alternate configuration file.
99
100
101       -dX    Set debugging value to X.
102
103
104       -E     (ignored) Don't trust userid of sender.
105
106
107       -Ffullname
108              Set the full name of the sender.
109
110
111       -fname Sets  the name of the ``from'' person. This option is valid only
112              if no From: line is specified within the header of the email.
113
114
115       -h     (ignored) Set the hop count to N.
116
117
118       -m     (ignored) Ignore originator in alias.
119
120
121       -Mid   (ignored) Attempt to deliver the queued message with  message-id
122              id.
123
124
125       -N dsn (ignored) Set delivery status notification conditions to dsn.
126
127
128       -n     (default) Do not do aliasing.
129
130
131       -oAfile
132              (ignored) Use alternate alias file.
133
134
135       -oc    (ignored) Delay ``expensive'' connections.
136
137
138       -od    (ignored)  Set  the  delivery  mode  to interactive/synchronous,
139              background or queue (Always interactive).
140
141
142       -oD    (ignored) Run newaliases if required.
143
144
145       -oe    (ignored) Set error processing to mail, write,  print  or  quit.
146              (Always print).
147
148
149       -oFmode
150              (ignored) The mode to use when creating temporary files.
151
152
153       -of    (ignored)  Save UNIX-system-style ``From'' lines at the front of
154              messages.
155
156
157       -ogN   (ignored) Set group ID to use when calling mailers.
158
159
160       -oHfile
161              (ignored) Set SMTP help file.
162
163
164       -oi    (default) Do not take dots on a line by themselves as a  message
165              terminator.
166
167
168       -oLn   (ignored) The log level.
169
170
171       -om    (default) Send to ``me'' (the sender) also if in an alias.
172
173
174       -oo    (unsupported) If set, this message may have old style headers.
175
176
177       -oQqueuedir
178              (ignored) Select the directory in which to queue messages.
179
180
181       -ortimeout
182              (ignored) The timeout on reads.
183
184
185       -oSfile
186              (ignored) Save statistics in the named file.
187
188
189       -os    (ignored) Always instantiate the queue.
190
191
192       -oTtime
193              (ignored) Set timeout on messages.
194
195
196       -otstz,dtz
197              (ignored) Set the name of the time zone.
198
199
200       -ouN   (ignored) Set the default user id for mailers.
201
202
203       -q[time]
204              (simulated) Process the queue.
205
206
207       -rname Same as -f.
208
209
210       -Rstring
211              (ignored) Process queue for recipient.
212
213
214       -R return
215              (ignored)  Set  the  amount of the message to be returned if the
216              message bounces.
217
218
219       -t     Read  message, searching for recipients.  ``To:'',  `Cc:'',  and
220              ``Bcc:''  lines  will  be  scanned  for  people  to send to. Any
221              addresses  in  the  argument list will be suppressed  (not  sup‐
222              ported).
223
224
225       -v     Go into verbose mode.
226
227
228       -V     Say version and quit.
229
230

REVERSE ALIASES

232       A  reverse  alias  gives  the From: address placed on a user's outgoing
233       messages and (optionally) the  mailhub  these  messages  will  be  sent
234       through. Example:
235
236          root:jdoe@isp.com:mail.isp.com
237
238       Messages  root  sends  will be identified as from jdoe@isp.com and sent
239       through mail.isp.com.
240
241

FILES

243        /etc/ssmtp/ssmtp.conf - configuration file
244        /etc/ssmtp/revaliases - reverse aliases file
245
246

SEE ALSO

248       RFC821, RFC822, ssmtp.conf(5).
249
250

AUTHORS

252       Matt Ryan  (mryan@debian.org)  Hugo  Haas  (hugo@debian.org)  Christoph
253       Lameter (clameter@debian.org) Dave Collier-Brown (davecb@hobbes.ss.org)
254
255

BUGS

257       sSMTP  does not support exception lists to the -t option (never seen it
258       used).
259
260       sSMTP will fail if the mailhub is unreachable.
261
262
263
264                         Last change: 4 February 2005                 SSMTP(8)
Impressum