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

# 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.7 (Berkeley) 05/28/93
#

This directory contains the source files for sendmail.

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

	eqn ../doc/op.me | pic | ditroff -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

There are a couple of other Makefiles for other systems -- these are
the ones that I use, and I don't guarantee that they will work in
your environment.  They are provided for information only.

Whereever possible, I try to make sendmail pull in the correct
compilation options based on automatically defined symbols.  Some
machines don't seem to have useful symbols availble, requiring
the following compilation flags in the Makefile:

SOLARIS		Define this if you are running Solaris 2.0 or higher.
NeXT		Define this if you are on a NeXT box.
_AIX3		Define this if you are IBM AIX 3.x.

Other compilation flags that you may need to tweak in order to get
it to compile and link properly include:

UNSETENV	Define this if your system library does NOT include the
		"unsetenv" subroutine.
SYSTEM5		Adjust for System V.
LOCKF		Set this if you do not have the flock system call -- it
		will revert to System V file locking.  There are some
		semantic gotchas, so flock is preferred.  Implied by
		SYSTEM5.
SYS5TZ		Use System V-style time zones.  If not set, the TZ
		environment variable is ignored.  Implied by SYSTEM5.
HASUNAME	Set if you have the "uname" system call.  Implied by
		SYSTEM5.
HASSTATFS	Define this if you have the statfs(2) system call.
HASUSTAT	Define this if you have the ustat(2) system call.
HASSETSID	Define this if you have the setsid(2) system call.  This
		is implied if your system appears to be POSIX compliant.
HASINITGROUPS	Define this if you have the initgroups(3) routine.

Compilation flags that add support for special features include:

NDBM		Include support for "new" DBM library for aliases and maps.
NEWDB		Include support for Berkeley "db" package (hash & btree)
		for aliases and maps.
NIS		Define this to get NIS (YP) support for aliases and maps.
YPCOMPAT	Define this to force building of DBM versions of alias
		files even if you have NEWDB defined; this will only
		occur on NIS master machines.  It is independent of NIS.
USERDB		Include support for the User Information Database.  Implied
		by NEWDB.
IDENTPROTO	Define this to get IDENT (RFC 1413) protocol support.
		This is assumed unless you are running on Ultrix or
		HP-UX, both of which have a problem in the UDP
		implementation.
MIME		Include support for MIME-encapsulated error messages.
FROZENCONFIG	Define this to get support for frozen configuration
		files.  At this point this is NOT recommended.
LOG		Set this to get syslog(3) support.  Defined by default
		in conf.h.
NETINET		Set this to get TCP/IP support.  Defined by default
		in conf.h
NETISO		Define this to get ISO networking support.
SMTP		Define this to get the SMTP code.  Implied by NETINET
		or NETISO.
NAMED_BIND	Define this to get DNS (name daemon) support, including
		MX support.  The specs you must use this if you run
		SMTP.  Defined by default in conf.h.
QUEUE		Define this to get queueing code.  Implied by NETINET
		or NETISO; required by SMTP.
DAEMON		Define this to get general network support.  Implied by
		NETINET or NETISO.
MATCHGECOS	Permit fuzzy matching of user names against the full
		name (GECOS) field in the /etc/passwd file.  This should
		probably be on, since you can disable it from the config
		file if you want to.
SETPROCTITLE	Try to set the string printed by "ps" to something
		informative about what sendmail is doing.

If you are compiling on SunOS and want to use frozen configuration
files, 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.
TRACEFLAGS	My own personal list of the trace flags -- not guaranteed
		to be particularly up to date.
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.
domain.c	Routines that interface with DNS (the Domain Name
		System).
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.
map.c		Support for database maps.
mci.c		Routines that handle mail connection information caching.
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.
udb.c		The user database interface module.
usersmtp.c	Routines to implement user SMTP.
util.c		Some general purpose routines used by sendmail.
version.c	The version number and information about this
		version of sendmail.  Theoretically, this gets
		modified on every change.

Eric Allman

(Version 6.7, last update 05/28/93 16:04:58)