The following files/programs are needed on clients:

$MAILSHARE/zmailer.conf

The $MAILSERVER variable may be set to the mail server host's name. This is not required as mailq will usually be able to discover this by itself.

/usr/lib/sendmail

to submit mail

mailq

should be installed in the site's local bin so people can query the mail server. (Remember to update /etc/services)

$POSTOFFICE/

This directory from the server should be mounted and writable.

User environment variables

ZCONFIG="/file/path"

Using this is alternate for using “--with-zconfig=../” option. Not needed if the --prefix= derived $MAILSHARE/zmailer.conf is used.

CC="command", CFLAGS="options"

Obvious ones, compiler, and possible “-g -O” flags…

CPPDEP="command"

Not normally needed — builds dependencies

INEWSBIN=/file/path

If you want to pre-define where your “inews” program is — for possible use of “usenet” channel.

Options for various facilities

--prefix=/DIR/PATH

The only really mandatory option, gives actually defaults for ZENV variables: $MAILSHARE, $MAILVAR, $MAILBIN.

--with-gcc

Compile with GCC even when you have “cc” around.

--with-zconfig=/FILE/PATH

Where the run-time zmailer.conf file is located at (and with what name). This is the only hard-coded info within libraries and thus programs using them. Everything else is run-time relocatable by means of using “variables” listed in this file.

Default: $MAILSHARE/zmailer.conf

Lots of ZCONFIG environment variables are pre-set from values present in pre-existing file.

When environment variable ZCONFIG is set and exported to the ./configure script, use of “--with-zconfig=no” will set the location of the file, but prevents pre-load of various values from it to the auto-configuration environment.

--with-zconfig-noload

Without this option the configuration will load ZENV variable values from possibly existing ZCONFIG file.

Default: values will be preloaded without this option.

--with-mailbox=/DIR/PATH

Overrides system-dependent location of the user mail-boxes. Defaults are looked up thru list of directories:

/var/mail /var/spool/mail /usr/mail /usr/spool/mail

First found directory will be the default — or then system yields /usr/spool/mail.

--with-postoffice=/DIR/PATH

Overrides system-dependent location of the “$POSTOFFICE” directory under which system stores queued email. Will try directories /{usr,var}/spool/postoffice/ to see, if previously installed directory tree exists. Default will be /var/spool/postoffice/ in case there is no previously created postoffice directory.

--with-mailshare=/DIR/PATH, --with-mailvar=/DIR/PATH, --with-mailbin=/DIR/PATH

These are overrides for values derived from --prefix=/DIR option, or possibly pre-loaded from ZCONFIG file.

MAILSHARE = "$PREFIX", MAILVAR = "$PREFIX", but MAILBIN = "$PREFIX/bin".

--with-logdir=/DIR/PATH

Explicit value to replace $LOGDIR ZENV value and/or to override default value of: /var/log/mail/

--with-nntpserver=HOST

If you want to use “usenet” channel, you need to name NNTP server into which you feed news with NNTP.

--with-sendmailpath=/FILE/PATH

Overrides for default location(s) of sendmail program. ZENV variable $SENDMAILPATH can be overridden with this.

--with-rmailpath=/FILE/PATH

Overrides for default location(s) of rmail program. ZENV variable $RMAILPATH can be overridden with this.

--with-selfaddresses="NAME,NAME"

Obsolete option regarding providing into in ZENV variable to yield system internal names auto-magically for the SMTP transport channel uses, and also for the router to see, if destination IP address is local at the system.

Usage of this option may become necessary at load-balance clusters, but even then, setting the value to the ZCONFIG file is easier than pre-configuring them.

--with-system-malloc

Use system malloc() library, don't compile own: Alternate for using: --with-libmalloc=system This is default.

--with-libmalloc=LIBNAME

Where “LIBNAME” is one of:

system

System malloc() as is.

malloc

Bundled "libmalloc" without debugging things.

malloc_d

Bundled "libmalloc" with debugging things.

--with-yp

Want to use YP, and has it at default locations

--with-yp-lib='-L... -lyp'

If needed to define linking-time options to find the YP-library.

