O8 => O7; add Oj

[unix-history] / usr / src / usr.sbin / sendmail / cf / README

diff --git a/usr/src/usr.sbin/sendmail/cf/README b/usr/src/usr.sbin/sendmail/cf/README
index f4975fd..9dd513c 100644 (file)
--- a/usr/src/usr.sbin/sendmail/cf/README
+++ b/usr/src/usr.sbin/sendmail/cf/README
@@ -4,7 +4,7 @@
 
                Eric Allman <eric@CS.Berkeley.EDU>
 
 
                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
 
 
 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.
 
 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 |
 +---------+
 +---------+
 | 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
        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.
 
 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.
 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.
 
 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.
 
 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:
 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.
 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.
 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
 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.
 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.
 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.
                                                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.
 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.
                                                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
 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.
                        (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)
    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)