-
Notifications
You must be signed in to change notification settings - Fork 18
/
ssmtp.8
288 lines (230 loc) · 6.34 KB
/
ssmtp.8
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
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
.TH SSMTP 8 "Last change: 4 February 2005"
.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 a mailhub for the mailhub MTA to process. Failed messages are
placed in dead.letter in the sender's home directory.
.PP
Config files allow one to specify the address to receive mail from
root, daemon, etc.; a default mailhub; a default domain to be used in
From: lines; and per-user From: addresses and mailhub names.
.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 \-4
Forces ssmtp to use IPv4 addresses only.
.TP
.B \-6
Forces ssmtp to use IPv6 addresses only.
.TP
\fB\-au\fP\fIusername\fP
Specifies username for SMTP authentication.
.TP
\fB\-ap\fP\fIpassword\fP
Specifies password for SMTP authentication.
.TP
\fB\-am\fP\fImechanism\fP
Specifies mechanism for SMTP authentication. (Only LOGIN and CRAM-MD5)
.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) Initialise 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
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 gives the From: address placed on a user's outgoing messages
and (optionally) the mailhub these messages will be sent through. Example:
.sp
.RS +.3i
.ta 1.0i
.nf
root:jdoe@isp.com:mail.isp.com
.fi
.RE
.sp
Messages root sends will be identified as from jdoe@isp.com and sent
through mail.isp.com.
.SH FILES
/etc/ssmtp/ssmtp.conf - configuration file
.br
/etc/ssmtp/revaliases - reverse aliases file
.SH SEE ALSO
RFC821, RFC822, ssmtp.conf(5).
.SH AUTHORS
Matt Ryan (mryan@debian.org)
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).
sSMTP will fail if the mailhub is unreachable.