xref: /csrg-svn/usr.sbin/sendmail/src/READ_ME (revision 65108)
135062Sbostic# Copyright (c) 1983 Eric P. Allman
248582Sbostic# Copyright (c) 1988 The Regents of the University of California.
333728Sbostic# All rights reserved.
433728Sbostic#
548582Sbostic# %sccs.include.redist.sh%
633728Sbostic#
7*65108Seric#	@(#)READ_ME	8.35 (Berkeley) 12/12/93
833728Sbostic#
948582Sbostic
109881SericThis directory contains the source files for sendmail.
115369Seric
1260565SericFor detailed instructions, please read the document ../doc/op.me:
135369Seric
1460565Seric	eqn ../doc/op.me | pic | ditroff -me
155369Seric
1664262SericThe Makefile is for the new (4.4BSD) Berkeley make, available from
1764262Sericftp.uu.net in the directory /systems/unix/bsd-sources/usr.bin/make.
1864501Seric(Paul Southworth <pauls@umich.edu> published a description of porting
1964501Sericthis make in comp.unix.bsd.)  This Makefile has assumptions about the
2064501Seric4.4 file system layout built in.
2157418Seric
2264501SericThere is also a Makefile.dist which is much less clever, but works on
2364501Sericthe old traditional make.  You can use this using:
2464501Seric
2557418Seric	make -f Makefile.dist
2657418Seric
2764262SericThere are a bunch of other Makefiles for other systems -- these are
2860584Sericthe ones that I use, they have "Berkeley quirks" in them, and I don't
2964262Sericguarantee that they will work unmodified in your environment.  However,
3064262Sericthey are all designed for the old make and can be used to help you get
3164262Sericstarted.  They have names like "Makefile.HPUX".  Many of them include
3264262Seric-I/usr/sww/include/db and -L/usr/sww/lib -- this is Berkeley's
3365000Sericlocation for the new database libraries, described below.  You don't
3465000Serichave to remove these definitions if you don't have these directories.
3557943Seric
3664272SericThere is also a shell script (makesendmail) that tries to be clever
3764272Sericabout using object subdirectories.  It's pretty straightforward, and
3864272Sericmay help if you share a source tree among different architectures.
3964035Seric
4065000Seric**************************************************************************
4165000Seric**  IMPORTANT:  DO NOT USE OPTIMIZATION (``-O'') IF YOU ARE RUNNING	**
4265000Seric**  GCC 2.4.x or 2.5.x.  THERE IS A BUG IN THE GCC OPTIMIZER THAT	**
4365000Seric**  CAUSES SENDMAIL COMPILES TO FAIL MISERABLY.				**
4465000Seric**************************************************************************
4564272Seric
4665000SericJim Wilson of Cygnus believes he has found the problem -- it will
4765000Sericprobably be fixed in GCC 2.5.6 -- but until this is verified, be
4865000Sericvery suspicious of gcc -O.
4964701Seric
5065000Seric**************************************************************************
5165000Seric**  IMPORTANT:  Read the appropriate paragraphs in the section on	**
5265000Seric**  ``Operating System and Compile Quirks''.				**
5365000Seric**************************************************************************
5464718Seric
5565000Seric
5664250Seric+----------------------+
5764250Seric| DATABASE DEFINITIONS |
5864250Seric+----------------------+
5964250Seric
6064250SericThere are several database formats that can be used for the alias files
6164250Sericand for general maps.  When used for alias files they interact in an
6264250Sericattempt to be back compatible.
6364250Seric
6464250SericThe three options are NEWDB (the new Berkeley DB package), NDBM (the
6564250Sericolder DBM implementation -- the very old V7 implementation is no
6664250Sericlonger supported), and NIS (Network Information Services).  Used alone
6764376Sericthese just include the support they indicate.  [If you are using NEWDB,
6864376Sericget the latest version from FTP.CS.Berkeley.EDU in /ucb/4bsd.  DO NOT
6965000Sericuse the version from the Net2 distribution!  However, if you are on
7065000SericBSD/386 or 386BSD-based systems, use the one that already exists
7165000Sericon your system.  You may need to define OLD_NEWDB to do this.]
7264250Seric
7364250SericIf NEWDB and NDBM are defined (but not NIS), then sendmail will read
7464250SericNDBM format alias files, but the next time a newaliases is run the
7564250Sericformat will be converted to NEWDB; that format will be used forever
7664250Sericmore.  This is intended as a transition feature.  [Note however that
7764250Sericthe NEWDB library also catches and maps NDBM calls; you will have to
7864250Sericback out this feature to get this to work.  See ``Quirks'' section
7964250Sericbelow for details.]
8064250Seric
8164250SericIf all three are defined, sendmail operates as described above, and also
8264250Sericlooks for the file /var/yp/Makefile.  If it exists, newaliases will
8364250Sericbuild BOTH the NEWDB and NDBM format alias files.  However, it will
8464250Sericonly use the NEWDB file; the NDBM format file is used only by the
8564250SericNIS subsystem.
8664250Seric
8764250SericIf NDBM and NIS are defined (regardless of the definition of NEWDB
8864250Sericor the existance of /var/yp/Makefile), sendmail adds the special
8964250Serictokens "YP_LAST_MODIFIED" and "YP_MASTER_NAME", both of which are
9064250Sericrequired if the NDBM file is to be used as an NIS map.
9164250Seric
9264250SericAll of -DNEWDB, -DNDBM, and -DNIS are normally defined in the DBMDEF
9364250Sericline in the Makefile.
9464250Seric
9564250Seric
9664035Seric+---------------+
9764035Seric| COMPILE FLAGS |
9864035Seric+---------------+
9964035Seric
10060565SericWhereever possible, I try to make sendmail pull in the correct
10160584Sericcompilation options needed to compile on various environments based on
10260584Sericautomatically defined symbols.  Some machines don't seem to have useful
10360584Sericsymbols availble, requiring the following compilation flags in the
10460584SericMakefile:
10560565Seric
10660565SericSOLARIS		Define this if you are running Solaris 2.0 or higher.
10765000SericSOLARIS_2_3	Define this if you are running Solaris 2.3 or higher.
108*65108SericSUNOS403	Define this if you are running SunOS 4.0.3.
10964077SericNeXT		Define this if you are on a NeXT box.  (This one may
11064072Seric		be pre-defined for you.)  There are other hacks you
11164072Seric		have to make -- see below.
11260565Seric_AIX3		Define this if you are IBM AIX 3.x.
11363965SericRISCOS		Define this if you are running RISC/os from MIPS.
11464501Seric_SCO_unix_	Define this if you are on SCO UNIX.
11565095Seric_SCO_unix_4_2	Define this if you are on SCO Open Server 3.2v4.
11660565Seric
11760584SericIf you are a system that sendmail has already been ported to, you
11860584Sericprobably won't have to touch these.  But if you are porting, you may
11963962Serichave to tweak the following compilation flags in conf.h in order to
12063962Sericget it to compile and link properly:
12160565Seric
12260565SericSYSTEM5		Adjust for System V.
12364035SericSYS5SIGNALS	Use System V signal semantics -- the signal handler
12464035Seric		is automatically dropped when the signal is caught.
12564035Seric		If this is not set, use POSIX/BSD semantics, where the
12664035Seric		signal handler stays in force until an exec or an
12764035Seric		explicit delete.  Implied by SYSTEM5.
12864706SericSYS5SETPGRP	Use System V setpgrp() semantics.  Implied by SYSTEM5.
12964035SericHASFLOCK	Set this if you prefer to use the flock(2) system call
13064035Seric		rather than using fcntl-based locking.  Fcntl locking
13164035Seric		has some semantic gotchas, but many vendor systems
13264035Seric		also interface it to lockd(8) to do NFS-style locking.
13364035Seric		For this reason, this should not be set unless you
13464035Seric		don't have an alternative.
13560565SericHASUNAME	Set if you have the "uname" system call.  Implied by
13660565Seric		SYSTEM5.
13763962SericHASUNSETENV	Define this if your system library has the "unsetenv"
13863962Seric		subroutine.
13960584SericHASSTATFS	Define this if you have the statfs(2) system call.  It's
14060584Seric		not a disaster to get this wrong -- but you do lose the
14160584Seric		queue free space code.
14260584SericHASUSTAT	Define this if you have the ustat(2) system call.  It's
14360584Seric		not a disaster to get this wrong -- but you do lose the
14460584Seric		queue free space code.
14560565SericHASSETSID	Define this if you have the setsid(2) system call.  This
14660565Seric		is implied if your system appears to be POSIX compliant.
14760565SericHASINITGROUPS	Define this if you have the initgroups(3) routine.
14863753SericHASSETVBUF	Define this if you have the setvbuf(3) library call.
14963753Seric		If you don't, setlinebuf will be used instead.  This
15063753Seric		defaults on if your compiler defines __STDC__.
15163902SericHASSETREUID	Define this if you have setreuid(2) ***AND*** root can
15263902Seric		use setreuid to change to an arbitrary user.  This second
15363902Seric		condition is not satisfied on AIX 3.x.  You may find that
15463902Seric		your system has setresuid(2), (for example, on HP-UX) in
15563902Seric		which case you will also have to #define setreuid(r, e)
15663902Seric		to be the appropriate call.  Some systems (such as Solaris)
15765000Seric		have a compatibility routine that doesn't work properly,
15865000Seric		but may have "saved user ids" properly implemented so you
15965000Seric		can ``#define setreuid(r, e) seteuid(e)'' and have it work.
16063902Seric		The important thing is that you have a call that will set
16165000Seric		the effective uid independently of the real or saved uid
16265000Seric		and be able to set the effective uid back again when done.
16365000Seric		There's a test program in ../test/t_setreuid.c that will
16465000Seric		try things on your system.  Setting this improves the
16565000Seric		security, since sendmail doesn't have to read .forward
16665000Seric		and :include: files as root.  There are certain attacks
16765000Seric		that may be unpreventable without this call.
16865000SericHASLSTAT	Define this if you have symbolic links (and thus the
16965000Seric		lstat(2) system call).  This improves security.  Unlike
17065000Seric		most other options, this one is on by default, so you
17165000Seric		need to #undef it in conf.h if you don't have symbolic
17265000Seric		links (these days everyone does).
17363937SericGIDSET_T	The type of entries in a gidset passed as the second
17463937Seric		argument to getgroups(2).  Historically this has been an
17563937Seric		int, so this is the default, but some systems (such as
17663937Seric		IRIX) pass it as a gid_t, which is an unsigned short.
17763937Seric		This will make a difference, so it is important to get
17863937Seric		this right!  However, it is only an issue if you have
17963937Seric		group sets.
18063968SericSLEEP_T		The type returned by the system sleep() function.
18163968Seric		Defaults to "unsigned int".  Don't worry about this
18263968Seric		if you don't have compilation problems.
18363974SericARBPTR_T	The type of an arbitrary pointer -- defaults to "void *".
18463974Seric		If you are an very old compiler you may need to define
18563974Seric		this to be "char *".
18660584SericLA_TYPE		The type of load average your kernel supports.  These
18760584Seric		can be LA_SUBR (4) if you have the getloadavg(3) routine,
18864376Seric		LA_MACH (5) to use MACH-style load averages (calls
18964376Seric		processor_set_info()), LA_FLOAT (3) if you read kmem and
19064376Seric		interpret the value as a floating point number, LA_INT (2)
19164376Seric		to interpret as a long integer, or LA_SHORT (6) to
19264376Seric		interpret as a short integer.  These last three have
19364376Seric		several other parameters that they try to divine: the
19464376Seric		name of your kernel, the name of the variable in the
19564376Seric		kernel to examine, the number of bits of precision in
19664376Seric		a fixed point load average, and so forth.  In desparation,
19764376Seric		use LA_ZERO (1) -- it always returns the load average as
19864376Seric		"zero" (and does so on all architectures).  The actual
19964376Seric		code is in conf.c -- it can be tweaked if you are brave.
20063962SericERRLIST_PREDEFINED
20163962Seric		If set, assumes that some header file defines sys_errlist.
20263962Seric		This may be needed if you get type conflicts on this
20363962Seric		variable -- otherwise don't worry about it.
20464562SericWAITUNION	The wait(2) routine takes a "union wait" argument instead
20564562Seric		of an integer argument.  This is for compatibility with
20664562Seric		old versions of BSD.
20765000SericSCANF		You can set this to extend the F command to accept a
20865000Seric		scanf string -- this gives you a primitive parser for
20965000Seric		class definitions -- BUT it can make you vulnerable to
21065000Seric		core dumps if the target file is poorly formed.
21165095SericSYSLOG_BUFSIZE	You can define this to be the size of the buffer that
21265095Seric		syslog accepts.  If it is not defined, it assumes a
21365095Seric		1024-byte buffer.  If the buffer is very small (under
21465095Seric		256 bytes) the log message format changes -- each
21565095Seric		e-mail message will log many more messages, since it
21665095Seric		will log each piece of information as a separate line
21765095Seric		in syslog.
21860565Seric
21964035Seric
22064035Seric+-----------------------+
22164035Seric| COMPILE-TIME FEATURES |
22264035Seric+-----------------------+
22364035Seric
22460584SericThere are a bunch of features that you can decide to compile in, such
22560584Sericas selecting various database packages and special protocol support.
22660584SericSeveral are assumed based on other compilation flags -- if you want to
22760584Seric"un-assume" something, you probably need to edit conf.h.  Compilation
22860584Sericflags that add support for special features include:
22960565Seric
23060565SericNDBM		Include support for "new" DBM library for aliases and maps.
23164250Seric		Normally defined in the Makefile.
23260565SericNEWDB		Include support for Berkeley "db" package (hash & btree)
23364250Seric		for aliases and maps.  Normally defined in the Makefile.
23460565SericNIS		Define this to get NIS (YP) support for aliases and maps.
23564250Seric		Normally defined in the Makefile.
23660565SericUSERDB		Include support for the User Information Database.  Implied
23764250Seric		by NEWDB in conf.h.
23865000SericIDENTPROTO	Define this as 1 to get IDENT (RFC 1413) protocol support.
23960565Seric		This is assumed unless you are running on Ultrix or
24060565Seric		HP-UX, both of which have a problem in the UDP
24165000Seric		implementation.  You can define it to be 0 to explicitly
24265000Seric		turn off IDENT protocol support.
24360565SericMIME		Include support for MIME-encapsulated error messages.
24460565SericLOG		Set this to get syslog(3) support.  Defined by default
24560584Seric		in conf.h.  You want this if at all possible.
24660565SericNETINET		Set this to get TCP/IP support.  Defined by default
24760584Seric		in conf.h.  You probably want this.
24860565SericNETISO		Define this to get ISO networking support.
24960565SericSMTP		Define this to get the SMTP code.  Implied by NETINET
25060565Seric		or NETISO.
25160565SericNAMED_BIND	Define this to get DNS (name daemon) support, including
25260565Seric		MX support.  The specs you must use this if you run
25360565Seric		SMTP.  Defined by default in conf.h.
25460565SericQUEUE		Define this to get queueing code.  Implied by NETINET
25560584Seric		or NETISO; required by SMTP.  This gives you other good
25660584Seric		stuff -- it should be on.
25760565SericDAEMON		Define this to get general network support.  Implied by
25860584Seric		NETINET or NETISO.  Defined by default in conf.h.  You
25960584Seric		almost certainly want it on.
26060565SericMATCHGECOS	Permit fuzzy matching of user names against the full
26160565Seric		name (GECOS) field in the /etc/passwd file.  This should
26260565Seric		probably be on, since you can disable it from the config
26360584Seric		file if you want to.  Defined by default in conf.h.
26460565SericSETPROCTITLE	Try to set the string printed by "ps" to something
26560584Seric		informative about what sendmail is doing.  Defined by
26660584Seric		default in conf.h.
26760565Seric
26864035Seric
26965000Seric+---------------------+
27065000Seric| DNS/RESOLVER ISSUES |
27165000Seric+---------------------+
27265000Seric
27365000SericMany systems have old versions of the resolver library.  At a minimum,
27465000Sericyou should be running BIND 4.8.3; older versions may compile, but they
27565000Serichave known bugs that should give you pause.
27665000Seric
27765000SericCommon problems in old versions include "undefined" errors for
27865000Sericdn_skipname.
27965000Seric
28065000SericSome people have had a problem with BIND 4.9; it uses some routines
28165000Sericthat it expects to be externally defined such as strerror().  It may
28265000Serichelp to link with "-l44bsd" to solve this problem.
28365000Seric
28465095Seric!PLEASE! be sure to link with the same version of the resolver as
28565095Sericthe header files you used -- some people have used the 4.9 headers
28665095Sericand linked with BIND 4.8 or vice versa, and it doesn't work.
28765095SericUnfortunately, it doesn't fail in an obvious way -- things just
28865095Sericsubtlely don't work.
28965000Seric
29065095Seric
29164035Seric+-------------------------------------+
29264035Seric| OPERATING SYSTEM AND COMPILE QUIRKS |
29364035Seric+-------------------------------------+
29464035Seric
29565095SericGCC 2.5.x problems  *** IMPORTANT ***
29665095Seric	Date: Mon, 29 Nov 93 19:08:44 PST
29765095Seric	From: wilson@cygnus.com (Jim Wilson)
29865095Seric	Message-Id: <9311300308.AA04608@cygnus.com>
29965095Seric	To: kenner@vlsi1.ultra.nyu.edu
30065095Seric	Subject: [cattelan@thebarn.com: gcc 2.5.4-2.5.5 -O bug]
30165095Seric	Cc: cattelan@thebarn.com, rms@gnu.ai.mit.edu, sendmail@cs.berkeley.edu
30265095Seric
30365095Seric	This fixes a problem that occurs when gcc 2.5.5 is used to compile
30465095Seric	sendmail 8.6.4 with optimization on a sparc.
30565095Seric
30665095Seric	Mon Nov 29 19:00:14 1993  Jim Wilson  (wilson@sphagnum.cygnus.com)
30765095Seric
30865095Seric		* reload.c (find_reloads_toplev): Replace obsolete reference to
30965095Seric		BYTE_LOADS_*_EXTEND with LOAD_EXTEND_OP.
31065095Seric
31165095Seric	*** clean-ss-931128/reload.c    Sun Nov 14 16:20:01 1993
31265095Seric	--- ss-931128/reload.c  Mon Nov 29 18:52:55 1993
31365095Seric	*************** find_reloads_toplev (x, opnum, type, ind
31465095Seric	*** 3888,3894 ****
31565095Seric		 force a reload in that case.  So we should not do anything here.  */
31665095Seric
31765095Seric		else if (regno >= FIRST_PSEUDO_REGISTER
31865095Seric	! #if defined(BYTE_LOADS_ZERO_EXTEND) || defined(BYTE_LOADS_SIGN_EXTEND)
31965095Seric		       && (GET_MODE_SIZE (GET_MODE (x))
32065095Seric			   <= GET_MODE_SIZE (GET_MODE (SUBREG_REG (x))))
32165095Seric	  #endif
32265095Seric	--- 3888,3894 ----
32365095Seric		 force a reload in that case.  So we should not do anything here.  */
32465095Seric
32565095Seric		else if (regno >= FIRST_PSEUDO_REGISTER
32665095Seric	! #ifdef LOAD_EXTEND_OP
32765095Seric		       && (GET_MODE_SIZE (GET_MODE (x))
32865095Seric			   <= GET_MODE_SIZE (GET_MODE (SUBREG_REG (x))))
32965095Seric	  #endif
33065095Seric
33165095Seric
33264376SericSunOS 4.x (Solaris 1.x)
33364376Seric	You may have to use -lresolv on SunOS.  However, beware that
33464376Seric	this links in a new version of gethostbyname that does not
33564376Seric	understand NIS, so you must have all of your hosts in DNS.
33664035Seric
33764798Seric	Some people have reported problems with the SunOS version of
33864798Seric	-lresolv and/or in.named, and suggest that you get a newer
33964798Seric	version.  The symptoms are delays when you connect to the
34065000Seric	SMTP server on a SunOS machine or having your domain added to
34165000Seric	addresses inappropriately.  There is a version of BIND
34264798Seric	version 4.9 on gatekeeper.DEC.COM in pub/BSD/bind/4.9.
34364798Seric
34464400Seric	There is substantial disagreement about whether you can make
34564400Seric	this work with resolv+, which allows you to specify a search-path
34664400Seric	of services.  Some people report that it works fine, others
34764400Seric	claim it doesn't work at all (including causing sendmail to
34864400Seric	drop core when it tries to do multiple resolv+ lookups for a
34964400Seric	single job).  I haven't tried resolv+, as we use DNS exclusively.
35064400Seric
35164400Seric	Should you want to try resolv+, it is on ftp.uu.net in
35264400Seric	/networking/ip/dns.
35364400Seric
35464376SericSolaris 2.x (SunOS 5.x)
35564376Seric	To compile for Solaris, be sure you use -DSOLARIS.
35664376Seric
35764364Seric	From a correspondent:
35864364Seric
35964364Seric	   For solaris 2.2, I have
36064364Seric
36164364Seric		hosts:      files dns
36264364Seric
36364364Seric	   in /etc/nsswitch.conf and /etc/hosts has to have the fully
36464364Seric	   qualified host name. I think "files" has to be before "dns"
36564364Seric	   in /etc/nsswitch.conf during bootup.
36664364Seric
36764376Seric	To the best of my knowledge, Solaris does not have the
36864376Seric	gethostbyname problem described above.
36964376Seric
37064385Seric	The Solaris "syslog" function is apparently limited to something
37164385Seric	about 90 characters because of a kernel limitation.  If you have
37265000Seric	source code, you can probably up this number.  The syslogd patch
37365000Seric	is included in kernel jumbo patch for Solaris 2.2 as of revision
37465000Seric	-39 or so.  At least one person is running with patch 100999-45
37565000Seric	and their long lost sendmail logging is finally showing up.
37664385Seric
37764250SericOSF/1
37865000Seric	If you are compiling on OSF/1 (DEC Alpha), you must use
37965000Seric	-non_shared (otherwise it core dumps on startup).  You may also
38065000Seric	need -mld to get the nlist() function, although some versions
38165000Seric	apparently don't need this.
38265000Seric
38365000Seric	Also, the enclosed makefile removed /usr/sbin/smtpd; if you need
38465000Seric	it, just create the link to the sendmail binary.
38557977Seric
38664250SericNeXT
38764250Seric	If you are compiling on NeXT, you will have to create an empty
38864250Seric	file "unistd.h" and create a file "dirent.h" containing:
38963753Seric
39064250Seric		#include <sys/dir.h>
39164250Seric		#define dirent	direct
39264035Seric
39364250Seric	(The Makefile.NeXT should try to do both of these for you.)
39464077Seric
39564364Seric	Apparently, there is a bug in getservbyname on Nextstep 3.0
39664364Seric	that causes it to fail under some circumstances with the
39764364Seric	message "SYSERR: service "smtp" unknown" logged.  You should
39864364Seric	be able to work around this by including the line:
39964364Seric
40064670Seric		OOPort=25
40164364Seric
40264364Seric	in your .cf file.
40364364Seric
40464376Seric	You may have to use -DNeXT.
40564376Seric
40665000SericBSDI (BSD/386) 1.0, NetBSD 0.9, FreeBSD 1.0
40765000Seric	The "m4" from BSDI won't handle the config files properly.
40865000Seric	I haven't had a chance to test this myself.
40957943Seric
41065000Seric	The M4 shipped in FreeBSD and NetBSD 0.9 don't handle the config
41165000Seric	files properly. One must use either GNU m4 1.1 or the PD-M4
41265000Seric	recently posted in comp.os.386bsd.bugs (and maybe others).
41365000Seric	NetBSD-current includes the PD-M4 (as stated in the NetBSD file
41465000Seric	CHANGES).
41565000Seric
41665000Seric	FreeBSD 1.0 RELEASE has uname(2) now. Use -DUSEUNAME in order to
41765000Seric	use it (look into Makefile.FreeBSD). NetBSD-current may have
41865000Seric	it too but it has not been verified.
41965000Seric
42065000Seric	You cannot port the latest version of the Berkeley db library
42165000Seric	and use it with sendmail without recompiling the world.  This
42265000Seric	is because C library routines use the older version which have
42365000Seric	incompatible header files -- the result is that it can't read
42465000Seric	other system files, such as /etc/passwd, unless you use the
42565000Seric	new db format throughout your system.  You should normally just
42665000Seric	use the version of db supplied in your release.  You may need
42765000Seric	to use -DOLD_NEWDB to make this work -- this turns off some
42865000Seric	new interface calls (for file locking) that are not in older
42965000Seric	versions of db.  You'll get compile errors if you need this
43065000Seric	flag and don't have it set.
43165000Seric
43264364Seric4.3BSD
43364364Seric	If you are running a "virgin" version of 4.3BSD, you'll have
43464364Seric	a very old resolver and be missing some header files.  The
43564364Seric	header files are simple -- create empty versions and everything
43664364Seric	will work fine.  For the resolver you should really port a new
43764364Seric	version (4.8.3 or later) of the resolver; 4.9 is available on
43864364Seric	gatekeeper.DEC.COM in pub/BSD/bind/4.9.  If you are really
43964364Seric	determined to continue to use your old, buggy version (or as
44064364Seric	a shortcut to get sendmail working -- I'm sure you have the
44164364Seric	best intentions to port a modern version of BIND), you can
44264364Seric	copy ../contrib/oldbind.compat.c into src and add
44364364Seric	oldbind.compat.o to OBJADD in the Makefile.
44464364Seric
44564501SericLinux
44664501Seric	From: Karl London <karl@borg.demon.co.uk>
44764501Seric	Subject: Little bit to add to a readme for Linux for 8.6
44864501Seric	Date: Fri, 10 Sep 1993 20:16:05 +0100 (BST)
44964501Seric
45064501Seric	Below is a copy of a section of the /usr/include/unistd.h from
45164501Seric	linux libc-4.4.1 which needs changing because of a bug in the
45264501Seric	header files. Should be fixed for future releases..
45364501Seric
45464501Seric	Karl
45564501Seric
45664501Seric	The #if 0 and #endif are new!!
45764501Seric
45864501Seric	-------
45964501Seric
46064501Seric	   If OPTS begins with `--', then non-option arguments
46164501Seric	   are treated as arguments to the option '\0'.
46264501Seric	   This behavior is specific to the GNU `getopt'.  */
46364501Seric	#if 0
46464501Seric	extern int getopt __P ((int __argc, char *__const * __argv,
46564501Seric				__const char *__opts));
46664501Seric	#endif
46764501Seric	extern int opterr;
46864501Seric	extern int optind;
46964501Seric
47064718SericA/UX
47164718Seric	Date: Tue, 12 Oct 1993 18:28:28 -0400 (EDT)
47264718Seric	From: "Eric C. Hagberg" <hagberg@med.cornell.edu>
47364718Seric	Subject: Fix for A/UX ndbm
47464718Seric
47564718Seric	I guess this isn't really a sendmail bug, however, it is something
47664718Seric	that A/UX users should be aware of when compiling sendmail 8.6.
47764718Seric
47864718Seric	Apparently, the calls that sendmail is using to the ndbm routines
47964718Seric	in A/UX 3.0.x contain calls to "broken" routines, in that the
48064718Seric	aliases database will break when it gets "just a little big"
48164718Seric	(sorry I don't have exact numbers here, but it broke somewhere
48264718Seric	around 20-25 aliases for me.), making all aliases non-functional
48364718Seric	after exceeding this point.
48464718Seric
48564718Seric	What I did was to get the gnu-dbm-1.6 package, compile it, and
48664718Seric	then re-compile sendmail with "-lgdbm", "-DNDBM", and using the
48764718Seric	ndbm.h header file that comes with the gnu-package. This makes
48864718Seric	things behave properly.
48964718Seric
49064718Seric	I suppose porting the New Berkeley db package is another route,
49164718Seric	however, I made a quick attempt at it, and found it difficult
49264718Seric	(not easy at least); the gnu-dbm package "configured" and
49364718Seric	compiled easily.
49464718Seric
49564718SericDG/UX
49664718Seric	Apparently, /bin/mail doesn't work properly for delivery on
49764718Seric	DG/UX -- the person who has this working, Douglas Anderson
49864718Seric	<dlander@afterlife.ncsc.mil>, used procmail instead.
49964718Seric
50065095SericDELL SVR4
50165095Seric	Date:      Mon, 06 Dec 1993 10:42:29 EST
50265095Seric	From: "Kimmo Suominen" <kim@grendel.lut.fi>
50365095Seric	Message-ID: <2d0352f9.lento29@lento29.UUCP>
50465095Seric	To: eric@cs.berkeley.edu
50565095Seric	Cc: sendmail@cs.berkeley.edu, "Kimmo Suominen" <kim@grendel.lut.fi>
50665095Seric	Subject:   Notes for DELL SVR4
50765095Seric
50865095Seric	Eric,
50965095Seric
51065095Seric	Here are some notes for compiling Sendmail 8.6.4 on DELL SVR4.  I ran
51165095Seric	across these things when helping out some people who contacted me by
51265095Seric	e-mail.
51365095Seric
51465095Seric	1) Use gcc 2.4.5 (or later?).  Dell distributes gcc 2.1 with their
51565095Seric	   Issue 2.2 Unix.  It is too old, and gives you problems with
51665095Seric	   clock.c, because sigset_t won't get defined in <sys/signal.h>.
51765095Seric	   This is due to a problematic protection rule in there, and is
51865095Seric	   fixed with gcc 2.4.5.
51965095Seric
52065095Seric	2) If you don't use the new Berkeley DB (-DNEWDB), then you need
52165095Seric	   to add "-lc -lucb" to the libraries to link with.  This is because
52265095Seric	   the -ldbm distributed by Dell needs the bcopy, bcmp and bzero
52365095Seric	   functions.  It is important that you specify both libraries in
52465095Seric	   the given order to be sure you only get the BSTRING functions
52565095Seric	   from the UCB library (and not the signal routines etc.).
52665095Seric
52765095Seric	3) Don't leave out "-lelf" even if compiling with "-lc -lucb".
52865095Seric	   The UCB library also has another copy of the nlist routines,
52965095Seric	   but we do want the ones from "-lelf".
53065095Seric
53165095Seric	If anyone needs a compiled gcc 2.4.5 and/or a ported DB library, they
53265095Seric	can use anonymous ftp to fetch them from lut.fi in the /kim directory.
53365095Seric	They are copies of what I use on grendel.lut.fi, and offering them
53465095Seric	does not imply that I would also support them.  I have sent the DB
53565095Seric	port for SVR4 back to Keith Bostic for inclusion in the official
53665095Seric	distribution, but I haven't heard anything from him as of today.
53765095Seric
53865095Seric	- gcc-2.4.5-svr4.tar.gz	(gcc 2.4.5 and the corresponding libg++)
53965095Seric	- db-1.72.tar.gz	(with source, objects and a installed copy)
54065095Seric
54165095Seric	Cheers
54265095Seric	+ Kim
54365095Seric	--
54465095Seric	 *  Kimmo.Suominen@lut.fi  *  SysVr4 enthusiast at GRENDEL.LUT.FI  *
54565095Seric	*    KIM@FINFILES.BITNET   *  Postmaster and Hostmaster at LUT.FI   *
54665095Seric	 *    + 358 200 865 718    *  Unix area moderator at NIC.FUNET.FI  *
54765095Seric
54865095Seric
54964718SericNon-DNS based sites
55064718Seric	This version of sendmail always tries to connect to the Domain
55164718Seric	Name System (DNS) to resolve names, regardless of the setting
55264718Seric	of the `I' option.  On most systems that are not running DNS,
55364718Seric	this will fail quickly and sendmail will continue, but on some
55464718Seric	systems it has a long timeout.  If you have this problem, you
55564718Seric	will have to recompile without NAMED_BIND.  Some people have
55664718Seric	claimed that they have successfully used "OI+USEVC" to force
55764718Seric	sendmail to use a virtual circuit -- this will always time out
55864718Seric	quickly, but also tells sendmail that a failed connection
55964718Seric	should requeue the message (probably not what you intended).
56064718Seric	A future release of sendmail will correct this problem.
56164718Seric
56264250SericBoth NEWDB and NDBM
56364250Seric	If you use both -DNDBM and -DNEWDB, you must delete the module
56464250Seric	ndbm.o from libdb.a and delete the file "ndbm.h" from the files
56564250Seric	that get installed (that is, use the OLD ndbm.h, not the new
56664250Seric	ndbm.h).  This compatibility module maps ndbm calls into DB
56764250Seric	calls, and breaks things rather badly.
56858709Seric
56964559SericGNU getopt
57064559Seric	I'm told that GNU getopt has a problem in that it gets confused
57164559Seric	by the double call.  Use the version in conf.c instead.
57264250Seric
57364559Seric
57464820Seric+--------------+
57564820Seric| MANUAL PAGES |
57664820Seric+--------------+
57764820Seric
57864820SericThe manual pages have been written against the -mandoc macros
57964820Sericinstead of the -man macros.  The latest version of groff has them
58064820Sericincluded.  You can also get a copy from FTP.UU.NET in directory
58164820Seric/systems/unix/bsd-sources/share/tmac.
58264820Seric
58364820Seric
58464035Seric+-----------------------------+
58564035Seric| DESCRIPTION OF SOURCE FILES |
58664035Seric+-----------------------------+
58764035Seric
5889881SericThe following list describes the files in this directory:
5895369Seric
59057418SericMakefile	The makefile used here; this version only works with
59157418Seric		the new Berkeley make.
59257418SericMakefile.dist	A trimmed down version of the makefile that works with
59357418Seric		the old make.
5945369SericREAD_ME		This file.
59560565SericTRACEFLAGS	My own personal list of the trace flags -- not guaranteed
59660565Seric		to be particularly up to date.
5975369Sericalias.c		Does name aliasing in all forms.
5989881Sericarpadate.c	A subroutine which creates ARPANET standard dates.
5999881Sericclock.c		Routines to implement real-time oriented functions
6009881Seric		in sendmail -- e.g., timeouts.
6015369Sericcollect.c	The routine that actually reads the mail into a temp
6025369Seric		file.  It also does a certain amount of parsing of
6035369Seric		the header, etc.
6045369Sericconf.c		The configuration file.  This contains information
6055369Seric		that is presumed to be quite static and non-
6065369Seric		controversial, or code compiled in for efficiency
6075369Seric		reasons.  Most of the configuration is in sendmail.cf.
6089881Sericconf.h		Configuration that must be known everywhere.
6095369Sericconvtime.c	A routine to sanely process times.
6109881Sericdaemon.c	Routines to implement daemon mode.  This version is
6119881Seric		specifically for Berkeley 4.1 IPC.
6125369Sericdeliver.c	Routines to deliver mail.
61360565Sericdomain.c	Routines that interface with DNS (the Domain Name
61460565Seric		System).
6155369Sericerr.c		Routines to print error messages.
6169881Sericenvelope.c	Routines to manipulate the envelope structure.
6175369Sericheaders.c	Routines to process message headers.
6185369Sericmacro.c		The macro expander.  This is used internally to
6195369Seric		insert information from the configuration file.
6205369Sericmain.c		The main routine to sendmail.  This file also
6215369Seric		contains some miscellaneous routines.
62260565Sericmap.c		Support for database maps.
62360565Sericmci.c		Routines that handle mail connection information caching.
6249881Sericparseaddr.c	The routines which do address parsing.
6255369Sericqueue.c		Routines to implement message queueing.
6265369Sericreadcf.c	The routine that reads the configuration file and
6275369Seric		translates it to internal form.
6289881Sericrecipient.c	Routines that manipulate the recipient list.
6295369Sericsavemail.c	Routines which save the letter on processing errors.
6305369Sericsendmail.h	Main header file for sendmail.
6315369Sericsrvrsmtp.c	Routines to implement server SMTP.
6325369Sericstab.c		Routines to manage the symbol table.
6335369Sericstats.c		Routines to collect and post the statistics.
6345369Sericsysexits.c	List of error messages associated with error codes
6355369Seric		in sysexits.h.
6369881Serictrace.c		The trace package.  These routines allow setting and
6379881Seric		testing of trace flags with a high granularity.
63860565Sericudb.c		The user database interface module.
6395369Sericusersmtp.c	Routines to implement user SMTP.
6405369Sericutil.c		Some general purpose routines used by sendmail.
64160565Sericversion.c	The version number and information about this
64260565Seric		version of sendmail.  Theoretically, this gets
64360565Seric		modified on every change.
6445369Seric
6455369SericEric Allman
6465369Seric
647*65108Seric(Version 8.35, last update 12/12/93 07:25:34)
648