xref: /csrg-svn/usr.sbin/sendmail/src/READ_ME (revision 60172)

# Copyright (c) 1983 Eric P. Allman
# Copyright (c) 1988 The Regents of the University of California.
# All rights reserved.
#
# %sccs.include.redist.sh%
#
#	@(#)READ_ME	6.6 (Berkeley) 05/21/93
#

This directory contains the source files for sendmail.

For installation instructions, please read the document ../doc/op.me:

	nroff -me ../doc/op.me

The Makefile is for the new Berkeley make, available from ftp.uu.net
in the directory /systems/unix/bsd-sources/usr.bin/make.  There is
also a Makefile.dist which is much less clever, but works on the old
traditional make.  You can use this using:

	make -f Makefile.dist

If you are compiling on SunOS, you must use -Bstatic -- if you do not,
frozen configuration files fail in bizarre ways and you will open up
several security holes.

If you are compiling on OSF/1 (DEC Alpha), you must use -lmld.

If you use both -DNDBM and -DNEWDB, you must delete the module ndbm.o
from libdb.a and delete the file "ndbm.h" from the files that get
installed (that is, use the OLD ndbm.h, not the new ndbm.h).  This
compatibility module maps ndbm calls into DB calls, and breaks things
rather badly.

You probably want to look over the compilation options in conf.h
before you compile.  These are intended to be per-site information.

The following list describes the files in this directory:

Makefile	The makefile used here; this version only works with
		the new Berkeley make.
Makefile.dist	A trimmed down version of the makefile that works with
		the old make.
READ_ME		This file.
TODO		New features to be put in (maybe) at some time.
Version.c	The version number and information about this
		version of sendmail.  Theoretically, this gets
		modified on every change.
alias.c		Does name aliasing in all forms.
arpadate.c	A subroutine which creates ARPANET standard dates.
clock.c		Routines to implement real-time oriented functions
		in sendmail -- e.g., timeouts.
collect.c	The routine that actually reads the mail into a temp
		file.  It also does a certain amount of parsing of
		the header, etc.
conf.c		The configuration file.  This contains information
		that is presumed to be quite static and non-
		controversial, or code compiled in for efficiency
		reasons.  Most of the configuration is in sendmail.cf.
conf.h		Configuration that must be known everywhere.
convtime.c	A routine to sanely process times.
daemon.c	Routines to implement daemon mode.  This version is
		specifically for Berkeley 4.1 IPC.
deliver.c	Routines to deliver mail.
err.c		Routines to print error messages.
envelope.c	Routines to manipulate the envelope structure.
headers.c	Routines to process message headers.
macro.c		The macro expander.  This is used internally to
		insert information from the configuration file.
main.c		The main routine to sendmail.  This file also
		contains some miscellaneous routines.
parseaddr.c	The routines which do address parsing.
queue.c		Routines to implement message queueing.
readcf.c	The routine that reads the configuration file and
		translates it to internal form.
recipient.c	Routines that manipulate the recipient list.
savemail.c	Routines which save the letter on processing errors.
sendmail.h	Main header file for sendmail.
srvrsmtp.c	Routines to implement server SMTP.
stab.c		Routines to manage the symbol table.
stats.c		Routines to collect and post the statistics.
sysexits.c	List of error messages associated with error codes
		in sysexits.h.
trace.c		The trace package.  These routines allow setting and
		testing of trace flags with a high granularity.
trace.h		Definitions needed for the trace package.
usersmtp.c	Routines to implement user SMTP.
util.c		Some general purpose routines used by sendmail.
version.c	A master file for Version.c -- it may not exist in
		your distribution.

Eric Allman

(Version 6.6, last update 05/21/93 07:06:31)