clean up option setting and move it to 8.7 long option name syntax

[unix-history] / usr / src / usr.sbin / sendmail / READ_ME

diff --git a/usr/src/usr.sbin/sendmail/READ_ME b/usr/src/usr.sbin/sendmail/READ_ME
index c949e09..be28dde 100644 (file)
--- a/usr/src/usr.sbin/sendmail/READ_ME
+++ b/usr/src/usr.sbin/sendmail/READ_ME
@@ -1,5 +1,5 @@
 /*-
 /*-

- *     @(#)READ_ME     8.4 (Berkeley) %G%
+ *     @(#)READ_ME     8.13 (Berkeley) %G%

  */
 
                        SENDMAIL RELEASE 8
  */
 
                        SENDMAIL RELEASE 8


@@ -19,9 +19,9 @@ The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
 
 The sendmail manual pages use contemporary Berkeley troff macros.  If
 your system does not process these manual pages, you can pick up the
 
 The sendmail manual pages use contemporary Berkeley troff macros.  If
 your system does not process these manual pages, you can pick up the

-new macros in a BSD Net/2 FTP site (e.g. 
-ftp.uu.net:/systems/unix/bsd-unix/share/me/strip.sed and
-ftp.uu.net:/systems/unix/bsd-unix/share/tmac/* )
+new macros in a BSD Net/2 FTP site (e.g.  on FTP.UU.NET, the files
+/systems/unix/bsd-sources/share/tmac/me/strip.sed and
+/systems/unix/bsd-sources/share/tmac/*).

 
 The strip.sed file is only used in installation.
 
 
 The strip.sed file is only used in installation.
 


@@ -41,6 +41,43 @@ I'm also told that the groff distribution from MIT has a tmac.doc
 macro set that is compatible with these macros.
 
 
 macro set that is compatible with these macros.
 
 

++-----------------------+
+| RELATED DOCUMENTATION |
++-----------------------+
+
+There are other files you should read.  Rooted in this directory are:
+
+  CHANGES-R5-R8
+       Describes changes between Release 5 and Release 8 of sendmail.
+       There are some things that may behave somewhat differently.
+       For example, the rules governing when :include: files will
+       be read have been tightened up for security reasons.
+  FAQ
+       Answers to Frequently Asked Questions.
+  KNOWNBUGS
+       Known bugs in the current release.  I try to keep this up
+       to date -- get the latest version from FTP.CS.Berkeley.EDU
+       in /ucb/sendmail/KNOWNBUGS.
+  RELEASE_NOTES
+       A detailed description of the changes in each version.  This
+       is quite long, but informative.
+  src/READ_ME
+       Details on compiling and installing sendmail.
+  cf/README
+       Details on configuring sendmail.
+  doc/op/op.me
+       The sendmail Installation & Operations Guide.  Be warned: if
+       you are running this off on SunOS or some other system with an
+       old version of -me, you need to add the following macro to the
+       macros:
+
+               .de sm
+               \s-1\\$1\\s0\\$2
+               ..
+
+       This sets a word in a smaller pointsize.
+
+

 +--------------+
 | RELATED RFCS |
 +--------------+
 +--------------+
 | RELATED RFCS |
 +--------------+


@@ -67,8 +104,13 @@ Important RFCs for electronic mail are:
        RFC976  UUCP mail format
        RFC1123 Host requirements (modifies 821, 822, and 974)
        RFC1413 Identification server
        RFC976  UUCP mail format
        RFC1123 Host requirements (modifies 821, 822, and 974)
        RFC1413 Identification server

-       RFC1341 MIME: Multipurpose Internet Mail Extensions
+       RFC1425 SMTP Service Extensions (ESMTP spec)
+       RFC1426 SMTP Service Extension for 8bit-MIMEtransport
+       RFC1427 SMTP Service Extension for Message Size Declaration
+       RFC1521 MIME: Multipurpose Internet Mail Extensions

        RFC1344 Implications of MIME for Internet Mail Gateways
        RFC1344 Implications of MIME for Internet Mail Gateways

+       RFC1428 Transation of Internet Mail from Just-Send-8 to
+               8-bit SMTP/MIME

 
 Other standards that may be of interest (but which are less directly
 relevant to sendmail) are:
 
 Other standards that may be of interest (but which are less directly
 relevant to sendmail) are:


@@ -76,11 +118,9 @@ relevant to sendmail) are:
        RFC987  Mapping between RFC822 and X.400
        RFC1049 Content-Type header field (extension to RFC822)
 
        RFC987  Mapping between RFC822 and X.400
        RFC1049 Content-Type header field (extension to RFC822)
 

-Unfortunately, for a variety of reasons the Makefiles are for the new
-Berkeley "make" and will not work on the old, traditional make.  I urge
-you to get this make from Net2 (available on many public FTP archives).
-Failing that, some directories have a "Makefile.dist" that will work on
-older versions of make (but don't have the niceties included).
+Warning to AIX users: this version of sendmail does not implement
+MB, MR, or MG DNS resource records, as defined as experiments in
+RFC883.

 
 
 +-------------------+
 
 
 +-------------------+


@@ -97,6 +137,84 @@ faster, and the interface is nicer to animals and plants.  You will
 also probably find that you have to add -I/where/you/put/db/include
 to the sendmail makefile to get db.h to work properly.
 
 also probably find that you have to add -I/where/you/put/db/include
 to the sendmail makefile to get db.h to work properly.
 

+Be sure you remove ndbm.h and ndbm.o from the db distribution.  These
+will cause problems with sendmail because sendmail already understands
+about NEWDB and NDBM coexisting.
+
+
++--------------------+
+| HOST NAME SERVICES |
++--------------------+
+
+If you are using NIS and /etc/hosts, it is critical that you
+list the long (fully qualified) name first in the /etc/hosts file
+used to build the NIS database.  For example, the line should read
+
+       128.32.149.68   mastodon.CS.Berkeley.EDU mastodon
+
+**** NOT ****
+
+       128.32.149.68   mastodon mastodon.CS.Berkeley.EDU
+
+If you use the wrong order, sendmail will conclude that your
+canonical name is the short version and use that in messages.
+The name "mastodon" doesn't mean much outside of Berkeley,
+and so this creates incorrect and unreplyable messages.
+
+
++-------------+
+| USE WITH MH |
++-------------+
+
+This version of sendmail notices and reports certain kinds of SMTP
+protocol violations that were ignored by older versions.  If you
+are running MH you may wish to install the patch in contrib/mh.patch
+that will prevent these warning reports.  This patch also works
+with the old version of sendmail, so it's safe to go ahead and
+install it.
+
+
++----------------+
+| USE WITH IDENT |
++----------------+
+
+Sendmail 8 supports the IDENT protocol, as defined by RFC 1413.
+No ident server is included with this distribution.  I have found
+copies available on:
+
+  ftp.lysator.liu.se           /pub/ident/servers
+  romulus.ucs.uoknor.edu       /networking/ident/servers
+  ftp.cyf-kr.edu.pl            /agh/uciagh/network/ident
+
+If you want to run an IDENT server, I suggest getting a copy from
+one of those sites.  Versions are available for several different
+systems, including Apollo, BSD, NeXT, AIX, TOPS20, and VMS.
+
+
++-----------+
+| MAKEFILES |
++-----------+
+
+The Makefiles in this release use the new Berkeley "make" that is
+available in BSD Net/2 and 4.4BSD.  If you are using this version
+of make, you may notice one or two places where the Makefile includes
+"../../Makefile.inc".  This file is not included with the sendmail
+distribution because it's not part of sendmail.  However, it is,
+in toto:
+
+       #       @(#)Makefile.inc        8.1 (Berkeley) 6/6/93
+
+       BINDIR?=        /usr/sbin
+
+The other directories should all have Makefile.dist files that work
+on the old make, albeit without all the niceties included.
+
+You can also get a new Berkeley make from the Net2 release (available
+on many public FTP archives).  This version should also interpret old
+Makefiles, so you could drop it in as your default make.
+
+For more details, see src/READ_ME.
+

 
 +---------------------+
 | DIRECTORY STRUCTURE |
 
 +---------------------+
 | DIRECTORY STRUCTURE |


@@ -114,6 +232,10 @@ contrib            Some contributed tools to help with sendmail.  THESE
                on the 4.4BSD tape.)
 doc            Documentation.  If you are getting source, read
                op.me -- it's long, but worth it.
                on the 4.4BSD tape.)
 doc            Documentation.  If you are getting source, read
                op.me -- it's long, but worth it.

+mail.local     The source for the local delivery agent used for 4.4BSD.
+               THIS IS NOT PART OF SENDMAIL! and may not compile
+               everywhere, since it depends on some 4.4-isms.  Warning:
+               it does mailbox locking differently than other systems.

 mailstats      Statistics printing program.  It has the pathname of
                sendmail.st compiled in, so if you've changed that,
                beware.  This isn't all that useful.
 mailstats      Statistics printing program.  It has the pathname of
                sendmail.st compiled in, so if you've changed that,
                beware.  This isn't all that useful.


@@ -129,6 +251,12 @@ praliases  A program to print the DBM version of the aliases file.
 rmail          Source for rmail(8).  This is used as a delivery
                agent for for UUCP, and could presumably be used by
                other non-socket oriented mailers.  Older versions of
 rmail          Source for rmail(8).  This is used as a delivery
                agent for for UUCP, and could presumably be used by
                other non-socket oriented mailers.  Older versions of

-               rmail are probably deficient.
+               rmail are probably deficient.  RMAIL IS NOT PART OF
+               SENDMAIL!!!  The 4.4BSD source is included for you to
+               look at or try to port to your system.  I know it doesn't
+               compile on {SunOS, HP-UX, OSF/1, other} (pick one).
+smrsh          The "sendmail restricted shell", which can be used as
+               a replacement for /bin/mail in the prog mailer to provide
+               increased security control.  NOT PART OF SENDMAIL!

 src            Source for the sendmail program itself.
 test           Some test scripts (currently only for compilation aids).
 src            Source for the sendmail program itself.
 test           Some test scripts (currently only for compilation aids).