xref: /csrg-svn/usr.sbin/sendmail/READ_ME (revision 63901)
141139Sbostic/*-
2*63901Seric *	@(#)READ_ME	8.2 (Berkeley) 07/19/93
336585Sbostic */
410221Seric
562535Sbostic			SENDMAIL RELEASE 8
657210Seric
762535SbosticThis directory has the latest sendmail software from Berkeley.  See
862535Sbosticdoc/op/op.me for a summary of changes since 5.67.
957210Seric
1062535SbosticReport any bugs to sendmail@CS.Berkeley.EDU.
1157210Seric
1262535SbosticThe latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
1362535Sbostic/ucb/sendmail; check there for the latest revision.
1458285Seric
1557979SericThere are several related RFCs that you may wish to read -- they are
1657979Sericavailable via anonymous FTP to several sites, including nic.ddn.mil
1757979Seric(directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
1857979Sericnisc.jvnc.net (rfc), venera.isi.edu (in-notes), and wuarchive.wustl.edu
1957979Seric(info/rfc).  They can also be retrieved via electronic mail by sending
2057979Sericemail to one of:
2157979Seric
2257979Seric	mail-server@nisc.sri.com
2357979Seric		Put "send rfcNNN" in message body
2457979Seric	nis-info@nis.nsf.net
2557979Seric		Put "send RFCnnn.TXT-1" in message body
2657979Seric	sendrfc@jvnc.net
2757979Seric		Put "RFCnnn" as Subject: line
2857979Seric
2957979SericImportant RFCs for electronic mail are:
3057979Seric
3157979Seric	RFC821	SMTP protocol
3257979Seric	RFC822	Mail header format
3357979Seric	RFC974	MX routing
3457979Seric	RFC976	UUCP mail format
3557979Seric	RFC1123	Host requirements (modifies 821, 822, and 974)
3659106Seric	RFC1413	Identification server
3759742Seric	RFC1341	MIME: Multipurpose Internet Mail Extensions
3859742Seric	RFC1344	Implications of MIME for Internet Mail Gateways
3957979Seric
4057979SericOther standards that may be of interest (but which are less directly
4157979Sericrelevant to sendmail) are:
4257979Seric
4357979Seric	RFC987	Mapping between RFC822 and X.400
4457979Seric	RFC1049	Content-Type header field (extension to RFC822)
4557979Seric
4657979SericUnfortunately, for a variety of reasons the Makefiles are for the new
4757979SericBerkeley "make" and will not work on the old, traditional make.  I urge
4857979Sericyou to get this make from Net2 (available on many public FTP archives).
4957979SericFailing that, some directories have a "Makefile.dist" that will work on
5057979Sericolder versions of make (but don't have the niceties included).
5157979Seric
5257979SericSimilar comments apply to the man pages -- they use the new Berkeley
5357979Seric-mandoc macros instead of the -man macros.  You can get these from
5457979SericNet2 as well.
5557979Seric
5657979SericIF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
5757979Sericuse the version that was on the Net2 tape -- it has a number of
5857979Sericnefarious bugs that were bad enough when I got them; you shouldn't have
5957979Sericto go through the same thing.  Instead, get a new version via public
6062535SbosticFTP from ftp.CS.Berkeley.EDU, file ucb/4bsd/db.tar.Z.  This software
6157979Sericis highly recommended; it gets rid of several stupid limits, it's much
6257979Sericfaster, and the interface is nicer to animals and plants.  You will
6357979Sericalso probably find that you have to add -I/where/you/put/db/include
6457979Sericto the sendmail makefile to get db.h to work properly.
6557979Seric
6657979SericThe structure of this directory tree is:
6757979Seric
6857210Sericcf		Source for Berkeley configuration files.  These are
6957210Seric		different than what you've seen before.  They are a
7057210Seric		fairly dramatic rewrite, requiring the new sendmail
7157210Seric		(since they use new features).
7259106Sericcontrib		Some contributed tools to help with sendmail.  THESE
7359106Seric		ARE NOT SUPPORTED by Berkeley -- contact the original
7462535Sbostic		authors if you have problems.  (This directory is not
7562535Sbostic		on the 4.4BSD tape.)
7657210Sericdoc		Documentation.  If you are getting source, read
7757210Seric		op.me -- it's long, but worth it.
7857210Sericmailstats	Statistics printing program.  It has the pathname of
7957210Seric		sendmail.st compiled in, so if you've changed that,
8057210Seric		beware.  This isn't all that useful.
8157210Sericmakemap		A program that creates the keyed maps used by the $( ... $)
8257210Seric		construct in sendmail.  It is primitive but effective.
8357210Seric		It takes a very simple input format, so you will probably
8457210Seric		expect to preprocess must human-convenient formats
8557210Seric		using sed scripts before this program will like them.
8657210Seric		But it should be functionally complete.
8757210Sericpraliases	A program to print the DBM version of the aliases file.
8857210Seric		It hasn't been converted to understand the new Berkeley
8957210Seric		DB format (which we are using).
9057210Sericrmail		Source for rmail(8).  This is used as a delivery
9157210Seric		agent for for UUCP, and could presumably be used by
9257635Seric		other non-socket oriented mailers.  Older versions of
9357635Seric		rmail are probably deficient.
9454987Sericsrc		Source for the sendmail program itself.
95*63901Serictest		Some test scripts (currently only for compilation aids).
96