1 '\" te |
|
2 .\" Copyright (c) 1998-2003 Sendmail, Inc. and its suppliers. All rights reserved. |
|
3 .\" Copyright (c) 1983, 1997 Eric P. Allman. All rights reserved. |
|
4 .\" Copyright (c) 1988, 1991, 1993 The Regents of the University of California. All rights reserved. |
|
5 .\" Portions Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved. |
|
6 .TH sendmail 1M "4 Feb 2015" "SunOS 5.12" "System Administration Commands" |
|
7 .SH NAME |
|
8 sendmail \- send mail over the internet |
|
9 .SH SYNOPSIS |
|
10 .LP |
|
11 .nf |
|
12 \fB/usr/lib/sendmail\fR [\fB-Ac\fR] [\fB-Am\fR] [\fB-ba\fR] [\fB-bD\fR] [\fB-bd\fR] [\fB-bi\fR] [\fB-bl\fR] |
|
13 [\fB-bm\fR] [\fB-bp\fR] [\fB-bP\fR] [\fB-bs\fR] [\fB-bt\fR] [\fB-bv\fR] [\fB-B\fR \fItype\fR] [\fB-C\fR \fIfile\fR] |
|
14 [\fB-D\fR \fIlogfile\fR] [\fB-d\fR \fIX\fR] [\fB-F\fR \fIfullname\fR] [\fB-f\fR \fIname\fR] [\fB-G\fR] |
|
15 [\fB-h\fR \fIN\fR] [\fB-L \fItag\fR\fR] [\fB-M\fR x\fIvalue\fR] [\fB-N\fR \fInotifications\fR] [\fB-n\fR] |
|
16 [\fB-O\fR\fIoption\fR =\fIvalue\fR] [\fB-o\fR x\fIvalue\fR] [\fB-p\fR \fIprotocol\fR] |
|
17 [\fB-Q\fR [\fIreason\fR]] [\fB-q\fR [\fItime\fR]] [\fB-q\fR \fIXstring\fR] [\fB-R\fR \fIret\fR] |
|
18 [\fB-r\fR \fIname\fR] [\fB-t\fR] [\fB-V\fR \fIenvid\fR] [\fB-v\fR] [\fB-X\fR \fIlogfile\fR] |
|
19 [\fIaddress\fR]... |
|
20 .fi |
|
21 |
|
22 .SH DESCRIPTION |
|
23 .sp |
|
24 .LP |
|
25 The \fBsendmail\fR utility sends a message to one or more people, routing the message over whatever networks are necessary. \fBsendmail\fR does internetwork forwarding as necessary to deliver the message to the correct place. |
|
26 .sp |
|
27 .LP |
|
28 \fBsendmail\fR is not intended as a user interface routine. Other programs provide user-friendly front ends. \fBsendmail\fR is used only to deliver pre-formatted messages. |
|
29 .sp |
|
30 .LP |
|
31 With no flags, \fBsendmail\fR reads its standard input up to an EOF, or a line with a single dot, and sends a copy of the letter found there to all of the addresses listed. It determines the network to use based on the syntax and contents of the addresses. |
|
32 .sp |
|
33 .LP |
|
34 Local addresses are looked up in the local \fBaliases\fR(4) file, or in a name service as defined by the \fBnsswitch.conf\fR(4) file, and aliased appropriately. In addition, if there is a \fB\&.forward\fR file in a recipient's home directory, \fBsendmail\fR forwards a copy of each message to the list of recipients that file contains. Refer to the \fBNOTES\fR section for more information about \fB\&.forward\fR files. Aliasing can be prevented by preceding the address with a backslash. |
|
35 .sp |
|
36 .LP |
|
37 There are several conditions under which the expected behavior is for the alias database to be either built or rebuilt. This cannot occur under any circumstances unless root owns \fBand\fR has exclusive write permission to the \fB/etc/mail/aliases*\fR files. |
|
38 .sp |
|
39 .LP |
|
40 If a message is found to be undeliverable, it is returned to the sender with diagnostics that indicate the location and nature of the failure; or, the message is placed in a \fBdead.letter\fR file in the sender's home directory. |
|
41 .SS "Service Management" |
|
42 .sp |
|
43 .LP |
|
44 The \fBsendmail\fR service is managed by the service management facility, \fBsmf\fR(5), under the service identifiers: |
|
45 .sp |
|
46 .in +2 |
|
47 .nf |
|
48 svc:/network/smtp:sendmail |
|
49 svc:/network/sendmail-client:default |
|
50 |
|
51 .fi |
|
52 .in -2 |
|
53 .sp |
|
54 |
|
55 .sp |
|
56 .LP |
|
57 Administrative actions on these services, such as enabling, disabling, or requesting restart, can be performed using \fBsvcadm\fR(1M). The services' status can be queried using the \fBsvcs\fR(1) command. |
|
58 .sp |
|
59 .LP |
|
60 These are separate services rather than instances of the same service so that other services can properly express any dependencies. In particular, here are some guidelines about which service/instance should be depended on for which purposes: |
|
61 .RS +4 |
|
62 .TP |
|
63 .ie t \(bu |
|
64 .el o |
|
65 For a service that uses \fBsendmail\fR to send mail, an optional dependency on the service \fBsvc:/network/sendmail-client\fR might be in order. |
|
66 .RE |
|
67 .RS +4 |
|
68 .TP |
|
69 .ie t \(bu |
|
70 .el o |
|
71 For a service that needs to receive mail in general, but does not depend on \fBsendmail\fR being the particular SMTP receiver, a dependency on the service \fBsvc:/network/smtp\fR might be in order. |
|
72 .RE |
|
73 .RS +4 |
|
74 .TP |
|
75 .ie t \(bu |
|
76 .el o |
|
77 For a service that needs to interact with sendmail in particular, such as a \fBMilter\fR, a dependency on the instance \fBsvc:/network/smtp:sendmail\fR might be in order. |
|
78 .RE |
|
79 .sp |
|
80 .LP |
|
81 For the last two, note the difference, as the latter has the \fB":sendmail"\fR instance specification, whereas the former does not, thus representing the more general service. |
|
82 .SS "Enabling Access to Remote Clients" |
|
83 .sp |
|
84 .LP |
|
85 On an unmodified system, access to \fBsendmail\fR by remote clients is enabled and disabled through the service management facility (see \fBsmf\fR(5)). In particular, remote access is determined by the value of the \fBlocal_only\fR SMF property: |
|
86 .sp |
|
87 .in +2 |
|
88 .nf |
|
89 svc:/network/smtp:sendmail/config/local_only = true |
|
90 .fi |
|
91 .in -2 |
|
92 |
|
93 .sp |
|
94 .LP |
|
95 A setting of \fBtrue\fR, as above, disallows remote access; \fBfalse\fR allows remote access. The default value is \fBtrue\fR. |
|
96 .sp |
|
97 .LP |
|
98 The following example shows the sequence of SMF commands used to enable \fBsendmail\fR to allow access to remote systems: |
|
99 .sp |
|
100 .in +2 |
|
101 .nf |
|
102 # \fBsvccfg -s svc:/network/smtp:sendmail setprop config/local_only = false\fR |
|
103 # \fBsvcadm refresh svc:/network/smtp:sendmail\fR |
|
104 # \fBsvcadm restart svc:/network/smtp:sendmail\fR |
|
105 .fi |
|
106 .in -2 |
|
107 .sp |
|
108 |
|
109 .sp |
|
110 .LP |
|
111 See \fBsvcadm\fR(1M) and \fBsvccfg\fR(1M). |
|
112 .sp |
|
113 .LP |
|
114 Note, however, on a system where any of the \fBsendmail\fR(4) files have been customized, setting this property might not have the intended effect. See \fBsendmail\fR(4) for details. |
|
115 .SS "Automated Rebuilding of Configuration Files" |
|
116 .sp |
|
117 .LP |
|
118 See \fBsendmail\fR(4) for details on which service properties can be set to automate (re)building of configuration files when the service is started. |
|
119 .SS "Restricting Host Access" |
|
120 .sp |
|
121 .LP |
|
122 \fBsendmail\fR uses TCP Wrappers to restrict access to hosts. It uses the service name of \fBsendmail\fR for \fBhosts_access()\fR. For more information on TCP Wrappers, see \fBtcpd\fR(1M) and \fBhosts_access\fR(4) in the \fBsecurity/tcp-wrapper\fR package. \fBtcpd\fR(1M) and \fBhosts_access\fR(4) are not part of the Solaris man pages. |
|
123 .SS "Startup Options" |
|
124 .sp |
|
125 .LP |
|
126 The \fB/etc/default/sendmail\fR file stores startup options for \fBsendmail\fR so that the options are not removed when a host is upgraded. See also \fBsendmail\fR(4) for details on which service properties can be set to automate (re)building of configuration files when the service is started. |
|
127 .sp |
|
128 .LP |
|
129 You can use the following variables in the \fB/etc/default/sendmail\fR startup file: |
|
130 .sp |
|
131 .ne 2 |
|
132 .mk |
|
133 .na |
|
134 \fBCLIENTOPTIONS=\fIstring\fR\fR |
|
135 .ad |
|
136 .sp .6 |
|
137 .RS 4n |
|
138 Selects additional options to be used with the client daemon, which looks in the client-only queue (\fB/var/spool/clientmqueue\fR) and acts as a client queue runner. No syntax checking is done, so be careful when making changes to this variable. |
|
139 .RE |
|
140 |
|
141 .sp |
|
142 .ne 2 |
|
143 .mk |
|
144 .na |
|
145 \fBCLIENTQUEUEINTERVAL=\fI#\fR\fR |
|
146 .ad |
|
147 .sp .6 |
|
148 .RS 4n |
|
149 Similar to the \fBQUEUEINTERVAL\fR option, \fBCLIENTQUEUEINTERVAL\fR sets the time interval for mail queue runs. However, the \fBCLIENTQUEUEINTERVAL\fR option controls the functions of the client daemon, instead of the functions of the master daemon. Typically, the master daemon is able to deliver all messages to the SMTP port. However, if the message load is too high or the master daemon is not running, then messages go into the client-only queue, \fB/var/spool/clientmqueue\fR. The client daemon, which checks in the client-only queue, then acts as a client queue processor. |
|
150 .RE |
|
151 |
|
152 .sp |
|
153 .ne 2 |
|
154 .mk |
|
155 .na |
|
156 \fBETRN_HOSTS=\fIstring\fR\fR |
|
157 .ad |
|
158 .sp .6 |
|
159 .RS 4n |
|
160 Enables an SMTP client and server to interact immediately without waiting for the queue run intervals, which are periodic. The server can immediately deliver the portion of its queue that goes to the specified hosts. For more information, refer to the \fBetrn\fR(1M) man page. |
|
161 .RE |
|
162 |
|
163 .sp |
|
164 .ne 2 |
|
165 .mk |
|
166 .na |
|
167 \fBMODE=-bd\fR |
|
168 .ad |
|
169 .sp .6 |
|
170 .RS 4n |
|
171 Selects the mode to start \fBsendmail\fR with. Use the \fB-bd\fR option or leave it undefined. |
|
172 .RE |
|
173 |
|
174 .sp |
|
175 .ne 2 |
|
176 .mk |
|
177 .na |
|
178 \fBOPTIONS=\fIstring\fR\fR |
|
179 .ad |
|
180 .sp .6 |
|
181 .RS 4n |
|
182 Selects additional options to be used with the master daemon. No syntax checking is done, so be careful when making changes to this variable. |
|
183 .RE |
|
184 |
|
185 .sp |
|
186 .ne 2 |
|
187 .mk |
|
188 .na |
|
189 \fBQUEUEINTERVAL=\fI#\fR\fR |
|
190 .ad |
|
191 .sp .6 |
|
192 .RS 4n |
|
193 Sets the interval for mail queue runs on the master daemon. \fI#\fR can be a positive integer that is followed by either \fBs\fR for seconds, \fBm\fR for minutes, \fBh\fR for hours, \fBd\fR for days, or \fBw\fR for weeks. The syntax is checked before \fBsendmail\fR is started. If the interval is negative or if the entry does not end with an appropriate letter, the interval is ignored and \fBsendmail\fR starts with a queue interval of 15 minutes. |
|
194 .RE |
|
195 |
|
196 .sp |
|
197 .ne 2 |
|
198 .mk |
|
199 .na |
|
200 \fBQUEUEOPTIONS=p\fR |
|
201 .ad |
|
202 .sp .6 |
|
203 .RS 4n |
|
204 Enables one persistent queue runner that sleeps between queue run intervals, instead of a new queue runner for each queue run interval. You can set this option to \fBp\fR, which is the only setting available. Otherwise, this option is not set. |
|
205 .RE |
|
206 |
|
207 .SS "Mail Filter API" |
|
208 .sp |
|
209 .LP |
|
210 \fBsendmail\fR supports a mail filter API called "milter". For more information, see \fB/usr/include/libmilter/README\fR and http://www.milter.org |
|
211 .SH OPTIONS |
|
212 .sp |
|
213 .LP |
|
214 The following options are supported: |
|
215 .sp |
|
216 .ne 2 |
|
217 .mk |
|
218 .na |
|
219 \fB\fB-Ac\fR\fR |
|
220 .ad |
|
221 .sp .6 |
|
222 .RS 4n |
|
223 Uses \fBsubmit.cf\fR even if the operation mode does not indicate an initial mail submission. |
|
224 .RE |
|
225 |
|
226 .sp |
|
227 .ne 2 |
|
228 .mk |
|
229 .na |
|
230 \fB\fB-Am\fR\fR |
|
231 .ad |
|
232 .sp .6 |
|
233 .RS 4n |
|
234 Uses \fBsendmail.cf\fR even if the operation mode indicates an initial mail submission. |
|
235 .RE |
|
236 |
|
237 .sp |
|
238 .ne 2 |
|
239 .mk |
|
240 .na |
|
241 \fB\fB-ba\fR\fR |
|
242 .ad |
|
243 .sp .6 |
|
244 .RS 4n |
|
245 Goes into \fBARPANET\fR mode. All input lines must end with a RETURN-LINEFEED, and all messages are generated with a RETURN-LINEFEED at the end. Also, the \fBFrom:\fR and \fBSender:\fR fields are examined for the name of the sender. |
|
246 .RE |
|
247 |
|
248 .sp |
|
249 .ne 2 |
|
250 .mk |
|
251 .na |
|
252 \fB\fB-bd\fR\fR |
|
253 .ad |
|
254 .sp .6 |
|
255 .RS 4n |
|
256 Runs as a daemon in the background, waiting for incoming SMTP connections. |
|
257 .RE |
|
258 |
|
259 .sp |
|
260 .ne 2 |
|
261 .mk |
|
262 .na |
|
263 \fB\fB-bD\fR\fR |
|
264 .ad |
|
265 .sp .6 |
|
266 .RS 4n |
|
267 Runs as a daemon in the foreground, waiting for incoming SMTP connections. |
|
268 .RE |
|
269 |
|
270 .sp |
|
271 .ne 2 |
|
272 .mk |
|
273 .na |
|
274 \fB\fB-bi\fR\fR |
|
275 .ad |
|
276 .sp .6 |
|
277 .RS 4n |
|
278 Initializes the \fBaliases\fR(4) database. Root must own \fIand\fR have exclusive write permission to the \fB/etc/mail/aliases*\fR files for successful use of this option. |
|
279 .RE |
|
280 |
|
281 .sp |
|
282 .ne 2 |
|
283 .mk |
|
284 .na |
|
285 \fB\fB-bl\fR\fR |
|
286 .ad |
|
287 .sp .6 |
|
288 .RS 4n |
|
289 Runs as a daemon (like \fB-bd\fR) but accepts only loopback SMTP connections. |
|
290 .RE |
|
291 |
|
292 .sp |
|
293 .ne 2 |
|
294 .mk |
|
295 .na |
|
296 \fB\fB-bm\fR\fR |
|
297 .ad |
|
298 .sp .6 |
|
299 .RS 4n |
|
300 Delivers mail in the usual way (default). |
|
301 .RE |
|
302 |
|
303 .sp |
|
304 .ne 2 |
|
305 .mk |
|
306 .na |
|
307 \fB\fB-bp\fR\fR |
|
308 .ad |
|
309 .sp .6 |
|
310 .RS 4n |
|
311 Prints a summary of the mail queues. |
|
312 .RE |
|
313 |
|
314 .sp |
|
315 .ne 2 |
|
316 .mk |
|
317 .na |
|
318 \fB\fB-bP\fR\fR |
|
319 .ad |
|
320 .sp .6 |
|
321 .RS 4n |
|
322 Prints the number of entries in the queues. This option is only available with shared memory support. |
|
323 .RE |
|
324 |
|
325 .sp |
|
326 .ne 2 |
|
327 .mk |
|
328 .na |
|
329 \fB\fB-bs\fR\fR |
|
330 .ad |
|
331 .sp .6 |
|
332 .RS 4n |
|
333 Uses the SMTP protocol as described in RFC 2821. This flag implies all the operations of the \fB-ba\fR flag that are compatible with \fBSMTP\fR. |
|
334 .RE |
|
335 |
|
336 .sp |
|
337 .ne 2 |
|
338 .mk |
|
339 .na |
|
340 \fB\fB-bt\fR\fR |
|
341 .ad |
|
342 .sp .6 |
|
343 .RS 4n |
|
344 Runs in address test mode. This mode reads addresses and shows the steps in parsing; it is used for debugging configuration tables. |
|
345 .RE |
|
346 |
|
347 .sp |
|
348 .ne 2 |
|
349 .mk |
|
350 .na |
|
351 \fB\fB-bv\fR\fR |
|
352 .ad |
|
353 .sp .6 |
|
354 .RS 4n |
|
355 Verifies names only. Does not try to collect or deliver a message. Verify mode is normally used for validating users or mailing lists. |
|
356 .RE |
|
357 |
|
358 .sp |
|
359 .ne 2 |
|
360 .mk |
|
361 .na |
|
362 \fB\fB-B\fR \fItype\fR\fR |
|
363 .ad |
|
364 .sp .6 |
|
365 .RS 4n |
|
366 Indicates body \fItype\fR (\fB7BIT\fR or \fB8BITMIME\fR). |
|
367 .RE |
|
368 |
|
369 .sp |
|
370 .ne 2 |
|
371 .mk |
|
372 .na |
|
373 \fB\fB-C\fR \fIfile\fR\fR |
|
374 .ad |
|
375 .sp .6 |
|
376 .RS 4n |
|
377 Uses alternate configuration file. |
|
378 .RE |
|
379 |
|
380 .sp |
|
381 .ne 2 |
|
382 .mk |
|
383 .na |
|
384 \fB\fB-D\fR \fIlogfile\fR\fR |
|
385 .ad |
|
386 .sp .6 |
|
387 .RS 4n |
|
388 Send debugging output to the indicated log file instead of \fBstdout\fR. |
|
389 .RE |
|
390 |
|
391 .sp |
|
392 .ne 2 |
|
393 .mk |
|
394 .na |
|
395 \fB\fB-d\fR \fIX\fR\fR |
|
396 .ad |
|
397 .sp .6 |
|
398 .RS 4n |
|
399 Sets debugging value to \fIX\fR. |
|
400 .RE |
|
401 |
|
402 .sp |
|
403 .ne 2 |
|
404 .mk |
|
405 .na |
|
406 \fB\fB-f\fR \fIname\fR\fR |
|
407 .ad |
|
408 .sp .6 |
|
409 .RS 4n |
|
410 Sets the name of the "from" person (that is, the sender of the mail). |
|
411 .RE |
|
412 |
|
413 .sp |
|
414 .ne 2 |
|
415 .mk |
|
416 .na |
|
417 \fB\fB-F\fR \fIfullname\fR\fR |
|
418 .ad |
|
419 .sp .6 |
|
420 .RS 4n |
|
421 Sets the full name of the sender. |
|
422 .RE |
|
423 |
|
424 .sp |
|
425 .ne 2 |
|
426 .mk |
|
427 .na |
|
428 \fB\fB-G\fR\fR |
|
429 .ad |
|
430 .sp .6 |
|
431 .RS 4n |
|
432 When accepting messages by way of the command line, indicates that they are for relay (gateway) submission. When this flag is set, \fBsendmail\fR might complain about syntactically invalid messages, for example, unqualified host names, rather than fixing them. \fBsendmail\fR does not do any canonicalization in this mode. |
|
433 .RE |
|
434 |
|
435 .sp |
|
436 .ne 2 |
|
437 .mk |
|
438 .na |
|
439 \fB\fB-h\fR \fIN\fR\fR |
|
440 .ad |
|
441 .sp .6 |
|
442 .RS 4n |
|
443 Sets the hop count to \fIN\fR. The hop count is incremented every time the mail is processed. When it reaches a limit, the mail is returned with an error message, the victim of an aliasing loop. |
|
444 .RE |
|
445 |
|
446 .sp |
|
447 .ne 2 |
|
448 .mk |
|
449 .na |
|
450 \fB\fB-L\fR \fItag\fR\fR |
|
451 .ad |
|
452 .sp .6 |
|
453 .RS 4n |
|
454 Sets the identifier used in \fBsyslog\fR messages to the supplied \fItag\fR. |
|
455 .RE |
|
456 |
|
457 .sp |
|
458 .ne 2 |
|
459 .mk |
|
460 .na |
|
461 \fB\fB-M\fR\fIxvalue\fR\fR |
|
462 .ad |
|
463 .sp .6 |
|
464 .RS 4n |
|
465 Sets macro \fIx\fR to the specified \fIvalue\fR. |
|
466 .RE |
|
467 |
|
468 .sp |
|
469 .ne 2 |
|
470 .mk |
|
471 .na |
|
472 \fB\fB-n\fR\fR |
|
473 .ad |
|
474 .sp .6 |
|
475 .RS 4n |
|
476 Does not do aliasing. |
|
477 .RE |
|
478 |
|
479 .sp |
|
480 .ne 2 |
|
481 .mk |
|
482 .na |
|
483 \fB\fB-N\fR \fInotifications\fR\fR |
|
484 .ad |
|
485 .sp .6 |
|
486 .RS 4n |
|
487 Tags all addresses being sent as wanting the indicated \fInotifications\fR, which consists of the word "NEVER" or a comma-separated list of "SUCCESS", "FAILURE", and "DELAY" for successful delivery, failure and a message that is stuck in a queue somwhere. The default is "FAILURE,DELAY". |
|
488 .RE |
|
489 |
|
490 .sp |
|
491 .ne 2 |
|
492 .mk |
|
493 .na |
|
494 \fB\fB-o\fR\fIxvalue\fR\fR |
|
495 .ad |
|
496 .sp .6 |
|
497 .RS 4n |
|
498 Sets option \fIx\fR to the specified \fIvalue\fR. \fBProcessing\fR \fBOptions\fR are described below. |
|
499 .RE |
|
500 |
|
501 .sp |
|
502 .ne 2 |
|
503 .mk |
|
504 .na |
|
505 \fB\fB-O\fR\fIoption=value\fR\fR |
|
506 .ad |
|
507 .sp .6 |
|
508 .RS 4n |
|
509 Sets \fIoption\fR to the specified \fIvalue\fR (for long from names). \fBProcessing\fR \fBOptions\fR are described below. |
|
510 .RE |
|
511 |
|
512 .sp |
|
513 .ne 2 |
|
514 .mk |
|
515 .na |
|
516 \fB\fB-p\fR \fIprotocol\fR\fR |
|
517 .ad |
|
518 .sp .6 |
|
519 .RS 4n |
|
520 Sets the sending protocol. The \fIprotocol\fR field can be in form \fIprotocol\fR\fB:\fR\fIhost\fR to set both the sending protocol and the sending host. For example: \fB-pUUCP:uunet\fR sets the sending \fIprotocol\fR to \fBUUCP\fR and the sending host to \fBuunet\fR. Some existing programs use \fB-oM\fR to set the \fIr\fR and \fIs\fR macros; this is equivalent to using \fB-p\fR. |
|
521 .RE |
|
522 |
|
523 .sp |
|
524 .ne 2 |
|
525 .mk |
|
526 .na |
|
527 \fB\fB-q\fR[\fItime\fR]\fR |
|
528 .ad |
|
529 .sp .6 |
|
530 .RS 4n |
|
531 Processes saved messages in the queue at given intervals. If \fItime\fR is omitted, processes the queue once. \fItime\fR is given as a tagged number, where \fIs\fR is seconds, \fIm\fR is minutes, \fIh\fR is hours, \fId\fR is days, and \fIw\fR is weeks. For example, \fB-q1h30m\fR or \fB-q90m\fR would both set the timeout to one hour thirty minutes. |
|
532 .sp |
|
533 By default, sendmail runs in the background. This option can be used safely with \fB-bd\fR. |
|
534 .RE |
|
535 |
|
536 .sp |
|
537 .ne 2 |
|
538 .mk |
|
539 .na |
|
540 \fB\fB-qp[\fR\fItime\fR\fB-]\fR\fR |
|
541 .ad |
|
542 .sp .6 |
|
543 .RS 4n |
|
544 Similar to \fB-q\fR[\fItime\fR], except that instead of periodically forking a child to process the queue, \fBsendmail\fR forks a single persistent child for each queue that alternates between processing the queue and sleeping. The sleep time (\fItime\fR) is specified as the argument; it defaults to \fB1\fR second. The process always sleeps at least \fB5\fR seconds if the queue was empty in the previous queue run. |
|
545 .RE |
|
546 |
|
547 .sp |
|
548 .ne 2 |
|
549 .mk |
|
550 .na |
|
551 \fB\fB-qf\fR\fR |
|
552 .ad |
|
553 .sp .6 |
|
554 .RS 4n |
|
555 Processes saved messages in the queue once and does not \fBfork\fR(2), but runs in the foreground. |
|
556 .RE |
|
557 |
|
558 .sp |
|
559 .ne 2 |
|
560 .mk |
|
561 .na |
|
562 \fB\fB-qG\fR \fIname\fR\fR |
|
563 .ad |
|
564 .sp .6 |
|
565 .RS 4n |
|
566 Processes jobs in queue group called \fIname\fR only. |
|
567 .RE |
|
568 |
|
569 .sp |
|
570 .ne 2 |
|
571 .mk |
|
572 .na |
|
573 \fB\fB-q[!]I\fR \fIsubstr\fR\fR |
|
574 .ad |
|
575 .sp .6 |
|
576 .RS 4n |
|
577 Limits processed jobs to those containing \fIsubstr\fR as a substring of the queue \fBID\fR or not when \fB!\fR is specified. |
|
578 .RE |
|
579 |
|
580 .sp |
|
581 .ne 2 |
|
582 .mk |
|
583 .na |
|
584 \fB\fB-q[!]Q\fR \fIsubstr\fR\fR |
|
585 .ad |
|
586 .sp .6 |
|
587 .RS 4n |
|
588 Limits processed jobs to those quarantined jobs containing \fIsubstr\fR as a substring of the quarantine \fIreason\fR or not when \fB!\fR is specified. |
|
589 .RE |
|
590 |
|
591 .sp |
|
592 .ne 2 |
|
593 .mk |
|
594 .na |
|
595 \fB\fB-q[!]R\fR \fIsubstr\fR\fR |
|
596 .ad |
|
597 .sp .6 |
|
598 .RS 4n |
|
599 Limits processed jobs to those containing \fIsubstr\fR as a substring of one of the recipients or not when \fB!\fR is specified. |
|
600 .RE |
|
601 |
|
602 .sp |
|
603 .ne 2 |
|
604 .mk |
|
605 .na |
|
606 \fB\fB-q[!]S\fR \fIsubstr\fR\fR |
|
607 .ad |
|
608 .sp .6 |
|
609 .RS 4n |
|
610 Limits processed jobs to those containing \fIsubstr\fR as a substring of the sender or not when \fB!\fR is specified. |
|
611 .RE |
|
612 |
|
613 .sp |
|
614 .ne 2 |
|
615 .mk |
|
616 .na |
|
617 \fB\fB-Q\fR[\fIreason\fR]\fR |
|
618 .ad |
|
619 .sp .6 |
|
620 .RS 4n |
|
621 Quarantines a normal queue item with the given reason or unquarantines a quarantined queue item if no reason is given. This should only be used with some sort of item matching as described above. |
|
622 .RE |
|
623 |
|
624 .sp |
|
625 .ne 2 |
|
626 .mk |
|
627 .na |
|
628 \fB\fB-r\fR \fIname\fR\fR |
|
629 .ad |
|
630 .sp .6 |
|
631 .RS 4n |
|
632 An alternate and obsolete form of the \fB-f\fR flag. |
|
633 .RE |
|
634 |
|
635 .sp |
|
636 .ne 2 |
|
637 .mk |
|
638 .na |
|
639 \fB\fB-R\fR \fIret\fR\fR |
|
640 .ad |
|
641 .sp .6 |
|
642 .RS 4n |
|
643 Identifies the information you want returned if the message bounces. \fIret\fR can be \fBHDRS\fR for headers only or \fBFULL\fR for headers plus body. |
|
644 .RE |
|
645 |
|
646 .sp |
|
647 .ne 2 |
|
648 .mk |
|
649 .na |
|
650 \fB\fB-t\fR\fR |
|
651 .ad |
|
652 .sp .6 |
|
653 .RS 4n |
|
654 Reads message for recipients. \fBTo:\fR,\fBCc:\fR, and \fBBcc:\fR lines are scanned for people to send to. The \fBBcc:\fR line is deleted before transmission. Any addresses in the argument list is suppressed. The \fBNoRecipientAction\fR Processing Option can be used to change the behavior when no legal recipients are included in the message. |
|
655 .RE |
|
656 |
|
657 .sp |
|
658 .ne 2 |
|
659 .mk |
|
660 .na |
|
661 \fB\fB-v\fR\fR |
|
662 .ad |
|
663 .sp .6 |
|
664 .RS 4n |
|
665 Goes into verbose mode. Alias expansions are announced, and so forth. |
|
666 .RE |
|
667 |
|
668 .sp |
|
669 .ne 2 |
|
670 .mk |
|
671 .na |
|
672 \fB\fB-V\fR \fIenvid\fR\fR |
|
673 .ad |
|
674 .sp .6 |
|
675 .RS 4n |
|
676 The indicated \fIenvid\fR is passed with the envelope of the message and returned if the message bounces. |
|
677 .RE |
|
678 |
|
679 .sp |
|
680 .ne 2 |
|
681 .mk |
|
682 .na |
|
683 \fB\fB-X\fR \fIlogfile\fR\fR |
|
684 .ad |
|
685 .sp .6 |
|
686 .RS 4n |
|
687 Logs all traffic in and out of \fBsendmail\fR in the indicated \fIlogfile\fR for debugging mailer problems. This produces a lot of data very quickly and should be used sparingly. |
|
688 .RE |
|
689 |
|
690 .SS "Processing Options" |
|
691 .sp |
|
692 .LP |
|
693 There are a number of "random" options that can be set from a configuration file. Options are represented by a single character or by multiple character names. The syntax for the single character names of is: |
|
694 .sp |
|
695 .in +2 |
|
696 .nf |
|
697 \fBO\fR\fIxvalue\fR |
|
698 .fi |
|
699 .in -2 |
|
700 .sp |
|
701 |
|
702 .sp |
|
703 .LP |
|
704 This sets option \fIx\fR to be \fIvalue\fR. Depending on the option, \fIvalue\fR may be a string, an integer, a boolean (with legal values \fBt\fR, \fBT\fR, \fBf\fR, or \fBF\fR; the default is \fBTRUE\fR), or a time interval. |
|
705 .sp |
|
706 .LP |
|
707 The multiple character or long names use this syntax: |
|
708 .sp |
|
709 .in +2 |
|
710 .nf |
|
711 \fBO\fR \fILongname=argument\fR |
|
712 .fi |
|
713 .in -2 |
|
714 .sp |
|
715 |
|
716 .sp |
|
717 .LP |
|
718 This sets the option \fILongname\fR to be \fIargument\fR. The long names are beneficial because they are easier to interpret than the single character names. |
|
719 .sp |
|
720 .LP |
|
721 Not all processing options have single character names associated with them. In the list below, the multiple character name is presented first followed by the single character syntax enclosed in parentheses. |
|
722 .sp |
|
723 .ne 2 |
|
724 .mk |
|
725 .na |
|
726 \fB\fBAliasFile (A\fR\fIfile\fR\fB)\fR\fR |
|
727 .ad |
|
728 .sp .6 |
|
729 .RS 4n |
|
730 Specifies possible alias files. |
|
731 .RE |
|
732 |
|
733 .sp |
|
734 .ne 2 |
|
735 .mk |
|
736 .na |
|
737 \fB\fBAliasWait (a\fR \fIN\fR\fB)\fR\fR |
|
738 .ad |
|
739 .sp .6 |
|
740 .RS 4n |
|
741 If set, waits up to \fIN\fR minutes for an "@:@" entry to exist in the \fBaliases\fR(4) database before starting up. If it does not appear in \fIN\fR minutes, issues a warning. Defaults to 10 minutes. |
|
742 .RE |
|
743 |
|
744 .sp |
|
745 .ne 2 |
|
746 .mk |
|
747 .na |
|
748 \fB\fBAllowBogusHELO\fR\fR |
|
749 .ad |
|
750 .sp .6 |
|
751 .RS 4n |
|
752 Allows a \fBHELO SMTP\fR command that does not include a host name. By default this option is disabled. |
|
753 .RE |
|
754 |
|
755 .sp |
|
756 .ne 2 |
|
757 .mk |
|
758 .na |
|
759 \fB\fBBadRcptThrottle=\fR\fIN\fR\fR |
|
760 .ad |
|
761 .sp .6 |
|
762 .RS 4n |
|
763 If set and more than the specified number of recipients in a single \fBSMTP\fR envelope are rejected, sleeps for one second after each rejected RCPT command. |
|
764 .RE |
|
765 |
|
766 .sp |
|
767 .ne 2 |
|
768 .mk |
|
769 .na |
|
770 \fB\fBBlankSub (B\fR\fIc\fR\fB)\fR\fR |
|
771 .ad |
|
772 .sp .6 |
|
773 .RS 4n |
|
774 Sets the blank substitution character to \fIc\fR. Unquoted spaces in addresses are replaced by this character. Defaults to SPACE (that is, no change is made). |
|
775 .RE |
|
776 |
|
777 .sp |
|
778 .ne 2 |
|
779 .mk |
|
780 .na |
|
781 \fB\fBCACertFile\fR\fR |
|
782 .ad |
|
783 .sp .6 |
|
784 .RS 4n |
|
785 File containing one CA cert. |
|
786 .RE |
|
787 |
|
788 .sp |
|
789 .ne 2 |
|
790 .mk |
|
791 .na |
|
792 \fB\fBCACertPath\fR\fR |
|
793 .ad |
|
794 .sp .6 |
|
795 .RS 4n |
|
796 Path to directory with certs of CAs. |
|
797 .RE |
|
798 |
|
799 .sp |
|
800 .ne 2 |
|
801 .mk |
|
802 .na |
|
803 \fB\fBCheckAliases (n)\fR\fR |
|
804 .ad |
|
805 .sp .6 |
|
806 .RS 4n |
|
807 Validates the RHS of aliases when rebuilding the \fBaliases\fR(4) database. |
|
808 .RE |
|
809 |
|
810 .sp |
|
811 .ne 2 |
|
812 .mk |
|
813 .na |
|
814 \fB\fBCheckpointInterval (C\fR\fIN\fR\fB)\fR\fR |
|
815 .ad |
|
816 .sp .6 |
|
817 .RS 4n |
|
818 Checkpoints the queue every \fIN\fR (default \fB10\fR) addresses sent. If your system crashes during delivery to a large list, this prevents retransmission to any but the last \fIN\fR recipients. |
|
819 .RE |
|
820 |
|
821 .sp |
|
822 .ne 2 |
|
823 .mk |
|
824 .na |
|
825 \fB\fBClassFactor (z\fR\fIfact\fR\fB)\fR\fR |
|
826 .ad |
|
827 .sp .6 |
|
828 .RS 4n |
|
829 The indicated factor \fIfact\fR is multiplied by the message class (determined by the \fBPrecedence:\fR field in the user header and the \fBP\fR lines in the configuration file) and subtracted from the priority. Thus, messages with a higher \fBPriority:\fR are favored. Defaults to \fB1800\fR. |
|
830 .RE |
|
831 |
|
832 .sp |
|
833 .ne 2 |
|
834 .mk |
|
835 .na |
|
836 \fB\fBClientCertFile\fR\fR |
|
837 .ad |
|
838 .sp .6 |
|
839 .RS 4n |
|
840 File containing the cert of the client, that is, this cert is used when \fBsendmail\fR acts as client. |
|
841 .RE |
|
842 |
|
843 .sp |
|
844 .ne 2 |
|
845 .mk |
|
846 .na |
|
847 \fB\fBClientKeyFile\fR\fR |
|
848 .ad |
|
849 .sp .6 |
|
850 .RS 4n |
|
851 File containing the private key belonging to the client cert. |
|
852 .RE |
|
853 |
|
854 .sp |
|
855 .ne 2 |
|
856 .mk |
|
857 .na |
|
858 \fB\fBClientPortOptions\fR\fR |
|
859 .ad |
|
860 .sp .6 |
|
861 .RS 4n |
|
862 Sets client \fBSMTP\fR options. The options are key=value pairs. Known keys are: |
|
863 .sp |
|
864 .ne 2 |
|
865 .mk |
|
866 .na |
|
867 \fB\fBAddr\fR \fIAddress Mask\fR\fR |
|
868 .ad |
|
869 .sp .6 |
|
870 .RS 4n |
|
871 \fIAddress Mask\fR defaults to \fBINADDR_ANY\fR. The address mask can be a numeric address in dot notation or a network name. |
|
872 .RE |
|
873 |
|
874 .sp |
|
875 .ne 2 |
|
876 .mk |
|
877 .na |
|
878 \fB\fBFamily\fR\fR |
|
879 .ad |
|
880 .sp .6 |
|
881 .RS 4n |
|
882 Address family (defaults to INET). |
|
883 .RE |
|
884 |
|
885 .sp |
|
886 .ne 2 |
|
887 .mk |
|
888 .na |
|
889 \fB\fBListen\fR\fR |
|
890 .ad |
|
891 .sp .6 |
|
892 .RS 4n |
|
893 Size of listen queue (defaults to 10). |
|
894 .RE |
|
895 |
|
896 .sp |
|
897 .ne 2 |
|
898 .mk |
|
899 .na |
|
900 \fB\fBPort\fR\fR |
|
901 .ad |
|
902 .sp .6 |
|
903 .RS 4n |
|
904 Name/number of listening port (defaults to \fBsmtp\fR). |
|
905 .RE |
|
906 |
|
907 .sp |
|
908 .ne 2 |
|
909 .mk |
|
910 .na |
|
911 \fB\fBRcvBufSize\fR\fR |
|
912 .ad |
|
913 .sp .6 |
|
914 .RS 4n |
|
915 The size of the TCP/IP receive buffer. |
|
916 .RE |
|
917 |
|
918 .sp |
|
919 .ne 2 |
|
920 .mk |
|
921 .na |
|
922 \fB\fBSndBufSize\fR\fR |
|
923 .ad |
|
924 .sp .6 |
|
925 .RS 4n |
|
926 The size of the TCP/IP send buffer. |
|
927 .RE |
|
928 |
|
929 .sp |
|
930 .ne 2 |
|
931 .mk |
|
932 .na |
|
933 \fB\fBModifier\fR\fR |
|
934 .ad |
|
935 .sp .6 |
|
936 .RS 4n |
|
937 Options (flags) for the daemon. Can be: |
|
938 .sp |
|
939 .ne 2 |
|
940 .mk |
|
941 .na |
|
942 \fB\fBh\fR\fR |
|
943 .ad |
|
944 .sp .6 |
|
945 .RS 4n |
|
946 Uses name of interface for \fBHELO\fR command. |
|
947 .RE |
|
948 |
|
949 If \fBh\fR is set, the name corresponding to the outgoing interface address (whether chosen by means of the \fBConnection\fR parameter or the default) is used for the \fBHELO\fR/\fBEHLO\fR command. |
|
950 .RE |
|
951 |
|
952 .RE |
|
953 |
|
954 .sp |
|
955 .ne 2 |
|
956 .mk |
|
957 .na |
|
958 \fB\fBColonOkInAddr\fR\fR |
|
959 .ad |
|
960 .sp .6 |
|
961 .RS 4n |
|
962 If set, colons are treated as a regular character in addresses. If not set, they are treated as the introducer to the RFC 822 "group" syntax. This option is on for version 5 and lower configuration files. |
|
963 .RE |
|
964 |
|
965 .sp |
|
966 .ne 2 |
|
967 .mk |
|
968 .na |
|
969 \fB\fBConnectionCacheSize (k\fR\fIN\fR\fB)\fR\fR |
|
970 .ad |
|
971 .sp .6 |
|
972 .RS 4n |
|
973 The maximum number of open connections that are to be cached at a time. The default is \fB1\fR. This delays closing the current connection until either this invocation of \fBsendmail\fR needs to connect to another host or it terminates. Setting it to \fB0\fR defaults to the old behavior, that is, connections are closed immediately. |
|
974 .RE |
|
975 |
|
976 .sp |
|
977 .ne 2 |
|
978 .mk |
|
979 .na |
|
980 \fB\fBConnectionCacheTimeout (K\fR\fItimeout\fR\fB)\fR\fR |
|
981 .ad |
|
982 .sp .6 |
|
983 .RS 4n |
|
984 The maximum amount of time a cached connection is permitted to idle without activity. If this time is exceeded, the connection is immediately closed. This value should be small (on the order of ten minutes). Before \fBsendmail\fR uses a cached connection, it always sends a \fBNOOP\fR (no operation) command to check the connection. If the \fBNOOP\fR command fails, it reopens the connection. This keeps your end from failing if the other end times out. The point of this option is to be a good network neighbor and avoid using up excessive resources on the other end. The default is five minutes. |
|
985 .RE |
|
986 |
|
987 .sp |
|
988 .ne 2 |
|
989 .mk |
|
990 .na |
|
991 \fB\fBConnectionRateThrottle\fR\fR |
|
992 .ad |
|
993 .sp .6 |
|
994 .RS 4n |
|
995 The maximum number of connections permitted per second. After this many connections are accepted, further connections are delayed. If not set or <= 0, there is no limit. |
|
996 .RE |
|
997 |
|
998 .sp |
|
999 .ne 2 |
|
1000 .mk |
|
1001 .na |
|
1002 \fB\fBConnectionRateWindowSize\fR\fR |
|
1003 .ad |
|
1004 .sp .6 |
|
1005 .RS 4n |
|
1006 Define the length of the interval for which the number of incoming connections is maintained. The default is 60 seconds. |
|
1007 .RE |
|
1008 |
|
1009 .sp |
|
1010 .ne 2 |
|
1011 .mk |
|
1012 .na |
|
1013 \fB\fBControlSocketName\fR\fR |
|
1014 .ad |
|
1015 .sp .6 |
|
1016 .RS 4n |
|
1017 Name of the control socket for daemon management. A running \fBsendmail\fR daemon can be controlled through this Unix domain socket. Available commands are: \fBhelp\fR, \fBrestart\fR, \fBshutdown\fR, and \fBstatus\fR. The \fBstatus\fR command returns the current number of daemon children, the free disk space (in blocks) of the queue directory, and the load average of the machine expressed as an integer. If not set, no control socket is available. For the sake of security, this Unix domain socket must be in a directory which is accessible only by root; \fB/var/spool/mqueue/.smcontrol\fR is recommended for the socket name. |
|
1018 .RE |
|
1019 |
|
1020 .sp |
|
1021 .ne 2 |
|
1022 .mk |
|
1023 .na |
|
1024 \fB\fBCRLFile\fR\fR |
|
1025 .ad |
|
1026 .sp .6 |
|
1027 .RS 4n |
|
1028 File containing certificate revocation status, useful for X.509v3 authentication. |
|
1029 .RE |
|
1030 |
|
1031 .sp |
|
1032 .ne 2 |
|
1033 .mk |
|
1034 .na |
|
1035 \fB\fBDaemonPortOptions (O\fR\fIoptions\fR\fB)\fR\fR |
|
1036 .ad |
|
1037 .sp .6 |
|
1038 .RS 4n |
|
1039 Sets server SMTP options. The options are \fIkey=value\fR pairs. Known keys are: |
|
1040 .sp |
|
1041 .ne 2 |
|
1042 .mk |
|
1043 .na |
|
1044 \fB\fBName\fR\fR |
|
1045 .ad |
|
1046 .sp .6 |
|
1047 .RS 4n |
|
1048 User-definable name for the daemon (defaults to "\fBDaemon#\fR"). Used for error messages and logging. |
|
1049 .RE |
|
1050 |
|
1051 .sp |
|
1052 .ne 2 |
|
1053 .mk |
|
1054 .na |
|
1055 \fB\fBAddr\fR\fR |
|
1056 .ad |
|
1057 .sp .6 |
|
1058 .RS 4n |
|
1059 Address mask (defaults \fBINADDR_ANY)\fR. |
|
1060 .sp |
|
1061 The address mask may be a numeric address in dot notation or a network name. |
|
1062 .RE |
|
1063 |
|
1064 .sp |
|
1065 .ne 2 |
|
1066 .mk |
|
1067 .na |
|
1068 \fB\fBFamily\fR\fR |
|
1069 .ad |
|
1070 .sp .6 |
|
1071 .RS 4n |
|
1072 Address family (defaults to \fBINET).\fR |
|
1073 .RE |
|
1074 |
|
1075 .sp |
|
1076 .ne 2 |
|
1077 .mk |
|
1078 .na |
|
1079 \fB\fBInputMailFilters\fR\fR |
|
1080 .ad |
|
1081 .sp .6 |
|
1082 .RS 4n |
|
1083 List of input mail filters for the daemon. |
|
1084 .RE |
|
1085 |
|
1086 .sp |
|
1087 .ne 2 |
|
1088 .mk |
|
1089 .na |
|
1090 \fB\fBListen\fR\fR |
|
1091 .ad |
|
1092 .sp .6 |
|
1093 .RS 4n |
|
1094 Size of listen queue (defaults to \fB10\fR). |
|
1095 .RE |
|
1096 |
|
1097 .sp |
|
1098 .ne 2 |
|
1099 .mk |
|
1100 .na |
|
1101 \fB\fBModifier\fR\fR |
|
1102 .ad |
|
1103 .sp .6 |
|
1104 .RS 4n |
|
1105 Options (flags) for the daemon; can be a sequence (without any delimiters) of: |
|
1106 .sp |
|
1107 .ne 2 |
|
1108 .mk |
|
1109 .na |
|
1110 \fB\fBa\fR\fR |
|
1111 .ad |
|
1112 .sp .6 |
|
1113 .RS 4n |
|
1114 Requires authentication. |
|
1115 .RE |
|
1116 |
|
1117 .sp |
|
1118 .ne 2 |
|
1119 .mk |
|
1120 .na |
|
1121 \fB\fBb\fR\fR |
|
1122 .ad |
|
1123 .sp .6 |
|
1124 .RS 4n |
|
1125 Binds to interface through which mail has been received. |
|
1126 .RE |
|
1127 |
|
1128 .sp |
|
1129 .ne 2 |
|
1130 .mk |
|
1131 .na |
|
1132 \fB\fBc\fR\fR |
|
1133 .ad |
|
1134 .sp .6 |
|
1135 .RS 4n |
|
1136 Performs hostname canonification (\fB\&.cf\fR). |
|
1137 .RE |
|
1138 |
|
1139 .sp |
|
1140 .ne 2 |
|
1141 .mk |
|
1142 .na |
|
1143 \fB\fBf\fR\fR |
|
1144 .ad |
|
1145 .sp .6 |
|
1146 .RS 4n |
|
1147 Requires fully qualified hostname (\fB\&.cf\fR). |
|
1148 .RE |
|
1149 |
|
1150 .sp |
|
1151 .ne 2 |
|
1152 .mk |
|
1153 .na |
|
1154 \fB\fBh\fR\fR |
|
1155 .ad |
|
1156 .sp .6 |
|
1157 .RS 4n |
|
1158 Uses name of interface for \fBHELO\fR command. |
|
1159 .RE |
|
1160 |
|
1161 .sp |
|
1162 .ne 2 |
|
1163 .mk |
|
1164 .na |
|
1165 \fB\fBu\fR\fR |
|
1166 .ad |
|
1167 .sp .6 |
|
1168 .RS 4n |
|
1169 Allows unqualified addresses (\fB\&.cf\fR). |
|
1170 .RE |
|
1171 |
|
1172 .sp |
|
1173 .ne 2 |
|
1174 .mk |
|
1175 .na |
|
1176 \fB\fBC\fR\fR |
|
1177 .ad |
|
1178 .sp .6 |
|
1179 .RS 4n |
|
1180 Does not perform hostname canonification. |
|
1181 .RE |
|
1182 |
|
1183 .sp |
|
1184 .ne 2 |
|
1185 .mk |
|
1186 .na |
|
1187 \fB\fBE\fR\fR |
|
1188 .ad |
|
1189 .sp .6 |
|
1190 .RS 4n |
|
1191 Disallows \fBETRN\fR (see \fBRFC\fR 2476). |
|
1192 .RE |
|
1193 |
|
1194 .RE |
|
1195 |
|
1196 .sp |
|
1197 .ne 2 |
|
1198 .mk |
|
1199 .na |
|
1200 \fB\fBName\fR\fR |
|
1201 .ad |
|
1202 .sp .6 |
|
1203 .RS 4n |
|
1204 User-definable name for the daemon (defaults to \fBDaemon#\fR). Used for error messages and logging. |
|
1205 .RE |
|
1206 |
|
1207 .sp |
|
1208 .ne 2 |
|
1209 .mk |
|
1210 .na |
|
1211 \fB\fBPort\fR\fR |
|
1212 .ad |
|
1213 .sp .6 |
|
1214 .RS 4n |
|
1215 Name/number of listening port (defaults to \fBsmtp\fR). |
|
1216 .RE |
|
1217 |
|
1218 .sp |
|
1219 .ne 2 |
|
1220 .mk |
|
1221 .na |
|
1222 \fB\fBReceiveSize\fR\fR |
|
1223 .ad |
|
1224 .sp .6 |
|
1225 .RS 4n |
|
1226 The size of the TCP/IP receive buffer. |
|
1227 .RE |
|
1228 |
|
1229 .sp |
|
1230 .ne 2 |
|
1231 .mk |
|
1232 .na |
|
1233 \fB\fBSendSize\fR\fR |
|
1234 .ad |
|
1235 .sp .6 |
|
1236 .RS 4n |
|
1237 The size of the TCP/IP send buffer. |
|
1238 .RE |
|
1239 |
|
1240 .sp |
|
1241 .ne 2 |
|
1242 .mk |
|
1243 .na |
|
1244 \fB\fBchildren\fR\fR |
|
1245 .ad |
|
1246 .sp .6 |
|
1247 .RS 4n |
|
1248 Maximum number of children per daemon. See \fBMaxDaemonChildren\fR. |
|
1249 .RE |
|
1250 |
|
1251 .sp |
|
1252 .ne 2 |
|
1253 .mk |
|
1254 .na |
|
1255 \fB\fBDeliveryMode\fR\fR |
|
1256 .ad |
|
1257 .sp .6 |
|
1258 .RS 4n |
|
1259 Delivery mode per daemon. See \fBDeliveryMode\fR. |
|
1260 .RE |
|
1261 |
|
1262 .sp |
|
1263 .ne 2 |
|
1264 .mk |
|
1265 .na |
|
1266 \fB\fBrefuseLA\fR\fR |
|
1267 .ad |
|
1268 .sp .6 |
|
1269 .RS 4n |
|
1270 \fBRefuseLA\fR per daemon. |
|
1271 .RE |
|
1272 |
|
1273 .sp |
|
1274 .ne 2 |
|
1275 .mk |
|
1276 .na |
|
1277 \fB\fBdelayLA\fR\fR |
|
1278 .ad |
|
1279 .sp .6 |
|
1280 .RS 4n |
|
1281 \fBDelayLA\fR per daemon. |
|
1282 .RE |
|
1283 |
|
1284 .sp |
|
1285 .ne 2 |
|
1286 .mk |
|
1287 .na |
|
1288 \fB\fBqueueLA\fR\fR |
|
1289 .ad |
|
1290 .sp .6 |
|
1291 .RS 4n |
|
1292 \fBQueueLA\fR per daemon. |
|
1293 .RE |
|
1294 |
|
1295 \fBsendmail\fR listens on a new socket for each occurrence of the \fBDaemonPortOptions\fR option in a configuration file. |
|
1296 .RE |
|
1297 |
|
1298 .sp |
|
1299 .ne 2 |
|
1300 .mk |
|
1301 .na |
|
1302 \fB\fBDataFileBufferSize\fR\fR |
|
1303 .ad |
|
1304 .sp .6 |
|
1305 .RS 4n |
|
1306 Sets the threshold, in bytes, before a memory-bases queue data file becomes disk-based. The default is 4096 bytes. |
|
1307 .RE |
|
1308 |
|
1309 .sp |
|
1310 .ne 2 |
|
1311 .mk |
|
1312 .na |
|
1313 \fB\fBDeadLetterDrop\fR\fR |
|
1314 .ad |
|
1315 .sp .6 |
|
1316 .RS 4n |
|
1317 Defines the location of the system-wide dead.letter file, formerly hard-coded to \fB/var/tmp/dead.letter\fR. If this option is not set (the default), \fBsendmail\fR does not attempt to save to a system-wide \fBdead.letter\fR file in the event it cannot bounce the mail to the user or postmaster. Instead, it renames the \fBqf\fR file as it has in the past when the \fBdead.letter\fR file could not be opened. |
|
1318 .RE |
|
1319 |
|
1320 .sp |
|
1321 .ne 2 |
|
1322 .mk |
|
1323 .na |
|
1324 \fB\fBDefaultCharSet\fR\fR |
|
1325 .ad |
|
1326 .sp .6 |
|
1327 .RS 4n |
|
1328 Sets the default character set to use when converting unlabeled 8 bit input to MIME. |
|
1329 .RE |
|
1330 |
|
1331 .sp |
|
1332 .ne 2 |
|
1333 .mk |
|
1334 .na |
|
1335 \fB\fBDefaultUser (g\fR\fIgid\fR\fB) or (u\fR\fIuid\fR\fB)\fR\fR |
|
1336 .ad |
|
1337 .sp .6 |
|
1338 .RS 4n |
|
1339 Sets the default group ID for mailers to run in to \fIgid\fR or set the default userid for mailers to \fIuid\fR. Defaults to \fB1\fR. The value can also be given as a symbolic group or user name. |
|
1340 .RE |
|
1341 |
|
1342 .sp |
|
1343 .ne 2 |
|
1344 .mk |
|
1345 .na |
|
1346 \fB\fBDelayLA=\fR\fILA\fR\fR |
|
1347 .ad |
|
1348 .sp .6 |
|
1349 .RS 4n |
|
1350 When the system load average exceeds \fILA\fR, \fBsendmail\fR sleeps for one second on most SMTP commands and before accepting connections. |
|
1351 .RE |
|
1352 |
|
1353 .sp |
|
1354 .ne 2 |
|
1355 .mk |
|
1356 .na |
|
1357 \fB\fBDeliverByMin=\fR\fItime\fR\fR |
|
1358 .ad |
|
1359 .sp .6 |
|
1360 .RS 4n |
|
1361 Sets minimum time for \fBDeliver By SMTP Service Extension\fR (RFC 2852). If \fB0\fR, no time is listed, if less than \fB0\fR, the extension is not offered, if greater than \fB0\fR, it is listed as minimum time for the \fBEHLO\fR keyword \fBDELIVERBY\fR. |
|
1362 .RE |
|
1363 |
|
1364 .sp |
|
1365 .ne 2 |
|
1366 .mk |
|
1367 .na |
|
1368 \fB\fBDeliveryMode (d\fR\fIx\fR\fB)\fR\fR |
|
1369 .ad |
|
1370 .sp .6 |
|
1371 .RS 4n |
|
1372 Delivers in mode \fIx\fR. Legal modes are: |
|
1373 .sp |
|
1374 .ne 2 |
|
1375 .mk |
|
1376 .na |
|
1377 \fB\fBi\fR\fR |
|
1378 .ad |
|
1379 .sp .6 |
|
1380 .RS 4n |
|
1381 Delivers interactively (synchronously). |
|
1382 .RE |
|
1383 |
|
1384 .sp |
|
1385 .ne 2 |
|
1386 .mk |
|
1387 .na |
|
1388 \fB\fBb\fR\fR |
|
1389 .ad |
|
1390 .sp .6 |
|
1391 .RS 4n |
|
1392 Delivers in background (asynchronously). |
|
1393 .RE |
|
1394 |
|
1395 .sp |
|
1396 .ne 2 |
|
1397 .mk |
|
1398 .na |
|
1399 \fB\fBd\fR\fR |
|
1400 .ad |
|
1401 .sp .6 |
|
1402 .RS 4n |
|
1403 Deferred mode. Database lookups are deferred until the actual queue run. |
|
1404 .RE |
|
1405 |
|
1406 .sp |
|
1407 .ne 2 |
|
1408 .mk |
|
1409 .na |
|
1410 \fB\fBq\fR\fR |
|
1411 .ad |
|
1412 .sp .6 |
|
1413 .RS 4n |
|
1414 Just queues the message (delivers during queue run). |
|
1415 .RE |
|
1416 |
|
1417 Defaults to \fBb\fR if no option is specified, \fBi\fR if it is specified but given no argument (that is, \fBOd\fR is equivalent to \fBOdi\fR). |
|
1418 .RE |
|
1419 |
|
1420 .sp |
|
1421 .ne 2 |
|
1422 .mk |
|
1423 .na |
|
1424 \fB\fBDHParameters\fR\fR |
|
1425 .ad |
|
1426 .sp .6 |
|
1427 .RS 4n |
|
1428 File containing the DH parameters. |
|
1429 .RE |
|
1430 |
|
1431 .sp |
|
1432 .ne 2 |
|
1433 .mk |
|
1434 .na |
|
1435 \fB\fBDialDelay\fR\fR |
|
1436 .ad |
|
1437 .sp .6 |
|
1438 .RS 4n |
|
1439 If a connection fails, waits this many seconds and tries again. Zero means "do not retry". |
|
1440 .RE |
|
1441 |
|
1442 .sp |
|
1443 .ne 2 |
|
1444 .mk |
|
1445 .na |
|
1446 \fB\fBDontBlameSendmail\fR\fR |
|
1447 .ad |
|
1448 .sp .6 |
|
1449 .RS 4n |
|
1450 If set, overrides the file safety checks. This compromises system security and should not be used. See http://www.sendmail.org/tips/dontBlameSendmail for more information. |
|
1451 .RE |
|
1452 |
|
1453 .sp |
|
1454 .ne 2 |
|
1455 .mk |
|
1456 .na |
|
1457 \fB\fBDontExpandCnames\fR\fR |
|
1458 .ad |
|
1459 .sp .6 |
|
1460 .RS 4n |
|
1461 If set, $[ ... $] lookups that do DNS-based lookups do not expand CNAME records. |
|
1462 .RE |
|
1463 |
|
1464 .sp |
|
1465 .ne 2 |
|
1466 .mk |
|
1467 .na |
|
1468 \fB\fBDontInitGroups\fR\fR |
|
1469 .ad |
|
1470 .sp .6 |
|
1471 .RS 4n |
|
1472 If set, the \fBinitgroups\fR(3C) routine is never invoked. If you set this, agents run on behalf of users only have their primary (\fB/etc/passwd\fR) group permissions. |
|
1473 .RE |
|
1474 |
|
1475 .sp |
|
1476 .ne 2 |
|
1477 .mk |
|
1478 .na |
|
1479 \fB\fBDontProbeInterfaces\fR\fR |
|
1480 .ad |
|
1481 .sp .6 |
|
1482 .RS 4n |
|
1483 If set, \fBsendmail\fR does not insert the names and addresses of any local interfaces into the \fB$=w class\fR. If set, you must also include support for these addresses, otherwise mail to addresses in this list bounces with a configuration error. |
|
1484 .RE |
|
1485 |
|
1486 .sp |
|
1487 .ne 2 |
|
1488 .mk |
|
1489 .na |
|
1490 \fB\fBDontPruneRoutes (R)\fR\fR |
|
1491 .ad |
|
1492 .sp .6 |
|
1493 .RS 4n |
|
1494 If set, does not prune route-addr syntax addresses to the minimum possible. |
|
1495 .RE |
|
1496 |
|
1497 .sp |
|
1498 .ne 2 |
|
1499 .mk |
|
1500 .na |
|
1501 \fB\fBDoubleBounceAddress\fR\fR |
|
1502 .ad |
|
1503 .sp .6 |
|
1504 .RS 4n |
|
1505 If an error occurs when sending an error message, sends that "double bounce" error message to this address. |
|
1506 .RE |
|
1507 |
|
1508 .sp |
|
1509 .ne 2 |
|
1510 .mk |
|
1511 .na |
|
1512 \fB\fBEightBitMode (8)\fR\fR |
|
1513 .ad |
|
1514 .sp .6 |
|
1515 .RS 4n |
|
1516 Uses 8-bit data handling. This option requires one of the following keys. The key can selected by using just the first character, but using the full word is better for clarity. |
|
1517 .sp |
|
1518 .ne 2 |
|
1519 .mk |
|
1520 .na |
|
1521 \fB\fBmimify\fR\fR |
|
1522 .ad |
|
1523 .sp .6 |
|
1524 .RS 4n |
|
1525 Does any necessary conversion of \fB8BITMIME\fR to 7-bit. |
|
1526 .RE |
|
1527 |
|
1528 .sp |
|
1529 .ne 2 |
|
1530 .mk |
|
1531 .na |
|
1532 \fB\fBpass\fR\fR |
|
1533 .ad |
|
1534 .sp .6 |
|
1535 .RS 4n |
|
1536 Passes unlabeled 8-bit input through as is. |
|
1537 .RE |
|
1538 |
|
1539 .sp |
|
1540 .ne 2 |
|
1541 .mk |
|
1542 .na |
|
1543 \fB\fBstrict\fR\fR |
|
1544 .ad |
|
1545 .sp .6 |
|
1546 .RS 4n |
|
1547 Rejects unlabeled 8-bit input. |
|
1548 .RE |
|
1549 |
|
1550 .RE |
|
1551 |
|
1552 .sp |
|
1553 .ne 2 |
|
1554 .mk |
|
1555 .na |
|
1556 \fB\fBErrorHeader (E\fR\fIfile/message\fR\fB)\fR\fR |
|
1557 .ad |
|
1558 .sp .6 |
|
1559 .RS 4n |
|
1560 Appends error messages with the indicated message. If it begins with a slash, it is assumed to be the pathname of a file containing a message (this is the recommended setting). Otherwise, it is a literal message. The error file might contain the name, email address, and/or phone number of a local postmaster who could provide assistance to end users. If the option is missing or \fINULL\fR, or if it names a file which does not exist or which is not readable, no message is printed. |
|
1561 .RE |
|
1562 |
|
1563 .sp |
|
1564 .ne 2 |
|
1565 .mk |
|
1566 .na |
|
1567 \fB\fBErrorMode (e\fR\fIx\fR\fB)\fR\fR |
|
1568 .ad |
|
1569 .sp .6 |
|
1570 .RS 4n |
|
1571 Disposes of errors using mode \fIx\fR. The values for \fIx\fR are: |
|
1572 .sp |
|
1573 .ne 2 |
|
1574 .mk |
|
1575 .na |
|
1576 \fB\fBe\fR\fR |
|
1577 .ad |
|
1578 .sp .6 |
|
1579 .RS 4n |
|
1580 Mails back errors and gives \fB0\fR exit status always. |
|
1581 .RE |
|
1582 |
|
1583 .sp |
|
1584 .ne 2 |
|
1585 .mk |
|
1586 .na |
|
1587 \fB\fBm\fR\fR |
|
1588 .ad |
|
1589 .sp .6 |
|
1590 .RS 4n |
|
1591 Mails back errors. |
|
1592 .RE |
|
1593 |
|
1594 .sp |
|
1595 .ne 2 |
|
1596 .mk |
|
1597 .na |
|
1598 \fB\fBp\fR\fR |
|
1599 .ad |
|
1600 .sp .6 |
|
1601 .RS 4n |
|
1602 Prints error messages (default). |
|
1603 .RE |
|
1604 |
|
1605 .sp |
|
1606 .ne 2 |
|
1607 .mk |
|
1608 .na |
|
1609 \fB\fBq\fR\fR |
|
1610 .ad |
|
1611 .sp .6 |
|
1612 .RS 4n |
|
1613 No messages, just gives exit status. |
|
1614 .RE |
|
1615 |
|
1616 .sp |
|
1617 .ne 2 |
|
1618 .mk |
|
1619 .na |
|
1620 \fB\fBw\fR\fR |
|
1621 .ad |
|
1622 .sp .6 |
|
1623 .RS 4n |
|
1624 Writes back errors (mail if user not logged in). |
|
1625 .RE |
|
1626 |
|
1627 .RE |
|
1628 |
|
1629 .sp |
|
1630 .ne 2 |
|
1631 .mk |
|
1632 .na |
|
1633 \fB\fBFallbackMXhost (V\fR\fIfallbackhost\fR\fB)\fR\fR |
|
1634 .ad |
|
1635 .sp .6 |
|
1636 .RS 4n |
|
1637 If specified, the \fIfallbackhost\fR acts like a very low priority MX on every host. This is intended to be used by sites with poor network connectivity. |
|
1638 .RE |
|
1639 |
|
1640 .sp |
|
1641 .ne 2 |
|
1642 .mk |
|
1643 .na |
|
1644 \fB\fBFallBackSmartHost\fR\fR |
|
1645 .ad |
|
1646 .sp .6 |
|
1647 .RS 4n |
|
1648 If specified, the \fIfallBackSmartHost\fR is used in a last-ditch effort for each host. This is intended to be used by sites with "fake internal DNS". That is, a company whose DNS accurately reflects the world inside that company's domain but not outside. |
|
1649 .RE |
|
1650 |
|
1651 .sp |
|
1652 .ne 2 |
|
1653 .mk |
|
1654 .na |
|
1655 \fB\fBFastSplit\fR\fR |
|
1656 .ad |
|
1657 .sp .6 |
|
1658 .RS 4n |
|
1659 If set to a value greater than zero (the default is one), it suppresses the MX lookups on addresses when they are initially sorted, that is, for the first delivery attempt. This usually results in faster envelope splitting unless the MX records are readily available in a local DNS cache. To enforce initial sorting based on MX records set \fBFastSplit\fR to zero. If the mail is submitted directly from the command line, then the value also limits the number of processes to deliver the envelopes; if more envelopes are created they are only queued up and must be taken care of by a queue run. Since the default submission method is by way of SMTP (either from a MUA or by way of the Message Submission Program [MSP]), the value of \fBFastSplit\fR is seldom used to limit the number of processes to deliver the envelopes. |
|
1660 .RE |
|
1661 |
|
1662 .sp |
|
1663 .ne 2 |
|
1664 .mk |
|
1665 .na |
|
1666 \fB\fBForkEachJob (Y)\fR\fR |
|
1667 .ad |
|
1668 .sp .6 |
|
1669 .RS 4n |
|
1670 If set, delivers each job that is run from the queue in a separate process. Use this option if you are short of memory, since the default tends to consume considerable amounts of memory while the queue is being processed. |
|
1671 .RE |
|
1672 |
|
1673 .sp |
|
1674 .ne 2 |
|
1675 .mk |
|
1676 .na |
|
1677 \fB\fBForwardPath (J\fR\fIpath\fR\fB)\fR\fR |
|
1678 .ad |
|
1679 .sp .6 |
|
1680 .RS 4n |
|
1681 Sets the path for searching for users' \fB\&.forward\fR files. The default is \fB$z/.forward\fR. Some sites that use the automounter may prefer to change this to \fB/var/forward/$u\fR to search a file with the same name as the user in a system directory. It can also be set to a sequence of paths separated by colons; \fBsendmail\fR stops at the first file it can successfully and safely open. For example, \fB/var/forward/$u:$z/.forward\fR searches first in \fB/var/forward/\fR \fIusername\fR and then in \fB~\fR\fIusername\fR\fB/.forward\fR (but only if the first file does not exist). Refer to the NOTES section for more information. |
|
1682 .RE |
|
1683 |
|
1684 .sp |
|
1685 .ne 2 |
|
1686 .mk |
|
1687 .na |
|
1688 \fB\fBHeloName=\fIname\fR\fR\fR |
|
1689 .ad |
|
1690 .sp .6 |
|
1691 .RS 4n |
|
1692 Sets the name to be used for \fBHELO\fR/\fBEHLO\fR (instead of \fB$j\fR). |
|
1693 .RE |
|
1694 |
|
1695 .sp |
|
1696 .ne 2 |
|
1697 .mk |
|
1698 .na |
|
1699 \fB\fBHelpFile (H\fR\fIfile\fR\fB)\fR\fR |
|
1700 .ad |
|
1701 .sp .6 |
|
1702 .RS 4n |
|
1703 Specifies the help file for SMTP. |
|
1704 .RE |
|
1705 |
|
1706 .sp |
|
1707 .ne 2 |
|
1708 .mk |
|
1709 .na |
|
1710 \fB\fBHoldExpensive (c)\fR\fR |
|
1711 .ad |
|
1712 .sp .6 |
|
1713 .RS 4n |
|
1714 If an outgoing mailer is marked as being expensive, does not connect immediately. |
|
1715 .RE |
|
1716 |
|
1717 .sp |
|
1718 .ne 2 |
|
1719 .mk |
|
1720 .na |
|
1721 \fB\fBHostsFile\fR\fR |
|
1722 .ad |
|
1723 .sp .6 |
|
1724 .RS 4n |
|
1725 Sets the file to use when doing "file" type access of host names. |
|
1726 .RE |
|
1727 |
|
1728 .sp |
|
1729 .ne 2 |
|
1730 .mk |
|
1731 .na |
|
1732 \fB\fBHostStatusDirectory\fR\fR |
|
1733 .ad |
|
1734 .sp .6 |
|
1735 .RS 4n |
|
1736 If set, host status is kept on disk between \fBsendmail\fR runs in the named directory tree. If a full path is not used, then the path is interpreted relative to the queue directory. |
|
1737 .RE |
|
1738 |
|
1739 .sp |
|
1740 .ne 2 |
|
1741 .mk |
|
1742 .na |
|
1743 \fB\fBIgnoreDots (i)\fR\fR |
|
1744 .ad |
|
1745 .sp .6 |
|
1746 .RS 4n |
|
1747 Ignores dots in incoming messages. This is always disabled (that is, dots are always accepted) when reading \fBSMTP\fR mail. |
|
1748 .RE |
|
1749 |
|
1750 .sp |
|
1751 .ne 2 |
|
1752 .mk |
|
1753 .na |
|
1754 \fB\fBLogLevel (L\fR\fIn\fR\fB)\fR\fR |
|
1755 .ad |
|
1756 .sp .6 |
|
1757 .RS 4n |
|
1758 Sets the default log level to \fIn\fR. Defaults to \fB9\fR. |
|
1759 .RE |
|
1760 |
|
1761 .sp |
|
1762 .ne 2 |
|
1763 .mk |
|
1764 .na |
|
1765 \fB\fB(M\fR\fIx\|value\fR\fB)\fR\fR |
|
1766 .ad |
|
1767 .sp .6 |
|
1768 .RS 4n |
|
1769 Sets the macro \fIx\fR to \fIvalue\fR. This is intended only for use from the command line. |
|
1770 .RE |
|
1771 |
|
1772 .sp |
|
1773 .ne 2 |
|
1774 .mk |
|
1775 .na |
|
1776 \fB\fBMailboxDatabase\fR\fR |
|
1777 .ad |
|
1778 .sp .6 |
|
1779 .RS 4n |
|
1780 Type of lookup to find information about local mail boxes, defaults to \fBpw\fR which uses \fBgetpwnam\fR(3C). Other types can be introduced by adding them to the source code, see \fBlibsm/mbdb.c\fR for details. |
|
1781 .RE |
|
1782 |
|
1783 .sp |
|
1784 .ne 2 |
|
1785 .mk |
|
1786 .na |
|
1787 \fB\fBMatchGECOS (G)\fR\fR |
|
1788 .ad |
|
1789 .sp .6 |
|
1790 .RS 4n |
|
1791 Tries to match recipient names using the GECOS field. This allows for mail to be delivered using names defined in the GECOS field in \fB/etc/passwd\fR as well as the login name. |
|
1792 .RE |
|
1793 |
|
1794 .sp |
|
1795 .ne 2 |
|
1796 .mk |
|
1797 .na |
|
1798 \fB\fBMaxDaemonChildren\fR\fR |
|
1799 .ad |
|
1800 .sp .6 |
|
1801 .RS 4n |
|
1802 The maximum number of children the daemon permits. After this number, connections are rejected. If not set or <=0, there is no limit. |
|
1803 .RE |
|
1804 |
|
1805 .sp |
|
1806 .ne 2 |
|
1807 .mk |
|
1808 .na |
|
1809 \fB\fBMaxHopCount (h\fR\fIN\fR\fB)\fR\fR |
|
1810 .ad |
|
1811 .sp .6 |
|
1812 .RS 4n |
|
1813 The maximum hop count. Messages that have been processed more than \fIN\fR times are assumed to be in a loop and are rejected. Defaults to \fB25\fR. |
|
1814 .RE |
|
1815 |
|
1816 .sp |
|
1817 .ne 2 |
|
1818 .mk |
|
1819 .na |
|
1820 \fB\fBMaxMessageSize\fR\fR |
|
1821 .ad |
|
1822 .sp .6 |
|
1823 .RS 4n |
|
1824 The maximum size of messages that are accepted (in bytes). |
|
1825 .RE |
|
1826 |
|
1827 .sp |
|
1828 .ne 2 |
|
1829 .mk |
|
1830 .na |
|
1831 \fB\fBMaxMimeHeaderLength=\fR\fIM\fR\fB[/\fR\fIN\fR\fB]\fR\fR |
|
1832 .ad |
|
1833 .sp .6 |
|
1834 .RS 4n |
|
1835 Sets the maximum length of certain MIME header field values to \fIM\fR characters. For some of these headers which take parameters, the maximum length of each parameter is set to \fIN\fR if specified. If \fB/\fR\fIN\fR is not specified, one half of \fIM\fR is used. By default, these values are \fB0\fR, meaning no checks are done. |
|
1836 .RE |
|
1837 |
|
1838 .sp |
|
1839 .ne 2 |
|
1840 .mk |
|
1841 .na |
|
1842 \fB\fBMaxNOOPCommands=\fR\fIN\fR\fR |
|
1843 .ad |
|
1844 .sp .6 |
|
1845 .RS 4n |
|
1846 Overrides the default of 20 for the number of useless commands. |
|
1847 .RE |
|
1848 |
|
1849 .sp |
|
1850 .ne 2 |
|
1851 .mk |
|
1852 .na |
|
1853 \fB\fBMaxQueueChildren=\fR\fIN\fR\fR |
|
1854 .ad |
|
1855 .sp .6 |
|
1856 .RS 4n |
|
1857 When set, this limits the number of concurrent queue runner processes to \fIN\fR. This helps to control the amount of system resources used when processing the queue. When there are multiple queue groups defined and the total number of queue runners for these queue groups would exceed \fBMaxQueueChildren\fR then the queue groups are not all run concurrently. That is, some portion of the queue groups run concurrently such that \fBMaxQueueChildren\fR is not be exceeded, while the remaining queue groups are run later (in round robin order). See \fBMaxRunnersPerQueue\fR. |
|
1858 .RE |
|
1859 |
|
1860 .sp |
|
1861 .ne 2 |
|
1862 .mk |
|
1863 .na |
|
1864 \fB\fBMaxQueueRunSize\fR\fR |
|
1865 .ad |
|
1866 .sp .6 |
|
1867 .RS 4n |
|
1868 If set, limits the maximum size of any given queue run to this number of entries. This stops reading the queue directory after this number of entries is reached; job priority is not used. If not set, there is no limit. |
|
1869 .RE |
|
1870 |
|
1871 .sp |
|
1872 .ne 2 |
|
1873 .mk |
|
1874 .na |
|
1875 \fB\fBMaxRunnersPerQueue=\fR\fIN\fR\fR |
|
1876 .ad |
|
1877 .sp .6 |
|
1878 .RS 4n |
|
1879 This sets the default maximum number of queue runners for queue groups. Up to \fIN\fR queue runners work in parallel on a queue group's messages. This is useful where the processing of a message in the queue might delay the processing of subsequent messages. Such a delay can be the result of non-erroneous situations such as a low bandwidth connection. The can be overridden on a per queue group basis by setting the \fBRunners\fR option. The default is \fB1\fR when not set. |
|
1880 .RE |
|
1881 |
|
1882 .sp |
|
1883 .ne 2 |
|
1884 .mk |
|
1885 .na |
|
1886 \fB\fBMeToo (m)\fR\fR |
|
1887 .ad |
|
1888 .sp .6 |
|
1889 .RS 4n |
|
1890 Sends to me too, even if I am in an alias expansion. |
|
1891 .RE |
|
1892 |
|
1893 .sp |
|
1894 .ne 2 |
|
1895 .mk |
|
1896 .na |
|
1897 \fB\fBMaxRecipientsPerMessage\fR\fR |
|
1898 .ad |
|
1899 .sp .6 |
|
1900 .RS 4n |
|
1901 If set, allows no more than the specified number of recipients in an SMTP envelope. Further recipients receive a 452 error code and are deferred for the next delivery attempt. |
|
1902 .RE |
|
1903 |
|
1904 .sp |
|
1905 .ne 2 |
|
1906 .mk |
|
1907 .na |
|
1908 \fB\fBMinFreeBlocks (b\fR\fIN/M\fR\fB)\fR\fR |
|
1909 .ad |
|
1910 .sp .6 |
|
1911 .RS 4n |
|
1912 Insists on at least \fIN\fR blocks free on the file system that holds the queue files before accepting email by way of SMTP. If there is insufficient space, \fBsendmail\fR gives a \fB452\fR response to the \fBMAIL\fR command. This invites the sender to try again later. The optional \fIM\fR is a maximum message size advertised in the \fBESMTP\fR \fBEHLO\fR response. It is currently otherwise unused. |
|
1913 .RE |
|
1914 |
|
1915 .sp |
|
1916 .ne 2 |
|
1917 .mk |
|
1918 .na |
|
1919 \fB\fBMinQueueAge\fR\fR |
|
1920 .ad |
|
1921 .sp .6 |
|
1922 .RS 4n |
|
1923 Specifies the amount of time a job must sit in the queue between queue runs. This allows you to set the queue run interval low for better responsiveness without trying all jobs in each run. The default value is 0. |
|
1924 .RE |
|
1925 |
|
1926 .sp |
|
1927 .ne 2 |
|
1928 .mk |
|
1929 .na |
|
1930 \fB\fBMustQuoteChars\fR\fR |
|
1931 .ad |
|
1932 .sp .6 |
|
1933 .RS 4n |
|
1934 Specifies the characters to be quoted in a full name phrase. \fB&,;:\e()[]\fR are quoted automatically. |
|
1935 .RE |
|
1936 |
|
1937 .sp |
|
1938 .ne 2 |
|
1939 .mk |
|
1940 .na |
|
1941 \fB\fBNiceQueueRun\fR\fR |
|
1942 .ad |
|
1943 .sp .6 |
|
1944 .RS 4n |
|
1945 Specifies the priority of queue runners. See \fBnice\fR(1). |
|
1946 .RE |
|
1947 |
|
1948 .sp |
|
1949 .ne 2 |
|
1950 .mk |
|
1951 .na |
|
1952 \fB\fBNoRecipientAction\fR\fR |
|
1953 .ad |
|
1954 .sp .6 |
|
1955 .RS 4n |
|
1956 Sets action if there are no legal recipient files in the message. The legal values are: |
|
1957 .sp |
|
1958 .ne 2 |
|
1959 .mk |
|
1960 .na |
|
1961 \fB\fBadd-apparently-to\fR\fR |
|
1962 .ad |
|
1963 .sp .6 |
|
1964 .RS 4n |
|
1965 Adds an \fBApparently-to:\fR header with all the known recipients (which may expose blind recipients). |
|
1966 .RE |
|
1967 |
|
1968 .sp |
|
1969 .ne 2 |
|
1970 .mk |
|
1971 .na |
|
1972 \fB\fBadd-bcc\fR\fR |
|
1973 .ad |
|
1974 .sp .6 |
|
1975 .RS 4n |
|
1976 Adds an empty \fBBcc:\fR header. |
|
1977 .RE |
|
1978 |
|
1979 .sp |
|
1980 .ne 2 |
|
1981 .mk |
|
1982 .na |
|
1983 \fB\fBadd-to\fR\fR |
|
1984 .ad |
|
1985 .sp .6 |
|
1986 .RS 4n |
|
1987 Adds a \fBTo:\fR header with all the known recipients (which may expose blind recipients). |
|
1988 .RE |
|
1989 |
|
1990 .sp |
|
1991 .ne 2 |
|
1992 .mk |
|
1993 .na |
|
1994 \fB\fBadd-to-undisclosed\fR\fR |
|
1995 .ad |
|
1996 .sp .6 |
|
1997 .RS 4n |
|
1998 Adds a \fBTo: undisclosed-recipients:\fR header. |
|
1999 .RE |
|
2000 |
|
2001 .sp |
|
2002 .ne 2 |
|
2003 .mk |
|
2004 .na |
|
2005 \fB\fBnone\fR\fR |
|
2006 .ad |
|
2007 .sp .6 |
|
2008 .RS 4n |
|
2009 Does nothing, that is, leaves the message as it is. |
|
2010 .RE |
|
2011 |
|
2012 .RE |
|
2013 |
|
2014 .sp |
|
2015 .ne 2 |
|
2016 .mk |
|
2017 .na |
|
2018 \fB\fBOldStyleHeaders (o)\fR\fR |
|
2019 .ad |
|
2020 .sp .6 |
|
2021 .RS 4n |
|
2022 Assumes that the headers may be in old format, that is, spaces delimit names. This actually turns on an adaptive algorithm: if any recipient address contains a comma, parenthesis, or angle bracket, it is assumed that commas already exist. If this flag is not on, only commas delimit names. Headers are always output with commas between the names. |
|
2023 .RE |
|
2024 |
|
2025 .sp |
|
2026 .ne 2 |
|
2027 .mk |
|
2028 .na |
|
2029 \fB\fBOperatorChars or $o\fR\fR |
|
2030 .ad |
|
2031 .sp .6 |
|
2032 .RS 4n |
|
2033 Defines the list of characters that can be used to separate the components of an address into tokens. |
|
2034 .RE |
|
2035 |
|
2036 .sp |
|
2037 .ne 2 |
|
2038 .mk |
|
2039 .na |
|
2040 \fB\fBPidFile\fR\fR |
|
2041 .ad |
|
2042 .sp .6 |
|
2043 .RS 4n |
|
2044 Specifies the filename of the \fBpid\fR file. The default is \fB/var/run/sendmail.pid\fR. The filename is macro-expanded before it is opened, and unlinked when \fBsendmail\fR exits. |
|
2045 .RE |
|
2046 |
|
2047 .sp |
|
2048 .ne 2 |
|
2049 .mk |
|
2050 .na |
|
2051 \fB\fBPostmasterCopy (P\fR\fIpostmaster\fR\fB)\fR\fR |
|
2052 .ad |
|
2053 .sp .6 |
|
2054 .RS 4n |
|
2055 If set, copies of error messages are sent to the named \fIpostmaster\fR. Only the header of the failed message is sent. Since most errors are user problems, this is probably not a good idea on large sites, and arguably contains all sorts of privacy violations, but it seems to be popular with certain operating systems vendors. |
|
2056 .RE |
|
2057 |
|
2058 .sp |
|
2059 .ne 2 |
|
2060 .mk |
|
2061 .na |
|
2062 \fB\fBPrivacyOptions (p\fR\fIopt,opt,...\fR\fB)\fR\fR |
|
2063 .ad |
|
2064 .sp .6 |
|
2065 .RS 4n |
|
2066 Sets privacy options. Privacy is really a misnomer; many of these options are just a way of insisting on stricter adherence to the SMTP protocol. |
|
2067 .sp |
|
2068 The \fBgoaway\fR pseudo-flag sets all flags except \fBnoreceipts\fR, \fBrestrictmailq\fR, \fBrestrictqrun\fR, \fBrestrictexpand\fR, \fBnoetrn\fR, and \fBnobodyreturn\fR. If \fBmailq\fR is restricted, only people in the same group as the queue directory can print the queue. If queue runs are restricted, only root and the owner of the queue directory can run the queue. The \fBrestrict-expand\fR pseudo-flag instructs sendmail to drop privileges when the -bv option is given by users who are neither root nor the \fBTrustedUser\fR so users cannot read private aliases, forwards, or \fB:include:\fR files. It adds the \fBNonRootSafeAddr\fR to the "DontBlame-Sendmail" option to prevent misleading unsafe address warnings. It also overrides the \fB-v\fR (verbose) command line option to prevent information leakage. Authentication Warnings add warnings about various conditions that may indicate attempts to fool the mail system, such as using an non-standard queue directory. |
|
2069 .sp |
|
2070 The options can be selected from: |
|
2071 .sp |
|
2072 .ne 2 |
|
2073 .mk |
|
2074 .na |
|
2075 \fB\fBauthwarnings\fR\fR |
|
2076 .ad |
|
2077 .sp .6 |
|
2078 .RS 4n |
|
2079 Puts \fBX-Authentication-Warning:\fR headers in messages. |
|
2080 .RE |
|
2081 |
|
2082 .sp |
|
2083 .ne 2 |
|
2084 .mk |
|
2085 .na |
|
2086 \fB\fBgoaway\fR\fR |
|
2087 .ad |
|
2088 .sp .6 |
|
2089 .RS 4n |
|
2090 Disallows essentially all SMTP status queries. |
|
2091 .RE |
|
2092 |
|
2093 .sp |
|
2094 .ne 2 |
|
2095 .mk |
|
2096 .na |
|
2097 \fB\fBneedexpnhelo\fR\fR |
|
2098 .ad |
|
2099 .sp .6 |
|
2100 .RS 4n |
|
2101 Insists on \fBHELO\fR or \fBEHLO\fR command before \fBEXPN\fR. |
|
2102 .RE |
|
2103 |
|
2104 .sp |
|
2105 .ne 2 |
|
2106 .mk |
|
2107 .na |
|
2108 \fB\fBneedmailhelo\fR\fR |
|
2109 .ad |
|
2110 .sp .6 |
|
2111 .RS 4n |
|
2112 Insists on \fBHELO\fR or \fBEHLO\fR command before \fBMAIL\fR. |
|
2113 .RE |
|
2114 |
|
2115 .sp |
|
2116 .ne 2 |
|
2117 .mk |
|
2118 .na |
|
2119 \fB\fBneedvrfyhelo\fR\fR |
|
2120 .ad |
|
2121 .sp .6 |
|
2122 .RS 4n |
|
2123 Insists on \fBHELO\fR or \fBEHLO\fR command before \fBVRFY\fR. |
|
2124 .RE |
|
2125 |
|
2126 .sp |
|
2127 .ne 2 |
|
2128 .mk |
|
2129 .na |
|
2130 \fB\fBnoactualrecipient\fR\fR |
|
2131 .ad |
|
2132 .sp .6 |
|
2133 .RS 4n |
|
2134 Do not put an X-Actual-Recipient line in a DNS that reveals the actual account to which an address is mapped. |
|
2135 .RE |
|
2136 |
|
2137 .sp |
|
2138 .ne 2 |
|
2139 .mk |
|
2140 .na |
|
2141 \fB\fBnoetrn\fR\fR |
|
2142 .ad |
|
2143 .sp .6 |
|
2144 .RS 4n |
|
2145 Disallows \fBETRN\fR entirely. |
|
2146 .RE |
|
2147 |
|
2148 .sp |
|
2149 .ne 2 |
|
2150 .mk |
|
2151 .na |
|
2152 \fB\fBnoexpn\fR\fR |
|
2153 .ad |
|
2154 .sp .6 |
|
2155 .RS 4n |
|
2156 Disallows \fBEXPN\fR entirely. |
|
2157 .RE |
|
2158 |
|
2159 .sp |
|
2160 .ne 2 |
|
2161 .mk |
|
2162 .na |
|
2163 \fB\fBnoreceipts\fR\fR |
|
2164 .ad |
|
2165 .sp .6 |
|
2166 .RS 4n |
|
2167 Prevents return receipts. |
|
2168 .RE |
|
2169 |
|
2170 .sp |
|
2171 .ne 2 |
|
2172 .mk |
|
2173 .na |
|
2174 \fB\fBnobodyreturn\fR\fR |
|
2175 .ad |
|
2176 .sp .6 |
|
2177 .RS 4n |
|
2178 Does not return the body of a message with DSNs. |
|
2179 .RE |
|
2180 |
|
2181 .sp |
|
2182 .ne 2 |
|
2183 .mk |
|
2184 .na |
|
2185 \fB\fBnovrfy\fR\fR |
|
2186 .ad |
|
2187 .sp .6 |
|
2188 .RS 4n |
|
2189 Disallows \fBVRFY\fR entirely. |
|
2190 .RE |
|
2191 |
|
2192 .sp |
|
2193 .ne 2 |
|
2194 .mk |
|
2195 .na |
|
2196 \fB\fBpublic\fR\fR |
|
2197 .ad |
|
2198 .sp .6 |
|
2199 .RS 4n |
|
2200 Allows open access. |
|
2201 .RE |
|
2202 |
|
2203 .sp |
|
2204 .ne 2 |
|
2205 .mk |
|
2206 .na |
|
2207 \fB\fBre\fR\fB\fR\fBstrictexpand\fR\fR |
|
2208 .ad |
|
2209 .sp .6 |
|
2210 .RS 4n |
|
2211 Restricts \fB-bv\fR and \fB-v\fR command line flags. |
|
2212 .RE |
|
2213 |
|
2214 .sp |
|
2215 .ne 2 |
|
2216 .mk |
|
2217 .na |
|
2218 \fB\fBrestrictmailq\fR\fR |
|
2219 .ad |
|
2220 .sp .6 |
|
2221 .RS 4n |
|
2222 Restricts \fBmailq\fR command. |
|
2223 .RE |
|
2224 |
|
2225 .sp |
|
2226 .ne 2 |
|
2227 .mk |
|
2228 .na |
|
2229 \fB\fBrestrictqrun\fR\fR |
|
2230 .ad |
|
2231 .sp .6 |
|
2232 .RS 4n |
|
2233 Restricts \fB-q\fR command line flag. |
|
2234 .RE |
|
2235 |
|
2236 .RE |
|
2237 |
|
2238 .sp |
|
2239 .ne 2 |
|
2240 .mk |
|
2241 .na |
|
2242 \fB\fBProcessTitlePrefix \fIstring\fR\fR\fR |
|
2243 .ad |
|
2244 .sp .6 |
|
2245 .RS 4n |
|
2246 Prefixes the process title shown on "\fB/usr/bin/ps auxww\fR" listings with \fIstring\fR. The string is macro processed. |
|
2247 .RE |
|
2248 |
|
2249 .sp |
|
2250 .ne 2 |
|
2251 .mk |
|
2252 .na |
|
2253 \fB\fBQueueDirectory (Q\fR\fIdir\fR\fB)\fR\fR |
|
2254 .ad |
|
2255 .sp .6 |
|
2256 .RS 4n |
|
2257 Uses the named \fIdir\fR as the queue directory. |
|
2258 .RE |
|
2259 |
|
2260 .sp |
|
2261 .ne 2 |
|
2262 .mk |
|
2263 .na |
|
2264 \fB\fBQueueFactor (q\fR\fIfactor\fR\fB)\fR\fR |
|
2265 .ad |
|
2266 .sp .6 |
|
2267 .RS 4n |
|
2268 Uses \fIfactor\fR as the multiplier in the map function to decide when to just queue up jobs rather than run them. This value is divided by the difference between the current load average and the load average limit (\fBx\fR flag) to determine the maximum message priority to be sent. Defaults to \fB600000\fR. |
|
2269 .RE |
|
2270 |
|
2271 .sp |
|
2272 .ne 2 |
|
2273 .mk |
|
2274 .na |
|
2275 \fB\fBQueueFileMode=\fR\fImode\fR\fR |
|
2276 .ad |
|
2277 .sp .6 |
|
2278 .RS 4n |
|
2279 Defaults permissions for queue files (octal). If not set, \fBsendmail\fR uses \fB0600\fR unless its real and effective \fBuid\fR are different in which case it uses \fB0644\fR. |
|
2280 .RE |
|
2281 |
|
2282 .sp |
|
2283 .ne 2 |
|
2284 .mk |
|
2285 .na |
|
2286 \fB\fBQueueLA (x\fR\fILA\fR\fB)\fR\fR |
|
2287 .ad |
|
2288 .sp .6 |
|
2289 .RS 4n |
|
2290 When the system load average exceeds \fILA\fR, just queues messages (that is, does not try to send them). Defaults to eight times the number of processors online when \fBsendmail\fR starts. |
|
2291 .RE |
|
2292 |
|
2293 .sp |
|
2294 .ne 2 |
|
2295 .mk |
|
2296 .na |
|
2297 \fB\fBQueueSortOrder=\fR\fIalgorithm\fR\fR |
|
2298 .ad |
|
2299 .sp .6 |
|
2300 .RS 4n |
|
2301 Sets the algorithm used for sorting the queue. Only the first character of the value is used. Legal values are \fBhost\fR (to order by the name of the first host name of the first recipient), \fBfilename\fR (to order by the name of the queue file name), \fBtime\fR (to order by the submission/creation time), \fBrandom\fR (to order randomly), \fBmodification\fR (to order by the modification time of the \fBqf\fR file (older entries first)), \fBnone\fR (to not order), and \fBpriority\fR (to order by message priority). Host ordering makes better use of the connection cache, but may tend to process low priority messages that go to a single host over high priority messages that go to several hosts; it probably shouldn't be used on slow network links. Filename and modification time ordering saves the overhead of reading all of the queued items before starting the queue run. Creation (submission) time ordering is almost always a bad idea, since it allows large, bulk mail to go out before smaller, personal mail, but may have applicability on some hosts with very fast connections. Random is useful if several queue runners are started by hand which try to drain the same queue since odds are they are working on different parts of the queue at the same time. Priority ordering is the default. |
|
2302 .RE |
|
2303 |
|
2304 .sp |
|
2305 .ne 2 |
|
2306 .mk |
|
2307 .na |
|
2308 \fB\fBQueueTimeout (T\fR\fIrtime\fR\fB/\fR\fIwtime\fR\fB)\fR\fR |
|
2309 .ad |
|
2310 .sp .6 |
|
2311 .RS 4n |
|
2312 Sets the queue timeout to \fIrtime\fR. After this interval, messages that have not been successfully sent are returned to the sender. Defaults to five days (\fB5d\fR). The optional \fIwtime\fR is the time after which a warning message is sent. If it is missing or \fB0\fR, then no warning messages are sent. |
|
2313 .RE |
|
2314 |
|
2315 .sp |
|
2316 .ne 2 |
|
2317 .mk |
|
2318 .na |
|
2319 \fB\fBRandFile\fR\fR |
|
2320 .ad |
|
2321 .sp .6 |
|
2322 .RS 4n |
|
2323 File containing random data (use prefix \fBfile:\fR) or the name of the UNIX socket if EGD is used (use prefix \fBegd:\fR). Note that Solaris supports \fBrandom\fR(7D), so this does not need to be specified. |
|
2324 .RE |
|
2325 |
|
2326 .sp |
|
2327 .ne 2 |
|
2328 .mk |
|
2329 .na |
|
2330 \fB\fBRecipientFactor (y\fR\fIfact\fR\fB)\fR\fR |
|
2331 .ad |
|
2332 .sp .6 |
|
2333 .RS 4n |
|
2334 The indicated factor \fIfact\fR is added to the priority (thus \fIlowering\fR the priority of the job) for each recipient, that is, this value penalizes jobs with large numbers of recipients. Defaults to \fB30000\fR. |
|
2335 .RE |
|
2336 |
|
2337 .sp |
|
2338 .ne 2 |
|
2339 .mk |
|
2340 .na |
|
2341 \fB\fBRefuseLA (X\fR\fILA\fR\fB)\fR\fR |
|
2342 .ad |
|
2343 .sp .6 |
|
2344 .RS 4n |
|
2345 When the system load average exceeds \fILA\fR, refuses incoming \fBSMTP\fR connections. Defaults to 12 times the number of processors online when \fBsendmail\fR starts. |
|
2346 .RE |
|
2347 |
|
2348 .sp |
|
2349 .ne 2 |
|
2350 .mk |
|
2351 .na |
|
2352 \fB\fBRejectLogInterval\fR\fR |
|
2353 .ad |
|
2354 .sp .6 |
|
2355 .RS 4n |
|
2356 Log interval when refusing connections for this long (default: 3h). |
|
2357 .RE |
|
2358 |
|
2359 .sp |
|
2360 .ne 2 |
|
2361 .mk |
|
2362 .na |
|
2363 \fB\fBResolverOptions (I)\fR\fR |
|
2364 .ad |
|
2365 .sp .6 |
|
2366 .RS 4n |
|
2367 Tunes DNS lookups. |
|
2368 .RE |
|
2369 |
|
2370 .sp |
|
2371 .ne 2 |
|
2372 .mk |
|
2373 .na |
|
2374 \fB\fBRetryFactor (Z\fR\fIfact\fR\fB)\fR\fR |
|
2375 .ad |
|
2376 .sp .6 |
|
2377 .RS 4n |
|
2378 The indicated factor \fIfact\fR is added to the priority every time a job is processed. Thus, each time a job is processed, its priority is decreased by the indicated value. In most environments this should be positive, since hosts that are down are all too often down for a long time. Defaults to \fB90000\fR. |
|
2379 .RE |
|
2380 |
|
2381 .sp |
|
2382 .ne 2 |
|
2383 .mk |
|
2384 .na |
|
2385 \fB\fBRrtImpliesDsn\fR\fR |
|
2386 .ad |
|
2387 .sp .6 |
|
2388 .RS 4n |
|
2389 If this option is set, a \fBReturn-Receipt-To\fR: header causes the request of a \fBDSN\fR, which is sent to the envelope sender as required by RFC 1891, not to the address given in the header. |
|
2390 .RE |
|
2391 |
|
2392 .sp |
|
2393 .ne 2 |
|
2394 .mk |
|
2395 .na |
|
2396 \fB\fBRunAsUser\fR\fR |
|
2397 .ad |
|
2398 .sp .6 |
|
2399 .RS 4n |
|
2400 If set, becomes this user when reading and delivering mail. Intended for use of firewalls where users do not have accounts. |
|
2401 .RE |
|
2402 |
|
2403 .sp |
|
2404 .ne 2 |
|
2405 .mk |
|
2406 .na |
|
2407 \fB\fBSafeFileEnvironment\fR\fR |
|
2408 .ad |
|
2409 .sp .6 |
|
2410 .RS 4n |
|
2411 If set, \fBsendmail\fR does a \fBchroot\fR into this directory before writing files. |
|
2412 .RE |
|
2413 |
|
2414 .sp |
|
2415 .ne 2 |
|
2416 .mk |
|
2417 .na |
|
2418 \fB\fBSaveFromLine (f)\fR\fR |
|
2419 .ad |
|
2420 .sp .6 |
|
2421 .RS 4n |
|
2422 Saves Unix-style \fBFrom\fR lines at the front of headers. Normally they are assumed redundant and discarded. |
|
2423 .RE |
|
2424 |
|
2425 .sp |
|
2426 .ne 2 |
|
2427 .mk |
|
2428 .na |
|
2429 \fB\fBSendMimeErrors (j)\fR\fR |
|
2430 .ad |
|
2431 .sp .6 |
|
2432 .RS 4n |
|
2433 If set, sends error messages in MIME format (see RFC 2045 and RFC 1344 for details). If disabled, \fBsendmail\fR does not return the DSN keyword in response to an \fBEHLO\fR and does not do Delivery Status Notification processing as described in RFC 1891. |
|
2434 .RE |
|
2435 |
|
2436 .sp |
|
2437 .ne 2 |
|
2438 .mk |
|
2439 .na |
|
2440 \fB\fBServerCertFile\fR\fR |
|
2441 .ad |
|
2442 .sp .6 |
|
2443 .RS 4n |
|
2444 File containing the cert of the server, that is, this cert is used when \fBsendmail\fR acts as server. |
|
2445 .RE |
|
2446 |
|
2447 .sp |
|
2448 .ne 2 |
|
2449 .mk |
|
2450 .na |
|
2451 \fB\fBServerKeyFile\fR\fR |
|
2452 .ad |
|
2453 .sp .6 |
|
2454 .RS 4n |
|
2455 File containing the private key belonging to the server cert. |
|
2456 .RE |
|
2457 |
|
2458 .sp |
|
2459 .ne 2 |
|
2460 .mk |
|
2461 .na |
|
2462 \fB\fBServiceSwitchFile\fR\fR |
|
2463 .ad |
|
2464 .sp .6 |
|
2465 .RS 4n |
|
2466 Defines the path to the service-switch file. Since the service-switch file is defined in the Solaris operating environment this option is ignored. |
|
2467 .RE |
|
2468 |
|
2469 .sp |
|
2470 .ne 2 |
|
2471 .mk |
|
2472 .na |
|
2473 \fB\fBSevenBitInput (7)\fR\fR |
|
2474 .ad |
|
2475 .sp .6 |
|
2476 .RS 4n |
|
2477 Strips input to seven bits for compatibility with old systems. This should not be necessary. |
|
2478 .RE |
|
2479 |
|
2480 .sp |
|
2481 .ne 2 |
|
2482 .mk |
|
2483 .na |
|
2484 \fB\fBSharedMemoryKey\fR\fR |
|
2485 .ad |
|
2486 .sp .6 |
|
2487 .RS 4n |
|
2488 Specifies key to use for shared memory segment. If not set (or \fB0\fR), shared memory is not be used. If this option is set, \fBsendmail\fR can share some data between different instances. For example, the number of entries in a queue directory or the available space in a file system. This allows for more efficient program execution, since only one process needs to update the data instead of each individual process gathering the data each time it is required. |
|
2489 .RE |
|
2490 |
|
2491 .sp |
|
2492 .ne 2 |
|
2493 .mk |
|
2494 .na |
|
2495 \fB\fBSharedMemoryKeyFile=\fR\fIfile\fR\fR |
|
2496 .ad |
|
2497 .sp .6 |
|
2498 .RS 4n |
|
2499 If \fBSharedMemoryKeyFile\fR is set to \fB-1\fR, the automatically selected shared memory key will be stored in the specified file. |
|
2500 .RE |
|
2501 |
|
2502 .sp |
|
2503 .ne 2 |
|
2504 .mk |
|
2505 .na |
|
2506 \fB\fBSingleLineFromHeader\fR\fR |
|
2507 .ad |
|
2508 .sp .6 |
|
2509 .RS 4n |
|
2510 If set, \fBFrom:\fR lines that have embedded newlines are unwrapped onto one line. |
|
2511 .RE |
|
2512 |
|
2513 .sp |
|
2514 .ne 2 |
|
2515 .mk |
|
2516 .na |
|
2517 \fB\fBSingleThreadDelivery\fR\fR |
|
2518 .ad |
|
2519 .sp .6 |
|
2520 .RS 4n |
|
2521 If this option and the \fBHostStatusDirectory\fR option are both set, uses single thread deliveries to other hosts. |
|
2522 .RE |
|
2523 |
|
2524 .sp |
|
2525 .ne 2 |
|
2526 .mk |
|
2527 .na |
|
2528 \fB\fBSmtpGreetingMessage or $e\fR\fR |
|
2529 .ad |
|
2530 .sp .6 |
|
2531 .RS 4n |
|
2532 Specifies the initial SMTP greeting message. |
|
2533 .RE |
|
2534 |
|
2535 .sp |
|
2536 .ne 2 |
|
2537 .mk |
|
2538 .na |
|
2539 \fB\fBSoftBounce\fR\fR |
|
2540 .ad |
|
2541 .sp .6 |
|
2542 .RS 4n |
|
2543 If set, issue temporary errors (\fB4xy\fR) instead of permanent errors (\fB5xy\fR). This can be useful during testing of a new configuration to avoid erroneous bouncing of mail. |
|
2544 .RE |
|
2545 |
|
2546 .sp |
|
2547 .ne 2 |
|
2548 .mk |
|
2549 .na |
|
2550 \fB\fBStatusFile (S\fR\fIfile\fR\fB)\fR\fR |
|
2551 .ad |
|
2552 .sp .6 |
|
2553 .RS 4n |
|
2554 Logs statistics in the named \fIfile\fR. By default, this is \fB/etc/mail/sendmail.st\fR. As root, you must \fBtouch\fR(1) this file to enable \fBmailstats\fR(1). |
|
2555 .RE |
|
2556 |
|
2557 .sp |
|
2558 .ne 2 |
|
2559 .mk |
|
2560 .na |
|
2561 \fB\fBSuperSafe (s)\fR\fR |
|
2562 .ad |
|
2563 .sp .6 |
|
2564 .RS 4n |
|
2565 This option can be set to \fBTrue\fR, \fBFalse\fR, \fBInteractive\fR, or \fBPostMilter\fR. If set to \fBTrue\fR, \fBsendmail\fR is set to super-safe when running things, that is, always instantiate the queue file, even if you are going to attempt immediate delivery. \fBsendmail\fR always instantiates the queue file before returning control to the client under any circumstances. This should really always be set to \fBTrue\fR. The \fBInteractive\fR value has been introduced in \fB8.12\fR and can be used together with \fBDeliveryMode=i\fR. It skips some synchronization calls which are effectively doubled in the code execution path for this mode. If set to \fBPostMilter\fR, \fBsendmail\fR defers synchronizing the queue file until any milters have signaled acceptance of the message. \fBPostMilter\fR is useful only when \fBsendmail\fR is running as an SMTP server; in all other situations it acts the same as True. |
|
2566 .RE |
|
2567 |
|
2568 .sp |
|
2569 .ne 2 |
|
2570 .mk |
|
2571 .na |
|
2572 \fB\fBTempFileMode (F\fR\fImode\fR\fB)\fR\fR |
|
2573 .ad |
|
2574 .sp .6 |
|
2575 .RS 4n |
|
2576 Specifies the file mode for queue files. |
|
2577 .RE |
|
2578 |
|
2579 .sp |
|
2580 .ne 2 |
|
2581 .mk |
|
2582 .na |
|
2583 \fB\fBTimeout (r\fR\fItimeouts\fR\fB)\fR\fR |
|
2584 .ad |
|
2585 .sp .6 |
|
2586 .RS 4n |
|
2587 Timeout reads after time interval. The \fItimeouts\fR argument is a list of \fIkeyword=value\fR pairs. All but \fIcommand\fR apply to client \fBSMTP\fR. For backward compatibility, a timeout with no \fIkeyword\fR= part is set all of the longer values. The recognized timeouts and their default values, and their minimum values specified in RFC 1123 section 5.3.2 are: |
|
2588 .sp |
|
2589 .ne 2 |
|
2590 .mk |
|
2591 .na |
|
2592 \fB\fBaconnect\fR\fR |
|
2593 .ad |
|
2594 .sp .6 |
|
2595 .RS 4n |
|
2596 all connections for a single delivery attempt [0, unspecified] |
|
2597 .RE |
|
2598 |
|
2599 .sp |
|
2600 .ne 2 |
|
2601 .mk |
|
2602 .na |
|
2603 \fB\fBcommand\fR\fR |
|
2604 .ad |
|
2605 .sp .6 |
|
2606 .RS 4n |
|
2607 command read [1h, 5m] |
|
2608 .RE |
|
2609 |
|
2610 .sp |
|
2611 .ne 2 |
|
2612 .mk |
|
2613 .na |
|
2614 \fB\fBconnect\fR\fR |
|
2615 .ad |
|
2616 .sp .6 |
|
2617 .RS 4n |
|
2618 initial connect [0, unspecified] |
|
2619 .RE |
|
2620 |
|
2621 .sp |
|
2622 .ne 2 |
|
2623 .mk |
|
2624 .na |
|
2625 \fB\fBcontrol\fR\fR |
|
2626 .ad |
|
2627 .sp .6 |
|
2628 .RS 4n |
|
2629 complete control socket transaction [2m, none] |
|
2630 .RE |
|
2631 |
|
2632 .sp |
|
2633 .ne 2 |
|
2634 .mk |
|
2635 .na |
|
2636 \fB\fBdatablock\fR\fR |
|
2637 .ad |
|
2638 .sp .6 |
|
2639 .RS 4n |
|
2640 data block read [1h, 3m] |
|
2641 .RE |
|
2642 |
|
2643 .sp |
|
2644 .ne 2 |
|
2645 .mk |
|
2646 .na |
|
2647 \fB\fBdatafinal\fR\fR |
|
2648 .ad |
|
2649 .sp .6 |
|
2650 .RS 4n |
|
2651 reply to final \fB\&.\fR in data [1h, 10m] |
|
2652 .RE |
|
2653 |
|
2654 .sp |
|
2655 .ne 2 |
|
2656 .mk |
|
2657 .na |
|
2658 \fB\fBdatainit\fR\fR |
|
2659 .ad |
|
2660 .sp .6 |
|
2661 .RS 4n |
|
2662 reply to \fBDATA\fR command [5m, 2m] |
|
2663 .RE |
|
2664 |
|
2665 .sp |
|
2666 .ne 2 |
|
2667 .mk |
|
2668 .na |
|
2669 \fB\fBfileopen\fR\fR |
|
2670 .ad |
|
2671 .sp .6 |
|
2672 .RS 4n |
|
2673 file open [60sec, none] |
|
2674 .RE |
|
2675 |
|
2676 .sp |
|
2677 .ne 2 |
|
2678 .mk |
|
2679 .na |
|
2680 \fB\fBhelo\fR\fR |
|
2681 .ad |
|
2682 .sp .6 |
|
2683 .RS 4n |
|
2684 reply to \fBHELO\fR or \fBEHLO\fR command [5m, none] |
|
2685 .RE |
|
2686 |
|
2687 .sp |
|
2688 .ne 2 |
|
2689 .mk |
|
2690 .na |
|
2691 \fB\fBhoststatus\fR\fR |
|
2692 .ad |
|
2693 .sp .6 |
|
2694 .RS 4n |
|
2695 host retry [30m, unspecified] |
|
2696 .RE |
|
2697 |
|
2698 .sp |
|
2699 .ne 2 |
|
2700 .mk |
|
2701 .na |
|
2702 \fB\fBiconnect\fR\fR |
|
2703 .ad |
|
2704 .sp .6 |
|
2705 .RS 4n |
|
2706 first attempt to connect to a host [0, unspecified] |
|
2707 .RE |
|
2708 |
|
2709 .sp |
|
2710 .ne 2 |
|
2711 .mk |
|
2712 .na |
|
2713 \fB\fBident\fR\fR |
|
2714 .ad |
|
2715 .sp .6 |
|
2716 .RS 4n |
|
2717 \fBIDENT\fR protocol timeout [5s, none] |
|
2718 .RE |
|
2719 |
|
2720 .sp |
|
2721 .ne 2 |
|
2722 .mk |
|
2723 .na |
|
2724 \fB\fBinitial\fR\fR |
|
2725 .ad |
|
2726 .sp .6 |
|
2727 .RS 4n |
|
2728 wait for initial greeting message [5m, 5m] |
|
2729 .RE |
|
2730 |
|
2731 .sp |
|
2732 .ne 2 |
|
2733 .mk |
|
2734 .na |
|
2735 \fB\fBlhlo\fR\fR |
|
2736 .ad |
|
2737 .sp .6 |
|
2738 .RS 4n |
|
2739 wait for reply to an LMTP LHLO command [2m, unspecified] |
|
2740 .RE |
|
2741 |
|
2742 .sp |
|
2743 .ne 2 |
|
2744 .mk |
|
2745 .na |
|
2746 \fB\fBmail\fR\fR |
|
2747 .ad |
|
2748 .sp .6 |
|
2749 .RS 4n |
|
2750 reply to \fBMAIL\fR command [10m, 5m] |
|
2751 .RE |
|
2752 |
|
2753 .sp |
|
2754 .ne 2 |
|
2755 .mk |
|
2756 .na |
|
2757 \fB\fBmisc\fR\fR |
|
2758 .ad |
|
2759 .sp .6 |
|
2760 .RS 4n |
|
2761 reply to \fBNOOP\fR and \fBVERB\fR commands [2m, none] |
|
2762 .RE |
|
2763 |
|
2764 .sp |
|
2765 .ne 2 |
|
2766 .mk |
|
2767 .na |
|
2768 \fB\fBqueuereturn\fR\fR |
|
2769 .ad |
|
2770 .sp .6 |
|
2771 .RS 4n |
|
2772 undeliverable message returned [5d] |
|
2773 .RE |
|
2774 |
|
2775 .sp |
|
2776 .ne 2 |
|
2777 .mk |
|
2778 .na |
|
2779 \fB\fBqueuewarn\fR\fR |
|
2780 .ad |
|
2781 .sp .6 |
|
2782 .RS 4n |
|
2783 deferred warning [4h] |
|
2784 .RE |
|
2785 |
|
2786 .sp |
|
2787 .ne 2 |
|
2788 .mk |
|
2789 .na |
|
2790 \fB\fBquit\fR\fR |
|
2791 .ad |
|
2792 .sp .6 |
|
2793 .RS 4n |
|
2794 reply to \fBQUIT\fR command [2m, none] |
|
2795 .RE |
|
2796 |
|
2797 .sp |
|
2798 .ne 2 |
|
2799 .mk |
|
2800 .na |
|
2801 \fB\fBrcpt\fR\fR |
|
2802 .ad |
|
2803 .sp .6 |
|
2804 .RS 4n |
|
2805 reply to \fBRCPT\fR command [1h, 5m] |
|
2806 .RE |
|
2807 |
|
2808 .sp |
|
2809 .ne 2 |
|
2810 .mk |
|
2811 .na |
|
2812 \fB\fBresolver.retrans\fR\fR |
|
2813 .ad |
|
2814 .sp .6 |
|
2815 .RS 4n |
|
2816 Resolver's retransmission time interval (in seconds) [varies]. Sets both \fBTimeout.resolver.retrans.first\fR and \fBTimeout.resolver.retrans.normal\fR. |
|
2817 .RE |
|
2818 |
|
2819 .sp |
|
2820 .ne 2 |
|
2821 .mk |
|
2822 .na |
|
2823 \fB\fBresolver.retrans.first\fR\fR |
|
2824 .ad |
|
2825 .sp .6 |
|
2826 .RS 4n |
|
2827 Resolver's retransmission time interval (in seconds) for the first attempt to deliver a message [varies]. |
|
2828 .RE |
|
2829 |
|
2830 .sp |
|
2831 .ne 2 |
|
2832 .mk |
|
2833 .na |
|
2834 \fB\fBresolver.retrans.normal\fR\fR |
|
2835 .ad |
|
2836 .sp .6 |
|
2837 .RS 4n |
|
2838 Resolver's retransmission time interval (in seconds) for all look-ups except the first delivery attempt [varies]. |
|
2839 .RE |
|
2840 |
|
2841 .sp |
|
2842 .ne 2 |
|
2843 .mk |
|
2844 .na |
|
2845 \fB\fBresolver.retry\fR\fR |
|
2846 .ad |
|
2847 .sp .6 |
|
2848 .RS 4n |
|
2849 Number of times to retransmit a resolver query [varies]. Sets both \fBTimeout.resolver.retry.first\fR and \fBTimeout.resolver.retry.normal\fR. |
|
2850 .RE |
|
2851 |
|
2852 .sp |
|
2853 .ne 2 |
|
2854 .mk |
|
2855 .na |
|
2856 \fB\fBresolver.retry.first\fR\fR |
|
2857 .ad |
|
2858 .sp .6 |
|
2859 .RS 4n |
|
2860 Number of times to retransmit a resolver query for the first attempt to deliver a message [varies]. |
|
2861 .RE |
|
2862 |
|
2863 .sp |
|
2864 .ne 2 |
|
2865 .mk |
|
2866 .na |
|
2867 \fB\fBresolver.retry.normal\fR\fR |
|
2868 .ad |
|
2869 .sp .6 |
|
2870 .RS 4n |
|
2871 Number of times to retransmit a resolver query for all look-ups except the first delivery attempt [varies]. |
|
2872 .RE |
|
2873 |
|
2874 .sp |
|
2875 .ne 2 |
|
2876 .mk |
|
2877 .na |
|
2878 \fB\fBrset\fR\fR |
|
2879 .ad |
|
2880 .sp .6 |
|
2881 .RS 4n |
|
2882 reply to \fBRSET\fR command [5m, none] |
|
2883 .RE |
|
2884 |
|
2885 .sp |
|
2886 .ne 2 |
|
2887 .mk |
|
2888 .na |
|
2889 \fB\fBstarttls\fR\fR |
|
2890 .ad |
|
2891 .sp .6 |
|
2892 .RS 4n |
|
2893 response to an \fBSMTP STARTTLS\fR command [1h] |
|
2894 .RE |
|
2895 |
|
2896 .RE |
|
2897 |
|
2898 .sp |
|
2899 .ne 2 |
|
2900 .mk |
|
2901 .na |
|
2902 \fB\fBTimeZoneSpec (t\fR\fItzinfo\fR\fB)\fR\fR |
|
2903 .ad |
|
2904 .sp .6 |
|
2905 .RS 4n |
|
2906 Sets the local time zone info to \fItzinfo\fR, for example, "PST8PDT". Actually, if this is not set, the \fBTZ\fR environment variable is cleared (so the system default is used); if set but null, the user's \fBTZ\fR variable is used, and if set and non-null, the \fBTZ\fR variable is set to this value. |
|
2907 .RE |
|
2908 |
|
2909 .sp |
|
2910 .ne 2 |
|
2911 .mk |
|
2912 .na |
|
2913 \fB\fBTLSSrvOptions\fR\fR |
|
2914 .ad |
|
2915 .sp .6 |
|
2916 .RS 4n |
|
2917 If this option is '\fBV\fR', then no client verification is performed,that is, the server does not ask for a certificate. |
|
2918 .RE |
|
2919 |
|
2920 .sp |
|
2921 .ne 2 |
|
2922 .mk |
|
2923 .na |
|
2924 \fB\fBTrustedUser\fR\fR |
|
2925 .ad |
|
2926 .sp .6 |
|
2927 .RS 4n |
|
2928 The user parameter can be a user name (looked up in the passwd map) or a numeric user id. Trusted user for file ownership and starting the daemon. If set, generated alias databases and the control socket (if configured) are automatically owned by this user. |
|
2929 .RE |
|
2930 |
|
2931 .sp |
|
2932 .ne 2 |
|
2933 .mk |
|
2934 .na |
|
2935 \fB\fBTryNullMXList (w)\fR\fR |
|
2936 .ad |
|
2937 .sp .6 |
|
2938 .RS 4n |
|
2939 If you are the "best" (that is, lowest preference) \fBMX\fR for a given host, you should normally detect this situation and treat that condition specially, by forwarding the mail to a \fBUUCP\fR feed, treating it as local, or whatever. However, in some cases (such as Internet firewalls) you may want to try to connect directly to that host as though it had no \fBMX\fR records at all. Setting this option causes \fBsendmail\fR to try this. The downside is that errors in your configuration are likely to be diagnosed as "host unknown" or "message timed out" instead of something more meaningful. This option is deprecated. |
|
2940 .RE |
|
2941 |
|
2942 .sp |
|
2943 .ne 2 |
|
2944 .mk |
|
2945 .na |
|
2946 \fB\fBUnixFromLine or $l\fR\fR |
|
2947 .ad |
|
2948 .sp .6 |
|
2949 .RS 4n |
|
2950 The "From " line used when sending to files or programs. |
|
2951 .RE |
|
2952 |
|
2953 .sp |
|
2954 .ne 2 |
|
2955 .mk |
|
2956 .na |
|
2957 \fB\fBUnsafeGroupWrites\fR\fR |
|
2958 .ad |
|
2959 .sp .6 |
|
2960 .RS 4n |
|
2961 If set, group-writable :include: and .forward files are considered "unsafe", that is, programs and files cannot be directly referenced from such files. |
|
2962 .RE |
|
2963 |
|
2964 .sp |
|
2965 .ne 2 |
|
2966 .mk |
|
2967 .na |
|
2968 \fB\fBUseErrorsTo (l)\fR\fR |
|
2969 .ad |
|
2970 .sp .6 |
|
2971 .RS 4n |
|
2972 If there is an \fBErrors-To\fR: header, sends error messages to the addresses listed there. They normally go to the envelope sender. Use of this option causes \fBsendmail\fR to violate \fBRFC\fR 1123. This option is not recommended and deprecated. |
|
2973 .RE |
|
2974 |
|
2975 .sp |
|
2976 .ne 2 |
|
2977 .mk |
|
2978 .na |
|
2979 \fB\fBUseMSP\fR\fR |
|
2980 .ad |
|
2981 .sp .6 |
|
2982 .RS 4n |
|
2983 Uses as mail submission program, that is, allows group writable queue files if the group is the same as that of a set-group-id \fBsendmail\fR binary. |
|
2984 .RE |
|
2985 |
|
2986 .sp |
|
2987 .ne 2 |
|
2988 .mk |
|
2989 .na |
|
2990 \fB\fBUserDatabaseSpec (U)\fR\fR |
|
2991 .ad |
|
2992 .sp .6 |
|
2993 .RS 4n |
|
2994 Defines the name and location of the file containing User Database information. |
|
2995 .RE |
|
2996 |
|
2997 .sp |
|
2998 .ne 2 |
|
2999 .mk |
|
3000 .na |
|
3001 \fB\fBVerbose (v)\fR\fR |
|
3002 .ad |
|
3003 .sp .6 |
|
3004 .RS 4n |
|
3005 Runs in verbose mode. If this is set, \fBsendmail\fR adjusts the \fBHoldExpensive\fR and \fBDeliveryMode\fR options so that all mail is delivered completely in a single job so that you can see the entire delivery process. The \fBVerbose\fR option should \fBnever\fR be set in the configuration file; it is intended for command line use only. |
|
3006 .RE |
|
3007 |
|
3008 .sp |
|
3009 .ne 2 |
|
3010 .mk |
|
3011 .na |
|
3012 \fB\fBXscriptFileBufferSize\fR\fR |
|
3013 .ad |
|
3014 .sp .6 |
|
3015 .RS 4n |
|
3016 Sets the threshold, in bytes, before a memory-bases queue transcript file becomes disk-based. The default is 4096 bytes. |
|
3017 .RE |
|
3018 |
|
3019 .sp |
|
3020 .LP |
|
3021 If the first character of the user name is a vertical bar, the rest of the user name is used as the name of a program to pipe the mail to. It may be necessary to quote the name of the user to keep \fBsendmail\fR from suppressing the blanks from between arguments. |
|
3022 .sp |
|
3023 .LP |
|
3024 If invoked as \fBnewaliases\fR, \fBsendmail\fR rebuilds the alias database, so long as the \fB/etc/mail/aliases*\fR files are owned by root \fIand\fR root has exclusive write permission. If invoked as \fBmailq\fR, \fBsendmail\fR prints the contents of the mail queue. |
|
3025 .SH OPERANDS |
|
3026 .sp |
|
3027 .ne 2 |
|
3028 .mk |
|
3029 .na |
|
3030 \fB\fIaddress\fR\fR |
|
3031 .ad |
|
3032 .sp .6 |
|
3033 .RS 4n |
|
3034 address of an intended recipient of the message being sent. |
|
3035 .RE |
|
3036 |
|
3037 .SH EXIT STATUS |
|
3038 .sp |
|
3039 .LP |
|
3040 \fBsendmail\fR returns an exit status describing what it did. The codes are defined in \fB/usr/include/sysexits.h\fR. |
|
3041 .sp |
|
3042 .ne 2 |
|
3043 .mk |
|
3044 .na |
|
3045 \fB\fBEX_OK\fR\fR |
|
3046 .ad |
|
3047 .sp .6 |
|
3048 .RS 4n |
|
3049 Successful completion on all addresses. |
|
3050 .RE |
|
3051 |
|
3052 .sp |
|
3053 .ne 2 |
|
3054 .mk |
|
3055 .na |
|
3056 \fB\fBEX_NOUSER\fR\fR |
|
3057 .ad |
|
3058 .sp .6 |
|
3059 .RS 4n |
|
3060 User name not recognized. |
|
3061 .RE |
|
3062 |
|
3063 .sp |
|
3064 .ne 2 |
|
3065 .mk |
|
3066 .na |
|
3067 \fB\fBEX_UNAVAILABLE\fR\fR |
|
3068 .ad |
|
3069 .sp .6 |
|
3070 .RS 4n |
|
3071 Catchall. Necessary resources were not available. |
|
3072 .RE |
|
3073 |
|
3074 .sp |
|
3075 .ne 2 |
|
3076 .mk |
|
3077 .na |
|
3078 \fB\fBEX_SYNTAX\fR\fR |
|
3079 .ad |
|
3080 .sp .6 |
|
3081 .RS 4n |
|
3082 Syntax error in address. |
|
3083 .RE |
|
3084 |
|
3085 .sp |
|
3086 .ne 2 |
|
3087 .mk |
|
3088 .na |
|
3089 \fB\fBEX_SOFTWARE\fR\fR |
|
3090 .ad |
|
3091 .sp .6 |
|
3092 .RS 4n |
|
3093 Internal software error, including bad arguments. |
|
3094 .RE |
|
3095 |
|
3096 .sp |
|
3097 .ne 2 |
|
3098 .mk |
|
3099 .na |
|
3100 \fB\fBEX_OSERR\fR\fR |
|
3101 .ad |
|
3102 .sp .6 |
|
3103 .RS 4n |
|
3104 Temporary operating system error, such as "cannot fork". |
|
3105 .RE |
|
3106 |
|
3107 .sp |
|
3108 .ne 2 |
|
3109 .mk |
|
3110 .na |
|
3111 \fB\fBEX_NOHOST\fR\fR |
|
3112 .ad |
|
3113 .sp .6 |
|
3114 .RS 4n |
|
3115 Host name not recognized. |
|
3116 .RE |
|
3117 |
|
3118 .sp |
|
3119 .ne 2 |
|
3120 .mk |
|
3121 .na |
|
3122 \fB\fBEX_TEMPFAIL\fR\fR |
|
3123 .ad |
|
3124 .sp .6 |
|
3125 .RS 4n |
|
3126 Message could not be sent immediately, but was queued. |
|
3127 .RE |
|
3128 |
|
3129 .SH ENVIRONMENT VARIABLES |
|
3130 .sp |
|
3131 .LP |
|
3132 No environment variables are used. However, sendmail's start-up script, invoked by \fBsvcadm\fR(1M), reads \fB/etc/default/sendmail\fR. In this file, if the variable \fBETRN_HOSTS\fR is set, the start-up script parses this variable and invokes \fBetrn\fR(1M) appropriately. \fBETRN_HOSTS\fR should be of the form: |
|
3133 .sp |
|
3134 .in +2 |
|
3135 .nf |
|
3136 "s1:c1.1,c1.2 s2:c2.1 s3:c3.1,c3.2,c3.3" |
|
3137 .fi |
|
3138 .in -2 |
|
3139 .sp |
|
3140 |
|
3141 .sp |
|
3142 .LP |
|
3143 That is, white-space separated groups of \fIserver:client\fR where \fIclient\fR can be one or more comma-separated names. The \fI:client\fR part is optional. \fIserver\fR is the name of the server to prod; a mail queue run is requested for each \fIclient\fR name. This is comparable to running: |
|
3144 .sp |
|
3145 .in +2 |
|
3146 .nf |
|
3147 /usr/lib/sendmail -qR \fIclient\fR |
|
3148 .fi |
|
3149 .in -2 |
|
3150 .sp |
|
3151 |
|
3152 .sp |
|
3153 .LP |
|
3154 on the host \fIserver\fR. |
|
3155 .SH FILES |
|
3156 .sp |
|
3157 .ne 2 |
|
3158 .mk |
|
3159 .na |
|
3160 \fB\fBdead.letter\fR\fR |
|
3161 .ad |
|
3162 .sp .6 |
|
3163 .RS 4n |
|
3164 Unmailable text |
|
3165 .RE |
|
3166 |
|
3167 .sp |
|
3168 .ne 2 |
|
3169 .mk |
|
3170 .na |
|
3171 \fB\fB/etc/default/sendmail\fR\fR |
|
3172 .ad |
|
3173 .sp .6 |
|
3174 .RS 4n |
|
3175 Contains default settings. You can override some of the settings by command line options. |
|
3176 .RE |
|
3177 |
|
3178 .sp |
|
3179 .ne 2 |
|
3180 .mk |
|
3181 .na |
|
3182 \fB\fB/etc/mail/aliases\fR\fR |
|
3183 .ad |
|
3184 .sp .6 |
|
3185 .RS 4n |
|
3186 Mail aliases file (ASCII) |
|
3187 .RE |
|
3188 |
|
3189 .sp |
|
3190 .ne 2 |
|
3191 .mk |
|
3192 .na |
|
3193 \fB\fB/etc/mail/aliases.db\fR\fR |
|
3194 .ad |
|
3195 .sp .6 |
|
3196 .RS 4n |
|
3197 Database of mail aliases (binary) |
|
3198 .RE |
|
3199 |
|
3200 .sp |
|
3201 .ne 2 |
|
3202 .mk |
|
3203 .na |
|
3204 \fB\fB/etc/mail/aliases.dir\fR\fR |
|
3205 .ad |
|
3206 .sp .6 |
|
3207 .RS 4n |
|
3208 Database of mail aliases (binary) |
|
3209 .RE |
|
3210 |
|
3211 .sp |
|
3212 .ne 2 |
|
3213 .mk |
|
3214 .na |
|
3215 \fB\fB/etc/mail/aliases.pag\fR\fR |
|
3216 .ad |
|
3217 .sp .6 |
|
3218 .RS 4n |
|
3219 Database of mail aliases (binary) |
|
3220 .RE |
|
3221 |
|
3222 .sp |
|
3223 .ne 2 |
|
3224 .mk |
|
3225 .na |
|
3226 \fB\fB/etc/mail/sendmail.cf\fR\fR |
|
3227 .ad |
|
3228 .sp .6 |
|
3229 .RS 4n |
|
3230 Defines environment for \fBsendmail\fR |
|
3231 .RE |
|
3232 |
|
3233 .sp |
|
3234 .ne 2 |
|
3235 .mk |
|
3236 .na |
|
3237 \fB\fB/etc/mail/submit.cf\fR\fR |
|
3238 .ad |
|
3239 .sp .6 |
|
3240 .RS 4n |
|
3241 Defines environment for MSP |
|
3242 .RE |
|
3243 |
|
3244 .sp |
|
3245 .ne 2 |
|
3246 .mk |
|
3247 .na |
|
3248 \fB\fB/etc/mail/trusted-users\fR\fR |
|
3249 .ad |
|
3250 .sp .6 |
|
3251 .RS 4n |
|
3252 Lists users that are "trusted", that is, able to set their envelope from address using \fB-f\fR without generating a warning message. Note that this file is consulted by the default \fBsendmail.cf\fR, but not by the default \fBsubmit.cf\fR, in which the line referring to \fB/etc/mail/trusted-users\fR is commented out. See \fBsendmail\fR(4) for instructions on making changes to \fBsubmit.cf\fR and \fBsendmail.cf\fR. |
|
3253 .RE |
|
3254 |
|
3255 .sp |
|
3256 .ne 2 |
|
3257 .mk |
|
3258 .na |
|
3259 \fB\fB/var/spool/clientmqueue/*\fR\fR |
|
3260 .ad |
|
3261 .sp .6 |
|
3262 .RS 4n |
|
3263 Temporary files and queued mail |
|
3264 .RE |
|
3265 |
|
3266 .sp |
|
3267 .ne 2 |
|
3268 .mk |
|
3269 .na |
|
3270 \fB\fB/var/spool/mqueue/*\fR\fR |
|
3271 .ad |
|
3272 .sp .6 |
|
3273 .RS 4n |
|
3274 Temporary files and queued mail |
|
3275 .RE |
|
3276 |
|
3277 .sp |
|
3278 .ne 2 |
|
3279 .mk |
|
3280 .na |
|
3281 \fB\fB~/.forward\fR\fR |
|
3282 .ad |
|
3283 .sp .6 |
|
3284 .RS 4n |
|
3285 List of recipients for forwarding messages |
|
3286 .RE |
|
3287 |
|
3288 .sp |
|
3289 .ne 2 |
|
3290 .mk |
|
3291 .na |
|
3292 \fB\fB/usr/include/libmilter/README\fR\fR |
|
3293 .ad |
|
3294 .sp .6 |
|
3295 .RS 4n |
|
3296 Describes the steps needed to compile and run a filter |
|
3297 .RE |
|
3298 |
|
3299 .SH ATTRIBUTES |
|
3300 .sp |
|
3301 .LP |
|
3302 See \fBattributes\fR(5) for descriptions of the following attributes: |
|
3303 .sp |
|
3304 |
|
3305 .sp |
|
3306 .TS |
|
3307 tab() box; |
|
3308 cw(2.75i) |cw(2.75i) |
|
3309 lw(2.75i) |lw(2.75i) |
|
3310 . |
|
3311 ATTRIBUTE TYPEATTRIBUTE VALUE |
|
3312 _ |
|
3313 Availabilityservice/network/smtp/sendmail |
|
3314 .TE |
|
3315 |
|
3316 .SH SEE ALSO |
|
3317 .sp |
|
3318 .LP |
|
3319 \fBsvcs\fR(1), \fBmail\fR(1), \fBmailq\fR(1), \fBmailx\fR(1), \fBnice\fR(1), \fBcheck-hostname\fR(1M), \fBcheck-permissions\fR(1M), \fBetrn\fR(1M), \fBnewaliases\fR(1M), \fBsvcadm\fR(1M), \fBsvccfg\fR(1M), \fBfork\fR(2), \fBgetpwnam\fR(3C), \fBgetusershell\fR(3C), \fBresolver\fR(3RESOLV), \fBaliases\fR(4), \fBhosts\fR(4), \fBsendmail\fR(4), \fBshells\fR(4), \fBattributes\fR(5), \fBsmf\fR(5), \fBrandom\fR(7D ) |
|
3320 .sp |
|
3321 .LP |
|
3322 \fBtcpd\fR(1M), \fBhosts_access\fR(4) in the \fBsecurity/tcp-wrapper\fR package. |
|
3323 .sp |
|
3324 .LP |
|
3325 \fBRFC\fR 2821 \fISimple Mail Transfer Protocol\fR, John Klensin, April 2001. |
|
3326 .sp |
|
3327 .LP |
|
3328 \fBRFC\fR 2822 \fIInternet Message Format\fR, Pete Resnick, April 2001. |
|
3329 .sp |
|
3330 .LP |
|
3331 \fIsendmail, Third Edition\fR, Bryan Costales with Eric Allman\fB\fR, O'Reilly & Associates, Inc., 2003. |
|
3332 .sp |
|
3333 .LP |
|
3334 http://www.sendmail.org |
|
3335 .sp |
|
3336 .LP |
|
3337 http://www.milter.org |
|
3338 .SH NOTES |
|
3339 .sp |
|
3340 .LP |
|
3341 The \fBsendmail\fR program requires a fully qualified host name when starting. A script has been included to help verify if the host name is defined properly (see \fBcheck-hostname\fR(1M)). |
|
3342 .sp |
|
3343 .LP |
|
3344 The permissions and the ownership of several directories have been changed in order to increase security. In particular, access to \fB/etc/mail\fR and \fB/var/spool/mqueue\fR has been restricted. |
|
3345 .sp |
|
3346 .LP |
|
3347 Security restrictions have been placed users using \fB\&.forward\fR files to pipe mail to a program or redirect mail to a file. The default shell (as listed in \fB/etc/passwd\fR) of these users must be listed in \fB/etc/shells\fR. This restriction does not affect mail that is being redirected to another alias. |
|
3348 .sp |
|
3349 .LP |
|
3350 Additional restrictions have been put in place on \fB\&.forward\fR and \fB:include:\fR files. These files and the directory structure that they are placed in cannot be group- or world-writable. See \fBcheck-permissions\fR(1M). |
|
3351 .sp |
|
3352 .LP |
|
3353 If you have interfaces that map to domains that have MX records that point to non-local destinations, you might need to enable the \fBDontProbeInterfaces\fR option to enable delivery to those destinations. In its default startup behavior, \fBsendmail\fR probes each interface and adds an interface's \fBIP\fR addresses, as well as any domains that those addresses map to, to its list of domains that are considered local. For domains thus added, being on the list of local domains is equivalent to having a 0-preference MX record, with \fBlocalhost\fR as the MX value. If this is not the result you want, enable \fBDontProbeInterfaces\fR. |
|