Codex

UPDATE-EXIM4DEFAULTS

Section: Maintenance Commands (8)

Updated: March 26, 2003

Index?action=index Return to Main Contents


NAME

update-exim4defaults - Manage exim4 daemon default file.

SYNOPSIS

update-exim4defaults [ --qflags flags ] [ --queuerunner combined|queueonly|separate|ppp|no|nodaemon ] [ --queuetime time ] [ --commonoptions options ] [ --queuerunneroptions options ] [ --smtplisteneroptions options ] [ --remove-common options ] [ --remove-queue options ] [ --remove-smtp options ] [ --force|-f ] [ --help|-h ] [ --init ]

DESCRIPTION

update-exim4defaults allows one to set run parameters for the Exim daemon 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 intervals (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 option -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 --commonoptions, --queuerunneroptions or --smtplisteneroptions. The --remove-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 already 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 option 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>


Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXIT STATUS

FILES

BUGS

SEE ALSO

AUTHOR