--with-ldap-prefix=DIRPREFIX

If UMich/NetScape LDAP are available thru DIRPREFIX/include/ and DIRPREFIX/lib/ locations, this is a short-hand to find the interface — with files in the system primary include and lib locations, “/usr” is a special value which will be ignored. There is no default value for DIRPREFIX.

--with-ldap-include-dir=/DIR/PATH

Special over-rider for compilation include directory of LDAP

--with-ldap-library-dir=/DIR/PATH

Special over-rider for linkage library directory of LDAP

--disable-pam

Disable PAM(3) facility from becoming auto-configured even when its API headers and libraries are present.

--without-fsync

At systems where the local file-system is log-based/journaling, doing fsync() is wasteful. This disables fsync() in cases where it is not needed. (In others it may boost your system performance by about 20% — with dangers… On the other hand, once a system disk(?) fault which hang mailer at spool directory access did cause severe damage all over, and probably use of this option would not have made any difference; fsck was mighty unhappy.)

--with-bundled-libresolv

If your system is not very modern, you may consider using this option to compile in a resolver from bind-4.9.4-REL. On the other hand, if your system is modern, it may have even newer resolver in it. At such time, don't use this!

--with-ipv6

Use IPv6 at things where it is supported. This is often highly experimental, although many subsystems in ZMailer are built with getnameinfo() et.al. interfaces, which works both on IPv4 and IPv6.

--with-ipv6-replacement-libc

If the system needs more support for user-space IPv6 things, this generates those.

--without-maillock

Don't use maillock(3) even if system has it. (Solaris maillock(3) is ok, some early Linux versions weren't…)

--without-rfc822-tabs

Some systems dislike getting RFC-822 headers with form of:

"Headername: <TAB> value"

With this option, no TABs are used and instead “ordinary” space character is used.

In real life, this feature is superseded by the router to always TABifying all headers, and the transport-agent header write-out to untabifying them, if ZENV variable RFC822TABS= has value “0”.

--with-tcp-wrappers, --with-tcp-wrappers=/DIR/PATH

Optional =/DIR/PATH value gives directory where there are tcpd.h and libwrap.a files. Without value this option looks for several common locations for those files, and if finds them, yields compile and linking hooks,

--with-ta-mmap

On some systems with good mmap(2) with “MAP_FILE|MAP_SHARED,” and well behaving munmap() it does make sense to replace read()/write() thru a file-descriptor to the file with mmap() — however that requires munmap() not to scrub away in-mapped blocks any more actively, than the buffer-cache works at read()/write() blocks.

This was default for a while, however most systems don't have really well-behaved munmap()s :-/ (Perhaps IBM AIX is the only exception ?)

--with-mboxquotacheck

Set 'CHECK_MB_SIZE' #define for mailbox.c compilation, and expect checkmbsize() function to be found via --with-generic-lib= referred library.

--with-privateauth"

Use “private/” sub-directory in a part of smtpserver program compilation.

--with-privatembox"

Use “private/” sub-directory in a part of mailbox program compilation.

--with-getpwnam-library="-L... -l..."

Certain sites have expressed wishes to use their own libraries to replace the standard getpwnam() (and possibly getpwuid()) routines. These are used in router, scheduler, mailbox, hold, and vacation programs.

These programs use getpwnam() libary call to look up various customer user-names to whatever the system needs them for.

For ZMailer needs the library must support user-ids:

• root

• daemon, or daemons

• nobody

and whatever others your local system magic needs.

--with-generic-include="-I/..."

This parameter allows ubiquitous “-I/...” options to be used in all program compilations throughout the package.

--with-generic-library="-L/..."

This parameter allows ubiquitous “-L/...” options to be used in all program linkages throughout the package.

--with-openssl, --with-openssl-prefix="/dir/prefix", --with-openssl-include="/dir/incl", --with-openssl-lib="/dir/lib"

Search for, and use OpenSSL, if it can be found. (For optional in and outbound SMTP traffic encryption on the Internet.)

--with-whoson, --with-whoson="/dir/prefix"

