add MAILER(mail11) from Barb Dijker
[unix-history] / usr / src / usr.sbin / sendmail / cf / README
index 56ee5ee..ac79911 100644 (file)
@@ -4,7 +4,7 @@
 
                Eric Allman <eric@CS.Berkeley.EDU>
 
 
                Eric Allman <eric@CS.Berkeley.EDU>
 
-               @(#)README      8.55 (Berkeley) %G%
+               @(#)README      8.59 (Berkeley) %G%
 
 
 This document describes the sendmail configuration files being used
 
 
 This document describes the sendmail configuration files being used
@@ -252,6 +252,10 @@ PROCMAIL_MAILER_ARGS       [procmail -m $h $f $u] The arguments passed to
                        the Procmail mailer.
 PROCMAIL_MAILER_MAX    [undefined] If set, the maximum size message that
                        will be accepted by the procmail mailer.
                        the Procmail mailer.
 PROCMAIL_MAILER_MAX    [undefined] If set, the maximum size message that
                        will be accepted by the procmail mailer.
+MAIL11_MAILER_PATH     [/usr/etc/mail11] The path to the mail11 mailer.
+MAIL11_MAILER_FLAGS    [nsFx] Flags for the mail11 mailer.
+MAIL11_MAILER_ARGS     [mail11 $g $x $h $u] Arguments passed to the mail11
+                       mailer.
 
 +---------+
 | DOMAINS |
 
 +---------+
 | DOMAINS |
@@ -262,11 +266,16 @@ file, referenced by the DOMAIN macro.  For example, our Berkeley
 domain file includes definitions for several internal distinguished
 hosts:
 
 domain file includes definitions for several internal distinguished
 hosts:
 
-UUCP_RELAY     The host that will forward UUCP-addressed email.
+UUCP_RELAY     The host that will accept UUCP-addressed email.
                If not defined, all UUCP sites must be directly
                connected.
                If not defined, all UUCP sites must be directly
                connected.
-BITNET_RELAY   The host that will forward BITNET-addressed email.
+BITNET_RELAY   The host that will accept BITNET-addressed email.
                If not defined, the .BITNET pseudo-domain won't work.
                If not defined, the .BITNET pseudo-domain won't work.
+DECNET_RELAY   The host that will accept DECNET-addressed email.
+               If not defined, the .DECNET pseudo-domain and addresses
+               of the form node::user will not work.
+FAX_RELAY      The host that will accept mail to the .FAX pseudo-domain.
+               The "fax" mailer overrides this value.
 LOCAL_RELAY    DEPRECATED.  The site that will handle unqualified
                names -- that is, names with out an @domain extension.
                If not set, they are assumed to belong on this machine.
 LOCAL_RELAY    DEPRECATED.  The site that will handle unqualified
                names -- that is, names with out an @domain extension.
                If not set, they are assumed to belong on this machine.
@@ -369,6 +378,10 @@ procmail   An interface to procmail (does not come with sendmail).
                If you use this with FEATURE(local_procmail), the FEATURE
                should be listed first.
 
                If you use this with FEATURE(local_procmail), the FEATURE
                should be listed first.
 
+mail11         The DECnet mail11 mailer, useful only if you have the mail11
+               program from gatekeeper.dec.com:/pub/DEC/gwtools (and
+               DECnet, of course).
+
 The local mailer accepts addresses of the form "user+detail", where
 the "+detail" is not used for mailbox matching but is available
 to certain local mail programs (in particular, see FEATURE(local_procmail)).
 The local mailer accepts addresses of the form "user+detail", where
 the "+detail" is not used for mailbox matching but is available
 to certain local mail programs (in particular, see FEATURE(local_procmail)).
@@ -826,11 +839,11 @@ SMART_HOST as well.  Briefly:
                local host (e.g., "eric@mastodon.CS.Berkeley.EDU").
        SMART_HOST applies to names qualified with other hosts.
 
                local host (e.g., "eric@mastodon.CS.Berkeley.EDU").
        SMART_HOST applies to names qualified with other hosts.
 
-However, beware that other relays (e.g., UUCP_RELAY, BITNET_RELAY, and
-FAX_RELAY) take precedence over SMART_HOST, so if you really want
-absolutely everything to go to a single central site you will need to
-unset all the other relays -- or better yet, find or build a minimal
-config file that does this.
+However, beware that other relays (e.g., UUCP_RELAY, BITNET_RELAY,
+DECNET_RELAY, and FAX_RELAY) take precedence over SMART_HOST, so if you
+really want absolutely everything to go to a single central site you will
+need to unset all the other relays -- or better yet, find or build a
+minimal config file that does this.
 
 
 +-------------------------------+
 
 
 +-------------------------------+
@@ -966,36 +979,38 @@ To build the internal form of the user database, use:
 
        makemap btree /usr/data/base.db < /usr/data/base.txt
 
 
        makemap btree /usr/data/base.db < /usr/data/base.txt
 
+As a general rule, I am adamantly opposed to using full names as
+e-mail addresses, since they are not in any sense unique.  For example,
+the Unix software-development community has two Andy Tannenbaums,
+at least two well-known Peter Deutsches, and at one time Bell Labs
+had two Stephen R. Bournes with offices along the same hallway.
+Which one will be forced to suffer the indignity of being
+Stephen_R_Bourne_2?  The less famous of the two, or the one that
+was hired later?
+
+Finger should handle full names (and be fuzzy).  Mail should use
+handles, and not be fuzzy.  [Not that I expect anyone to pay any
+attention to my opinions.]
+
 
 +--------------------------------+
 | MISCELLANEOUS SPECIAL FEATURES |
 +--------------------------------+
 
 
 +--------------------------------+
 | MISCELLANEOUS SPECIAL FEATURES |
 +--------------------------------+
 
-DOTTED_USER(name)
+Plussed users
        Sometimes it is convenient to merge configuration on a
        centralized mail machine, for example, to forward all
        root mail to a mail server.  In this case it might be
        useful to be able to treat the root addresses as a class
        of addresses with subtle differences.  You can do this
        Sometimes it is convenient to merge configuration on a
        centralized mail machine, for example, to forward all
        root mail to a mail server.  In this case it might be
        useful to be able to treat the root addresses as a class
        of addresses with subtle differences.  You can do this
-       using dotted users.  For example, a client might include
+       using plussed users.  For example, a client might include
        the alias:
 
        the alias:
 
-               root:  root.client1@server
-
-       On the server, the mail configuration would include:
+               root:  root+client1@server
 
 
-               DOTTED_USER(root)
-
-       Aliases on the server that would match this address would
-       be "root.client", "root.*", and "root", tried in that
-       order.  You can specify multiple addresses either by
-       joining them in one DOTTTED_USER macro or by having
-       multiple macros:
-
-               DOTTED_USER(root)
-               DOTTED_USER(postmaster mailer-daemon)
-
-       defines three dotted users.
+       On the server, this will match an alias for "root+client1".
+       If that is not found, the alias "root+*" will be tried,
+       then "root".
 
 
 +----------------+
 
 
 +----------------+
@@ -1442,13 +1457,14 @@ MAILERS
    2   uucp-*          UNIX-to-UNIX Copy Program
    3   netnews         Network News delivery
    4   fax             Sam Leffler's FlexFAX software
    2   uucp-*          UNIX-to-UNIX Copy Program
    3   netnews         Network News delivery
    4   fax             Sam Leffler's FlexFAX software
+   5   mail11          DECnet mailer
 
 
 MACROS
 
    A
    B   Bitnet Relay
 
 
 MACROS
 
    A
    B   Bitnet Relay
-   C
+   C   DECnet Relay
    D   The local domain -- usually not needed
    E
    F   FAX Relay
    D   The local domain -- usually not needed
    E
    F   FAX Relay
@@ -1479,7 +1495,7 @@ CLASSES
    A
    B
    C
    A
    B
    C
-   D   "dotted" users
+   D
    E   addresses that should not seem to come from $M
    F   hosts we forward for
    G
    E   addresses that should not seem to come from $M
    F   hosts we forward for
    G
@@ -1491,7 +1507,7 @@ CLASSES
    M
    N
    O   operators that indicate network operations (cannot be in local names)
    M
    N
    O   operators that indicate network operations (cannot be in local names)
-   P   top level pseudo-domains: BITNET, FAX, UUCP, etc.
+   P   top level pseudo-domains: BITNET, DECNET, FAX, UUCP, etc.
    Q
    R
    S
    Q
    R
    S