summaryrefslogtreecommitdiff
path: root/src/sendmail.0
diff options
context:
space:
mode:
Diffstat (limited to 'src/sendmail.0')
-rw-r--r--src/sendmail.0185
1 files changed, 93 insertions, 92 deletions
diff --git a/src/sendmail.0 b/src/sendmail.0
index 8eceedd6790b..8059e0446bc5 100644
--- a/src/sendmail.0
+++ b/src/sendmail.0
@@ -1,4 +1,4 @@
-SENDMAIL(8) System Manager's Manual SENDMAIL(8)
+SENDMAIL(8) SENDMAIL(8)
@@ -43,10 +43,10 @@ DDEESSCCRRIIPPTTIIOONN
--BB_t_y_p_e Set the body type to _t_y_p_e. Current legal values are 7BIT or
8BITMIME.
- --bbaa Go into ARPANET mode. All input lines must end with a CR-LF,
- and all messages will be generated with a CR-LF at the end.
- Also, the ``From:'' and ``Sender:'' fields are examined for the
- name of the sender.
+ --bbaa Go into ARPANET mode. All input lines must end with a CRLF, and
+ all messages will be generated with a CRLF at the end. Also,
+ the ``From:'' and ``Sender:'' fields are examined for the name
+ of the sender.
--bbCC Check the configuration file.
@@ -58,7 +58,7 @@ DDEESSCCRRIIPPTTIIOONN
--bbhh Print the persistent host status database.
- --bbHH Purge expired entries from the persistent host status database.
+ --bbHH Purge expired entries from the persistent host status database.
--bbii Initialize the alias database.
@@ -66,70 +66,70 @@ DDEESSCCRRIIPPTTIIOONN
--bbpp Print a listing of the queue(s).
- --bbPP Print number of entries in the queue(s); only available with
+ --bbPP Print number of entries in the queue(s); only available with
shared memory support.
- --bbss Use the SMTP protocol as described in RFC821 on standard input
- and output. This flag implies all the operations of the --bbaa
+ --bbss Use the SMTP protocol as described in RFC821 on standard input
+ and output. This flag implies all the operations of the --bbaa
flag that are compatible with SMTP.
- --bbtt Run in address test mode. This mode reads addresses and shows
- the steps in parsing; it is used for debugging configuration ta-
- bles.
+ --bbtt Run in address test mode. This mode reads addresses and shows
+ the steps in parsing; it is used for debugging configuration
+ tables.
- --bbvv Verify names only - do not try to collect or deliver a message.
- Verify mode is normally used for validating users or mailing
+ --bbvv Verify names only - do not try to collect or deliver a message.
+ Verify mode is normally used for validating users or mailing
lists.
- --CC_f_i_l_e Use alternate configuration file. SSeennddmmaaiill gives up any en-
- hanced (set-user-ID or set-group-ID) privileges if an alternate
- configuration file is specified.
+ --CC_f_i_l_e Use alternate configuration file. SSeennddmmaaiill gives up any
+ enhanced (set-user-ID or set-group-ID) privileges if an alter-
+ nate configuration file is specified.
--DD _l_o_g_f_i_l_e
- Send debugging output to the indicated log file instead of std-
+ Send debugging output to the indicated log file instead of std-
out.
--dd_c_a_t_e_g_o_r_y.._l_e_v_e_l_._._.
- Set the debugging flag for _c_a_t_e_g_o_r_y to _l_e_v_e_l. _C_a_t_e_g_o_r_y is ei-
- ther an integer or a name specifying the topic, and _l_e_v_e_l an in-
- teger specifying the level of debugging output desired. Higher
- levels generally mean more output. More than one flag can be
- specified by separating them with commas. A list of numeric de-
- bugging categories can be found in the TRACEFLAGS file in the
- sendmail source distribution.
- The option --dd00..11 prints the version of sseennddmmaaiill and the options
+ Set the debugging flag for _c_a_t_e_g_o_r_y to _l_e_v_e_l. _C_a_t_e_g_o_r_y is
+ either an integer or a name specifying the topic, and _l_e_v_e_l an
+ integer specifying the level of debugging output desired.
+ Higher levels generally mean more output. More than one flag
+ can be specified by separating them with commas. A list of
+ numeric debugging categories can be found in the TRACEFLAGS file
+ in the sendmail source distribution.
+ The option --dd00..11 prints the version of sseennddmmaaiill and the options
it was compiled with.
- Most other categories are only useful with, and documented in,
+ Most other categories are only useful with, and documented in,
sseennddmmaaiill's source code.
--FF_f_u_l_l_n_a_m_e
Set the full name of the sender.
- --ff_n_a_m_e Sets the name of the ``from'' person (i.e., the envelope sender
+ --ff_n_a_m_e Sets the name of the ``from'' person (i.e., the envelope sender
of the mail). This address may also be used in the From: header
- if that header is missing during initial submission. The enve-
+ if that header is missing during initial submission. The enve-
lope sender address is used as the recipient for delivery status
- notifications and may also appear in a Return-Path: header. --ff
+ notifications and may also appear in a Return-Path: header. --ff
should only be used by ``trusted'' users (normally _r_o_o_t, _d_a_e_m_o_n,
- and _n_e_t_w_o_r_k) or if the person you are trying to become is the
- same as the person you are. Otherwise, an X-Authentication-
+ and _n_e_t_w_o_r_k) or if the person you are trying to become is the
+ same as the person you are. Otherwise, an X-Authentication-
Warning header will be added to the message.
- --GG Relay (gateway) submission of a message, e.g., when rrmmaaiill calls
+ --GG Relay (gateway) submission of a message, e.g., when rrmmaaiill calls
sseennddmmaaiill ..
--hh_N Set the hop count to _N. The hop count is incremented every time
- the mail is processed. When it reaches a limit, the mail is re-
- turned with an error message, the victim of an aliasing loop.
+ the mail is processed. When it reaches a limit, the mail is
+ returned with an error message, the victim of an aliasing loop.
If not specified, ``Received:'' lines in the message are
counted.
- --ii Do not strip a leading dot from lines in incoming messages, and
+ --ii Do not strip a leading dot from lines in incoming messages, and
do not treat a dot on a line by itself as the end of an incoming
- message. This should be set if you are reading data from a
+ message. This should be set if you are reading data from a
file.
- --LL _t_a_g Set the identifier used in syslog messages to the supplied _t_a_g.
+ --LL _t_a_g Set the identifier used in syslog messages to the supplied _t_a_g.
--NN _d_s_n Set delivery status notification conditions to _d_s_n, which can be
`never' for no notifications or a comma separated list of the
@@ -183,105 +183,105 @@ DDEESSCCRRIIPPTTIIOONN
--qq[_!]Q_s_u_b_s_t_r
Limit processed jobs to quarantined jobs containing _s_u_b_s_t_r as a
- substring of the quarantine reason or not when _! is specified.
+ substring of the quarantine reason or not when _! is specified.
--qq[_!]R_s_u_b_s_t_r
- Limit processed jobs to those containing _s_u_b_s_t_r as a substring
+ Limit processed jobs to those containing _s_u_b_s_t_r as a substring
of one of the recipients or not when _! is specified.
--qq[_!]S_s_u_b_s_t_r
- Limit processed jobs to those containing _s_u_b_s_t_r as a substring
+ Limit processed jobs to those containing _s_u_b_s_t_r as a substring
of the sender or not when _! is specified.
--QQ[reason]
Quarantine a normal queue items with the given reason or unquar-
- antine quarantined queue items if no reason is given. This
- should only be used with some sort of item matching using as de-
- scribed above.
+ antine quarantined queue items if no reason is given. This
+ should only be used with some sort of item matching using as
+ described above.
--RR _r_e_t_u_r_n
- Set the amount of the message to be returned if the message
- bounces. The _r_e_t_u_r_n parameter can be `full' to return the en-
- tire message or `hdrs' to return only the headers. In the lat-
- ter case also local bounces return only the headers.
+ Set the amount of the message to be returned if the message
+ bounces. The _r_e_t_u_r_n parameter can be `full' to return the
+ entire message or `hdrs' to return only the headers. In the
+ latter case also local bounces return only the headers.
--rr_n_a_m_e An alternate and obsolete form of the --ff flag.
- --tt Read message for recipients. To:, Cc:, and Bcc: lines will be
- scanned for recipient addresses. The Bcc: line will be deleted
+ --tt Read message for recipients. To:, Cc:, and Bcc: lines will be
+ scanned for recipient addresses. The Bcc: line will be deleted
before transmission.
- --UU If a mail submission via the command line requires the use of
- the SSMMTTPPUUTTFF88 argument for the MMAAIILL command, e.g., because a
- header uses UTF-8 encoding, but the addresses on the command
- line are all ASCII, then this option must be used. Only avail-
- able if EEAAII support is enabled, and the SSMMTTPPUUTTFF88 option is set.
+ --UU If a mail submission via the command line requires the use of
+ the SSMMTTPPUUTTFF88 argument for the MMAAIILL command, e.g., because a
+ header uses UTF-8 encoding, but the addresses on the command
+ line are all ASCII, then this option must be used. Only avail-
+ able if EEAAII support is enabled, and the SSMMTTPPUUTTFF88 option is set.
--VV _e_n_v_i_d
Set the original envelope id. This is propagated across SMTP to
servers that support DSNs and is returned in DSN-compliant error
messages.
- --vv Go into verbose mode. Alias expansions will be announced, etc.
+ --vv Go into verbose mode. Alias expansions will be announced, etc.
--XX _l_o_g_f_i_l_e
Log all traffic in and out of mailers in the indicated log file.
- This should only be used as a last resort for debugging mailer
+ This should only be used as a last resort for debugging mailer
bugs. It will log a lot of data very quickly.
- ---- Stop processing command flags and use the rest of the arguments
+ ---- Stop processing command flags and use the rest of the arguments
as addresses.
OOppttiioonnss
- There are also a number of processing options that may be set. Nor-
- mally these will only be used by a system administrator. Options may
- be set either on the command line using the --oo flag (for short names),
- the --OO flag (for long names), or in the configuration file. This is a
- partial list limited to those options that are likely to be useful on
- the command line and only shows the long names; for a complete list
- (and details), consult the _S_e_n_d_m_a_i_l _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n _G_u_i_d_e.
+ There are also a number of processing options that may be set. Nor-
+ mally these will only be used by a system administrator. Options may
+ be set either on the command line using the --oo flag (for short names),
+ the --OO flag (for long names), or in the configuration file. This is a
+ partial list limited to those options that are likely to be useful on
+ the command line and only shows the long names; for a complete list
+ (and details), consult the _S_e_n_d_m_a_i_l _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n _G_u_i_d_e.
The options are:
AliasFile=_f_i_l_e
Use alternate alias file.
HoldExpensive
- On mailers that are considered ``expensive'' to connect to,
+ On mailers that are considered ``expensive'' to connect to,
don't initiate immediate connection. This requires queueing.
CheckpointInterval=_N
- Checkpoint the queue file after every _N successful deliveries
- (default 10). This avoids excessive duplicate deliveries when
+ Checkpoint the queue file after every _N successful deliveries
+ (default 10). This avoids excessive duplicate deliveries when
sending to long mailing lists interrupted by system crashes.
DeliveryMode=_x
Set the delivery mode to _x. Delivery modes are `i' for interac-
- tive (synchronous) delivery, `b' for background (asynchronous)
+ tive (synchronous) delivery, `b' for background (asynchronous)
delivery, `q' for queue only - i.e., actual delivery is done the
- next time the queue is run, and `d' for deferred - the same as
- `q' except that database lookups for maps which have set the -D
+ next time the queue is run, and `d' for deferred - the same as
+ `q' except that database lookups for maps which have set the -D
option (default for the host map) are avoided.
ErrorMode=_x
- Set error processing to mode _x. Valid modes are `m' to mail
- back the error message, `w' to ``write'' back the error message
- (or mail it back if the sender is not logged in), `p' to print
- the errors on the terminal (default), `q' to throw away error
- messages (only exit status is returned), and `e' to do special
- processing for the BerkNet. If the text of the message is not
- mailed back by modes `m' or `w' and if the sender is local to
- this machine, a copy of the message is appended to the file
+ Set error processing to mode _x. Valid modes are `m' to mail
+ back the error message, `w' to ``write'' back the error message
+ (or mail it back if the sender is not logged in), `p' to print
+ the errors on the terminal (default), `q' to throw away error
+ messages (only exit status is returned), and `e' to do special
+ processing for the BerkNet. If the text of the message is not
+ mailed back by modes `m' or `w' and if the sender is local to
+ this machine, a copy of the message is appended to the file
_d_e_a_d_._l_e_t_t_e_r in the sender's home directory.
SaveFromLine
Save UNIX-style From lines at the front of messages.
MaxHopCount=_N
- The maximum number of times a message is allowed to ``hop'' be-
- fore we decide it is in a loop.
+ The maximum number of times a message is allowed to ``hop''
+ before we decide it is in a loop.
IgnoreDots
- Do not take dots on a line by themselves as a message termina-
+ Do not take dots on a line by themselves as a message termina-
tor.
SendMimeErrors
@@ -354,11 +354,11 @@ DDEESSCCRRIIPPTTIIOONN
NoRecipientAction=_a_c_t_i_o_n
Set the behaviour when there are no recipient headers (To:, Cc:
- or Bcc:) in the message to _a_c_t_i_o_n: none leaves the message un-
- changed, add-to adds a To: header with the envelope recipients,
- add-apparently-to adds an Apparently-To: header with the enve-
- lope recipients, add-bcc adds an empty Bcc: header, and add-to-
- undisclosed adds a header reading `To: undisclosed-recipi-
+ or Bcc:) in the message to _a_c_t_i_o_n: none leaves the message
+ unchanged, add-to adds a To: header with the envelope recipi-
+ ents, add-apparently-to adds an Apparently-To: header with the
+ envelope recipients, add-bcc adds an empty Bcc: header, and add-
+ to-undisclosed adds a header reading `To: undisclosed-recipi-
ents:;'.
MaxDaemonChildren=_N
@@ -420,11 +420,11 @@ DDEESSCCRRIIPPTTIIOONN
mmaaiill will act as a daemon, as if the --bbdd option were specified.
NNOOTTEESS
- sseennddmmaaiill often gets blamed for many problems that are actually the re-
- sult of other problems, such as overly permissive modes on directories.
- For this reason, sseennddmmaaiill checks the modes on system directories and
- files to determine if they can be trusted. Although these checks can
- be turned off and your system security reduced by setting the DDoonntt--
+ sseennddmmaaiill often gets blamed for many problems that are actually the
+ result of other problems, such as overly permissive modes on directo-
+ ries. For this reason, sseennddmmaaiill checks the modes on system directories
+ and files to determine if they can be trusted. Although these checks
+ can be turned off and your system security reduced by setting the DDoonntt--
BBllaammeeSSeennddmmaaiill option, the permission problems should be fixed. For
more information, see the _S_e_n_d_m_a_i_l _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n _G_u_i_d_e
@@ -433,6 +433,7 @@ FFIILLEESS
names are all specified in _/_e_t_c_/_m_a_i_l_/_s_e_n_d_m_a_i_l_._c_f. Thus, these values
are only approximations.
+
/etc/mail/aliases
raw data for alias names