This does explicit integration with “whoson” server; see the “whoson-*.tar.gz” file in the “contrib/” sub-directory.

Runtime ZENV Variables

ZCONFIG=

ZCONFIG is the pathname of the configuration file specifying all the other host-dependent information needed by ZMailer programs. This file is created from the Config file in the distribution (the file you are reading right now), and contains variable assignments in an sh-compatible format.

MAILBIN=

MAILBIN is the directory hierarchy containing all ZMailer binaries. Usually /usr/lib/mail/bin or /local/lib/mail.

MAILSHARE=

MAILSHARE is the directory hierarchy containing site-wide configuration files and databases. Usually /usr/lib/mail or /local/share/mail.

MAILVAR=

MAILVAR is the directory that will contain machine-specific configuration files and databases. Usually /usr/lib/mail or /var/db/mail or /local/share/mail.

MAILBOX=

MAILBOX is the directory containing all the user mailboxes. This is defaulted inside the mailbox.c program (currently /var/mail) and may be overridden here. Usually /usr/spool/mail or /var/mail.

POSTOFFICE=

POSTOFFICE is the directory hierarchy used to manipulate message files, where runtime activity takes places. Usually /usr/spool/postoffice or /var/spool/postoffice.

ROUTERDIRS=

Multiple LOWER priorities on message routing can be defined by creating $POSTOFFICE/<component-of-$ROUTERDIRS> -directories. Routers process first $POSTOFFICE/router/ -directory, and once it is empty, files from subsequent dirs. See mail(3) mail_priority These can be only under the $POSTOFFICE.

ROUTERDIRS=router1:router2:router3:router4

ROUTERDIRHASH=

When defined, ROUTERDIRHASH submits messages immediately into the 'A' thru 'Z' subdirectory of whatever directory (e.g. see ROUTERDIRS). IF NO SUCH "hash subdirs" EXIST, MESSAGE SUBMISSION WILL FAIL! (The value must be "1" for this to take effect!)

LOGDIR=

LOGDIR is the directory where log files will appear. Usually /usr/spool/log or /var/log.

MANDIR=

MANDIR is the top of the manual directory hierarchy where manual pages for the ZMailer programs are installed. Usually /usr/man or /local/man.

LIBRARYDIR=

# LIBRARYDIR is the place for storing libzmailer.a, which can be used to # create programs which use Zmailer's zmailer(3) (aka: mail(3)) -library. LIBRARYDIR= @libdir@

INCLUDEDIR=

# INCLUDEDIR is the place for storing zmailer.h -- a copy of include/mail.h # and it is used in conjunction with the libzmailer.a .. INCLUDEDIR= @includedir@

SMTPOPTIONS=

# SMTPOPTIONS are command line options given to the smtpserver when started # from the zmailer shell script. The intent is that if you want non-default # address verification options they can be specified here. The default # value is "-sve". This is also used, when invoking ``sendmail'' with # "-bs" option. #SMTPOPTIONS= "-l ${LOGDIR}/smtpserver" SMTPOPTIONS= @SMTPOPTIONS@

ALLOWSOURCEROUTE=

# ALLOWSOURCEROUTE (when present) stops the system from ignoring # the old RFC821/822 source routes of type: @a,@b:c@d; By "ignoring" # we mean here that system chops away "@a,@b:" and uses only: c@d # This is done at all input portals; smtpserver, and at sendmail/rmail. #ALLOWSOURCEROUTE=

SCHEDULEROPTIONS=

# SCHEDULEROPTIONS are command line options given to the scheduler when # started from the zmailer shell script. The intent is that if you want # non-default logging options, the can be specified here. The default # value is "" # #SCHEDULEROPTIONS= "-l ${LOGDIR}/scheduler.perflog -S -H" SCHEDULEROPTIONS= @SCHEDULEROPTIONS@

SCHEDULERDIRHASH=

# The SCHEDULERDIRHASH is magic thing to tell to the router that it # should move resulting files directly into hash subdir(s) of the # scheduler subsystem, and not only to the main-level. # Existence of this variable also overrides -H option(s) to # the scheduler. Value is the number of -H options. # If these hash subdirectories don't exist, system failure happens! SCHEDULERDIRHASH=1

