Eric Allman <eric@CS.Berkeley.EDU>
- @(#)README 6.9 (Berkeley) %G%
+ @(#)README 6.23 (Berkeley) %G%
This document describes the sendmail configuration files being used
at your site masquerade behind one email name, you could also use
MASQUERADE_AS here.
+You do not have to define a domain -- in particular, if you are a
+single machine sitting off somewhere, it is probably more work than
+it's worth. This is just a mechanism for combining "domain dependent
+knowledge" into one place.
+
+---------+
| MAILERS |
+---------+
FEATURE(use_cw_file)
tells sendmail that you want to have it read an /etc/sendmail.cw
-file to get values for class $=w. Available features are:
+file to get values for class $=w. The FEATURE may contain a single
+optional parameter -- for example:
+
+ FEATURE(mailertable, dbm /usr/lib/mailertable)
+
+Available features are:
use_cw_file Read the file /etc/sendmail.cw file to get alternate
names for this host. This might be used if you were
on a host that MXed for a dynamic set of other
hosts. If the set is static, just including the line
"Cw<name1> <name2> ..." is probably superior.
+ The actual filename can be overridden by redefining
+ confCW_FILE.
redirect Reject all mail addressed to "address.REDIRECT" with
a ``551 User not local; please try <address>'' message.
If this is set, you can alias people who have left
to their new address with ".REDIRECT" appended.
nouucp Don't do anything special with UUCP addresses at all.
+nocanonify Don't pass addresses to $[ ... $] for canonification.
+ This would generally only be used by sites that only
+ act as mail gateways or which have user agents that do
+ full canonification themselves.
+notsticky By default, email sent to "user@local.host" are marked
+ as "sticky" -- that is, the local addresses aren't
+ matched against UDB and don't go through ruleset 5.
+ This features disables this treatment. It would
+ normally be used on network gateway machines.
+mailertable Include a "mailer table" which can be used to override
+ routing for particular domains. The argument of the
+ FEATURE may be the key definition. If none is specified,
+ the definition used is:
+ hash /etc/mailertable.db -o
+ Keys in this database must be of the form:
+ mailer:domain
+bitdomain Look up bitnet hosts in a table to try to turn them into
+ internet addresses. The table can be built using the
+ bitdomain program contributed by John Gardiner Meyers.
+ The argument of the FEATURE may be the key definition; if
+ none is specified, the definition used is:
+ hash /etc/bitdomain.db -o
+ Keys are the bitnet hostname; values are the corresponding
+ internet hostname.
+uucpdomain Similar feature for UUCP hosts. The default map definition
+ is:
+ hash /etc/uudomain.db -o
+ At the moment there is no automagic tool to build this
+ database.
Other FEATUREs should be defined, but I was trying to keep these
config files fairly lean and mean.
pointing at this host; this rule catches the message and forwards it on
using UUCP.
+You can also tweak rulesets 1 and 2 using LOCAL_RULE_1 and LOCAL_RULE_2.
+These rulesets are normally empty.
+
A similar macro is LOCAL_CONFIG. This introduces lines added after the
boilerplate option setting but before rulesets, and can be used to
declare local database maps or whatever. For example:
confMAILER_NAME MAILER-DAEMON Dn The sender name used for
internally generated
outgoing messages.
-confFROM_LINE From $?<$<$|$g$. $d The From_ line used when
- Dl sending to files or programs.
+confFROM_LINE From $g $d Dl The From_ line used when
+ sending to files or programs.
confFROM_HEADER $?x$x <$g>$|$g$. The format of an internally
Dq generated From: address.
confOPERATORS .:%@!^/[] Do Address operator characters.
confSTMP_LOGIN_MSG $j Sendmail $v/$Z ready at $b
De The initial (spontaneous)
SMTP greeting message.
-confEIGHT_BIT_INPUT False O8 Use 8-bit input?
+confSEVEN_BIT_INPUT False O7 Force input to seven bits?
confALIAS_WAIT 10 Oa Wait (in minutes) for alias
file rebuild.
confMIN_FREE_BLOCKS 4 Ob Minimum number of free blocks
confIGNORE_DOTS False Oi Ignore dot as terminator
for incoming messages?
confBIND_OPTS (empty) OI Default options for BIND.
+confMIME_FORMAT_ERRORS True Oj Send error messages as MIME-
+ encapsulated messages per
+ RFC 1344.
confMCI_CACHE_SIZE 2 Ok Size of open connection cache.
confMCI_CACHE_TIMEOUT 5m OK Open connection cache timeout.
confLOG_LEVEL 9 OL Log level.
running newaliases.
confOLD_STYLE_HEADERS True Oo Assume that headers without
special chars are old style.
-confPRIVACY_FLAGS public Op Privacy flags.
+confDAEMON_OPTIONS (undefined) OO SMTP daemon options.
+confPRIVACY_FLAGS authwarnings Op Privacy flags.
confCOPY_ERRORS_TO (undefined) OP Address for additional copies
of all error messages.
confQUEUE_FACTOR (undefined) Oq Slope of queue-only function
confREAD_TIMEOUT (undefined) Or SMTP read timeouts.
confSAFE_QUEUE True Os Commit all messages to disk
before forking.
-confMESSAGE_TIMEOUT 3d OT Timeout for messages before
- sending error message.
-confTIME_ZONE USE_SYSTEM Oz Time zone info -- can be
+confMESSAGE_TIMEOUT 5d/4h OT Timeout for messages before
+ sending error/warning message.
+confTIME_ZONE USE_SYSTEM Ot Time zone info -- can be
USE_SYSTEM to use the system's
idea, USE_TZ to use the user's
TZ envariable, or something
else to force that value.
confDEF_USER_ID 1 Ou Default user id.
+confUSERDB_SPEC (undefined) OU User database specification.
+confFALLBACK_MX (undefined) OV Fallback MX host.
confNO_WILDCARD_MX False Ow No wildcard MX records matches
our domain.
confQUEUE_LA 8 Ox Load average at which queue-only
(undefined) OY Cost of each recipient.
confWORK_CLASS_FACTOR (undefined) Oz Priority multiplier for class.
confWORK_TIME_FACTOR (undefined) OZ Cost of each delivery attempt.
+confCW_FILE /etc/sendmail.cw Name of file used to get the
+ Fw local additions to the $=w
+ class.
+-----------+
6 local configuration (at top of file)
7 mailer definitions
8 special local name recognition (late in ruleset 3)
- 9 special local name recognition (late in ruleset 0)
+ 9 special local rulesets (1 and 2)