This commit was manufactured by cvs2svn to create tag 'FreeBSD-release/1.0'.
[unix-history] / usr.sbin / sendmail / READ_ME
/*-
* @(#)READ_ME 8.1 (Berkeley) 6/7/93
*/
SENDMAIL RELEASE 8
This directory has the latest sendmail software from Berkeley. See
doc/op/op.me for a summary of changes since 5.67.
Report any bugs to sendmail@CS.Berkeley.EDU.
The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
/ucb/sendmail; check there for the latest revision.
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 ftp.CS.Berkeley.EDU, file ucb/4bsd/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).
contrib Some contributed tools to help with sendmail. THESE
ARE NOT SUPPORTED by Berkeley -- contact the original
authors if you have problems. (This directory is not
on the 4.4BSD tape.)
doc Documentation. If you are getting source, read
op.me -- it's long, but worth it.
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.
makemap A program that creates the keyed maps used by the $( ... $)
construct in sendmail. It is primitive but effective.
It takes a very simple input format, so you will probably
expect to preprocess must human-convenient formats
using sed scripts before this program will like them.
But it should be functionally complete.
praliases A program to print the DBM version of the aliases file.
It hasn't been converted to understand the new Berkeley
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. Older versions of
rmail are probably deficient.
src Source for the sendmail program itself.