UPDATE-EXIM4DEFAULTS(8) System Manager's Manual UPDATE-EXIM4DEFAULTS(8)
NAME
update-exim4defaults - Manage exim4 daemon default file.
SYNOPSIS
update-exim4defaults [ --qflags flags ] [ --queuerunner com-
bined|queueonly|separate|ppp|no|nodaemon ] [ --queuetime time ] [
--commonoptions options ] [ --queuerunneroptions options ] [ --smtplis-
teneroptions options ] [ --remove-common options ] [ --remove-queue op-
tions ] [ --remove-smtp options ] [ --force|-f ] [ --help|-h ] [ --init
]
DESCRIPTION
update-exim4defaults allows one to set run parameters for the Exim dae-
mon in /etc/default/exim4. Its main purpose is for interaction with
packages enhancing Exim like virus-scanners that need to change the way
the exim daemon is started.
OPTIONS
--help|-h
Print short usage instructions and exit.
--qflags flags
Set qflags, special flags given to exim directly after the "-q".
See exim(8) for more information.
--queuerunner combined|queueonly|separate|ppp|no|nodaemon
Should the init script start one daemon that listens on the smtp
port for incoming connections and runs the queue at regular in-
tervals (combined) , or should it start two separate daemons,
one listening on the smtp port, the other running the queue
(separate) , or should the queue only be run by
/etc/ppp/ip-up.d/exim4 (ppp) , or shouldn't we run the queue at
all, for example if you'd rather do this with cron ? Or should
we only start a queuerunner (queueonly) or no daemon at all
(nodaemon) ?
--queuetime time
In which intervals should we run the queue? This passed as op-
tion -q<qflags>time to Exim, e.g. -q30m or -qq1h.
--commonoptions options
Options passed both to queue-running and listening instances of
Exim.
--queuerunneroptions options
Options only passed to the instance of Exim running the queue.
--smtplisteneroptions options
Options only passed to the instance of Exim listening on the
SMTP port.
--force|-f
Without this option update-exim4defaults exits with an error if
at least one of the options --queuetime, --commonoptions,
--queuerunneroptions or --smtplisteneroptions is used and the
corresponding value in /etc/default/exim4 is already set to a
nonempty value.
--remove-common option
Try to remove the given option from COMMONOPTIONS.
--remove-queue option
Try to remove the given option from QUEUERUNNEROPTIONS.
--remove-smtp option
Try to remove the given option from SMTPLISTENEROPTIONS.
The --remove-commands cannot be used at the same time as any of --com-
monoptions, --queuerunneroptions or --smtplisteneroptions. The --re-
move-commands will additionally remove whitespace at the beginning and
the end of the option and exchange multiple spaces wi a single one.
--init create a default /etc/default/exim4 file and exit immediately.
Unless --force was also specified update-exim4defaults exits
(successfully) without doing anything if /etc/default/exim4 al-
ready exists. All other options are ignored.
EXIT STATUS
0 change was successful or nothing needed to be done.
1 generic error: wrong options, unreadable configuration file,
etc.
2 QUEUEINTERVAL was already set.
4 COMMONOPTIONS was already set.
8 QUEUERUNNEROPTIONS was already set.
16 SMTPLISTENEROPTIONS was already set.
32 QFLAGS was already set.
64 --remove-something failed, i.e. the value of the option was not
changed.
Exit codes 2 to 32 will be summed up, if more than one unsuccessful op-
tion was given.
FILES
/etc/default/exim4
The configuration file.
/etc/init.d/exim4
The Exim init-script.
/etc/ppp/ip-up.d/exim4
The queuerunner in this file also uses COMMONOPTIONS and
QUEUERUNNEROPTIONS and does not run if QUEUERUNNER=no.
BUGS
This manual page needs a major re-work. If somebody knows better groff
than us and has more experience in writing manual pages, any patches
would be greatly appreciated.
SEE ALSO
exim(8), /usr/share/doc/exim4-base/
AUTHOR
Andreas Metzler <ametzler at downhill.at.eu.org>
EXIM4 March 26, 2003 UPDATE-EXIM4DEFAULTS(8)