SCHEDULERNOTIFY=

# The SCHEDULERNOTIFY defines, where is a socket at which the scheduler # listens for PF_UNIX/SOCK_DGRAM messages telling paths to new jobs. # The router(s) inform the scheduler of new jobs. SCHEDULERNOTIFY=@POSTOFFICE@/.scheduler.notify

ROUTERNOTIFY=

# The ROUTERNOTIFY defines, where is a socket at which the router # listens for PF_UNIX/SOCK_DGRAM messages telling paths to new jobs. # The injection library informs the router queuing subsystem of new jobs. ROUTERNOTIFY=@POSTOFFICE@/.router.notify

ROUTEROPTIONS=

# ROUTEROPTIONS are command line options given to the router when started # from the zmailer shell script. The default values are "-dkn 4" #ROUTEROPTIONS= "-dkn 4" ROUTEROPTIONS= @ROUTEROPTIONS@

MAILSERVER=

# MAILSERVER is the hostname of the remote machine where the postoffice is # located. This value is only needed in an environment with distributed file # systems, and if it exists will be used by the mail queue querying program # as the default name of the host to query. It is a way of overriding the # algorithm used by mailq in an NFS environment, or when you are running a # different kind of DFS. Usually undefined or a hostname. #MAILSERVER= neat.cs

PUNTHOST=

# PUNTHOST is where mail that is supposed to go to a local address, but # no such address exists, is punted to. #PUNTHOST= relay.cs

FORCEPUNT=

# FORCEPUNT is for cases when the local machine under no circumstances # is to store any email locally, but send all such to this given address # (local host is a member on a "cluster" whose message store is at some # other cluster server, and said node handles "local" delivery for all # cluster members... *including* running pipes..) #FORCEPUNT= mailhost

SMARTHOST=

# SMARTHOST is where mail that cannot be resolved or routed is punted to. # There used to be a variable for this, now a better way is to use 'routes' # database at which you put line: . smtp!smart.host.name # (That is: dot, white-space(s), "smtp!smart.host.name" )

NOBODY=

# NOBODY is the unprivileged UID value. # This is absolutely necessary if setuid() will fail on your "nobody" account # uid (if it is -2, for example). Make sure that whatever value you give # here will work with setuid(). Values between 1 and 29999 will usually work. # BE CAREFULL WITH THIS! THE SYSTEM RELIES ON IT VERY MUCH IN DEED! # (On SunOS 4.1.x, the value of "-2" works the best, on Solaris the default # for nobody is 60001! If your system has "nobody" "account", use here the # name instead of number -- it should (usually) work) # -- Use a mapping via /etc/passwd, this is most generic.. NOBODY=nobody

LOGLEVEL=

# LOGLEVEL may be set to restrict the log output of the router to entries # whose tags are found in the specified string value. The currently known # tags are: # address: deferred: file: header_defer: info: recipient: #LOGLEVEL= "file: recipient:" LOGLEVEL= "deferred: file: header_defer:"

NNTPSERVER=

# Builtin USENET channel uses NNTPSERVER variable (depending upon your # inews ..) to send the artickle to.. NNTPSERVER= @NNTPSERVER@

INEWSBIN=

# Builtin USENET channel uses NNTPSERVER variable (depending upon your # inews ..) to send the artickle to.. INEWSBIN= @INEWS@

SENDMAILPATH=

# Where the sendmail (compability one) shall be located ? SENDMAILPATH= @SENDMAILPATH@

RMAILPATH=

# Where is the rmail to be located at ? RMAILPATH= @RMAILPATH@

BLOCKLOCKS=

# MAILBOX locking scheme -- no configuration option (yet) # See man-page of mailbox.8 for details; the order of key-chars # is meaningfull: # `.' Dotlock scheme for mailboxes at $MAILBOX/ directory # `F' flock() locking of files (and perhaps mailboxes) # `L' lockf() locking of files (and perhaps mailboxes) # `:' Separates the two parts of the parameter; left part # is for the mailbox locking, and right part is for # all other kinds of files. # # We use compiled-in defaults at the mailbox program! # Following examples are for flock(), and lockf() systems with their # respective defaults. ( Systems capable to use both will use lockf() ) #MBOXLOCKS=".F:F" #MBOXLOCKS=".L:L"

