sourCEntral - mobile manpages

pdf

UPDATE-EXIM4DEFAULTS

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>

pdf