4.4BSD snapshot (revision 8.1); add 1993 to copyright
[unix-history] / usr / src / usr.sbin / sendmail / READ_ME
index 8005d1c..cb876aa 100644 (file)
@@ -1,9 +1,8 @@
 /*-
 /*-
- *     @(#)READ_ME     4.6 (Berkeley) %G%
+ *     @(#)READ_ME     6.10 (Berkeley) %G%
  */
 
  */
 
-THIS IS AN ALPHA VERSION OF SENDMAIL.  DON'T EVEN THINK ABOUT USING IT
-IN A HEAVY PRODUCTION ENVIRONMENT.  We've been running it (in various
+THIS IS A BETA VERSION OF SENDMAIL.  We've been running it (in various
 forms) at Berkeley for several months, but our environment is far from
 general.  In particular, it hasn't been heavily tested for non-SMTP
 environments.  The good news is that most of the changes have been
 forms) at Berkeley for several months, but our environment is far from
 general.  In particular, it hasn't been heavily tested for non-SMTP
 environments.  The good news is that most of the changes have been
@@ -13,22 +12,79 @@ REPORT ANY BUGS to sendmail@CS.Berkeley.EDU.
 
 THIS IS COPYRIGHTED CODE.  BY COMPILING AND RUNNING THIS CODE YOU AGREE
 to upgrade to the production release when it comes out.  You understand
 
 THIS IS COPYRIGHTED CODE.  BY COMPILING AND RUNNING THIS CODE YOU AGREE
 to upgrade to the production release when it comes out.  You understand
-that we hope this will be by March, but if there are serious problems
+that we hope this will be by June, but if there are serious problems
 it may be longer than that.
 
 it may be longer than that.
 
-The structure of this directory is:
+PLEASE DO NOT MAKE THIS AVAILABLE ON PUBLIC FTP.  Since it is still an
+early release, I'd prefer that people get copies directly from Berkeley
+to make certain that they have the most recent version.  This isn't
+an attempt to limit access, just to make certain that everyone is able
+to keep up.  If you got this version from anywhere other than direct
+from Berkeley, check the machine FTP.CS.Berkeley.EDU, directory
+/ucb/sendmail for the latest version.
+
+There are several related RFCs that you may wish to read -- they are
+available via anonymous FTP to several sites, including nic.ddn.mil
+(directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
+nisc.jvnc.net (rfc), venera.isi.edu (in-notes), and wuarchive.wustl.edu
+(info/rfc).  They can also be retrieved via electronic mail by sending
+email to one of:
+
+       mail-server@nisc.sri.com
+               Put "send rfcNNN" in message body
+       nis-info@nis.nsf.net
+               Put "send RFCnnn.TXT-1" in message body
+       sendrfc@jvnc.net
+               Put "RFCnnn" as Subject: line
+
+Important RFCs for electronic mail are:
+
+       RFC821  SMTP protocol
+       RFC822  Mail header format
+       RFC974  MX routing
+       RFC976  UUCP mail format
+       RFC1123 Host requirements (modifies 821, 822, and 974)
+       RFC1413 Identification server
+       RFC1341 MIME: Multipurpose Internet Mail Extensions
+       RFC1344 Implications of MIME for Internet Mail Gateways
+
+Other standards that may be of interest (but which are less directly
+relevant to sendmail) are:
+
+       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).
+
+Similar comments apply to the man pages -- they use the new Berkeley
+-mandoc macros instead of the -man macros.  You can get these from
+Net2 as well.
+
+IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
+use the version that was on the Net2 tape -- it has a number of
+nefarious bugs that were bad enough when I got them; you shouldn't have
+to go through the same thing.  Instead, get a new version via public
+FTP from vangogh.CS.Berkeley.EDU, file pub/db.tar.Z.  This software
+is highly recommended; it gets rid of several stupid limits, it's much
+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.
+
+The structure of this directory tree is:
 
 cf             Source for Berkeley configuration files.  These are
                different than what you've seen before.  They are a
                fairly dramatic rewrite, requiring the new sendmail
                (since they use new features).
 
 cf             Source for Berkeley configuration files.  These are
                different than what you've seen before.  They are a
                fairly dramatic rewrite, requiring the new sendmail
                (since they use new features).
+contrib                Some contributed tools to help with sendmail.  THESE
+               ARE NOT SUPPORTED by Berkeley -- contact the original
+               authors if you have problems.
 doc            Documentation.  If you are getting source, read
                op.me -- it's long, but worth it.
 doc            Documentation.  If you are getting source, read
                op.me -- it's long, but worth it.
-mail.local     Source for mail.local(8), a local delivery program.
-               Older versions of sendmail called /bin/mail with a
-               special -d flag to mean "really deliver this mail";
-               this is a completely new (and much smaller) program
-               that does absolutely nothing but deliver local mail.
 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.
@@ -43,13 +99,6 @@ praliases    A program to print the DBM version of the aliases file.
                DB format (which we are using).
 rmail          Source for rmail(8).  This is used as a delivery
                agent for for UUCP, and could presumably be used by
                DB format (which we are using).
 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.
+               other non-socket oriented mailers.  Older versions of
+               rmail are probably deficient.
 src            Source for the sendmail program itself.
 src            Source for the sendmail program itself.
-
-IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
-use the version that was on the Net/2 tape -- it has a number of
-nefarious bugs that were bad enough when I got them; you shouldn't have
-to go through the same thing.  Instead, get a new version via public
-FTP from okeeffe.CS.Berkeley.EDU, file pub/db.tar.Z.  This software
-is highly recommended; it gets rid of several stupid limits, it's much
-faster, and the interface is nicer to animals and plants.