xref: /original-bsd/usr.sbin/sendmail/READ_ME (revision 3705696b)
1/*-
2 *	@(#)READ_ME	8.2 (Berkeley) 07/19/93
3 */
4
5			SENDMAIL RELEASE 8
6
7This directory has the latest sendmail software from Berkeley.  See
8doc/op/op.me for a summary of changes since 5.67.
9
10Report any bugs to sendmail@CS.Berkeley.EDU.
11
12The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
13/ucb/sendmail; check there for the latest revision.
14
15There are several related RFCs that you may wish to read -- they are
16available via anonymous FTP to several sites, including nic.ddn.mil
17(directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
18nisc.jvnc.net (rfc), venera.isi.edu (in-notes), and wuarchive.wustl.edu
19(info/rfc).  They can also be retrieved via electronic mail by sending
20email to one of:
21
22	mail-server@nisc.sri.com
23		Put "send rfcNNN" in message body
24	nis-info@nis.nsf.net
25		Put "send RFCnnn.TXT-1" in message body
26	sendrfc@jvnc.net
27		Put "RFCnnn" as Subject: line
28
29Important RFCs for electronic mail are:
30
31	RFC821	SMTP protocol
32	RFC822	Mail header format
33	RFC974	MX routing
34	RFC976	UUCP mail format
35	RFC1123	Host requirements (modifies 821, 822, and 974)
36	RFC1413	Identification server
37	RFC1341	MIME: Multipurpose Internet Mail Extensions
38	RFC1344	Implications of MIME for Internet Mail Gateways
39
40Other standards that may be of interest (but which are less directly
41relevant to sendmail) are:
42
43	RFC987	Mapping between RFC822 and X.400
44	RFC1049	Content-Type header field (extension to RFC822)
45
46Unfortunately, for a variety of reasons the Makefiles are for the new
47Berkeley "make" and will not work on the old, traditional make.  I urge
48you to get this make from Net2 (available on many public FTP archives).
49Failing that, some directories have a "Makefile.dist" that will work on
50older versions of make (but don't have the niceties included).
51
52Similar comments apply to the man pages -- they use the new Berkeley
53-mandoc macros instead of the -man macros.  You can get these from
54Net2 as well.
55
56IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
57use the version that was on the Net2 tape -- it has a number of
58nefarious bugs that were bad enough when I got them; you shouldn't have
59to go through the same thing.  Instead, get a new version via public
60FTP from ftp.CS.Berkeley.EDU, file ucb/4bsd/db.tar.Z.  This software
61is highly recommended; it gets rid of several stupid limits, it's much
62faster, and the interface is nicer to animals and plants.  You will
63also probably find that you have to add -I/where/you/put/db/include
64to the sendmail makefile to get db.h to work properly.
65
66The structure of this directory tree is:
67
68cf		Source for Berkeley configuration files.  These are
69		different than what you've seen before.  They are a
70		fairly dramatic rewrite, requiring the new sendmail
71		(since they use new features).
72contrib		Some contributed tools to help with sendmail.  THESE
73		ARE NOT SUPPORTED by Berkeley -- contact the original
74		authors if you have problems.  (This directory is not
75		on the 4.4BSD tape.)
76doc		Documentation.  If you are getting source, read
77		op.me -- it's long, but worth it.
78mailstats	Statistics printing program.  It has the pathname of
79		sendmail.st compiled in, so if you've changed that,
80		beware.  This isn't all that useful.
81makemap		A program that creates the keyed maps used by the $( ... $)
82		construct in sendmail.  It is primitive but effective.
83		It takes a very simple input format, so you will probably
84		expect to preprocess must human-convenient formats
85		using sed scripts before this program will like them.
86		But it should be functionally complete.
87praliases	A program to print the DBM version of the aliases file.
88		It hasn't been converted to understand the new Berkeley
89		DB format (which we are using).
90rmail		Source for rmail(8).  This is used as a delivery
91		agent for for UUCP, and could presumably be used by
92		other non-socket oriented mailers.  Older versions of
93		rmail are probably deficient.
94src		Source for the sendmail program itself.
95test		Some test scripts (currently only for compilation aids).
96