SELFADDRESSES=

# The SELFADDRESSES is a comma separated list of IP address literals # listing all of our acceptable IP addresses (Comma because IPv6 uses # colon for short-hand notation..): # For usual (IPv4) universe, no addresses are needed listing, however # for IPv6 it may be necessary - likewise if you want to use cluster-mode, # you may want to list all *cluster* addresses here - nodes know only # their local ones, after all.. (See: doc/guides/etrn-cluster) #SELFADDRESSES=[1.2.3.4],[2.3.4.5],[ipv6.::1.2.3.4] SELFADDRESSES=@SELFADDRESSES@

DBTYPE=

# What kind of DB type we prefer to use ? We can support several, # after all... btree/ndbm/gdbm ... (DBEXT: pag/db/dat) DBTYPE=@DBTYPE@

DBEXT=

# What kind of DB type we prefer to use ? We can support several, # after all... btree/ndbm/gdbm ... (DBEXT: pag/db/dat) DBEXT=@DBEXT@

DBEXTtest=

# What kind of DB type we prefer to use ? We can support several, # after all... btree/ndbm/gdbm ... (DBEXT: pag/db/dat) DBEXTtest=@DBEXTtest@

DEFCHARSET=

# The characterset to be used as a default when turning 8-bit containing # headers to MIME-2 headers -- and what to say at the default generated # "Content-Type: text/plain; charset=XXXX" -header in case the original # message was not of MIME, and still had 8-bit chars... DEFCHARSET=ISO-8859-1

RFC822TABS=

# We want those nice tabs between the header field name and value # The task of generating TABs or SPACEs is at TA *writeheaders(). # Value '0' here yields expansion of possibly existing header resident # line-start TABs. There is no mechanism to turn line-start SPACEs # to TABs with any other value stored here. RFC822TABS=@RFC822TABS@

MAX_NR, MAX_NT, MAX_LOAD=

# If the following limitations are exceeded then zmailcheck # will sent an alert. # Limit on the Router Queue MAX_NR=1000 # Limit on Transport Queue MAX_NT=1000 # Load times 100 MAX_LOAD=300

SYSLOGFLG=

# SYSLOGFLG tells which systems use syslog to log things: # Set of chars which are as follows: # S smtpserver and @SENDMAILPATH@ # R router # T transport agents # C scheduler completion of a message # #SYSLOGFLG=SRT SYSLOGFLG=RT

TRUSTEDUSER=

# Per default, ZMailer uses ``daemon'' userid when it wants to # operate in ``runastrusteduser()'' mode. Finding that userid # (or rather its numeric uid) can be a bit difficult, and if it # *fails*, apparently uid 65535 will be used. # #TRUSTEDUSER=daemon

ORGDOMAIN=

# Use ORGDOMAIN in ZENV if the system can't generate # MIME multipart boundary string contained host/domain ids # automagically... # #ORGDOMAIN=my.local.domain

ROUTEUSER_IN_ABNORMAL_UNIX=

# Depending, are you running strange private customer account databases # hooked (only) into 'mailbox', or not, make sure following is non-empty # if you *are* using private databases, as then ZMailer's router won't # claim wronly userid to be nonexistent.. These shunted tests look for # HOMEDIRECTORY, which might be nonexistent thing at such funny systems... # An EMPTY string means "this is NORMAL unix": # # (A "bug" is that this isn't automatically substituted, but non-void # content gives behaviour that has been around for quite a while...) # ROUTEUSER_IN_ABNORMAL_UNIX="@ROUTEUSER_IN_ABNORMAL_UNIX@"

LISTSERV=

# Some sites (well, one FUNET site), has LISTSERV, this is for # configuring that subpart of the aliases.cf scripts: #LISTSERV=/v/net/listserv.funet.fi