fix <route-addr> handling in ruleset 4

[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 910ff29..6325eb1 100644 (file)
--- a/usr/src/usr.sbin/sendmail/cf/README
+++ b/usr/src/usr.sbin/sendmail/cf/README
@@ -1,4 +1,4 @@
-@(#)README     2.1 (Berkeley) %G%
+@(#)README     2.3 (Berkeley) %G%

 
 This document describes the sendmail configuration files being used
 at Berkeley.  There have been several previous versions.  This file
 
 This document describes the sendmail configuration files being used
 at Berkeley.  There have been several previous versions.  This file


@@ -67,13 +67,13 @@ honest!
 
 You need this line!
 
 
 You need this line!
 

-       VERSIONID(@(#)README    2.1 (Berkeley) %G%)
+       VERSIONID(<SCCS or RCS version id>)

 
 VERSIONID is a macro that stuffs the version information into the
 resulting file.  We use SCCS; you could use RCS, something else, or
 omit it completely.
 
 
 VERSIONID is a macro that stuffs the version information into the
 resulting file.  We use SCCS; you could use RCS, something else, or
 omit it completely.
 

-       DOMAIN(cs.exposed)dnl
+       DOMAIN(cs.exposed)

 
 This example exposes the host inside of the CS subdomain -- that is,
 it doesn't try to hide the name of the workstation to the outside
 
 This example exposes the host inside of the CS subdomain -- that is,
 it doesn't try to hide the name of the workstation to the outside


@@ -85,10 +85,10 @@ local hostname.  This can also be effected by using:
 
 in the ".mc" file.
 
 
 in the ".mc" file.
 

-       MAILER(local)dnl
-       MAILER(smtp)dnl
+       MAILER(smtp)

 
 

-These describe the mailers used at the default CS site site.  
+These describe the mailers used at the default CS site site.  The
+local mailer is always included automatically.

 
 Note that cf/cs-exposed.mc omits an OSTYPE macro -- this assumes
 default Computer Science Division environment.  There are several
 
 Note that cf/cs-exposed.mc omits an OSTYPE macro -- this assumes
 default Computer Science Division environment.  There are several


@@ -115,6 +115,36 @@ uucp               The Unix-to-Unix Copy Program mailer.  Actually, this
                is for when you know that the UUCP mailer at the other
                end can handle multiple recipients in one transfer.
 
                is for when you know that the UUCP mailer at the other
                end can handle multiple recipients in one transfer.
 

+EXTENSIONS
+
+For more complex configurations, you can define special rules.
+The macro LOCAL_RULE_3 introduces rules that are used in canonicalizing
+the names.  Any modifications made here are reflected in the header.
+
+A common use is to convert old UUCP addreses to SMTP addresses using
+the UUCPSMTP macro.  For example:
+
+       LOCAL_RULE_3
+       UUCPSMTP(decvax,        decvax.dec.com)
+       UUCPSMTP(research,      research.att.com)
+
+will cause addresses of the form "decvax!user" and "research!user"
+to be converted to "user@decvax.dec.com" and "user@research.att.com"
+respectively.
+
+Similarly, LOCAL_RULE_0 can be used to introduce new parsing rules.
+For example, new rules are needed to parse hostnames that you accept
+via MX records.  For example, you might have:
+
+       LOCAL_RULE_0
+       R$+ < @ cnmat.Berkeley.EDU >    $#uucp $@ cnmat $: $1
+
+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.
+
+????
+

 HIERARCHY
 
 Within this directory are several subdirectories, to wit:
 HIERARCHY
 
 Within this directory are several subdirectories, to wit:


@@ -158,6 +188,9 @@ hack                Local hacks.  These can be referenced using the HACK
                interest outside the .Berkeley.EDU domain, but who knows?
                We've all got our own peccadilloes.
 
                interest outside the .Berkeley.EDU domain, but who knows?
                We've all got our own peccadilloes.
 

+siteconfig     Site configuration -- e.g., tables of locally connected
+               UUCP sites.
+

 
 ADMINISTRATIVE DETAILS
 
 
 ADMINISTRATIVE DETAILS
 


@@ -209,11 +242,11 @@ MACROS
    R   Relay (for unqualified names)
    S
    T
    R   Relay (for unqualified names)
    S
    T

-   U   UUCP Relay (all hosts)
+   U   my UUCP name (if I have a UUCP connection)

    V   UUCP Relay (class V hosts)
    W   UUCP Relay (class W hosts)
    X   UUCP Relay (class X hosts)
    V   UUCP Relay (class V hosts)
    W   UUCP Relay (class W hosts)
    X   UUCP Relay (class X hosts)

-   Y   UUCP Relay (class Y hosts)
+   Y   UUCP Relay (all other hosts)

    Z   Version number
 
 
    Z   Version number
 
 


@@ -240,10 +273,10 @@ CLASSES
    S
    T
    U   locally connected UUCP hosts
    S
    T
    U   locally connected UUCP hosts

-   V   UUCP hosts connected to host $V
-   W   UUCP hosts connected to host $X
-   X   UUCP hosts connected to host $Y
-   Y   UUCP hosts connected to host $Z
+   V   UUCP hosts connected to relay $V
+   W   UUCP hosts connected to relay $W
+   X   UUCP hosts connected to relay $X
+   Y   locally connected smart UUCP hosts

    Z
 
 
    Z
 
 


@@ -252,8 +285,8 @@ M4 DIVERSIONS
    1   Versions
    2   Local Ruleset 0 additions
    3   Local Ruleset 3 additions
    1   Versions
    2   Local Ruleset 0 additions
    3   Local Ruleset 3 additions

-   4
-   5
+   4   UUCP Ruleset 0 additions
+   5   locally interpreted names (overrides $R)

    6
    7   mailer definitions
    8
    6
    7   mailer definitions
    8