O8 => O7; add Oj
[unix-history] / usr / src / usr.sbin / sendmail / cf / README
index f4975fd..9dd513c 100644 (file)
@@ -4,7 +4,7 @@
 
                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
@@ -199,6 +199,11 @@ The domain file can also be used to define a domain name, if needed
 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 |
 +---------+
@@ -247,18 +252,54 @@ example, the .mc line:
        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.
@@ -354,6 +395,9 @@ You would use this if you had installed an MX record for cnmat.Berkeley.EDU
 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:
@@ -566,15 +610,15 @@ M4 Variable Name  Default         Mac/Opt Description
 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
@@ -600,6 +644,9 @@ confMAX_HOP         17              Oh      Maximum hop count.
 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.
@@ -609,21 +656,24 @@ confCHECK_ALIASES True            On      Check RHS of aliases when
                                                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
@@ -636,6 +686,9 @@ confWORK_RECIPIENT_FACTOR
                        (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.
 
 
 +-----------+
@@ -790,4 +843,4 @@ M4 DIVERSIONS
    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)