xref: /freebsd/contrib/sendmail/src/README (revision 602a2b1b1d5877cb573baf0407540810a490b0cf)
1602a2b1bSGregory Neil Shapiro# Copyright (c) 1998-2001 Sendmail, Inc. and its suppliers.
206f25ae9SGregory Neil Shapiro#	All rights reserved.
3c2aa98e2SPeter Wemm# Copyright (c) 1983, 1995-1997 Eric P. Allman.  All rights reserved.
4c2aa98e2SPeter Wemm# Copyright (c) 1988
5c2aa98e2SPeter Wemm#	The Regents of the University of California.  All rights reserved.
6c2aa98e2SPeter Wemm#
7c2aa98e2SPeter Wemm# By using this file, you agree to the terms and conditions set
8c2aa98e2SPeter Wemm# forth in the LICENSE file which can be found at the top level of
9c2aa98e2SPeter Wemm# the sendmail distribution.
10c2aa98e2SPeter Wemm#
11c2aa98e2SPeter Wemm#
12602a2b1bSGregory Neil Shapiro#	$Id: README,v 8.263.2.1.2.32 2001/01/29 23:45:22 gshapiro Exp $
13c2aa98e2SPeter Wemm#
14c2aa98e2SPeter Wemm
15c2aa98e2SPeter WemmThis directory contains the source files for sendmail(TM).
16c2aa98e2SPeter Wemm
17c2aa98e2SPeter Wemm*********************
18c2aa98e2SPeter Wemm!! DO NOT USE MAKE !!  in this directory to compile sendmail --
19c2aa98e2SPeter Wemm*********************  instead, use the "Build" script located in
2006f25ae9SGregory Neil Shapirothe sendmail directory.  It will build an appropriate Makefile, and
21c2aa98e2SPeter Wemmcreate an appropriate obj.* subdirectory so that multiplatform
22c2aa98e2SPeter Wemmsupport works easily.
23c2aa98e2SPeter Wemm
24c2aa98e2SPeter Wemm	**********************************************************
25c2aa98e2SPeter Wemm	**  Read below for more details on building sendmail.	**
26c2aa98e2SPeter Wemm	**********************************************************
27c2aa98e2SPeter Wemm
28c2aa98e2SPeter Wemm**************************************************************************
29c2aa98e2SPeter Wemm**  IMPORTANT:  Read the appropriate paragraphs in the section on	**
30c2aa98e2SPeter Wemm**  ``Operating System and Compile Quirks''.				**
31c2aa98e2SPeter Wemm**************************************************************************
32c2aa98e2SPeter Wemm
33c2aa98e2SPeter WemmFor detailed instructions, please read the document ../doc/op/op.me:
34c2aa98e2SPeter Wemm
35c2aa98e2SPeter Wemm	eqn ../doc/op/op.me | pic | ditroff -me
36c2aa98e2SPeter Wemm
37c2aa98e2SPeter WemmSendmail is a trademark of Sendmail, Inc.
38c2aa98e2SPeter Wemm
39c2aa98e2SPeter Wemm
40c2aa98e2SPeter Wemm+-------------------+
41c2aa98e2SPeter Wemm| BUILDING SENDMAIL |
42c2aa98e2SPeter Wemm+-------------------+
43c2aa98e2SPeter Wemm
44c2aa98e2SPeter WemmBy far, the easiest way to compile sendmail is to use the "Build"
45c2aa98e2SPeter Wemmscript:
46c2aa98e2SPeter Wemm
47c2aa98e2SPeter Wemm	sh Build
48c2aa98e2SPeter Wemm
49c2aa98e2SPeter WemmThis uses the "uname" command to figure out what architecture you are
50c2aa98e2SPeter Wemmon and creates a proper Makefile accordingly.  It also creates a
51c2aa98e2SPeter Wemmsubdirectory per object format, so that multiarchitecture support is
52c2aa98e2SPeter Wemmeasy.  In general this should be all you need.  IRIX 6.x users should
53c2aa98e2SPeter Wemmread the note below in the OPERATING SYSTEM AND COMPILE QUIRKS section.
54c2aa98e2SPeter Wemm
55c2aa98e2SPeter WemmIf you need to look at other include or library directories, use the
56c2aa98e2SPeter Wemm-I or -L flags on the command line, e.g.,
57c2aa98e2SPeter Wemm
58c2aa98e2SPeter Wemm	sh Build -I/usr/sww/include -L/usr/sww/lib
59c2aa98e2SPeter Wemm
60c2aa98e2SPeter WemmIt's also possible to create local site configuration in the file
61c2aa98e2SPeter Wemmsite.config.m4 (or another file settable with the -f flag).  This
62c2aa98e2SPeter Wemmfile contains M4 definitions for various compilation values; the
63c2aa98e2SPeter Wemmmost useful are:
64c2aa98e2SPeter Wemm
65c2aa98e2SPeter WemmconfMAPDEF	-D flags to specify database types to be included
66c2aa98e2SPeter Wemm		(see below)
67c2aa98e2SPeter WemmconfENVDEF	-D flags to specify other environment information
68c2aa98e2SPeter WemmconfINCDIRS	-I flags for finding include files during compilation
69c2aa98e2SPeter WemmconfLIBDIRS	-L flags for finding libraries during linking
70c2aa98e2SPeter WemmconfLIBS	-l flags for selecting libraries during linking
71c2aa98e2SPeter WemmconfLDOPTS	other ld(1) linker options
72c2aa98e2SPeter Wemm
73c2aa98e2SPeter WemmOthers can be found by examining Makefile.m4.  Please read
7406f25ae9SGregory Neil Shapiro../devtools/README for more information about the site.config.m4
75c2aa98e2SPeter Wemmfile.
76c2aa98e2SPeter Wemm
77c2aa98e2SPeter WemmYou can recompile from scratch using the -c flag with the Build
78c2aa98e2SPeter Wemmcommand.  This removes the existing compilation directory for the
79c2aa98e2SPeter Wemmcurrent platform and builds a new one.
80c2aa98e2SPeter Wemm
81c2aa98e2SPeter WemmPorting to a new Unix-based system should be a matter of creating
8206f25ae9SGregory Neil Shapiroan appropriate configuration file in the devtools/OS/ directory.
83c2aa98e2SPeter Wemm
84c2aa98e2SPeter Wemm
85c2aa98e2SPeter Wemm
86c2aa98e2SPeter Wemm+----------------------+
87c2aa98e2SPeter Wemm| DATABASE DEFINITIONS |
88c2aa98e2SPeter Wemm+----------------------+
89c2aa98e2SPeter Wemm
90c2aa98e2SPeter WemmThere are several database formats that can be used for the alias files
91c2aa98e2SPeter Wemmand for general maps.  When used for alias files they interact in an
92c2aa98e2SPeter Wemmattempt to be backward compatible.
93c2aa98e2SPeter Wemm
94c2aa98e2SPeter WemmThe options are:
95c2aa98e2SPeter Wemm
96c2aa98e2SPeter WemmNEWDB		The new Berkeley DB package.  Some systems (e.g., BSD/OS and
97c2aa98e2SPeter Wemm		Digital UNIX 4.0) have some version of this package
98c2aa98e2SPeter Wemm		pre-installed.  If your system does not have Berkeley DB
99c2aa98e2SPeter Wemm		pre-installed, or the version installed is not version 2.0
100c2aa98e2SPeter Wemm		or greater (e.g., is Berkeley DB 1.85 or 1.86), get the
101c2aa98e2SPeter Wemm		current version from http://www.sleepycat.com/.  DO NOT
102c2aa98e2SPeter Wemm		use a version from any of the University of California,
103c2aa98e2SPeter Wemm		Berkeley "Net" or other distributions.  If you are still
104c2aa98e2SPeter Wemm		running BSD/386 1.x, you will need to upgrade the included
105c2aa98e2SPeter Wemm		Berkeley DB library to a current version.  NEWDB is included
106c2aa98e2SPeter Wemm		automatically if the Build script can find a library named
10706f25ae9SGregory Neil Shapiro		libdb.a or libdb.so.
108c2aa98e2SPeter WemmNDBM		The older NDBM implementation -- the very old V7 DBM
109c2aa98e2SPeter Wemm		implementation is no longer supported.
110c2aa98e2SPeter WemmNIS		Network Information Services.  To use this you must have
111c2aa98e2SPeter Wemm		NIS support on your system.
112c2aa98e2SPeter WemmNISPLUS		NIS+ (the revised NIS released with Solaris 2).  You must
113c2aa98e2SPeter Wemm		have NIS+ support on your system to use this flag.
114c2aa98e2SPeter WemmHESIOD		Support for Hesiod (from the DEC/Athena distribution).  You
115c2aa98e2SPeter Wemm		must already have Hesiod support on your system for this to
116c2aa98e2SPeter Wemm		work.  You may be able to get this to work with the MIT/Athena
117c2aa98e2SPeter Wemm		version of Hesiod, but that's likely to be a lot of work.
11806f25ae9SGregory Neil ShapiroLDAPMAP		Lightweight Directory Access Protocol support.  You will
11906f25ae9SGregory Neil Shapiro		have to install the UMich or OpenLDAP
12006f25ae9SGregory Neil Shapiro		(http://www.openldap.org/) ldap and lber libraries to use
12106f25ae9SGregory Neil Shapiro		this flag.
122c2aa98e2SPeter WemmMAP_REGEX	Regular Expression support.  You will need to use an
123c2aa98e2SPeter Wemm		operating system which comes with the POSIX regex()
124c2aa98e2SPeter Wemm		routines or install a regexp library such as libregex from
125c2aa98e2SPeter Wemm		the Free Software Foundation.
12606f25ae9SGregory Neil ShapiroPH_MAP		PH map support.  You will need the qi PH package.
12706f25ae9SGregory Neil ShapiroMAP_NSD		nsd map support (IRIX 6.5 and later).
128c2aa98e2SPeter Wemm
129c2aa98e2SPeter Wemm>>>  NOTE WELL for NEWDB support: If you want to get ndbm support, for
130c2aa98e2SPeter Wemm>>>  Berkeley DB versions under 2.0, it is CRITICAL that you remove
131c2aa98e2SPeter Wemm>>>  ndbm.o from libdb.a before you install it and DO NOT install ndbm.h;
132c2aa98e2SPeter Wemm>>>  for Berkeley DB versions 2.0 through 2.3.14, remove dbm.o from libdb.a
133c2aa98e2SPeter Wemm>>>  before you install it.  If you don't delete these, there is absolutely
134c2aa98e2SPeter Wemm>>>  no point to including -DNDBM, since it will just get you another
135c2aa98e2SPeter Wemm>>>  (inferior) API to the same format database.  These files OVERRIDE
136c2aa98e2SPeter Wemm>>>  calls to ndbm routines -- in particular, if you leave ndbm.h in,
137c2aa98e2SPeter Wemm>>>  you can find yourself using the new db package even if you don't
138c2aa98e2SPeter Wemm>>>  define NEWDB.  Berkeley DB versions later than 2.3.14 do not need
139c2aa98e2SPeter Wemm>>>  to be modified.  Please also consult the README in the top level
140c2aa98e2SPeter Wemm>>>  directory of the sendmail distribution for other important information.
141c2aa98e2SPeter Wemm>>>
142c2aa98e2SPeter Wemm>>>  Further note: DO NOT remove your existing /usr/include/ndbm.h --
143c2aa98e2SPeter Wemm>>>  you need that one.  But do not install an updated ndbm.h in
144c2aa98e2SPeter Wemm>>>  /usr/include, /usr/local/include, or anywhere else.
145c2aa98e2SPeter Wemm
146c2aa98e2SPeter WemmIf NEWDB and NDBM are defined (but not NIS), then sendmail will read
147c2aa98e2SPeter WemmNDBM format alias files, but the next time a newaliases is run the
148c2aa98e2SPeter Wemmformat will be converted to NEWDB; that format will be used forever
149c2aa98e2SPeter Wemmmore.  This is intended as a transition feature.
150c2aa98e2SPeter Wemm
151c2aa98e2SPeter WemmIf NEWDB, NDBM, and NIS are all defined and the name of the file includes
152c2aa98e2SPeter Wemmthe string "/yp/", sendmail will rebuild BOTH the NEWDB and NDBM format
153c2aa98e2SPeter Wemmalias files.  However, it will only read the NEWDB file; the NDBM format
154c2aa98e2SPeter Wemmfile is used only by the NIS subsystem.  This is needed because the NIS
155c2aa98e2SPeter Wemmmaps on an NIS server are built directly from the NDBM files.
156c2aa98e2SPeter Wemm
157c2aa98e2SPeter WemmIf NDBM and NIS are defined (regardless of the definition of NEWDB),
158c2aa98e2SPeter Wemmand the filename includes the string "/yp/", sendmail adds the special
159c2aa98e2SPeter Wemmtokens "YP_LAST_MODIFIED" and "YP_MASTER_NAME", both of which are
160c2aa98e2SPeter Wemmrequired if the NDBM file is to be used as an NIS map.
161c2aa98e2SPeter Wemm
162c2aa98e2SPeter WemmAll of these flags are normally defined in the DBMDEF line in the
163c2aa98e2SPeter WemmMakefile.
164c2aa98e2SPeter Wemm
165c2aa98e2SPeter WemmIf you define NEWDB or HESIOD you get the User Database (USERDB)
166c2aa98e2SPeter Wemmautomatically.  Generally you do want to have NEWDB for it to do
167c2aa98e2SPeter Wemmanything interesting.  See above for getting the Berkeley DB
168c2aa98e2SPeter Wemmpackage (i.e., NEWDB).  There is no separate "user database"
169c2aa98e2SPeter Wemmpackage -- don't bother searching for it on the net.
170c2aa98e2SPeter Wemm
171c2aa98e2SPeter WemmHesiod and LDAP require libraries that may not be installed with your
172c2aa98e2SPeter Wemmsystem.  These are outside of my ability to provide support.  See the
173c2aa98e2SPeter Wemm"Quirks" section for more information.
174c2aa98e2SPeter Wemm
175c2aa98e2SPeter WemmThe regex map can be used to see if an address matches a certain regular
176c2aa98e2SPeter Wemmexpression.  For example, all-numerics local parts are common spam
177c2aa98e2SPeter Wemmaddresses, so "^[0-9]+$" would match this.  By using such a map in a
178c2aa98e2SPeter Wemmcheck_* rule-set, you can block a certain range of addresses that would
179c2aa98e2SPeter Wemmotherwise be considered valid.
180c2aa98e2SPeter Wemm
181c2aa98e2SPeter Wemm+---------------+
182c2aa98e2SPeter Wemm| COMPILE FLAGS |
183c2aa98e2SPeter Wemm+---------------+
184c2aa98e2SPeter Wemm
185c2aa98e2SPeter WemmWherever possible, I try to make sendmail pull in the correct
186c2aa98e2SPeter Wemmcompilation options needed to compile on various environments based on
187c2aa98e2SPeter Wemmautomatically defined symbols.  Some machines don't seem to have useful
188c2aa98e2SPeter Wemmsymbols available, requiring that a compilation flag be defined in
18906f25ae9SGregory Neil Shapirothe Makefile; see the devtools/OS subdirectory for the supported
190c2aa98e2SPeter Wemmarchitectures.
191c2aa98e2SPeter Wemm
192c2aa98e2SPeter WemmIf you are a system to which sendmail has already been ported you
193c2aa98e2SPeter Wemmshould not have to touch the following symbols.  But if you are porting,
194c2aa98e2SPeter Wemmyou may have to tweak the following compilation flags in conf.h in order
195c2aa98e2SPeter Wemmto get it to compile and link properly:
196c2aa98e2SPeter Wemm
197c2aa98e2SPeter WemmSYSTEM5		Adjust for System V (not necessarily Release 4).
198c2aa98e2SPeter WemmSYS5SIGNALS	Use System V signal semantics -- the signal handler
199c2aa98e2SPeter Wemm		is automatically dropped when the signal is caught.
200c2aa98e2SPeter Wemm		If this is not set, use POSIX/BSD semantics, where the
201c2aa98e2SPeter Wemm		signal handler stays in force until an exec or an
202c2aa98e2SPeter Wemm		explicit delete.  Implied by SYSTEM5.
203c2aa98e2SPeter WemmSYS5SETPGRP	Use System V setpgrp() semantics.  Implied by SYSTEM5.
204c2aa98e2SPeter WemmHASFCHMOD	Define this to one if you have the fchmod(2) system call.
205c2aa98e2SPeter Wemm		This improves security.
20606f25ae9SGregory Neil ShapiroHASFCHOWN	Define this to one if you have the fchown(2) system call.
20706f25ae9SGregory Neil Shapiro		This is required for the TrustedUser option.
208c2aa98e2SPeter WemmHASFLOCK	Set this if you prefer to use the flock(2) system call
209c2aa98e2SPeter Wemm		rather than using fcntl-based locking.  Fcntl locking
210c2aa98e2SPeter Wemm		has some semantic gotchas, but many vendor systems
211c2aa98e2SPeter Wemm		also interface it to lockd(8) to do NFS-style locking.
212c2aa98e2SPeter Wemm		Unfortunately, may vendors implementations of fcntl locking
213c2aa98e2SPeter Wemm		is just plain broken (e.g., locks are never released,
214c2aa98e2SPeter Wemm		causing your sendmail to deadlock; when the kernel runs
215c2aa98e2SPeter Wemm		out of locks your system crashes).  For this reason, I
216c2aa98e2SPeter Wemm		recommend always defining this unless you are absolutely
217c2aa98e2SPeter Wemm		certain that your fcntl locking implementation really works.
218c2aa98e2SPeter WemmHASUNAME	Set if you have the "uname" system call.  Implied by
219c2aa98e2SPeter Wemm		SYSTEM5.
220c2aa98e2SPeter WemmHASUNSETENV	Define this if your system library has the "unsetenv"
221c2aa98e2SPeter Wemm		subroutine.
222c2aa98e2SPeter WemmHASSETSID	Define this if you have the setsid(2) system call.  This
223c2aa98e2SPeter Wemm		is implied if your system appears to be POSIX compliant.
224c2aa98e2SPeter WemmHASINITGROUPS	Define this if you have the initgroups(3) routine.
225c2aa98e2SPeter WemmHASSETVBUF	Define this if you have the setvbuf(3) library call.
226c2aa98e2SPeter Wemm		If you don't, setlinebuf will be used instead.  This
227c2aa98e2SPeter Wemm		defaults on if your compiler defines __STDC__.
228c2aa98e2SPeter WemmHASSETREUID	Define this if you have setreuid(2) ***AND*** root can
229c2aa98e2SPeter Wemm		use setreuid to change to an arbitrary user.  This second
230c2aa98e2SPeter Wemm		condition is not satisfied on AIX 3.x.  You may find that
231c2aa98e2SPeter Wemm		your system has setresuid(2), (for example, on HP-UX) in
232c2aa98e2SPeter Wemm		which case you will also have to #define setreuid(r, e)
233c2aa98e2SPeter Wemm		to be the appropriate call.  Some systems (such as Solaris)
234c2aa98e2SPeter Wemm		have a compatibility routine that doesn't work properly,
235c2aa98e2SPeter Wemm		but may have "saved user ids" properly implemented so you
236c2aa98e2SPeter Wemm		can ``#define setreuid(r, e) seteuid(e)'' and have it work.
237c2aa98e2SPeter Wemm		The important thing is that you have a call that will set
238c2aa98e2SPeter Wemm		the effective uid independently of the real or saved uid
239c2aa98e2SPeter Wemm		and be able to set the effective uid back again when done.
240c2aa98e2SPeter Wemm		There's a test program in ../test/t_setreuid.c that will
241c2aa98e2SPeter Wemm		try things on your system.  Setting this improves the
242c2aa98e2SPeter Wemm		security, since sendmail doesn't have to read .forward
243c2aa98e2SPeter Wemm		and :include: files as root.  There are certain attacks
244c2aa98e2SPeter Wemm		that may be unpreventable without this call.
245c2aa98e2SPeter WemmUSESETEUID	Define this to 1 if you have a seteuid(2) system call that
246c2aa98e2SPeter Wemm		will allow root to set only the effective user id to an
247c2aa98e2SPeter Wemm		arbitrary value ***AND*** you have saved user ids.  This is
248c2aa98e2SPeter Wemm		preferable to HASSETREUID if these conditions are fulfilled.
249c2aa98e2SPeter Wemm		These are the semantics of the to-be-released revision of
250c2aa98e2SPeter Wemm		Posix.1.  The test program ../test/t_seteuid.c will try
251c2aa98e2SPeter Wemm		this out on your system.  If you define both HASSETREUID
252c2aa98e2SPeter Wemm		and USESETEUID, the former is ignored.
253c2aa98e2SPeter WemmHASLSTAT	Define this if you have symbolic links (and thus the
254c2aa98e2SPeter Wemm		lstat(2) system call).  This improves security.  Unlike
255c2aa98e2SPeter Wemm		most other options, this one is on by default, so you
256c2aa98e2SPeter Wemm		need to #undef it in conf.h if you don't have symbolic
257c2aa98e2SPeter Wemm		links (these days everyone does).
258c2aa98e2SPeter WemmHASSETRLIMIT	Define this to 1 if you have the setrlimit(2) syscall.
259c2aa98e2SPeter Wemm		You can define it to 0 to force it off.  It is assumed
260c2aa98e2SPeter Wemm		if you are running a BSD-like system.
261c2aa98e2SPeter WemmHASULIMIT	Define this if you have the ulimit(2) syscall (System V
262c2aa98e2SPeter Wemm		style systems).  HASSETRLIMIT overrides, as it is more
263c2aa98e2SPeter Wemm		general.
264c2aa98e2SPeter WemmHASWAITPID	Define this if you have the waitpid(2) syscall.
265c2aa98e2SPeter WemmHASGETDTABLESIZE
266c2aa98e2SPeter Wemm		Define this if you have the getdtablesize(2) syscall.
267c2aa98e2SPeter WemmHAS_ST_GEN	Define this to 1 if your system has the st_gen field in
268c2aa98e2SPeter Wemm		the stat structure (see stat(2)).
26906f25ae9SGregory Neil ShapiroHASSRANDOMDEV	Define this if your system has the srandomdev(3) function
27006f25ae9SGregory Neil Shapiro		call.
27106f25ae9SGregory Neil ShapiroHASURANDOMDEV	Define this if your system has /dev/urandom(4).
27206f25ae9SGregory Neil ShapiroHASSTRERROR	Define this if you have the libc strerror(3) function (which
273c2aa98e2SPeter Wemm		should be declared in <errno.h>), and it should be used
274c2aa98e2SPeter Wemm		instead of sys_errlist.
275c2aa98e2SPeter WemmNEEDGETOPT	Define this if you need a reimplementation of getopt(3).
276c2aa98e2SPeter Wemm		On some systems, getopt does very odd things if called
277c2aa98e2SPeter Wemm		to scan the arguments twice.  This flag will ask sendmail
278c2aa98e2SPeter Wemm		to compile in a local version of getopt that works
279c2aa98e2SPeter Wemm		properly.
280c2aa98e2SPeter WemmNEEDSTRTOL	Define this if your standard C library does not define
281c2aa98e2SPeter Wemm		strtol(3).  This will compile in a local version.
282c2aa98e2SPeter WemmNEEDVPRINTF	Define this if your standard C library does not define
283c2aa98e2SPeter Wemm		vprintf(3).  Note that the resulting fake implementation
284c2aa98e2SPeter Wemm		is not very elegant and may not even work on some
285c2aa98e2SPeter Wemm		architectures.
286c2aa98e2SPeter WemmNEEDFSYNC	Define this if your standard C library does not define
287c2aa98e2SPeter Wemm		fsync(2).  This will try to simulate the operation using
288c2aa98e2SPeter Wemm		fcntl(2); if that is not available it does nothing, which
289c2aa98e2SPeter Wemm		isn't great, but at least it compiles and runs.
290c2aa98e2SPeter WemmHASGETUSERSHELL	Define this to 1 if you have getusershell(3) in your
291c2aa98e2SPeter Wemm		standard C library.  If this is not defined, or is defined
292c2aa98e2SPeter Wemm		to be 0, sendmail will scan the /etc/shells file (no
293c2aa98e2SPeter Wemm		NIS-style support, defaults to /bin/sh and /bin/csh if
294c2aa98e2SPeter Wemm		that file does not exist) to get a list of unrestricted
295c2aa98e2SPeter Wemm		user shells.  This is used to determine whether users
296c2aa98e2SPeter Wemm		are allowed to forward their mail to a program or a file.
297c2aa98e2SPeter WemmNEEDPUTENV	Define this if your system needs am emulation of the
298c2aa98e2SPeter Wemm		putenv(3) call.  Define to 1 to implement it in terms
299c2aa98e2SPeter Wemm		of setenv(3) or to 2 to do it in terms of primitives.
300c2aa98e2SPeter WemmNOFTRUNCATE	Define this if you don't have the ftruncate(2) syscall.
301c2aa98e2SPeter Wemm		If you don't have this system call, there is an unavoidable
302c2aa98e2SPeter Wemm		race condition that occurs when creating alias databases.
303c2aa98e2SPeter WemmGIDSET_T	The type of entries in a gidset passed as the second
304c2aa98e2SPeter Wemm		argument to getgroups(2).  Historically this has been an
305c2aa98e2SPeter Wemm		int, so this is the default, but some systems (such as
306c2aa98e2SPeter Wemm		IRIX) pass it as a gid_t, which is an unsigned short.
307c2aa98e2SPeter Wemm		This will make a difference, so it is important to get
308c2aa98e2SPeter Wemm		this right!  However, it is only an issue if you have
309c2aa98e2SPeter Wemm		group sets.
310c2aa98e2SPeter WemmSLEEP_T		The type returned by the system sleep() function.
311c2aa98e2SPeter Wemm		Defaults to "unsigned int".  Don't worry about this
312c2aa98e2SPeter Wemm		if you don't have compilation problems.
313c2aa98e2SPeter WemmARBPTR_T	The type of an arbitrary pointer -- defaults to "void *".
314c2aa98e2SPeter Wemm		If you are an very old compiler you may need to define
315c2aa98e2SPeter Wemm		this to be "char *".
316c2aa98e2SPeter WemmSOCKADDR_LEN_T	The type used for the third parameter to accept(2),
317c2aa98e2SPeter Wemm		getsockname(2), and getpeername(2), representing the
318c2aa98e2SPeter Wemm		length of a struct sockaddr.  Defaults to int.
319c2aa98e2SPeter WemmSOCKOPT_LEN_T	The type used for the fifth parameter to getsockopt(2)
320c2aa98e2SPeter Wemm		and setsockopt(2), representing the length of the option
321c2aa98e2SPeter Wemm		buffer.  Defaults to int.
322c2aa98e2SPeter WemmLA_TYPE		The type of load average your kernel supports.  These
323c2aa98e2SPeter Wemm		can be one of:
324c2aa98e2SPeter Wemm		 LA_ZERO (1) -- it always returns the load average as
325c2aa98e2SPeter Wemm			"zero" (and does so on all architectures).
326c2aa98e2SPeter Wemm		 LA_INT (2) to read /dev/kmem for the symbol avenrun and
327c2aa98e2SPeter Wemm			interpret as a long integer.
328c2aa98e2SPeter Wemm		 LA_FLOAT (3) same, but interpret the result as a floating
329c2aa98e2SPeter Wemm			point number.
330c2aa98e2SPeter Wemm		 LA_SHORT (6) to interpret as a short integer.
331c2aa98e2SPeter Wemm		 LA_SUBR (4) if you have the getloadavg(3) routine in your
332c2aa98e2SPeter Wemm			system library.
333c2aa98e2SPeter Wemm		 LA_MACH (5) to use MACH-style load averages (calls
334c2aa98e2SPeter Wemm			processor_set_info()),
335c2aa98e2SPeter Wemm		 LA_PROCSTR (7) to read /proc/loadavg and interpret it
336c2aa98e2SPeter Wemm			as a string representing a floating-point
337c2aa98e2SPeter Wemm			number (Linux-style).
338c2aa98e2SPeter Wemm		 LA_READKSYM (8) is an implementation suitable for some
339c2aa98e2SPeter Wemm			versions of SVr4 that uses the MIOC_READKSYM ioctl
340c2aa98e2SPeter Wemm			call to read /dev/kmem.
341c2aa98e2SPeter Wemm		 LA_DGUX (9) is a special implementation for DG/UX that uses
342c2aa98e2SPeter Wemm			the dg_sys_info system call.
343c2aa98e2SPeter Wemm		 LA_HPUX (10) is an HP-UX specific version that uses the
344c2aa98e2SPeter Wemm			pstat_getdynamic system call.
345c2aa98e2SPeter Wemm		 LA_IRIX6 (11) is an IRIX 6.x specific version that adapts
346c2aa98e2SPeter Wemm			to 32 or 64 bit kernels; it is otherwise very similar
347c2aa98e2SPeter Wemm			to LA_INT.
348c2aa98e2SPeter Wemm		 LA_KSTAT (12) uses the (Solaris-specific) kstat(3k)
349c2aa98e2SPeter Wemm			implementation.
350c2aa98e2SPeter Wemm		 LA_DEVSHORT (13) reads a short from a system file (default:
351c2aa98e2SPeter Wemm			/dev/table/avenrun) and scales it in the same manner
352c2aa98e2SPeter Wemm			as LA_SHORT.
353c2aa98e2SPeter Wemm		LA_INT, LA_SHORT, LA_FLOAT, and LA_READKSYM have several
354c2aa98e2SPeter Wemm		other parameters that they try to divine: the name of your
355c2aa98e2SPeter Wemm		kernel, the name of the variable in the kernel to examine,
356c2aa98e2SPeter Wemm		the number of bits of precision in a fixed point load average,
357c2aa98e2SPeter Wemm		and so forth.  LA_DEVSHORT uses _PATH_AVENRUN to find the
358c2aa98e2SPeter Wemm		device to be read to find the load average.
359c2aa98e2SPeter Wemm		In desperation, use LA_ZERO.  The actual code is in
360c2aa98e2SPeter Wemm		conf.c -- it can be tweaked if you are brave.
361c2aa98e2SPeter WemmFSHIFT		For LA_INT, LA_SHORT, and LA_READKSYM, this is the number
362c2aa98e2SPeter Wemm		of bits of load average after the binary point -- i.e.,
363c2aa98e2SPeter Wemm		the number of bits to shift right in order to scale the
364c2aa98e2SPeter Wemm		integer to get the true integer load average.  Defaults to 8.
365c2aa98e2SPeter Wemm_PATH_UNIX	The path to your kernel.  Needed only for LA_INT, LA_SHORT,
366c2aa98e2SPeter Wemm		and LA_FLOAT.  Defaults to "/unix" on System V, "/vmunix"
367c2aa98e2SPeter Wemm		everywhere else.
368c2aa98e2SPeter WemmLA_AVENRUN	For LA_INT, LA_SHORT, and LA_FLOAT, the name of the kernel
369c2aa98e2SPeter Wemm		variable that holds the load average.  Defaults to "avenrun"
370c2aa98e2SPeter Wemm		on System V, "_avenrun" everywhere else.
371c2aa98e2SPeter WemmSFS_TYPE	Encodes how your kernel can locate the amount of free
372c2aa98e2SPeter Wemm		space on a disk partition.  This can be set to SFS_NONE
373c2aa98e2SPeter Wemm		(0) if you have no way of getting this information,
374c2aa98e2SPeter Wemm		SFS_USTAT (1) if you have the ustat(2) system call,
375c2aa98e2SPeter Wemm		SFS_4ARGS (2) if you have a four-argument statfs(2)
376c2aa98e2SPeter Wemm		system call (and the include file is <sys/statfs.h>),
377c2aa98e2SPeter Wemm		SFS_VFS (3), SFS_MOUNT (4), SFS_STATFS (5) if you have
378c2aa98e2SPeter Wemm		the two-argument statfs(2) system call with includes in
379c2aa98e2SPeter Wemm		<sys/vfs.h>, <sys/mount.h>, or <sys/statfs.h> respectively,
380c2aa98e2SPeter Wemm		or SFS_STATVFS (6) if you have the two-argument statvfs(2)
381c2aa98e2SPeter Wemm		call.  The default if nothing is defined is SFS_NONE.
382c2aa98e2SPeter WemmSFS_BAVAIL	with SFS_4ARGS you can also set SFS_BAVAIL to the field name
383c2aa98e2SPeter Wemm		in the statfs structure that holds the useful information;
384c2aa98e2SPeter Wemm		this defaults to f_bavail.
385c2aa98e2SPeter WemmSPT_TYPE	Encodes how your system can display what a process is doing
386c2aa98e2SPeter Wemm		on a ps(1) command (SPT stands for Set Process Title).  Can
387c2aa98e2SPeter Wemm		be set to:
388c2aa98e2SPeter Wemm		SPT_NONE (0) -- Don't try to set the process title at all.
389c2aa98e2SPeter Wemm		SPT_REUSEARGV (1) -- Pad out your argv with the information;
390c2aa98e2SPeter Wemm			this is the default if none specified.
391c2aa98e2SPeter Wemm		SPT_BUILTIN (2) -- The system library has setproctitle.
392c2aa98e2SPeter Wemm		SPT_PSTAT (3) -- Use the PSTAT_SETCMD option to pstat(2)
393c2aa98e2SPeter Wemm			to set the process title; this is used by HP-UX.
394c2aa98e2SPeter Wemm		SPT_PSSTRINGS (4) -- Use the magic PS_STRINGS pointer (4.4BSD).
395c2aa98e2SPeter Wemm		SPT_SYSMIPS (5) -- Use sysmips() supported by NEWS-OS 6.
396c2aa98e2SPeter Wemm		SPT_SCO (6) -- Write kernel u. area.
397c2aa98e2SPeter Wemm		SPT_CHANGEARGV (7) -- Write pointers to our own strings into
398c2aa98e2SPeter Wemm			the existing argv vector.
399c2aa98e2SPeter WemmSPT_PADCHAR	Character used to pad the process title; if undefined,
400c2aa98e2SPeter Wemm		the space character (0x20) is used.  This is ignored if
401c2aa98e2SPeter Wemm		SPT_TYPE != SPT_REUSEARGV
402c2aa98e2SPeter WemmERRLIST_PREDEFINED
403c2aa98e2SPeter Wemm		If set, assumes that some header file defines sys_errlist.
404c2aa98e2SPeter Wemm		This may be needed if you get type conflicts on this
405c2aa98e2SPeter Wemm		variable -- otherwise don't worry about it.
406c2aa98e2SPeter WemmWAITUNION	The wait(2) routine takes a "union wait" argument instead
407c2aa98e2SPeter Wemm		of an integer argument.  This is for compatibility with
408c2aa98e2SPeter Wemm		old versions of BSD.
409c2aa98e2SPeter WemmSCANF		You can set this to extend the F command to accept a
410c2aa98e2SPeter Wemm		scanf string -- this gives you a primitive parser for
411c2aa98e2SPeter Wemm		class definitions -- BUT it can make you vulnerable to
412c2aa98e2SPeter Wemm		core dumps if the target file is poorly formed.
413c2aa98e2SPeter WemmSYSLOG_BUFSIZE	You can define this to be the size of the buffer that
414c2aa98e2SPeter Wemm		syslog accepts.  If it is not defined, it assumes a
415c2aa98e2SPeter Wemm		1024-byte buffer.  If the buffer is very small (under
416c2aa98e2SPeter Wemm		256 bytes) the log message format changes -- each
417c2aa98e2SPeter Wemm		e-mail message will log many more messages, since it
418c2aa98e2SPeter Wemm		will log each piece of information as a separate line
419c2aa98e2SPeter Wemm		in syslog.
420c2aa98e2SPeter WemmBROKEN_RES_SEARCH
421c2aa98e2SPeter Wemm		On Ultrix (and maybe other systems?) if you use the
422c2aa98e2SPeter Wemm		res_search routine with an unknown host name, it returns
423c2aa98e2SPeter Wemm		-1 but sets h_errno to 0 instead of HOST_NOT_FOUND.  If
424c2aa98e2SPeter Wemm		you set this, sendmail considers 0 to be the same as
425c2aa98e2SPeter Wemm		HOST_NOT_FOUND.
426c2aa98e2SPeter WemmNAMELISTMASK	If defined, values returned by nlist(3) are masked
427c2aa98e2SPeter Wemm		against this value before use -- a common value is
428c2aa98e2SPeter Wemm		0x7fffffff to strip off the top bit.
429c2aa98e2SPeter WemmBSD4_4_SOCKADDR	If defined, socket addresses have an sa_len field that
430c2aa98e2SPeter Wemm		defines the length of this address.
431c2aa98e2SPeter WemmSAFENFSPATHCONF	Set this to 1 if and only if you have verified that a
432c2aa98e2SPeter Wemm		pathconf(2) call with _PC_CHOWN_RESTRICTED argument on an
433c2aa98e2SPeter Wemm		NFS filesystem where the underlying system allows users to
434c2aa98e2SPeter Wemm		give away files to other users returns <= 0.  Be sure you
435c2aa98e2SPeter Wemm		try both on NFS V2 and V3.  Some systems assume that their
436c2aa98e2SPeter Wemm		local policy apply to NFS servers -- this is a bad
437c2aa98e2SPeter Wemm		assumption!  The test/t_pathconf.c program will try this
438c2aa98e2SPeter Wemm		for you -- you have to run it in a directory that is
439c2aa98e2SPeter Wemm		mounted from a server that allows file giveaway.
440c2aa98e2SPeter WemmSIOCGIFCONF_IS_BROKEN
441c2aa98e2SPeter Wemm		Set this if your system has an SIOCGIFCONF ioctl defined,
442c2aa98e2SPeter Wemm		but it doesn't behave the same way as "most" systems (BSD,
443c2aa98e2SPeter Wemm		Solaris, SunOS, HP-UX, etc.)
444c2aa98e2SPeter WemmSIOCGIFNUM_IS_BROKEN
445c2aa98e2SPeter Wemm		Set this if your system has an SIOCGIFNUM ioctl defined,
446c2aa98e2SPeter Wemm		but it doesn't behave the same way as "most" systems
447c2aa98e2SPeter Wemm		(Solaris, HP-UX).
448c2aa98e2SPeter WemmNEED_PERCENTQ	Set this if your system doesn't support the printf
449c2aa98e2SPeter Wemm		format strings %lld or %llu.  If this is set, %qd and
450c2aa98e2SPeter Wemm		%qu are used instead.
45106f25ae9SGregory Neil ShapiroFAST_PID_RECYCLE
45206f25ae9SGregory Neil Shapiro		Set this if your system can reuse the same PID in the same
45306f25ae9SGregory Neil Shapiro		second.
45406f25ae9SGregory Neil ShapiroSO_REUSEADDR_IS_BROKEN
45506f25ae9SGregory Neil Shapiro		Set this if your system has a setsockopt() SO_REUSEADDR
45606f25ae9SGregory Neil Shapiro		flag but doesn't pay attention to it when trying to bind a
45706f25ae9SGregory Neil Shapiro		socket to a recently closed port.
45806f25ae9SGregory Neil ShapiroSNPRINTF_IS_BROKEN
45906f25ae9SGregory Neil Shapiro		Set this if your system has an snprintf() implementation
46006f25ae9SGregory Neil Shapiro		which does not NUL terminate the string being filled in.
46106f25ae9SGregory Neil Shapiro		Use test/t_snprintf.c to test your system.
462c2aa98e2SPeter Wemm
463c2aa98e2SPeter Wemm+-----------------------+
464c2aa98e2SPeter Wemm| COMPILE-TIME FEATURES |
465c2aa98e2SPeter Wemm+-----------------------+
466c2aa98e2SPeter Wemm
467c2aa98e2SPeter WemmThere are a bunch of features that you can decide to compile in, such
468c2aa98e2SPeter Wemmas selecting various database packages and special protocol support.
469c2aa98e2SPeter WemmSeveral are assumed based on other compilation flags -- if you want to
470c2aa98e2SPeter Wemm"un-assume" something, you probably need to edit conf.h.  Compilation
471c2aa98e2SPeter Wemmflags that add support for special features include:
472c2aa98e2SPeter Wemm
473c2aa98e2SPeter WemmNDBM		Include support for "new" DBM library for aliases and maps.
474c2aa98e2SPeter Wemm		Normally defined in the Makefile.
475c2aa98e2SPeter WemmNEWDB		Include support for Berkeley DB package (hash & btree)
476c2aa98e2SPeter Wemm		for aliases and maps.  Normally defined in the Makefile.
477c2aa98e2SPeter Wemm		If the version of NEWDB you have is the old one that does
478c2aa98e2SPeter Wemm		not include the "fd" call (this call was added in version
479c2aa98e2SPeter Wemm		1.5 of the Berkeley DB code), you must upgrade to the
480c2aa98e2SPeter Wemm		current version of Berkeley DB.
481c2aa98e2SPeter WemmNIS		Define this to get NIS (YP) support for aliases and maps.
482c2aa98e2SPeter Wemm		Normally defined in the Makefile.
483c2aa98e2SPeter WemmNISPLUS		Define this to get NIS+ support for aliases and maps.
484c2aa98e2SPeter Wemm		Normally defined in the Makefile.
485c2aa98e2SPeter WemmHESIOD		Define this to get Hesiod support for aliases and maps.
486c2aa98e2SPeter Wemm		Normally defined in the Makefile.
487c2aa98e2SPeter WemmNETINFO		Define this to get NeXT NetInfo support for aliases and maps.
488c2aa98e2SPeter Wemm		Normally defined in the Makefile.
48906f25ae9SGregory Neil ShapiroLDAPMAP		Define this to get LDAP support for maps.
49006f25ae9SGregory Neil ShapiroPH_MAP		Define this to get PH support for maps.
49106f25ae9SGregory Neil ShapiroMAP_NSD		Define this to get nsd support for maps.
492c2aa98e2SPeter WemmUSERDB		Define this to 1 to include support for the User Information
493c2aa98e2SPeter Wemm		Database.  Implied by NEWDB or HESIOD.  You can use
494c2aa98e2SPeter Wemm		-DUSERDB=0 to explicitly turn it off.
495c2aa98e2SPeter WemmIDENTPROTO	Define this as 1 to get IDENT (RFC 1413) protocol support.
496c2aa98e2SPeter Wemm		This is assumed unless you are running on Ultrix or
497c2aa98e2SPeter Wemm		HP-UX, both of which have a problem in the UDP
498c2aa98e2SPeter Wemm		implementation.  You can define it to be 0 to explicitly
499c2aa98e2SPeter Wemm		turn off IDENT protocol support.  If defined off, the code
500c2aa98e2SPeter Wemm		is actually still compiled in, but it defaults off; you
50106f25ae9SGregory Neil Shapiro		can turn it on by setting the IDENT timeout in the
502c2aa98e2SPeter Wemm		configuration file.
503c2aa98e2SPeter WemmIP_SRCROUTE	Define this to 1 to get IP source routing information
504c2aa98e2SPeter Wemm		displayed in the Received: header.  This is assumed on
505c2aa98e2SPeter Wemm		most systems, but some (e.g., Ultrix) apparently have a
506c2aa98e2SPeter Wemm		broken version of getsockopt that doesn't properly
507c2aa98e2SPeter Wemm		support the IP_OPTIONS call.  You probably want this if
508c2aa98e2SPeter Wemm		your OS can cope with it.  Symptoms of failure will be that
509c2aa98e2SPeter Wemm		it won't compile properly (that is, no support for fetching
510c2aa98e2SPeter Wemm		IP_OPTIONs), or it compiles but source-routed TCP connections
511c2aa98e2SPeter Wemm		either refuse to open or open and hang for no apparent reason.
512c2aa98e2SPeter Wemm		Ultrix and AIX3 are known to fail this way.
513c2aa98e2SPeter WemmLOG		Set this to get syslog(3) support.  Defined by default
514c2aa98e2SPeter Wemm		in conf.h.  You want this if at all possible.
515c2aa98e2SPeter WemmNETINET		Set this to get TCP/IP support.  Defined by default
516c2aa98e2SPeter Wemm		in conf.h.  You probably want this.
51706f25ae9SGregory Neil ShapiroNETINET6	Set this to get IPv6 support.  Other configuration may
51806f25ae9SGregory Neil Shapiro		be needed in conf.h for your particular operating system.
51906f25ae9SGregory Neil Shapiro		Also, DaemonPortOptions must be set appropriately for
52006f25ae9SGregory Neil Shapiro		sendmail to accept IPv6 connections.
521c2aa98e2SPeter WemmNETISO		Define this to get ISO networking support.
522c2aa98e2SPeter WemmNETUNIX		Define this to get Unix domain networking support.  Defined
523c2aa98e2SPeter Wemm		by default.  A few bizarre systems (SCO, ISC, Altos) don't
524c2aa98e2SPeter Wemm		support this networking domain.
52506f25ae9SGregory Neil ShapiroNETNS		Define this to get NS networking support.
52606f25ae9SGregory Neil ShapiroNETX25		Define this to get X.25 networking support.
527c2aa98e2SPeter WemmSMTP		Define this to get the SMTP code.  Implied by NETINET
528c2aa98e2SPeter Wemm		or NETISO.
529c2aa98e2SPeter WemmNAMED_BIND	If non-zero, include DNS (name daemon) support, including
530c2aa98e2SPeter Wemm		MX support.  The specs say you must use this if you run
531c2aa98e2SPeter Wemm		SMTP.  You don't have to be running a name server daemon
532c2aa98e2SPeter Wemm		on your machine to need this -- any use of the DNS resolver,
533c2aa98e2SPeter Wemm		including remote access to another machine, requires this
534c2aa98e2SPeter Wemm		option.  Defined by default in conf.h.  Define it to zero
535c2aa98e2SPeter Wemm		ONLY on machines that do not use DNS in any way.
536c2aa98e2SPeter WemmQUEUE		Define this to get queueing code.  Implied by NETINET
537c2aa98e2SPeter Wemm		or NETISO; required by SMTP.  This gives you other good
538c2aa98e2SPeter Wemm		stuff -- it should be on.
539c2aa98e2SPeter WemmDAEMON		Define this to get general network support.  Implied by
540c2aa98e2SPeter Wemm		NETINET or NETISO.  Defined by default in conf.h.  You
541c2aa98e2SPeter Wemm		almost certainly want it on.
542c2aa98e2SPeter WemmMATCHGECOS	Permit fuzzy matching of user names against the full
543c2aa98e2SPeter Wemm		name (GECOS) field in the /etc/passwd file.  This should
544c2aa98e2SPeter Wemm		probably be on, since you can disable it from the config
545c2aa98e2SPeter Wemm		file if you want to.  Defined by default in conf.h.
546c2aa98e2SPeter WemmMIME8TO7	If non-zero, include 8 to 7 bit MIME conversions.  This
547c2aa98e2SPeter Wemm		also controls advertisement of 8BITMIME in the ESMTP
548c2aa98e2SPeter Wemm		startup dialogue.
549c2aa98e2SPeter WemmMIME7TO8	If non-zero, include 7 to 8 bit MIME conversions.
550c2aa98e2SPeter WemmHES_GETMAILHOST	Define this to 1 if you are using Hesiod with the
551c2aa98e2SPeter Wemm		hes_getmailhost() routine.  This is included with the MIT
552c2aa98e2SPeter Wemm		Hesiod distribution, but not with the DEC Hesiod distribution.
553c2aa98e2SPeter WemmXDEBUG		Do additional internal checking.  These don't cost too
554c2aa98e2SPeter Wemm		much; you might as well leave this on.
555c2aa98e2SPeter WemmTCPWRAPPERS	Turns on support for the TCP wrappers library (-lwrap).
556c2aa98e2SPeter Wemm		See below for further information.
557c2aa98e2SPeter WemmSECUREWARE	Enable calls to the SecureWare luid enabling/changing routines.
558c2aa98e2SPeter Wemm		SecureWare is a C2 security package added to several UNIX's
559c2aa98e2SPeter Wemm		(notably ConvexOS) to get a C2 Secure system.  This
560c2aa98e2SPeter Wemm		option causes mail delivery to be done with the luid of the
561c2aa98e2SPeter Wemm		recipient.
562c2aa98e2SPeter WemmSHARE_V1	Support for the fair share scheduler, version 1.  Setting to
563c2aa98e2SPeter Wemm		1 causes final delivery to be done using the recipients
564c2aa98e2SPeter Wemm		resource limitations.  So far as I know, this is only
565c2aa98e2SPeter Wemm		supported on ConvexOS.
56606f25ae9SGregory Neil ShapiroSASL		Enables SMTP AUTH (RFC 2554). This requires the Cyrus SASL
56706f25ae9SGregory Neil Shapiro		library (ftp://ftp.andrew.cmu.edu/pub/cyrus-mail/).  Please
56806f25ae9SGregory Neil Shapiro		install at least version 1.5.13.  See below for further
56906f25ae9SGregory Neil Shapiro		information: SASL COMPILATION AND CONFIGURATION.  If your
57006f25ae9SGregory Neil Shapiro		SASL library is older than 1.5.10, you have to set this
57106f25ae9SGregory Neil Shapiro		to its version number using a simple conversion:  a.b.c
57206f25ae9SGregory Neil Shapiro		-> c + b*100 + a*10000, e.g. for 1.5.9 define SASL=10509.
57306f25ae9SGregory Neil Shapiro		Note: Using an older version than 1.5.5 of Cyrus SASL is
57406f25ae9SGregory Neil Shapiro		not supported. Starting with version 1.5.10, setting SASL=1
57506f25ae9SGregory Neil Shapiro		is sufficient. Any value other than 1 (or 0) will be
57606f25ae9SGregory Neil Shapiro		compared with the actual version found and if there is a
57706f25ae9SGregory Neil Shapiro		mismatch, compilation will fail.
57806f25ae9SGregory Neil ShapiroEGD		Define this if your system has EGD installed, see
57906f25ae9SGregory Neil Shapiro		http://www.lothar.com/tech/crypto/ . It should be used to
58006f25ae9SGregory Neil Shapiro		seed the PRNG for STARTTLS if HASURANDOMDEV is not defined.
58106f25ae9SGregory Neil ShapiroSTARTTLS	Enables SMTP STARTTLS (RFC 2487). This requires OpenSSL
58206f25ae9SGregory Neil Shapiro		(http://www.OpenSSL.org/) and sfio (see below).
58342e5d165SGregory Neil Shapiro		Use OpenSSL 0.9.5a or later (if compatible with this
58442e5d165SGregory Neil Shapiro		version), do not use 0.9.3.
58506f25ae9SGregory Neil Shapiro		See STARTTLS COMPILATION AND CONFIGURATION for further
58606f25ae9SGregory Neil Shapiro		information.
58706f25ae9SGregory Neil ShapiroTLS_NO_RSA	Turn off support for RSA algorithms in STARTTLS.
58806f25ae9SGregory Neil ShapiroSFIO		Uses sfio instead of stdio. sfio is available from AT&T
58906f25ae9SGregory Neil Shapiro		(http://www.research.att.com/sw/tools/sfio/).  If this
59006f25ae9SGregory Neil Shapiro		compile flag is set, confSTDIO_TYPE must be set to portable.
59106f25ae9SGregory Neil Shapiro		This compile flag is necessary for STARTTLS; it also
59206f25ae9SGregory Neil Shapiro		enables the security layer of SASL.  The sfio include file
59306f25ae9SGregory Neil Shapiro		stdio.h must be installed in a subdirectory called sfio,
59406f25ae9SGregory Neil Shapiro		i.e., if you install sfio in /usr/local, stdio.h should
59506f25ae9SGregory Neil Shapiro		be in /usr/local/include/sfio, and libsfio.a should be in
596193538b7SGregory Neil Shapiro		/usr/local/lib.  Notice: read the sfio section in
597193538b7SGregory Neil Shapiro		OPERATING SYSTEM AND COMPILE QUIRKS.
598c2aa98e2SPeter Wemm
599c2aa98e2SPeter Wemm
600c2aa98e2SPeter Wemm+---------------------+
601c2aa98e2SPeter Wemm| DNS/RESOLVER ISSUES |
602c2aa98e2SPeter Wemm+---------------------+
603c2aa98e2SPeter Wemm
604c2aa98e2SPeter WemmMany systems have old versions of the resolver library.  At a minimum,
605c2aa98e2SPeter Wemmyou should be running BIND 4.8.3; older versions may compile, but they
606c2aa98e2SPeter Wemmhave known bugs that should give you pause.
607c2aa98e2SPeter Wemm
608c2aa98e2SPeter WemmCommon problems in old versions include "undefined" errors for
609c2aa98e2SPeter Wemmdn_skipname.
610c2aa98e2SPeter Wemm
611c2aa98e2SPeter WemmSome people have had a problem with BIND 4.9; it uses some routines
612c2aa98e2SPeter Wemmthat it expects to be externally defined such as strerror().  It may
613c2aa98e2SPeter Wemmhelp to link with "-l44bsd" to solve this problem.  This has apparently
614c2aa98e2SPeter Wemmbeen fixed in later versions of BIND, starting around 4.9.3.  In other
615c2aa98e2SPeter Wemmwords, if you use 4.9.0 through 4.9.2, you need -l44bsd; for earlier or
616c2aa98e2SPeter Wemmlater versions, you do not.
617c2aa98e2SPeter Wemm
618c2aa98e2SPeter Wemm!PLEASE! be sure to link with the same version of the resolver as
619c2aa98e2SPeter Wemmthe header files you used -- some people have used the 4.9 headers
620c2aa98e2SPeter Wemmand linked with BIND 4.8 or vice versa, and it doesn't work.
621c2aa98e2SPeter WemmUnfortunately, it doesn't fail in an obvious way -- things just
622c2aa98e2SPeter Wemmsubtly don't work.
623c2aa98e2SPeter Wemm
624c2aa98e2SPeter WemmWILDCARD MX RECORDS ARE A BAD IDEA!  The only situation in which they
625c2aa98e2SPeter Wemmwork reliably is if you have two versions of DNS, one in the real world
626c2aa98e2SPeter Wemmwhich has a wildcard pointing to your firewall, and a completely
627c2aa98e2SPeter Wemmdifferent version of the database internally that does not include
628c2aa98e2SPeter Wemmwildcard MX records that match your domain.  ANYTHING ELSE WILL GIVE
629c2aa98e2SPeter WemmYOU HEADACHES!
630c2aa98e2SPeter Wemm
631193538b7SGregory Neil ShapiroWhen attempting to canonify a hostname, some broken name servers will
632193538b7SGregory Neil Shapiroreturn SERVFAIL (a temporary failure) on T_AAAA (IPv6) lookups.  If you
633193538b7SGregory Neil Shapirowant to excuse this behavior, compile sendmail with
634602a2b1bSGregory Neil Shapiro-D_FFR_WORKAROUND_BROKEN_NAMESERVERS and add WorkAroundBrokenAAAA to your
635602a2b1bSGregory Neil ShapiroResolverOptions setting.  However, instead, we recommend catching the
636602a2b1bSGregory Neil Shapiroproblem and reporting it to the name server administrator so we can rid the
637602a2b1bSGregory Neil Shapiroworld of broken name servers.
638c2aa98e2SPeter Wemm
63906f25ae9SGregory Neil Shapiro+----------------------------------------+
64006f25ae9SGregory Neil Shapiro| STARTTLS COMPILATION AND CONFIGURATION |
64106f25ae9SGregory Neil Shapiro+----------------------------------------+
64206f25ae9SGregory Neil Shapiro
64306f25ae9SGregory Neil ShapiroPlease read the docs accompanying the OpenSSL library and sfio.
64406f25ae9SGregory Neil ShapiroYou have to compile and install both libraries before you can compile
64506f25ae9SGregory Neil Shapirosendmail.  See devtools/README how to set the correct compile time
64606f25ae9SGregory Neil Shapiroparameters; you should at least set the following variables:
64706f25ae9SGregory Neil Shapiro
64806f25ae9SGregory Neil Shapirodefine(`confSTDIO_TYPE', `portable')
64906f25ae9SGregory Neil ShapiroAPPENDDEF(`confENVDEF', `-DSFIO')
65006f25ae9SGregory Neil ShapiroAPPENDDEF(`confLIBS', `-lsfio')
65106f25ae9SGregory Neil ShapiroAPPENDDEF(`conf_sendmail_ENVDEF', `-DSTARTTLS')
65206f25ae9SGregory Neil ShapiroAPPENDDEF(`conf_sendmail_LIBS', `-lssl -lcrypto')
65306f25ae9SGregory Neil Shapiro
65406f25ae9SGregory Neil ShapiroConfiguration information can be found in doc/op/op.me (required
65506f25ae9SGregory Neil Shapirocertificates) and cf/README (how to tell sendmail about certificates).
65606f25ae9SGregory Neil Shapiro
65706f25ae9SGregory Neil ShapiroTo perform an initial test, connect to your sendmail daemon
65806f25ae9SGregory Neil Shapiro(telnet localhost 25) and issue a EHLO localhost and see whether
65906f25ae9SGregory Neil Shapiro250-STARTTLS
66006f25ae9SGregory Neil Shapirois in the response.  If it isn't, run the daemon with
66106f25ae9SGregory Neil Shapiro-O LogLevel=14
66206f25ae9SGregory Neil Shapiroand try again.  Then take a look at the logfile and see whether
66306f25ae9SGregory Neil Shapirothere are any problems listed about permissions (unsafe files)
66406f25ae9SGregory Neil Shapiroor the validity of X.509 certificates.
66506f25ae9SGregory Neil Shapiro
66606f25ae9SGregory Neil ShapiroNote: sfio must be used in all libraries with which sendmail exchanges
66706f25ae9SGregory Neil Shapirofile pointers. That is, libsmutil must be compiled with sfio, which
66806f25ae9SGregory Neil Shapirois accomplished by the above config parameters. Another example is
66906f25ae9SGregory Neil ShapiroPH map support.  This does not apply to the usual libraries, e.g.,
67006f25ae9SGregory Neil ShapiroOpenSSL, Berkeley DB, Cyrus SASL.
67106f25ae9SGregory Neil Shapiro
67206f25ae9SGregory Neil ShapiroFurther information can be found via:
67306f25ae9SGregory Neil Shapirohttp://www.sendmail.org/tips/
67406f25ae9SGregory Neil Shapiro
67506f25ae9SGregory Neil Shapiro
67606f25ae9SGregory Neil Shapiro+------------------------------------+
67706f25ae9SGregory Neil Shapiro| SASL COMPILATION AND CONFIGURATION |
67806f25ae9SGregory Neil Shapiro+------------------------------------+
67906f25ae9SGregory Neil Shapiro
68006f25ae9SGregory Neil ShapiroPlease read the docs accompanying the library (INSTALL and README).
68106f25ae9SGregory Neil ShapiroIf you use Berkeley DB for Cyrus SASL then you must compile sendmail
68206f25ae9SGregory Neil Shapirowith the same version of Berkeley DB.
68306f25ae9SGregory Neil Shapiro
68406f25ae9SGregory Neil ShapiroYou have to select and install authentication mechanisms and tell
68506f25ae9SGregory Neil Shapirosendmail where to find the sasl library and the include files (see
68606f25ae9SGregory Neil Shapirodevtools/README for the parameters to set). Setup the required
68706f25ae9SGregory Neil Shapirousers and passwords as explained in the SASL documentation.  See
68806f25ae9SGregory Neil Shapiroalso cf/README for authentication related options (esp. DefaultAuthInfo
68906f25ae9SGregory Neil Shapiroif you want authentication between MTAs).
69006f25ae9SGregory Neil Shapiro
69106f25ae9SGregory Neil ShapiroTo perform an initial test, connect to your sendmail daemon
69206f25ae9SGregory Neil Shapiro(telnet localhost 25) and issue a EHLO localhost and see whether
69306f25ae9SGregory Neil Shapiro250-AUTH ....
69406f25ae9SGregory Neil Shapirois in the response.  If it isn't, run the daemon with
69506f25ae9SGregory Neil Shapiro-O LogLevel=14
69606f25ae9SGregory Neil Shapiroand try again.  Then take a look at the logfile and see whether
69706f25ae9SGregory Neil Shapirothere are any security related problems listed (unsafe files).
69806f25ae9SGregory Neil Shapiro
69906f25ae9SGregory Neil ShapiroFurther information can be found via:
70006f25ae9SGregory Neil Shapirohttp://www.sendmail.org/tips/
70106f25ae9SGregory Neil Shapiro
70206f25ae9SGregory Neil Shapiro
703c2aa98e2SPeter Wemm+-------------------------------------+
704c2aa98e2SPeter Wemm| OPERATING SYSTEM AND COMPILE QUIRKS |
705c2aa98e2SPeter Wemm+-------------------------------------+
706c2aa98e2SPeter Wemm
707c2aa98e2SPeter WemmGCC problems
708c2aa98e2SPeter Wemm	*****************************************************************
709c2aa98e2SPeter Wemm	**  IMPORTANT:  DO NOT USE OPTIMIZATION (``-O'') IF YOU ARE    **
710c2aa98e2SPeter Wemm	**  RUNNING GCC 2.4.x or 2.5.x.  THERE IS A BUG IN THE GCC     **
711c2aa98e2SPeter Wemm	**  OPTIMIZER THAT CAUSES SENDMAIL COMPILES TO FAIL MISERABLY. **
712c2aa98e2SPeter Wemm	*****************************************************************
713c2aa98e2SPeter Wemm
714c2aa98e2SPeter Wemm	Jim Wilson of Cygnus believes he has found the problem -- it will
715c2aa98e2SPeter Wemm	probably be fixed in GCC 2.5.6 -- but until this is verified, be
716c2aa98e2SPeter Wemm	very suspicious of gcc -O.  This problem is reported to have been
717c2aa98e2SPeter Wemm	fixed in gcc 2.6.
718c2aa98e2SPeter Wemm
719c2aa98e2SPeter Wemm	A bug in gcc 2.5.5 caused problems compiling sendmail 8.6.5 with
720c2aa98e2SPeter Wemm	optimization on a Sparc.  If you are using gcc 2.5.5, youi should
721c2aa98e2SPeter Wemm	upgrade to the latest version of gcc.
722c2aa98e2SPeter Wemm
723c2aa98e2SPeter Wemm	Apparently GCC 2.7.0 on the Pentium processor has optimization
724c2aa98e2SPeter Wemm	problems.  I recommend against using -O on that architecture.  This
725c2aa98e2SPeter Wemm	has been seen on FreeBSD 2.0.5 RELEASE.
726c2aa98e2SPeter Wemm
727c2aa98e2SPeter Wemm	Solaris 2.X users should use version 2.7.2.3 over 2.7.2.
728c2aa98e2SPeter Wemm
729c2aa98e2SPeter Wemm	We have been told there are problems with gcc 2.8.0.  If you are
730c2aa98e2SPeter Wemm	using this version, you should upgrade to 2.8.1 or later.
731c2aa98e2SPeter Wemm
732c2aa98e2SPeter WemmGDBM	GDBM does not work with sendmail 8.8 because the additional
733c2aa98e2SPeter Wemm	security checks and file locking cause problems.  Unfortunately,
734c2aa98e2SPeter Wemm	gdbm does not provide a compile flag in its version of ndbm.h so
735c2aa98e2SPeter Wemm	the code can adapt.  Until the GDBM authors can fix these problems,
736c2aa98e2SPeter Wemm	GDBM will not be supported.  Please use Berkeley DB instead.
737c2aa98e2SPeter Wemm
738c2aa98e2SPeter WemmConfiguration file location
739c2aa98e2SPeter Wemm	Up to 8.6, sendmail tried to find the sendmail.cf file in the same
740c2aa98e2SPeter Wemm	place as the vendors had put it, even when this was obviously
741c2aa98e2SPeter Wemm	stupid.  As of 8.7, sendmail ALWAYS looks for /etc/sendmail.cf.
74206f25ae9SGregory Neil Shapiro	Beginning with 8.10, sendmail uses /etc/mail/sendmail.cf.
743c2aa98e2SPeter Wemm	You can get sendmail to use the stupid vendor .cf location by
744c2aa98e2SPeter Wemm	adding -DUSE_VENDOR_CF_PATH during compilation, but this may break
745c2aa98e2SPeter Wemm	support programs and scripts that need to find sendmail.cf.  You
746c2aa98e2SPeter Wemm	are STRONGLY urged to use symbolic links if you want to use the
747c2aa98e2SPeter Wemm	vendor location rather than changing the location in the sendmail
748c2aa98e2SPeter Wemm	binary.
749c2aa98e2SPeter Wemm
75006f25ae9SGregory Neil Shapiro	NETINFO systems use NETINFO to determine the location of
75106f25ae9SGregory Neil Shapiro	sendmail.cf. The full path to sendmail.cf is stored as the value of
75206f25ae9SGregory Neil Shapiro	the "sendmail.cf" property in the "/locations/sendmail"
75306f25ae9SGregory Neil Shapiro	subdirectory of NETINFO. Set the value of this property to
75406f25ae9SGregory Neil Shapiro	"/etc/mail/sendmail.cf" (without the quotes) to use this new
75506f25ae9SGregory Neil Shapiro	default location for Sendmail 8.10.0 and higher.
75606f25ae9SGregory Neil Shapiro
75706f25ae9SGregory Neil ShapiroControlSocket permissions
75806f25ae9SGregory Neil Shapiro	Paraphrased from BIND 8.2.1's README:
75906f25ae9SGregory Neil Shapiro
76006f25ae9SGregory Neil Shapiro	Solaris and other pre-4.4BSD kernels do not respect ownership or
76106f25ae9SGregory Neil Shapiro	protections on UNIX-domain sockets.  The short term fix for this is to
76206f25ae9SGregory Neil Shapiro	override the default path and put such control sockets into root-
76306f25ae9SGregory Neil Shapiro	owned directories which do not permit non-root to r/w/x through them.
76406f25ae9SGregory Neil Shapiro	The long term fix is for all kernels to upgrade to 4.4BSD semantics.
76506f25ae9SGregory Neil Shapiro
766c2aa98e2SPeter WemmSunOS 4.x (Solaris 1.x)
767c2aa98e2SPeter Wemm	You may have to use -lresolv on SunOS.  However, beware that
768c2aa98e2SPeter Wemm	this links in a new version of gethostbyname that does not
769c2aa98e2SPeter Wemm	understand NIS, so you must have all of your hosts in DNS.
770c2aa98e2SPeter Wemm
771c2aa98e2SPeter Wemm	Some people have reported problems with the SunOS version of
772c2aa98e2SPeter Wemm	-lresolv and/or in.named, and suggest that you get a newer
773c2aa98e2SPeter Wemm	version.  The symptoms are delays when you connect to the
774c2aa98e2SPeter Wemm	SMTP server on a SunOS machine or having your domain added to
775c2aa98e2SPeter Wemm	addresses inappropriately.  There is a version of BIND
776c2aa98e2SPeter Wemm	version 4.9 on gatekeeper.DEC.COM in pub/BSD/bind/4.9.
777c2aa98e2SPeter Wemm
778c2aa98e2SPeter Wemm	There is substantial disagreement about whether you can make
779c2aa98e2SPeter Wemm	this work with resolv+, which allows you to specify a search-path
780c2aa98e2SPeter Wemm	of services.  Some people report that it works fine, others
781c2aa98e2SPeter Wemm	claim it doesn't work at all (including causing sendmail to
782c2aa98e2SPeter Wemm	drop core when it tries to do multiple resolv+ lookups for a
783c2aa98e2SPeter Wemm	single job).  I haven't tried resolv+, as we use DNS exclusively.
784c2aa98e2SPeter Wemm
785c2aa98e2SPeter Wemm	Should you want to try resolv+, it is on ftp.uu.net in
786c2aa98e2SPeter Wemm	/networking/ip/dns.
787c2aa98e2SPeter Wemm
788c2aa98e2SPeter Wemm	Apparently getservbyname() can fail under moderate to high
789c2aa98e2SPeter Wemm	load under some circumstances.  This will exhibit itself as
790c2aa98e2SPeter Wemm	the message ``554 makeconnection: service "smtp" unknown''.
791c2aa98e2SPeter Wemm	The problem has been traced to one or more blank lines in
792c2aa98e2SPeter Wemm	/etc/services on the NIS server machine.  Delete these
793c2aa98e2SPeter Wemm	and it should work.  This info is thanks to Brian Bartholomew
794c2aa98e2SPeter Wemm	<bb@math.ufl.edu> of I-Kinetics, Inc.
795c2aa98e2SPeter Wemm
79606f25ae9SGregory Neil Shapiro	NOTE: The SunOS 4.X linker uses library paths specified during
79706f25ae9SGregory Neil Shapiro	compilation using -L for run-time shared library searches.
79806f25ae9SGregory Neil Shapiro	Therefore, it is vital that relative and unsafe directory paths not
79906f25ae9SGregory Neil Shapiro	be used when compiling sendmail.
80006f25ae9SGregory Neil Shapiro
801c2aa98e2SPeter WemmSunOS 4.0.2 (Sun 386i)
802c2aa98e2SPeter Wemm	Date: Fri, 25 Aug 1995 11:13:58 +0200 (MET DST)
803c2aa98e2SPeter Wemm	From: teus@oce.nl
804c2aa98e2SPeter Wemm
805c2aa98e2SPeter Wemm	Sendmail 8.7.Beta.12 compiles and runs nearly out of the box with the
806c2aa98e2SPeter Wemm	following changes:
807c2aa98e2SPeter Wemm	* Don't use /usr/5bin in your PATH, but make /usr/5bin/uname
808c2aa98e2SPeter Wemm	  available as "uname" command.
809c2aa98e2SPeter Wemm	* Use the defines "-DBSD4_3 -DNAMED_BIND=0" in
81006f25ae9SGregory Neil Shapiro	  devtools/OS/SunOS.4.0, which is selected via the "uname" command.
811c2aa98e2SPeter Wemm	I recommend to make available the db-library on the system first
812c2aa98e2SPeter Wemm	(and change the Makefile to use this library).
813c2aa98e2SPeter Wemm	Note that the sendmail.cf and aliases files are found in /etc.
814c2aa98e2SPeter Wemm
815c2aa98e2SPeter WemmSunOS 4.1.3, 4.1.3_U1
816c2aa98e2SPeter Wemm	Sendmail causes crashes on SunOS 4.1.3 and 4.1.3_U1.  According
817c2aa98e2SPeter Wemm	to Sun bug number 1077939:
818c2aa98e2SPeter Wemm
819c2aa98e2SPeter Wemm	If an application does a getsockopt() on a SOCK_STREAM (TCP) socket
820c2aa98e2SPeter Wemm	after the other side of the connection has sent a TCP RESET for
821c2aa98e2SPeter Wemm	the stream, the kernel gets a Bus Trap in the tcp_ctloutput() or
822c2aa98e2SPeter Wemm	ip_ctloutput() routine.
823c2aa98e2SPeter Wemm
824c2aa98e2SPeter Wemm	For 4.1.3, this is fixed in patch 100584-08, available on the
825c2aa98e2SPeter Wemm	Sunsolve 2.7.1 or later CDs.  For 4.1.3_U1, this was fixed in patch
826c2aa98e2SPeter Wemm	101790-01 (SunOS 4.1.3_U1: TCP socket and reset problems), later
827c2aa98e2SPeter Wemm	obsoleted by patch 102010-05.
828c2aa98e2SPeter Wemm
829c2aa98e2SPeter Wemm	Sun patch 100584-08 is not currently publicly available on their
830c2aa98e2SPeter Wemm	ftp site but a user has reported it can be found at other sites
831c2aa98e2SPeter Wemm	using a web search engine.
832c2aa98e2SPeter Wemm
833c2aa98e2SPeter WemmSolaris 2.x (SunOS 5.x)
834c2aa98e2SPeter Wemm	To compile for Solaris, the Makefile built by Build must
835c2aa98e2SPeter Wemm	include a SOLARIS definition which reflects the Solaris version
836c2aa98e2SPeter Wemm	(i.e. -DSOLARIS=20400 for 2.4 or -DSOLARIS=20501 for 2.5.1).
837c2aa98e2SPeter Wemm	If you are using gcc, make sure -I/usr/include is not used (or
838c2aa98e2SPeter Wemm	it might complain about TopFrame).  If you are using Sun's cc,
839c2aa98e2SPeter Wemm	make sure /opt/SUNWspro/bin/cc is used instead of /usr/ucb/cc
840c2aa98e2SPeter Wemm	(or it might complain about tm_zone).
841c2aa98e2SPeter Wemm
842c2aa98e2SPeter Wemm	The Solaris "syslog" function is apparently limited to something
843c2aa98e2SPeter Wemm	about 90 characters because of a kernel limitation.  If you have
844c2aa98e2SPeter Wemm	source code, you can probably up this number.  You can get patches
845c2aa98e2SPeter Wemm	that fix this problem: the patch ids are:
846c2aa98e2SPeter Wemm
847c2aa98e2SPeter Wemm		Solaris 2.1	100834
848c2aa98e2SPeter Wemm		Solaris 2.2	100999
849c2aa98e2SPeter Wemm		Solaris 2.3	101318
850c2aa98e2SPeter Wemm
851c2aa98e2SPeter Wemm	Be sure you have the appropriate patch installed or you won't
852c2aa98e2SPeter Wemm	see system logging.
853c2aa98e2SPeter Wemm
854c2aa98e2SPeter WemmSolaris 2.4 (SunOS 5.4)
855c2aa98e2SPeter Wemm	If you include /usr/lib at the end of your LD_LIBRARY_PATH you run
856c2aa98e2SPeter Wemm	the risk of getting the wrong libraries under some circumstances.
857c2aa98e2SPeter Wemm	This is because of a new feature in Solaris 2.4, described by
858c2aa98e2SPeter Wemm	Rod.Evans@Eng.Sun.COM:
859c2aa98e2SPeter Wemm
860c2aa98e2SPeter Wemm	>> Prior to SunOS 5.4, any LD_LIBRARY_PATH setting was ignored by the
861c2aa98e2SPeter Wemm	>> runtime linker if the application was setxid (secure), thus your
862c2aa98e2SPeter Wemm	>> applications search path would be:
863c2aa98e2SPeter Wemm	>>
864c2aa98e2SPeter Wemm	>>	/usr/local/lib	LD_LIBRARY_PATH component - IGNORED
865c2aa98e2SPeter Wemm	>>	/usr/lib	LD_LIBRARY_PATH component - IGNORED
866c2aa98e2SPeter Wemm	>>	/usr/local/lib	RPATH - honored
867c2aa98e2SPeter Wemm	>>	/usr/lib	RPATH - honored
868c2aa98e2SPeter Wemm	>>
869c2aa98e2SPeter Wemm	>> the effect is that path 3 would be the first used, and this would
870c2aa98e2SPeter Wemm	>> satisfy your resolv.so lookup.
871c2aa98e2SPeter Wemm	>>
872c2aa98e2SPeter Wemm	>> In SunOS 5.4 we made the LD_LIBRARY_PATH a little more flexible.
873c2aa98e2SPeter Wemm	>> People who developed setxid applications wanted to be able to alter
874c2aa98e2SPeter Wemm	>> the library search path to some degree to allow for their own
875c2aa98e2SPeter Wemm	>> testing and debugging mechanisms.  It was decided that the only
876c2aa98e2SPeter Wemm	>> secure way to do this was to allow a `trusted' path to be used in
877c2aa98e2SPeter Wemm	>> LD_LIBRARY_PATH.  The only trusted directory we presently define
878c2aa98e2SPeter Wemm	>> is /usr/lib.  Thus a setuid root developer could play with some
879c2aa98e2SPeter Wemm	>> alternative shared object implementations and place them in
880c2aa98e2SPeter Wemm	>> /usr/lib (being root we assume they'ed have access to write in this
881c2aa98e2SPeter Wemm	>> directory).  This change was made as part of 1155380 - after a
882c2aa98e2SPeter Wemm	>> *huge* amount of discussion regarding the security aspect of things.
883c2aa98e2SPeter Wemm	>>
884c2aa98e2SPeter Wemm	>> So, in SunOS 5.4 your applications search path would be:
885c2aa98e2SPeter Wemm	>>
886c2aa98e2SPeter Wemm	>>	/usr/local/lib	from LD_LIBRARY_PATH - IGNORED (untrustworthy)
887c2aa98e2SPeter Wemm	>>	/usr/lib	from LD_LIBRARY_PATH - honored (trustworthy)
888c2aa98e2SPeter Wemm	>>	/usr/local/lib	from RPATH - honored
889c2aa98e2SPeter Wemm	>>	/usr/lib	from RPATH - honored
890c2aa98e2SPeter Wemm	>>
891c2aa98e2SPeter Wemm	>> here, path 2 would be the first used.
892c2aa98e2SPeter Wemm
893c2aa98e2SPeter WemmSolaris 2.5.1 (SunOS 5.5.1) and 2.6 (SunOS 5.6)
894c2aa98e2SPeter Wemm	Apparently Solaris 2.5.1 patch 103663-01 installs a new
895c2aa98e2SPeter Wemm	/usr/include/resolv.h file that defines the __P macro without
896c2aa98e2SPeter Wemm	checking to see if it is already defined.  This new resolv.h is also
897c2aa98e2SPeter Wemm	included in the Solaris 2.6 distribution. This causes compile
898c2aa98e2SPeter Wemm	warnings such as:
899c2aa98e2SPeter Wemm
900c2aa98e2SPeter Wemm	   In file included from daemon.c:51:
901c2aa98e2SPeter Wemm	   /usr/include/resolv.h:208: warning: `__P' redefined
902c2aa98e2SPeter Wemm	   cdefs.h:58: warning: this is the location of the previous definition
903c2aa98e2SPeter Wemm
904c2aa98e2SPeter Wemm	These warnings can be safely ignored or you can create a resolv.h
905c2aa98e2SPeter Wemm	file in the obj.SunOS.5.5.1.* or obj.SunOS.5.6.* directory that reads:
906c2aa98e2SPeter Wemm
907c2aa98e2SPeter Wemm	   #undef __P
908c2aa98e2SPeter Wemm	   #include "/usr/include/resolv.h"
909c2aa98e2SPeter Wemm
910c2aa98e2SPeter Wemm	Sun is aware of the problem (Sun bug ID 4081053) and it will be fixed
911c2aa98e2SPeter Wemm	in Solaris 2.7.
912c2aa98e2SPeter Wemm
91306f25ae9SGregory Neil ShapiroSolaris 7 (SunOS 5.7)
91406f25ae9SGregory Neil Shapiro	Solaris 7 includes LDAP libraries but the implementation was
91506f25ae9SGregory Neil Shapiro	lacking a few things.  The following settings can be placed in
91606f25ae9SGregory Neil Shapiro	devtools/Site/site.SunOS.5.7.m4 if you plan on using those
91706f25ae9SGregory Neil Shapiro	libraries.
91806f25ae9SGregory Neil Shapiro
91906f25ae9SGregory Neil Shapiro	APPENDDEF(`confMAPDEF', `-DLDAPMAP')
92006f25ae9SGregory Neil Shapiro	APPENDDEF(`confENVDEF', `-DLDAP_VERSION_MAX=3')
92106f25ae9SGregory Neil Shapiro	APPENDDEF(`confLIBS', `-lldap')
92206f25ae9SGregory Neil Shapiro
92306f25ae9SGregory Neil Shapiro	Also, Sun's patch 107555 is needed to prevent a crash in the call
92406f25ae9SGregory Neil Shapiro	to ldap_set_option for LDAP_OPT_REFERRALS in ldapmap_setopts if
92506f25ae9SGregory Neil Shapiro	LDAP support is compiled in sendmail.
92606f25ae9SGregory Neil Shapiro
927193538b7SGregory Neil ShapiroSolaris
928193538b7SGregory Neil Shapiro	If you are using dns for hostname resolution on Solaris, make sure
929193538b7SGregory Neil Shapiro	that the 'dns' entry is last on the hosts line in
930193538b7SGregory Neil Shapiro	'/etc/nsswitch.conf'.  For example, use:
931193538b7SGregory Neil Shapiro
932193538b7SGregory Neil Shapiro		hosts:	nisplus files dns
933193538b7SGregory Neil Shapiro
934193538b7SGregory Neil Shapiro	Do not use:
935193538b7SGregory Neil Shapiro
936193538b7SGregory Neil Shapiro		host:  nisplus dns [NOTFOUND=return] files
937193538b7SGregory Neil Shapiro
938193538b7SGregory Neil Shapiro	Note that 'nisplus' above is an illustration.  The same comment
939193538b7SGregory Neil Shapiro	applies no matter what naming services you are using.  If you have
940193538b7SGregory Neil Shapiro	anything other than dns last, even after "[NOTFOUND=return]",
941193538b7SGregory Neil Shapiro	sendmail may not be able to determine whether an error was
942193538b7SGregory Neil Shapiro	temporary or permanent.  The error returned by the solaris
943193538b7SGregory Neil Shapiro	gethostbyname() is the error for the last lookup used, and other
944193538b7SGregory Neil Shapiro	naming services do not have the same concept of temporary failure.
945193538b7SGregory Neil Shapiro
946c2aa98e2SPeter WemmUltrix
947c2aa98e2SPeter Wemm	By default, the IDENT protocol is turned off on Ultrix.  If you
948c2aa98e2SPeter Wemm	are running Ultrix 4.4 or later, or if you have included patch
949c2aa98e2SPeter Wemm	CXO-8919 for Ultrix 4.2 or 4.3 to fix the TCP problem, you can turn
95006f25ae9SGregory Neil Shapiro	IDENT on in the configuration file by setting the "ident" timeout.
95106f25ae9SGregory Neil Shapiro
95206f25ae9SGregory Neil Shapiro	The Ultrix 4.5 Y2K patch (ULTV45-022-1) has changed the resolver
95306f25ae9SGregory Neil Shapiro	included in libc.a.  Unfortunately, the __RES symbol hasn't changed
95406f25ae9SGregory Neil Shapiro	and therefore, sendmail can no longer automatically detect the
95506f25ae9SGregory Neil Shapiro	newer version.  If you get a compiler error:
95606f25ae9SGregory Neil Shapiro
95706f25ae9SGregory Neil Shapiro	/lib/libc.a(gethostent.o): local_hostname_length: multiply defined
95806f25ae9SGregory Neil Shapiro
95906f25ae9SGregory Neil Shapiro	Then rebuild with this in devtools/Site/site.ULTRIX.m4:
96006f25ae9SGregory Neil Shapiro
96106f25ae9SGregory Neil Shapiro	APPENDDEF(`conf_sendmail_ENVDEF', `-DNEEDLOCAL_HOSTNAME_LENGTH=0')
962c2aa98e2SPeter Wemm
963c2aa98e2SPeter WemmDigital UNIX (formerly DEC OSF/1)
964c2aa98e2SPeter Wemm	If you are compiling on OSF/1 (DEC Alpha), you must use
965c2aa98e2SPeter Wemm	-L/usr/shlib (otherwise it core dumps on startup).  You may also
966c2aa98e2SPeter Wemm	need -mld to get the nlist() function, although some versions
967c2aa98e2SPeter Wemm	apparently don't need this.
968c2aa98e2SPeter Wemm
969c2aa98e2SPeter Wemm	Also, the enclosed makefile removed /usr/sbin/smtpd; if you need
970c2aa98e2SPeter Wemm	it, just create the link to the sendmail binary.
971c2aa98e2SPeter Wemm
972c2aa98e2SPeter Wemm	On DEC OSF/1 3.2 or earlier, the MatchGECOS option doesn't work
973c2aa98e2SPeter Wemm	properly due to a bug in the getpw* routines.  If you want to use
974c2aa98e2SPeter Wemm	this, use -DDEC_OSF_BROKEN_GETPWENT=1.  The problem is fixed in 3.2C.
975c2aa98e2SPeter Wemm
976c2aa98e2SPeter Wemm	Digital's mail delivery agent, /bin/mail (aka /bin/binmail), will
977c2aa98e2SPeter Wemm	only preserve the envelope sender in the "From " header if
978c2aa98e2SPeter Wemm	DefaultUserID is set to daemon.  Setting this to mailnull will
979c2aa98e2SPeter Wemm	cause all mail to have the header "From mailnull ...".  To use
980c2aa98e2SPeter Wemm	a different DefaultUserID, you will need to use a different mail
981c2aa98e2SPeter Wemm	delivery agent (such as mail.local found in the sendmail
982c2aa98e2SPeter Wemm	distribution).
983c2aa98e2SPeter Wemm
984c2aa98e2SPeter Wemm	On Digital UNIX 4.0 and later, Berkeley DB 1.85 is included with the
985c2aa98e2SPeter Wemm	operating system and already has the ndbm.o module removed.  However,
986c2aa98e2SPeter Wemm	Digital has modified the original Berkeley DB db.h include file.
987c2aa98e2SPeter Wemm	This results in the following warning while compiling map.c and udb.c:
988c2aa98e2SPeter Wemm
989c2aa98e2SPeter Wemm	cc: Warning: /usr/include/db.h, line 74: The redefinition of the macro
990c2aa98e2SPeter Wemm	 "__signed" conflicts with a current definition because the replacement
991c2aa98e2SPeter Wemm	 lists differ.  The redefinition is now in effect.
992c2aa98e2SPeter Wemm	#define __signed        signed
993c2aa98e2SPeter Wemm	------------------------^
994c2aa98e2SPeter Wemm
995c2aa98e2SPeter Wemm	This warning can be ignored.
996c2aa98e2SPeter Wemm
997065a643dSPeter Wemm	Digital UNIX's linker checks /usr/ccs/lib/ before /usr/lib/.
998065a643dSPeter Wemm	If you have installed a new version of BIND in /usr/include
999065a643dSPeter Wemm	and /usr/lib, you will experience difficulties as Digital ships
1000065a643dSPeter Wemm	libresolv.a in /usr/ccs/lib/ as well.  Be sure to replace both
1001065a643dSPeter Wemm	copies of libresolv.a.
1002065a643dSPeter Wemm
1003c2aa98e2SPeter WemmIRIX
1004c2aa98e2SPeter Wemm	The header files on SGI IRIX are completely prototyped, and as
1005c2aa98e2SPeter Wemm	a result you can sometimes get some warning messages during
1006c2aa98e2SPeter Wemm	compilation.  These can be ignored.  There are two errors in
1007c2aa98e2SPeter Wemm	deliver only if you are using gcc, both of the form ``warning:
1008c2aa98e2SPeter Wemm	passing arg N of `execve' from incompatible pointer type''.
1009c2aa98e2SPeter Wemm	Also, if you compile with -DNIS, you will get a complaint
1010c2aa98e2SPeter Wemm	about a declaration of struct dom_binding in a prototype
1011c2aa98e2SPeter Wemm	when compiling map.c; this is not important because the
1012c2aa98e2SPeter Wemm	function being prototyped is not used in that file.
1013c2aa98e2SPeter Wemm
1014c2aa98e2SPeter Wemm	In order to compile sendmail you will have had to install
1015c2aa98e2SPeter Wemm	the developers' option in order to get the necessary include
1016c2aa98e2SPeter Wemm	files.
1017c2aa98e2SPeter Wemm
1018c2aa98e2SPeter Wemm	If you compile with -lmalloc (the fast memory allocator), you may
1019c2aa98e2SPeter Wemm	get warning messages such as the following:
1020c2aa98e2SPeter Wemm
1021c2aa98e2SPeter Wemm	   ld32: WARNING 85: definition of _calloc in /usr/lib32/libmalloc.so
1022c2aa98e2SPeter Wemm		preempts that definition in /usr/lib32/mips3/libc.so.
1023c2aa98e2SPeter Wemm	   ld32: WARNING 85: definition of _malloc in /usr/lib32/libmalloc.so
1024c2aa98e2SPeter Wemm		preempts that definition in /usr/lib32/mips3/libc.so.
1025c2aa98e2SPeter Wemm	   ld32: WARNING 85: definition of _realloc in /usr/lib32/libmalloc.so
1026c2aa98e2SPeter Wemm		preempts that definition in /usr/lib32/mips3/libc.so.
1027c2aa98e2SPeter Wemm	   ld32: WARNING 85: definition of _free in /usr/lib32/libmalloc.so
1028c2aa98e2SPeter Wemm		preempts that definition in /usr/lib32/mips3/libc.so.
1029c2aa98e2SPeter Wemm	   ld32: WARNING 85: definition of _cfree in /usr/lib32/libmalloc.so
1030c2aa98e2SPeter Wemm		preempts that definition in /usr/lib32/mips3/libc.so.
1031c2aa98e2SPeter Wemm
1032c2aa98e2SPeter Wemm	These are unavoidable and innocuous -- just ignore them.
1033c2aa98e2SPeter Wemm
1034c2aa98e2SPeter Wemm	According to Dave Sill <de5@ornl.gov>, there is a version of the
1035c2aa98e2SPeter Wemm	Berkeley DB library patched to run on Irix 6.2 available from
1036c2aa98e2SPeter Wemm	http://reality.sgi.com/ariel/freeware/#db .
1037c2aa98e2SPeter Wemm
1038c2aa98e2SPeter WemmIRIX 6.x
103906f25ae9SGregory Neil Shapiro	If you are using XFS filesystem, avoid using the -32 ABI switch to
104006f25ae9SGregory Neil Shapiro	the cc compiler if possible.
1041c2aa98e2SPeter Wemm
1042602a2b1bSGregory Neil Shapiro	Broken inet_aton and inet_ntoa on IRIX using gcc: There's
1043602a2b1bSGregory Neil Shapiro	a problem with gcc on IRIX, i.e., gcc can't pass structs
1044602a2b1bSGregory Neil Shapiro	less than 16 bits long unless they are 8 bits; IRIX 6.2 has
1045602a2b1bSGregory Neil Shapiro	some other sized structs.  See
1046602a2b1bSGregory Neil Shapiro	http://www.bitmechanic.com/mail-archives/mysql/current/0418.html
1047602a2b1bSGregory Neil Shapiro
104806f25ae9SGregory Neil ShapiroIRIX 6.4
104906f25ae9SGregory Neil Shapiro	The IRIX 6.5.4 version of /bin/m4 does not work properly with
105006f25ae9SGregory Neil Shapiro	sendmail.  Either install fw_m4.sw.m4 off the Freeware_May99 CD and
105106f25ae9SGregory Neil Shapiro	use /usr/freeware/bin/m4 or install and use GNU m4.
1052c2aa98e2SPeter Wemm
1053c2aa98e2SPeter WemmNeXT or NEXTSTEP
1054c2aa98e2SPeter Wemm	NEXTSTEP 3.3 and earlier ship with the old DBM library.  Also,
1055c2aa98e2SPeter Wemm	Berkeley DB does not currently run on NEXTSTEP.
1056c2aa98e2SPeter Wemm
1057c2aa98e2SPeter Wemm	If you are compiling on NEXTSTEP, you will have to create an
1058c2aa98e2SPeter Wemm	empty file "unistd.h" and create a file "dirent.h" containing:
1059c2aa98e2SPeter Wemm
1060c2aa98e2SPeter Wemm		#include <sys/dir.h>
1061c2aa98e2SPeter Wemm		#define dirent	direct
1062c2aa98e2SPeter Wemm
106306f25ae9SGregory Neil Shapiro	(devtools/OS/NeXT should try to do both of these for you.)
1064c2aa98e2SPeter Wemm
1065c2aa98e2SPeter Wemm	Apparently, there is a bug in getservbyname on Nextstep 3.0
1066c2aa98e2SPeter Wemm	that causes it to fail under some circumstances with the
1067c2aa98e2SPeter Wemm	message "SYSERR: service "smtp" unknown" logged.  You should
1068c2aa98e2SPeter Wemm	be able to work around this by including the line:
1069c2aa98e2SPeter Wemm
1070c2aa98e2SPeter Wemm		OOPort=25
1071c2aa98e2SPeter Wemm
1072c2aa98e2SPeter Wemm	in your .cf file.
1073c2aa98e2SPeter Wemm
1074c2aa98e2SPeter WemmBSDI (BSD/386) 1.0, NetBSD 0.9, FreeBSD 1.0
1075c2aa98e2SPeter Wemm	The "m4" from BSDI won't handle the config files properly.
1076c2aa98e2SPeter Wemm	I haven't had a chance to test this myself.
1077c2aa98e2SPeter Wemm
1078c2aa98e2SPeter Wemm	The M4 shipped in FreeBSD and NetBSD 0.9 don't handle the config
1079c2aa98e2SPeter Wemm	files properly. One must use either GNU m4 1.1 or the PD-M4
1080c2aa98e2SPeter Wemm	recently posted in comp.os.386bsd.bugs (and maybe others).
1081c2aa98e2SPeter Wemm	NetBSD-current includes the PD-M4 (as stated in the NetBSD file
1082c2aa98e2SPeter Wemm	CHANGES).
1083c2aa98e2SPeter Wemm
1084c2aa98e2SPeter Wemm	FreeBSD 1.0 RELEASE has uname(2) now. Use -DUSEUNAME in order to
108506f25ae9SGregory Neil Shapiro	use it (look into devtools/OS/FreeBSD). NetBSD-current may have
1086c2aa98e2SPeter Wemm	it too but it has not been verified.
1087c2aa98e2SPeter Wemm
1088c2aa98e2SPeter Wemm	The latest version of Berkeley DB uses a different naming
1089c2aa98e2SPeter Wemm	scheme than the version that is supplied with your release.  This
1090c2aa98e2SPeter Wemm	means you will be able to use the current version of Berkeley DB
1091c2aa98e2SPeter Wemm	with sendmail as long you use the new db.h when compiling
109206f25ae9SGregory Neil Shapiro	sendmail and link it against the new libdb.a or libdb.so.  You
109306f25ae9SGregory Neil Shapiro	should probably keep the original db.h in /usr/include and the
109406f25ae9SGregory Neil Shapiro	new db.h in /usr/local/include.
1095c2aa98e2SPeter Wemm
1096c2aa98e2SPeter Wemm4.3BSD
1097c2aa98e2SPeter Wemm	If you are running a "virgin" version of 4.3BSD, you'll have
1098c2aa98e2SPeter Wemm	a very old resolver and be missing some header files.  The
1099c2aa98e2SPeter Wemm	header files are simple -- create empty versions and everything
1100c2aa98e2SPeter Wemm	will work fine.  For the resolver you should really port a new
1101c2aa98e2SPeter Wemm	version (4.8.3 or later) of the resolver; 4.9 is available on
1102c2aa98e2SPeter Wemm	gatekeeper.DEC.COM in pub/BSD/bind/4.9.  If you are really
1103c2aa98e2SPeter Wemm	determined to continue to use your old, buggy version (or as
1104c2aa98e2SPeter Wemm	a shortcut to get sendmail working -- I'm sure you have the
1105c2aa98e2SPeter Wemm	best intentions to port a modern version of BIND), you can
1106602a2b1bSGregory Neil Shapiro	copy ../contrib/oldbind.compat.c into sendmail and add the
1107602a2b1bSGregory Neil Shapiro	following to devtools/Site/site.config.m4:
1108602a2b1bSGregory Neil Shapiro
1109602a2b1bSGregory Neil Shapiro	APPENDDEF(`confOBJADD', `oldbind.compat.o')
1110c2aa98e2SPeter Wemm
1111c2aa98e2SPeter WemmA/UX
1112c2aa98e2SPeter Wemm	Date: Tue, 12 Oct 1993 18:28:28 -0400 (EDT)
1113c2aa98e2SPeter Wemm	From: "Eric C. Hagberg" <hagberg@med.cornell.edu>
1114c2aa98e2SPeter Wemm	Subject: Fix for A/UX ndbm
1115c2aa98e2SPeter Wemm
1116c2aa98e2SPeter Wemm	I guess this isn't really a sendmail bug, however, it is something
1117c2aa98e2SPeter Wemm	that A/UX users should be aware of when compiling sendmail 8.6.
1118c2aa98e2SPeter Wemm
1119c2aa98e2SPeter Wemm	Apparently, the calls that sendmail is using to the ndbm routines
1120c2aa98e2SPeter Wemm	in A/UX 3.0.x contain calls to "broken" routines, in that the
1121c2aa98e2SPeter Wemm	aliases database will break when it gets "just a little big"
1122c2aa98e2SPeter Wemm	(sorry I don't have exact numbers here, but it broke somewhere
1123c2aa98e2SPeter Wemm	around 20-25 aliases for me.), making all aliases non-functional
1124c2aa98e2SPeter Wemm	after exceeding this point.
1125c2aa98e2SPeter Wemm
1126c2aa98e2SPeter Wemm	What I did was to get the gnu-dbm-1.6 package, compile it, and
1127c2aa98e2SPeter Wemm	then re-compile sendmail with "-lgdbm", "-DNDBM", and using the
1128c2aa98e2SPeter Wemm	ndbm.h header file that comes with the gnu-package. This makes
1129c2aa98e2SPeter Wemm	things behave properly.
1130c2aa98e2SPeter Wemm	  [NOTE: see comment above about GDBM]
1131c2aa98e2SPeter Wemm
1132c2aa98e2SPeter Wemm	I suppose porting the New Berkeley DB package is another route,
1133c2aa98e2SPeter Wemm	however, I made a quick attempt at it, and found it difficult
1134c2aa98e2SPeter Wemm	(not easy at least); the gnu-dbm package "configured" and
1135c2aa98e2SPeter Wemm	compiled easily.
1136c2aa98e2SPeter Wemm
1137c2aa98e2SPeter Wemm	  [NOTE: Berkeley DB version 2.X runs on A/UX and can be used for
1138c2aa98e2SPeter Wemm	  database maps.]
1139c2aa98e2SPeter Wemm
1140c2aa98e2SPeter WemmSCO Unix
1141c2aa98e2SPeter Wemm	From: Thomas Essebier <tom@stallion.oz.au>
1142c2aa98e2SPeter Wemm	Organisation:  Stallion Technologies Pty Ltd.
1143c2aa98e2SPeter Wemm
1144c2aa98e2SPeter Wemm	It will probably help those who are trying to configure sendmail 8.6.9
1145c2aa98e2SPeter Wemm	to know that if they are on SCO, they had better set
1146c2aa98e2SPeter Wemm		OI-dnsrch
1147c2aa98e2SPeter Wemm	or they will core dump as soon as they try to use the resolver.
1148c2aa98e2SPeter Wemm	ie. although SCO has _res.dnsrch defined, and is kinda BIND 4.8.3, it
1149c2aa98e2SPeter Wemm	does not inititialise it, nor does it understand 'search' in
1150c2aa98e2SPeter Wemm	/etc/named.boot.
1151c2aa98e2SPeter Wemm		- sigh -
1152c2aa98e2SPeter Wemm
1153c2aa98e2SPeter Wemm	According to SCO, the m4 which ships with UnixWare 2.1.2 is broken.
1154c2aa98e2SPeter Wemm	We recommend installing GNU m4 before attempting to build sendmail.
1155c2aa98e2SPeter Wemm
1156c2aa98e2SPeter WemmDG/UX
1157c2aa98e2SPeter Wemm	Doug Anderson <dlander@afterlife.ncsc.mil> has successfully run
1158c2aa98e2SPeter Wemm	V8 on the DG/UX 5.4.2 and 5.4R3.x platforms under heavy usage.
1159c2aa98e2SPeter Wemm	Originally, the DG /bin/mail program wasn't compatible with
1160c2aa98e2SPeter Wemm	the V8 sendmail, since the DG /bin/mail requires the environment
1161c2aa98e2SPeter Wemm	variable "_FORCE_MAIL_LOCAL_=yes" be set.  Version 8.7 now includes
1162c2aa98e2SPeter Wemm	this in the environment before invoking the local mailer.  Some
1163c2aa98e2SPeter Wemm	have used procmail to avoid this problem in the past.  It works
1164c2aa98e2SPeter Wemm	but some have experienced file locking problems with their DG/UX
1165c2aa98e2SPeter Wemm	ports of procmail.
1166c2aa98e2SPeter Wemm
1167c2aa98e2SPeter WemmApollo DomainOS
1168c2aa98e2SPeter Wemm	If you are compiling on Apollo, you will have to create an empty
1169c2aa98e2SPeter Wemm	file "unistd.h" (for DomainOS 10.3 and earlier) and create a file
1170c2aa98e2SPeter Wemm	"dirent.h" containing:
1171c2aa98e2SPeter Wemm
1172c2aa98e2SPeter Wemm		#include <sys/dir.h>
1173c2aa98e2SPeter Wemm		#define dirent	direct
1174c2aa98e2SPeter Wemm
117506f25ae9SGregory Neil Shapiro	(devtools/OS/DomainOS will attempt to do both of these for you.)
1176c2aa98e2SPeter Wemm
1177c2aa98e2SPeter WemmHP-UX 8.00
1178c2aa98e2SPeter Wemm	Date: Mon, 24 Jan 1994 13:25:45 +0200
1179c2aa98e2SPeter Wemm	From: Kimmo Suominen <Kimmo.Suominen@lut.fi>
1180c2aa98e2SPeter Wemm	Subject: 8.6.5 w/ HP-UX 8.00 on s300
1181c2aa98e2SPeter Wemm
1182c2aa98e2SPeter Wemm	Just compiled and fought with sendmail 8.6.5 on a HP9000/360 (ie. a
1183c2aa98e2SPeter Wemm	series 300 machine) running HP-UX 8.00.
1184c2aa98e2SPeter Wemm
1185c2aa98e2SPeter Wemm	I was getting segmentation fault when delivering to a local user.
1186c2aa98e2SPeter Wemm	With debugging I saw it was faulting when doing _free@libc... *sigh*
1187c2aa98e2SPeter Wemm	It seems the new implementation of malloc on s300 is buggy as of 8.0,
1188c2aa98e2SPeter Wemm	so I tried out the one in -lmalloc (malloc(3X)).  With that it seems
1189c2aa98e2SPeter Wemm	to work just dandy.
1190c2aa98e2SPeter Wemm
1191c2aa98e2SPeter Wemm	When linking, you will get the following error:
1192c2aa98e2SPeter Wemm
1193c2aa98e2SPeter Wemm	ld: multiply defined symbol _freespace in file /usr/lib/libmalloc.a
1194c2aa98e2SPeter Wemm
1195c2aa98e2SPeter Wemm	but you can just ignore it.  You might want to add this info to the
1196c2aa98e2SPeter Wemm	README file for the future...
1197c2aa98e2SPeter Wemm
1198c2aa98e2SPeter WemmLinux
1199c2aa98e2SPeter Wemm	Something broke between versions 0.99.13 and 0.99.14 of Linux:
1200c2aa98e2SPeter Wemm	the flock() system call gives errors.  If you are running .14,
1201c2aa98e2SPeter Wemm	you must not use flock.  You can do this with -DHASFLOCK=0.
1202c2aa98e2SPeter Wemm
1203c2aa98e2SPeter Wemm	Around the inclusion of bind-4.9.3 & Linux libc-4.6.20, the
1204c2aa98e2SPeter Wemm	initialization of the _res structure changed.  If /etc/hosts.conf
1205c2aa98e2SPeter Wemm	was configured as "hosts, bind" the resolver code could return
1206c2aa98e2SPeter Wemm	"Name server failure" errors.  This is supposedly fixed in
1207c2aa98e2SPeter Wemm	later versions of libc (>= 4.6.29?), and later versions of
1208c2aa98e2SPeter Wemm	sendmail (> 8.6.10) try to work around the problem.
1209c2aa98e2SPeter Wemm
1210c2aa98e2SPeter Wemm	Some older versions (< 4.6.20?) of the libc/include files conflict
1211c2aa98e2SPeter Wemm	with sendmail's version of cdefs.h.  Deleting sendmail's version
1212c2aa98e2SPeter Wemm	on those systems should be non-harmful, and new versions don't care.
1213c2aa98e2SPeter Wemm
1214c2aa98e2SPeter Wemm	Sendmail assumes that libc has snprintf, which has been true since
1215c2aa98e2SPeter Wemm	libc 4.7.0.  If you are running an older version, you will need to
1216c2aa98e2SPeter Wemm	use -DHASSNPRINTF=0 in the Makefile.  If may be able to use -lbsd
1217c2aa98e2SPeter Wemm	(which includes snprintf) instead of turning this off on versions
1218c2aa98e2SPeter Wemm	of libc between 4.4.4 and 4.7.0 (snprintf improves security, so
1219c2aa98e2SPeter Wemm	you want to use this if at all possible).
1220c2aa98e2SPeter Wemm
1221c2aa98e2SPeter Wemm	NOTE ON LINUX & BIND:  By default, the Makefile generated for Linux
1222c2aa98e2SPeter Wemm	includes header files in /usr/local/include and libraries in
1223c2aa98e2SPeter Wemm	/usr/local/lib.  If you've installed BIND on your system, the header
1224c2aa98e2SPeter Wemm	files typically end up in the search path and you need to add
1225c2aa98e2SPeter Wemm	"-lresolv" to the LIBS line in your Makefile.  Really old versions
1226c2aa98e2SPeter Wemm	may need to include "-l44bsd" as well (particularly if the link phase
1227c2aa98e2SPeter Wemm	complains about missing strcasecmp, strncasecmp or strpbrk).
1228c2aa98e2SPeter Wemm	Complaints about an undefined reference to `__dn_skipname' in
1229c2aa98e2SPeter Wemm	domain.o are a sure sign that you need to add -lresolv to LIBS.
1230c2aa98e2SPeter Wemm	Newer versions of Linux are basically threaded BIND, so you may or
1231c2aa98e2SPeter Wemm	may not see complaints if you accidentally mix BIND
1232c2aa98e2SPeter Wemm	headers/libraries with virginal libc.  If you have BIND headers in
1233c2aa98e2SPeter Wemm	/usr/local/include (resolv.h, etc) you *should* be adding -lresolv
1234c2aa98e2SPeter Wemm	to LIBS.  Data structures may change and you'd be asking for a
1235c2aa98e2SPeter Wemm	core dump.
1236c2aa98e2SPeter Wemm
12372e43090eSPeter Wemm	A number of problems have been reported regarding the Linux 2.2.0
12382e43090eSPeter Wemm	kernel.  So far, these problems have been tracked down to syslog()
12392e43090eSPeter Wemm	and DNS resolution.  We believe the problem is with the poll()
12402e43090eSPeter Wemm	implementation in the Linux 2.2.0 kernel and poll()-aware versions
12412e43090eSPeter Wemm	of glib (at least up to 2.0.111).
12422e43090eSPeter Wemm
124306f25ae9SGregory Neil Shapiro	Some pre-glibc distributions of Linux include a syslog.h that does
124406f25ae9SGregory Neil Shapiro	not work properly with SFIO.  You can fix this by adding
124506f25ae9SGregory Neil Shapiro	"#include <syslog.h>" to the SFIO version of stdio.h as the very
124606f25ae9SGregory Neil Shapiro	first line.
124706f25ae9SGregory Neil Shapiro
1248602a2b1bSGregory Neil Shapiroglibc
1249602a2b1bSGregory Neil Shapiro	glibc 2.2.1 (and possibly other versions) changed the value of
1250602a2b1bSGregory Neil Shapiro	__RES in resolv.h but failed to actually provide the IPv6 API
1251602a2b1bSGregory Neil Shapiro	changes that the change implied.  Therefore, compiling with
1252602a2b1bSGregory Neil Shapiro	-DNETINET6 fails.
1253602a2b1bSGregory Neil Shapiro
1254602a2b1bSGregory Neil Shapiro	Workarounds:
1255602a2b1bSGregory Neil Shapiro	1) Compile without -DNETINET6
1256602a2b1bSGregory Neil Shapiro	2) Build against a real BIND 8.2.2 include/lib tree
1257602a2b1bSGregory Neil Shapiro	3) Wait for glibc to fix it
1258602a2b1bSGregory Neil Shapiro
125906f25ae9SGregory Neil ShapiroAIX 4.X
126006f25ae9SGregory Neil Shapiro	The AIX 4.X linker uses library paths specified during compilation
126106f25ae9SGregory Neil Shapiro	using -L for run-time shared library searches.  Therefore, it is
126206f25ae9SGregory Neil Shapiro	vital that relative and unsafe directory paths not be using when
126306f25ae9SGregory Neil Shapiro	compiling sendmail.  Because of this danger, by default, compiles
126406f25ae9SGregory Neil Shapiro	on AIX use the -blibpath option to limit shared libraries to
126506f25ae9SGregory Neil Shapiro	/usr/lib and /lib.  If you need to allow more directories, such as
126606f25ae9SGregory Neil Shapiro	/usr/local/lib, modify your devtools/Site/site.AIX.4.2.m4,
126706f25ae9SGregory Neil Shapiro	site.AIX.4.3.m4, and/or site.AIX.4.x.m4 file(s) and set confLDOPTS
126806f25ae9SGregory Neil Shapiro	approriately.  For example:
126906f25ae9SGregory Neil Shapiro
127006f25ae9SGregory Neil Shapiro	define(`confLDOPTS', `-blibpath:/usr/lib:/lib:/usr/local/lib')
127106f25ae9SGregory Neil Shapiro
127206f25ae9SGregory Neil Shapiro	Be sure to only add (safe) system directories.
127306f25ae9SGregory Neil Shapiro
127406f25ae9SGregory Neil Shapiro	The AIX version of GNU ld also exhibits this problem.  If you are
127506f25ae9SGregory Neil Shapiro	using that version, instead of -blibpath, use its -rpath option.
127606f25ae9SGregory Neil Shapiro	For example:
127706f25ae9SGregory Neil Shapiro
127806f25ae9SGregory Neil Shapiro	gcc -Wl,-rpath /usr/lib -Wl,-rpath /lib -Wl,-rpath /usr/local/lib
127906f25ae9SGregory Neil Shapiro
128006f25ae9SGregory Neil ShapiroAIX 4.3.3
128106f25ae9SGregory Neil Shapiro	From: Valdis.Kletnieks@vt.edu
128206f25ae9SGregory Neil Shapiro	Date: Sun, 02 Jul 2000 03:58:02 -0400
128306f25ae9SGregory Neil Shapiro
128406f25ae9SGregory Neil Shapiro	Under AIX 4.3.3, after applying bos.adt.include 4.3.3.12 to close the
128542e5d165SGregory Neil Shapiro	BIND 8.2.2 security holes, you can no longer build with  -DNETINET6
128606f25ae9SGregory Neil Shapiro	because they changed the value of __RES in resolv.h but failed to
128706f25ae9SGregory Neil Shapiro	actually provide the API changes that the change implied.
128806f25ae9SGregory Neil Shapiro
128906f25ae9SGregory Neil Shapiro	Workarounds:
129006f25ae9SGregory Neil Shapiro	1) Compile without -DNETINET6
1291602a2b1bSGregory Neil Shapiro	2) Build against a real BIND 8.2.2 include/lib tree
129206f25ae9SGregory Neil Shapiro	3) Wait for IBM to fix it
129306f25ae9SGregory Neil Shapiro
1294193538b7SGregory Neil ShapiroAIX 4.X
1295065a643dSPeter Wemm	The AIX m4 implements a different mechanism for ifdef which is
1296065a643dSPeter Wemm	inconsistent with other versions of m4.  Therefore, it will not
1297065a643dSPeter Wemm	work properly with the sendmail Build architecture or m4
1298065a643dSPeter Wemm	configuration method.  To work around this problem, please use
1299065a643dSPeter Wemm	GNU m4 from ftp://ftp.gnu.org/pub/gnu/.
1300065a643dSPeter Wemm
1301c2aa98e2SPeter WemmAIX 3.x
1302c2aa98e2SPeter Wemm	This version of sendmail does not support MB, MG, and MR resource
1303c2aa98e2SPeter Wemm	records, which are supported by AIX sendmail.
1304c2aa98e2SPeter Wemm
1305c2aa98e2SPeter Wemm	Several people have reported that the IBM-supplied named returns
1306c2aa98e2SPeter Wemm	fairly random results -- the named should be replaced.  It is not
1307c2aa98e2SPeter Wemm	necessary to replace the resolver, which will simplify installation.
1308c2aa98e2SPeter Wemm	A new BIND resolver can be found at http://www.isc.org/isc/.
1309c2aa98e2SPeter Wemm
1310c2aa98e2SPeter WemmAIX 3.1.x
1311c2aa98e2SPeter Wemm	The supplied load average code only works correctly for AIX 3.2.x.
1312c2aa98e2SPeter Wemm	For 3.1, use -DLA_TYPE=LA_SUBR and get the latest ``monitor''
1313c2aa98e2SPeter Wemm	package by Jussi Maki <jmaki@hut.fi> from ftp.funet.fi in the
1314c2aa98e2SPeter Wemm	directory pub/unix/AIX/rs6000/monitor-1.12.tar.Z; use the loadavgd
1315c2aa98e2SPeter Wemm	daemon, and the getloadavg subroutine supplied with that package.
1316c2aa98e2SPeter Wemm	If you don't care about load average throttling, just turn off
1317c2aa98e2SPeter Wemm	load average checking using -DLA_TYPE=LA_ZERO.
1318c2aa98e2SPeter Wemm
1319c2aa98e2SPeter WemmAIX 2.2.1
1320c2aa98e2SPeter Wemm	Date: Mon Dec  4 14:14:56 CST 1995
1321c2aa98e2SPeter Wemm	From: Mark Whetzel <markw@antimatr.houston.tx.us>
1322c2aa98e2SPeter Wemm	Subject: Porting sendmail 8.7.2 to AIX V2 on the RT.
1323c2aa98e2SPeter Wemm
1324c2aa98e2SPeter Wemm	This version of sendmail does not support MB, MG, and MR resource
1325c2aa98e2SPeter Wemm	records, which are supported by AIX sendmail.
1326c2aa98e2SPeter Wemm
1327c2aa98e2SPeter Wemm	AIX V2 on the RT does not have 'paths.h'.  Create a null
1328c2aa98e2SPeter Wemm	file in the 'obj' directory to remove this compile error.
1329c2aa98e2SPeter Wemm
1330c2aa98e2SPeter Wemm	A patch file is needed to get the BSD 'db' library to compile
1331c2aa98e2SPeter Wemm	for AIX/RT.  I have sent the necessary updates to the author,
1332c2aa98e2SPeter Wemm	but they may not be immediately available.
1333c2aa98e2SPeter Wemm	  [NOTE: Berkeley DB version 2.X runs on AIX/RT.]
1334c2aa98e2SPeter Wemm
1335c2aa98e2SPeter Wemm	The original AIX/RT resolver libraries are very old, and you
1336c2aa98e2SPeter Wemm	should get the latest BIND to replace it.  The 4.8.3 version
1337c2aa98e2SPeter Wemm	has been tested, but 4.9.x is out and should work.
1338c2aa98e2SPeter Wemm
1339c2aa98e2SPeter Wemm	To make the load average code work correctly requires an
1340c2aa98e2SPeter Wemm	external routine, as the kernel does not maintain system
1341c2aa98e2SPeter Wemm	load averages, similar to AIX V3.1.x.  A reverse port of the
1342c2aa98e2SPeter Wemm	older 1.05 'monitor' load average daemon code written by
1343c2aa98e2SPeter Wemm	Jussi Maki that will work on AIX V2 for the RT is available
1344c2aa98e2SPeter Wemm	by E-mail to Mark Whetzel  <markw@antimatr.houston.tx.us>.
1345c2aa98e2SPeter Wemm	That code depends on an external daemon to collect system
1346c2aa98e2SPeter Wemm	load information, and the external routine 'getloadavg',
1347c2aa98e2SPeter Wemm	that will return that information.  The 'LA_SUBR' define
1348c2aa98e2SPeter Wemm	will handle this for AIX V2 on the RT.
1349c2aa98e2SPeter Wemm
135006f25ae9SGregory Neil Shapiro	Note: You will have to change devtools/OS/AIX.2 to correctly
1351c2aa98e2SPeter Wemm	point to the locatons of the updated BIND source tree and
1352c2aa98e2SPeter Wemm	the location of the 'newdb' tree and library location.
135306f25ae9SGregory Neil Shapiro	You will also have to change devtools/OS/AIX.2 to know
1354c2aa98e2SPeter Wemm	about the location of the 'getloadavg' routine if you use
1355c2aa98e2SPeter Wemm	the LA_SUBR define.
1356c2aa98e2SPeter Wemm
1357c2aa98e2SPeter WemmRISC/os
1358c2aa98e2SPeter Wemm	RISC/os from MIPS is a merged AT&T/Berkeley system.  When you
1359c2aa98e2SPeter Wemm	compile on that platform you will get duplicate definitions
1360c2aa98e2SPeter Wemm	on many files.  You can ignore these.
1361c2aa98e2SPeter Wemm
1362c2aa98e2SPeter WemmSystem V Release 4 Based Systems
136306f25ae9SGregory Neil Shapiro	There is a single devtools OS that is intended for all SVR4-based
136406f25ae9SGregory Neil Shapiro	systems (built from devtools/OS/SVR4).  It defines __svr4__,
1365c2aa98e2SPeter Wemm	which is predefined by some compilers.  If your compiler already
1366c2aa98e2SPeter Wemm	defines this compile variable, you can delete the definition from
136706f25ae9SGregory Neil Shapiro	the generated Makefile or create a devtools/Site/site.config.m4
1368c2aa98e2SPeter Wemm	file.
1369c2aa98e2SPeter Wemm
1370c2aa98e2SPeter Wemm	It's been tested on Dell Issue 2.2.
1371c2aa98e2SPeter Wemm
1372c2aa98e2SPeter WemmDELL SVR4
1373c2aa98e2SPeter Wemm	Date:      Mon, 06 Dec 1993 10:42:29 EST
1374c2aa98e2SPeter Wemm	From: "Kimmo Suominen" <kim@grendel.lut.fi>
1375c2aa98e2SPeter Wemm	Message-ID: <2d0352f9.lento29@lento29.UUCP>
1376c2aa98e2SPeter Wemm	To: eric@cs.berkeley.edu
1377c2aa98e2SPeter Wemm	Cc: sendmail@cs.berkeley.edu
1378c2aa98e2SPeter Wemm	Subject:   Notes for DELL SVR4
1379c2aa98e2SPeter Wemm
1380c2aa98e2SPeter Wemm	Eric,
1381c2aa98e2SPeter Wemm
1382c2aa98e2SPeter Wemm	Here are some notes for compiling Sendmail 8.6.4 on DELL SVR4.  I ran
1383c2aa98e2SPeter Wemm	across these things when helping out some people who contacted me by
1384c2aa98e2SPeter Wemm	e-mail.
1385c2aa98e2SPeter Wemm
1386c2aa98e2SPeter Wemm	1) Use gcc 2.4.5 (or later?).  Dell distributes gcc 2.1 with their
1387c2aa98e2SPeter Wemm	   Issue 2.2 Unix.  It is too old, and gives you problems with
1388c2aa98e2SPeter Wemm	   clock.c, because sigset_t won't get defined in <sys/signal.h>.
1389c2aa98e2SPeter Wemm	   This is due to a problematic protection rule in there, and is
1390c2aa98e2SPeter Wemm	   fixed with gcc 2.4.5.
1391c2aa98e2SPeter Wemm
1392c2aa98e2SPeter Wemm	2) If you don't use the new Berkeley DB (-DNEWDB), then you need
1393c2aa98e2SPeter Wemm	   to add "-lc -lucb" to the libraries to link with.  This is because
1394c2aa98e2SPeter Wemm	   the -ldbm distributed by Dell needs the bcopy, bcmp and bzero
1395c2aa98e2SPeter Wemm	   functions.  It is important that you specify both libraries in
1396c2aa98e2SPeter Wemm	   the given order to be sure you only get the BSTRING functions
1397c2aa98e2SPeter Wemm	   from the UCB library (and not the signal routines etc.).
1398c2aa98e2SPeter Wemm
1399c2aa98e2SPeter Wemm	3) Don't leave out "-lelf" even if compiling with "-lc -lucb".
1400c2aa98e2SPeter Wemm	   The UCB library also has another copy of the nlist routines,
1401c2aa98e2SPeter Wemm	   but we do want the ones from "-lelf".
1402c2aa98e2SPeter Wemm
1403c2aa98e2SPeter Wemm	If anyone needs a compiled gcc 2.4.5 and/or a ported DB library, they
1404c2aa98e2SPeter Wemm	can use anonymous ftp to fetch them from lut.fi in the /kim directory.
1405c2aa98e2SPeter Wemm	They are copies of what I use on grendel.lut.fi, and offering them
1406c2aa98e2SPeter Wemm	does not imply that I would also support them.  I have sent the DB
1407c2aa98e2SPeter Wemm	port for SVR4 back to Keith Bostic for inclusion in the official
1408c2aa98e2SPeter Wemm	distribution, but I haven't heard anything from him as of today.
1409c2aa98e2SPeter Wemm
1410c2aa98e2SPeter Wemm	- gcc-2.4.5-svr4.tar.gz	(gcc 2.4.5 and the corresponding libg++)
1411c2aa98e2SPeter Wemm	- db-1.72.tar.gz	(with source, objects and a installed copy)
1412c2aa98e2SPeter Wemm
1413c2aa98e2SPeter Wemm	Cheers
1414c2aa98e2SPeter Wemm	+ Kim
1415c2aa98e2SPeter Wemm	--
1416c2aa98e2SPeter Wemm	 *  Kimmo.Suominen@lut.fi  *  SysVr4 enthusiast at GRENDEL.LUT.FI  *
1417c2aa98e2SPeter Wemm	*    KIM@FINFILES.BITNET   *  Postmaster and Hostmaster at LUT.FI   *
1418c2aa98e2SPeter Wemm	 *    + 358 200 865 718    *  Unix area moderator at NIC.FUNET.FI  *
1419c2aa98e2SPeter Wemm
1420c2aa98e2SPeter WemmConvexOS 10.1 and below
1421c2aa98e2SPeter Wemm	In order to use the name server, you must create the file
1422c2aa98e2SPeter Wemm	/etc/use_nameserver.  If this file does not exist, the call
1423c2aa98e2SPeter Wemm	to res_init() will fail and you will have absolutely no
1424c2aa98e2SPeter Wemm	access to DNS, including MX records.
1425c2aa98e2SPeter Wemm
1426c2aa98e2SPeter WemmAmdahl UTS 2.1.5
1427c2aa98e2SPeter Wemm	In order to get UTS to work, you will have to port BIND 4.9.
1428c2aa98e2SPeter Wemm	The vendor's BIND is reported to be ``totally inadequate.''
1429c2aa98e2SPeter Wemm	See sendmail/contrib/AmdahlUTS.patch for the patches necessary
1430c2aa98e2SPeter Wemm	to get BIND 4.9 compiled for UTS.
1431c2aa98e2SPeter Wemm
1432c2aa98e2SPeter WemmUnixWare
1433c2aa98e2SPeter Wemm	According to Alexander Kolbasov <sasha@unitech.gamma.ru>,
1434c2aa98e2SPeter Wemm	the m4 on UnixWare 2.0 (still in Beta) will core dump on the
1435c2aa98e2SPeter Wemm	config files.  GNU m4 and the m4 from UnixWare 1.x both work.
1436c2aa98e2SPeter Wemm
1437c2aa98e2SPeter Wemm	According to Larry Rosenman <ler@lerami.lerctr.org>:
1438c2aa98e2SPeter Wemm
1439c2aa98e2SPeter Wemm		UnixWare 2.1.[23]'s m4 chokes (not obviously) when
1440c2aa98e2SPeter Wemm		processing the 8.9.0 cf files.
1441c2aa98e2SPeter Wemm
1442c2aa98e2SPeter Wemm		I had a LOCAL_RULE_0 that wound up AFTER the
1443c2aa98e2SPeter Wemm		SBasic_check_rcpt rules using the SCO supplied M4.
1444c2aa98e2SPeter Wemm		GNU M4 works fine.
1445c2aa98e2SPeter Wemm
1446c2aa98e2SPeter WemmUNICOS 8.0.3.4
1447c2aa98e2SPeter Wemm	Some people have reported that the -O flag on UNICOS can cause
1448c2aa98e2SPeter Wemm	problems.  You may want to turn this off if you have problems
1449c2aa98e2SPeter Wemm	running sendmail.  Reported by Jerry G. DeLapp <jgd@acl.lanl.gov>.
1450c2aa98e2SPeter Wemm
1451c2aa98e2SPeter WemmGNU getopt
1452c2aa98e2SPeter Wemm	I'm told that GNU getopt has a problem in that it gets confused
1453c2aa98e2SPeter Wemm	by the double call.  Use the version in conf.c instead.
1454c2aa98e2SPeter Wemm
1455c2aa98e2SPeter WemmBIND 4.9.2 and Ultrix
1456c2aa98e2SPeter Wemm	If you are running on Ultrix, be sure you read conf/Info.Ultrix
1457c2aa98e2SPeter Wemm	in the BIND distribution very carefully -- there is information
1458c2aa98e2SPeter Wemm	in there that you need to know in order to avoid errors of the
1459c2aa98e2SPeter Wemm	form:
1460c2aa98e2SPeter Wemm
1461c2aa98e2SPeter Wemm		/lib/libc.a(gethostent.o): sethostent: multiply defined
1462c2aa98e2SPeter Wemm		/lib/libc.a(gethostent.o): endhostent: multiply defined
1463c2aa98e2SPeter Wemm		/lib/libc.a(gethostent.o): gethostbyname: multiply defined
1464c2aa98e2SPeter Wemm		/lib/libc.a(gethostent.o): gethostbyaddr: multiply defined
1465c2aa98e2SPeter Wemm
1466c2aa98e2SPeter Wemm	during the link stage.
1467c2aa98e2SPeter Wemm
146806f25ae9SGregory Neil ShapiroBIND 8.X
146906f25ae9SGregory Neil Shapiro	BIND 8.X returns HOST_NOT_FOUND instead of TRY_AGAIN on temporary
147006f25ae9SGregory Neil Shapiro	DNS failures when trying to find the hostname associated with an IP
147106f25ae9SGregory Neil Shapiro	address (gethostbyaddr()).  This can cause problems as
147206f25ae9SGregory Neil Shapiro	$&{client_name} based lookups in class R ($=R) and the access
147306f25ae9SGregory Neil Shapiro	database won't succeed.
147406f25ae9SGregory Neil Shapiro
147506f25ae9SGregory Neil Shapiro	This will be fixed in BIND 8.2.1.  For earlier versions, this can
147606f25ae9SGregory Neil Shapiro	be fixed by making "dns" the last name service queried for host
147706f25ae9SGregory Neil Shapiro	resolution in /etc/irs.conf:
147806f25ae9SGregory Neil Shapiro
147906f25ae9SGregory Neil Shapiro		hosts local continue
148006f25ae9SGregory Neil Shapiro		hosts dns
148106f25ae9SGregory Neil Shapiro
1482c2aa98e2SPeter Wemmstrtoul
1483c2aa98e2SPeter Wemm	Some compilers (notably gcc) claim to be ANSI C but do not
1484c2aa98e2SPeter Wemm	include the ANSI-required routine "strtoul".  If your compiler
1485c2aa98e2SPeter Wemm	has this problem, you will get an error in srvrsmtp.c on the
1486c2aa98e2SPeter Wemm	code:
1487c2aa98e2SPeter Wemm
1488c2aa98e2SPeter Wemm	  # ifdef defined(__STDC__) && !defined(BROKEN_ANSI_LIBRARY)
1489c2aa98e2SPeter Wemm			e->e_msgsize = strtoul(vp, (char **) NULL, 10);
1490c2aa98e2SPeter Wemm	  # else
1491c2aa98e2SPeter Wemm			e->e_msgsize = strtol(vp, (char **) NULL, 10);
1492c2aa98e2SPeter Wemm	  # endif
1493c2aa98e2SPeter Wemm
1494c2aa98e2SPeter Wemm	You can use -DBROKEN_ANSI_LIBRARY to get around this problem.
1495c2aa98e2SPeter Wemm
1496c2aa98e2SPeter WemmListproc 6.0c
1497c2aa98e2SPeter Wemm	Date: 23 Sep 1995 23:56:07 GMT
1498c2aa98e2SPeter Wemm	Message-ID: <95925101334.~INN-AUMa00187.comp-news@dl.ac.uk>
1499c2aa98e2SPeter Wemm	From: alansz@mellers1.psych.berkeley.edu (Alan Schwartz)
1500c2aa98e2SPeter Wemm	Subject: Listproc 6.0c + Sendmail 8.7 [Helpful hint]
1501c2aa98e2SPeter Wemm
1502c2aa98e2SPeter Wemm	Just upgraded to sendmail 8.7, and discovered that listproc 6.0c
1503c2aa98e2SPeter Wemm	breaks, because it, by default, sends a blank "HELO" rather than
1504c2aa98e2SPeter Wemm	a "HELO hostname" when using the 'system' or 'telnet' mailmethod.
1505c2aa98e2SPeter Wemm
1506c2aa98e2SPeter Wemm	The fix is to include -DZMAILER in the compilation, which will
1507c2aa98e2SPeter Wemm	cause it to use "HELO hostname" (which Z-mail apparently requires
1508c2aa98e2SPeter Wemm	as well. :)
1509c2aa98e2SPeter Wemm
151006f25ae9SGregory Neil ShapiroOpenSSL
151106f25ae9SGregory Neil Shapiro	OpenSSL versions prior to 0.9.6 use a macro named Free which
151206f25ae9SGregory Neil Shapiro	conflicts with existing macro names on some platforms, such as
151306f25ae9SGregory Neil Shapiro	AIX.
151442e5d165SGregory Neil Shapiro	Do not use 0.9.3, but OpenSSL 0.9.5a or later if compatible with
151542e5d165SGregory Neil Shapiro	0.9.5a.
1516c2aa98e2SPeter Wemm
1517193538b7SGregory Neil Shapirosfio
1518193538b7SGregory Neil Shapiro	You may run into problems if you use sfio2000 (the body of a
1519193538b7SGregory Neil Shapiro	message is lost).  Use sfio1999 instead; however, it also has
1520193538b7SGregory Neil Shapiro	a bug that can cause sendmail to fail.  A patch has been provided
1521193538b7SGregory Neil Shapiro	by Petr Lampa of Brno University of Technology, which is given here:
1522193538b7SGregory Neil Shapiro
1523193538b7SGregory Neil Shapirodiff -rc ../../../../sfio/src/lib/sfio/sfputr.c ./sfputr.c
1524193538b7SGregory Neil Shapiro*** ../../../../sfio/src/lib/sfio/sfputr.c      Tue May 16 18:25:49 2000
1525193538b7SGregory Neil Shapiro--- ./sfputr.c  Wed Sep 20 09:06:01 2000
1526193538b7SGregory Neil Shapiro***************
1527193538b7SGregory Neil Shapiro*** 24,29 ****
1528193538b7SGregory Neil Shapiro--- 24,30 ----
1529193538b7SGregory Neil Shapiro        for(w = 0; (*s || rc >= 0); )
1530193538b7SGregory Neil Shapiro        {       SFWPEEK(f,ps,p);
1531193538b7SGregory Neil Shapiro
1532193538b7SGregory Neil Shapiro+               if(p == -1) return -1;  /* PL */
1533193538b7SGregory Neil Shapiro                if(p == 0 || (f->flags&SF_WHOLE) )
1534193538b7SGregory Neil Shapiro                {       n = strlen(s);
1535193538b7SGregory Neil Shapiro                        if(p >= (n + (rc < 0 ? 0 : 1)) )
1536193538b7SGregory Neil Shapiro
1537193538b7SGregory Neil Shapiro
153806f25ae9SGregory Neil ShapiroPH
153906f25ae9SGregory Neil Shapiro	PH support is provided by Mark Roth <roth@uiuc.edu>.  The map is
1540193538b7SGregory Neil Shapiro	described at http://www-dev.cso.uiuc.edu/sendmail/ .
154106f25ae9SGregory Neil Shapiro	Please contact Mark Roth for support and questions regarding the
154206f25ae9SGregory Neil Shapiro	map.
15432e43090eSPeter Wemm
1544c2aa98e2SPeter WemmTCP Wrappers
1545c2aa98e2SPeter Wemm	If you are using -DTCPWRAPPERS to get TCP Wrappers support you will
1546c2aa98e2SPeter Wemm	also need to install libwrap.a and modify your site.config.m4 file
1547c2aa98e2SPeter Wemm	or the generated Makefile to include -lwrap in the LIBS line
1548c2aa98e2SPeter Wemm	(make sure that INCDIRS and LIBDIRS point to where the tcpd.h and
1549c2aa98e2SPeter Wemm	libwrap.a can be found).
1550c2aa98e2SPeter Wemm
155106f25ae9SGregory Neil Shapiro	TCP Wrappers is available at ftp://ftp.porcupine.org/pub/security/.
1552c2aa98e2SPeter Wemm
1553c2aa98e2SPeter Wemm	If you have alternate MX sites for your site, be sure that all of
1554c2aa98e2SPeter Wemm	your MX sites reject the same set of hosts.  If not, a bad guy whom
1555c2aa98e2SPeter Wemm	you reject will connect to your site, fail, and move on to the next
1556c2aa98e2SPeter Wemm	MX site, which will accept the mail for you and forward it on to you.
1557c2aa98e2SPeter Wemm
1558c2aa98e2SPeter WemmRegular Expressions (MAP_REGEX)
1559c2aa98e2SPeter Wemm	If sendmail linking fails with:
1560c2aa98e2SPeter Wemm
1561c2aa98e2SPeter Wemm		undefined reference to 'regcomp'
1562c2aa98e2SPeter Wemm
1563c2aa98e2SPeter Wemm	or sendmail gives an error about a regular expression with:
1564c2aa98e2SPeter Wemm
1565c2aa98e2SPeter Wemm		pattern-compile-error: : Operation not applicable
1566c2aa98e2SPeter Wemm
1567c2aa98e2SPeter Wemm	Your libc does not include a running version of POSIX-regex. Use
1568c2aa98e2SPeter Wemm	librx or regex.o from the GNU Free Software Foundation,
1569c2aa98e2SPeter Wemm	ftp://ftp.gnu.org/pub/gnu/rx-?.?.tar.gz or
1570c2aa98e2SPeter Wemm	ftp://ftp.gnu.org/pub/gnu/regex-?.?.tar.gz.
1571c2aa98e2SPeter Wemm	You can also use the regex-lib by Henry Spencer,
1572c2aa98e2SPeter Wemm	ftp://ftp.funet.fi/pub/languages/C/spencer/regex.shar.gz
1573c2aa98e2SPeter Wemm	Make sure, your compiler reads regex.h from the distribution,
1574c2aa98e2SPeter Wemm	not from /usr/include, otherwise sendmail will dump a core.
1575c2aa98e2SPeter Wemm
1576c2aa98e2SPeter Wemm
1577c2aa98e2SPeter Wemm+--------------+
1578c2aa98e2SPeter Wemm| MANUAL PAGES |
1579c2aa98e2SPeter Wemm+--------------+
1580c2aa98e2SPeter Wemm
158106f25ae9SGregory Neil ShapiroThe manual pages have been written against the -man macros, and
158206f25ae9SGregory Neil Shapiroshould format correctly with any reasonable *roff.
1583c2aa98e2SPeter Wemm
1584c2aa98e2SPeter Wemm+-----------------+
1585c2aa98e2SPeter Wemm| DEBUGGING HOOKS |
1586c2aa98e2SPeter Wemm+-----------------+
1587c2aa98e2SPeter Wemm
1588c2aa98e2SPeter WemmAs of 8.6.5, sendmail daemons will catch a SIGUSR1 signal and log
1589c2aa98e2SPeter Wemmsome debugging output (logged at LOG_DEBUG severity).  The
1590c2aa98e2SPeter Wemminformation dumped is:
1591c2aa98e2SPeter Wemm
1592c2aa98e2SPeter Wemm * The value of the $j macro.
1593c2aa98e2SPeter Wemm * A warning if $j is not in the set $=w.
1594c2aa98e2SPeter Wemm * A list of the open file descriptors.
1595c2aa98e2SPeter Wemm * The contents of the connection cache.
1596c2aa98e2SPeter Wemm * If ruleset 89 is defined, it is evaluated and the results printed.
1597c2aa98e2SPeter Wemm
1598c2aa98e2SPeter WemmThis allows you to get information regarding the runtime state of the
1599c2aa98e2SPeter Wemmdaemon on the fly.  This should not be done too frequently, since
1600c2aa98e2SPeter Wemmthe process of rewriting may lose memory which will not be recovered.
1601c2aa98e2SPeter WemmAlso, ruleset 89 may call non-reentrant routines, so there is a small
1602c2aa98e2SPeter Wemmnon-zero probability that this will cause other problems.  It is
1603c2aa98e2SPeter Wemmreally only for debugging serious problems.
1604c2aa98e2SPeter Wemm
1605c2aa98e2SPeter WemmA typical formulation of ruleset 89 would be:
1606c2aa98e2SPeter Wemm
1607c2aa98e2SPeter Wemm	R$*		$@ $>0 some test address
1608c2aa98e2SPeter Wemm
1609c2aa98e2SPeter Wemm
1610c2aa98e2SPeter Wemm+-----------------------------+
1611c2aa98e2SPeter Wemm| DESCRIPTION OF SOURCE FILES |
1612c2aa98e2SPeter Wemm+-----------------------------+
1613c2aa98e2SPeter Wemm
1614c2aa98e2SPeter WemmThe following list describes the files in this directory:
1615c2aa98e2SPeter Wemm
161606f25ae9SGregory Neil ShapiroBuild		Shell script for building sendmail.
161706f25ae9SGregory Neil ShapiroMakefile	A convenience for calling ./Build.
1618c2aa98e2SPeter WemmMakefile.m4	A template for constructing a makefile based on the
161906f25ae9SGregory Neil Shapiro		information in the devtools directory.
1620c2aa98e2SPeter WemmREADME		This file.
1621c2aa98e2SPeter WemmTRACEFLAGS	My own personal list of the trace flags -- not guaranteed
1622c2aa98e2SPeter Wemm		to be particularly up to date.
1623c2aa98e2SPeter Wemmalias.c		Does name aliasing in all forms.
162406f25ae9SGregory Neil Shapiroaliases.5	Man page describing the format of the aliases file.
1625c2aa98e2SPeter Wemmarpadate.c	A subroutine which creates ARPANET standard dates.
162606f25ae9SGregory Neil Shapirobf.h		Buffered file I/O function declarations.
162706f25ae9SGregory Neil Shapirobf_portable.c	Stub routines for systems lacking the Torek stdio library.
162806f25ae9SGregory Neil Shapirobf_portable.h	Data structure and function declarations for bf_portable.c.
162906f25ae9SGregory Neil Shapirobf_torek.c	Routines to implement memory-buffered file system using
163006f25ae9SGregory Neil Shapiro		hooks provided by Torek stdio library.
163106f25ae9SGregory Neil Shapirobf_torek.h	Data structure and function declarations for bf_torek.c.
1632c2aa98e2SPeter Wemmclock.c		Routines to implement real-time oriented functions
1633c2aa98e2SPeter Wemm		in sendmail -- e.g., timeouts.
1634c2aa98e2SPeter Wemmcollect.c	The routine that actually reads the mail into a temp
1635c2aa98e2SPeter Wemm		file.  It also does a certain amount of parsing of
1636c2aa98e2SPeter Wemm		the header, etc.
1637c2aa98e2SPeter Wemmconf.c		The configuration file.  This contains information
1638c2aa98e2SPeter Wemm		that is presumed to be quite static and non-
1639c2aa98e2SPeter Wemm		controversial, or code compiled in for efficiency
1640c2aa98e2SPeter Wemm		reasons.  Most of the configuration is in sendmail.cf.
1641c2aa98e2SPeter Wemmconf.h		Configuration that must be known everywhere.
1642c2aa98e2SPeter Wemmconvtime.c	A routine to sanely process times.
1643c2aa98e2SPeter Wemmdaemon.c	Routines to implement daemon mode.  This version is
1644c2aa98e2SPeter Wemm		specifically for Berkeley 4.1 IPC.
1645c2aa98e2SPeter Wemmdeliver.c	Routines to deliver mail.
1646c2aa98e2SPeter Wemmdomain.c	Routines that interface with DNS (the Domain Name
1647c2aa98e2SPeter Wemm		System).
1648c2aa98e2SPeter Wemmenvelope.c	Routines to manipulate the envelope structure.
164906f25ae9SGregory Neil Shapiroerr.c		Routines to print error messages.
1650c2aa98e2SPeter Wemmheaders.c	Routines to process message headers.
165106f25ae9SGregory Neil Shapirohelpfile	An example helpfile for the SMTP HELP command and -bt mode.
1652c2aa98e2SPeter Wemmmacro.c		The macro expander.  This is used internally to
1653c2aa98e2SPeter Wemm		insert information from the configuration file.
165406f25ae9SGregory Neil Shapiromailq.1		Man page for the mailq command.
1655c2aa98e2SPeter Wemmmain.c		The main routine to sendmail.  This file also
1656c2aa98e2SPeter Wemm		contains some miscellaneous routines.
165706f25ae9SGregory Neil Shapiromakesendmail	A convenience for calling ./Build.
1658c2aa98e2SPeter Wemmmap.c		Support for database maps.
1659c2aa98e2SPeter Wemmmci.c		Routines that handle mail connection information caching.
166006f25ae9SGregory Neil Shapiromilter.c	MTA portions of the mail filter API.
1661c2aa98e2SPeter Wemmmime.c		MIME conversion routines.
166206f25ae9SGregory Neil Shapironewaliases.1	Man page for the newaliases command.
1663c2aa98e2SPeter Wemmparseaddr.c	The routines which do address parsing.
1664c2aa98e2SPeter Wemmqueue.c		Routines to implement message queueing.
1665c2aa98e2SPeter Wemmreadcf.c	The routine that reads the configuration file and
1666c2aa98e2SPeter Wemm		translates it to internal form.
1667c2aa98e2SPeter Wemmrecipient.c	Routines that manipulate the recipient list.
1668c2aa98e2SPeter Wemmsavemail.c	Routines which save the letter on processing errors.
166906f25ae9SGregory Neil Shapirosendmail.8	Man page for the sendmail command.
1670c2aa98e2SPeter Wemmsendmail.h	Main header file for sendmail.
167106f25ae9SGregory Neil Shapirosfsasl.c	I/O interface between SASL/TLS and the MTA using SFIO.
167206f25ae9SGregory Neil Shapirosfsasl.h	Header file for sfsasl.c.
167306f25ae9SGregory Neil Shapiroshmticklib.c	Routines for shared memory counters.
1674c2aa98e2SPeter Wemmsrvrsmtp.c	Routines to implement server SMTP.
1675c2aa98e2SPeter Wemmstab.c		Routines to manage the symbol table.
1676c2aa98e2SPeter Wemmstats.c		Routines to collect and post the statistics.
167706f25ae9SGregory Neil Shapirostatusd_shm.h	Data structure and function declarations for shmticklib.c.
1678c2aa98e2SPeter Wemmsysexits.c	List of error messages associated with error codes
1679c2aa98e2SPeter Wemm		in sysexits.h.
168006f25ae9SGregory Neil Shapirosysexits.h	List of error codes for systems that lack their own.
168106f25ae9SGregory Neil Shapirotimers.c	Routines to provide microtimers.
168206f25ae9SGregory Neil Shapirotimers.h	Data structure and function declarations for timers.h.
1683c2aa98e2SPeter Wemmtrace.c		The trace package.  These routines allow setting and
1684c2aa98e2SPeter Wemm		testing of trace flags with a high granularity.
1685c2aa98e2SPeter Wemmudb.c		The user database interface module.
1686c2aa98e2SPeter Wemmusersmtp.c	Routines to implement user SMTP.
1687c2aa98e2SPeter Wemmutil.c		Some general purpose routines used by sendmail.
1688c2aa98e2SPeter Wemmversion.c	The version number and information about this
168906f25ae9SGregory Neil Shapiro		version of sendmail.
1690c2aa98e2SPeter Wemm
1691602a2b1bSGregory Neil Shapiro(Version $Revision: 8.263.2.1.2.32 $, last update $Date: 2001/01/29 23:45:22 $ )
1692