xref: /original-bsd/usr.sbin/sendmail/src/READ_ME (revision f919448c)
1# Copyright (c) 1983 Eric P. Allman
2# Copyright (c) 1988 The Regents of the University of California.
3# All rights reserved.
4#
5# %sccs.include.redist.sh%
6#
7#	@(#)READ_ME	6.5 (Berkeley) 03/18/93
8#
9
10This directory contains the source files for sendmail.
11
12For installation instructions, please read the document ../doc/op.me:
13
14	nroff -me ../doc/op.me
15
16The Makefile is for the new Berkeley make, available from ftp.uu.net
17in the directory /systems/unix/bsd-sources/usr.bin/make.  There is
18also a Makefile.dist which is much less clever, but works on the old
19traditional make.  You can use this using:
20
21	make -f Makefile.dist
22
23If you are compiling on SunOS, you must use -Bstatic -- if you do not,
24frozen configuration files fail in bizarre ways and you will open up
25several security holes.
26
27If you are compiling on OSF/1 (DEC Alpha), you must use -lmld.
28
29If you use both -DNDBM and -DNEWDB, you must delete the module ndbm.o
30from libdb.a.  This compatibility module maps ndbm calls into DB
31calls, and breaks things rather badly.
32
33You probably want to look over the compilation options in conf.h
34before you compile.  These are intended to be per-site information.
35
36The following list describes the files in this directory:
37
38Makefile	The makefile used here; this version only works with
39		the new Berkeley make.
40Makefile.dist	A trimmed down version of the makefile that works with
41		the old make.
42READ_ME		This file.
43TODO		New features to be put in (maybe) at some time.
44Version.c	The version number and information about this
45		version of sendmail.  Theoretically, this gets
46		modified on every change.
47alias.c		Does name aliasing in all forms.
48arpadate.c	A subroutine which creates ARPANET standard dates.
49clock.c		Routines to implement real-time oriented functions
50		in sendmail -- e.g., timeouts.
51collect.c	The routine that actually reads the mail into a temp
52		file.  It also does a certain amount of parsing of
53		the header, etc.
54conf.c		The configuration file.  This contains information
55		that is presumed to be quite static and non-
56		controversial, or code compiled in for efficiency
57		reasons.  Most of the configuration is in sendmail.cf.
58conf.h		Configuration that must be known everywhere.
59convtime.c	A routine to sanely process times.
60daemon.c	Routines to implement daemon mode.  This version is
61		specifically for Berkeley 4.1 IPC.
62deliver.c	Routines to deliver mail.
63err.c		Routines to print error messages.
64envelope.c	Routines to manipulate the envelope structure.
65headers.c	Routines to process message headers.
66macro.c		The macro expander.  This is used internally to
67		insert information from the configuration file.
68main.c		The main routine to sendmail.  This file also
69		contains some miscellaneous routines.
70parseaddr.c	The routines which do address parsing.
71queue.c		Routines to implement message queueing.
72readcf.c	The routine that reads the configuration file and
73		translates it to internal form.
74recipient.c	Routines that manipulate the recipient list.
75savemail.c	Routines which save the letter on processing errors.
76sendmail.h	Main header file for sendmail.
77srvrsmtp.c	Routines to implement server SMTP.
78stab.c		Routines to manage the symbol table.
79stats.c		Routines to collect and post the statistics.
80sysexits.c	List of error messages associated with error codes
81		in sysexits.h.
82trace.c		The trace package.  These routines allow setting and
83		testing of trace flags with a high granularity.
84trace.h		Definitions needed for the trace package.
85usersmtp.c	Routines to implement user SMTP.
86util.c		Some general purpose routines used by sendmail.
87version.c	A master file for Version.c -- it may not exist in
88		your distribution.
89
90Eric Allman
91
92(Version 6.5, last update 03/18/93 11:54:06)
93