1 .\" Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH UPDATE-EXIM4DEFAULTS 8 "March 26, 2003" EXIM4
6 .\" Please adjust this date whenever revising the manpage.
8 .\" Some roff macros, for reference:
9 .\" .nh disable hyphenation
10 .\" .hy enable hyphenation
11 .\" .ad l left justify
12 .\" .ad b justify to both left and right margins
13 .\" .nf disable filling
14 .\" .fi enable filling
15 .\" .br insert line break
16 .\" .sp <n> insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .\" \(oqthis text is enclosed in single quotes\(cq
19 .\" \(lqthis text is enclosed in double quotes\(rq
21 update\-exim4defaults \- Manage exim4 daemon default file.
23 .B update\-exim4defaults
24 .I [ \-\-qflags flags ]
25 .I [ \-\-queuerunner combined|queueonly|separate|ppp|no|nodaemon ]
26 .I [ \-\-queuetime time ]
27 .I [ \-\-commonoptions options ]
28 .I [ \-\-queuerunneroptions options ]
29 .I [ \-\-smtplisteneroptions options ]
30 .I [ \-\-remove\-common options ]
31 .I [ \-\-remove\-queue options ]
32 .I [ \-\-remove\-smtp options ]
38 .B update\-exim4defaults
39 allows one to set run parameters for the
42 .I /etc/default/exim4.
43 Its main purpose is for interaction with packages enhancing
45 like virus-scanners that need to change the way the exim daemon is started.
51 Print short usage instructions and exit.
54 Set qflags, special flags given to exim directly after the \(lq\-q\(rq. See
58 .I \-\-queuerunner combined|queueonly|separate|ppp|no|nodaemon
59 Should the init script start one daemon that listens on the smtp port for
60 incoming connections and runs the queue at regular intervals
62 , or should it start two separate daemons, one listening on the smtp port,
63 the other running the queue
65 , or should the queue only be run by /etc/ppp/ip\-up.d/exim4
67 , or shouldn't we run the queue at all, for example if you'd rather do this
70 ? Or should we only start a queuerunner
77 In which intervals should we run the queue? This passed as option
79 to Exim, e.g. \-q30m or \-qq1h.
81 .I \-\-commonoptions options
82 Options passed both to queue\-running and listening instances of Exim.
84 .I \-\-queuerunneroptions options
85 Options only passed to the instance of Exim running the queue.
87 .I \-\-smtplisteneroptions options
88 Options only passed to the instance of Exim listening on the SMTP port.
92 .B update\-exim4defaults
93 exits with an error if at least one of the options \-\-queuetime,
94 \-\-commonoptions, \-\-queuerunneroptions or \-\-smtplisteneroptions is used and the
95 corresponding value in /etc/default/exim4 is
97 set to a nonempty value.
99 .I \-\-remove\-common option
100 Try to remove the given option from COMMONOPTIONS.
102 .I \-\-remove\-queue option
103 Try to remove the given option from QUEUERUNNEROPTIONS.
105 .I \-\-remove\-smtp option
106 Try to remove the given option from SMTPLISTENEROPTIONS.
108 The \-\-remove\-commands cannot be used at the same time as any of \-\-commonoptions,
109 \-\-queuerunneroptions or \-\-smtplisteneroptions. The \-\-remove\-commands will
110 additionally remove whitespace at the beginning and the end of the option and
111 exchange multiple spaces wi a single one.
114 create a default /etc/default/exim4 file and exit immediately. Unless
117 .B update\-exim4defaults
118 exits (successfully) without doing anything if /etc/default/exim4 already
119 exists. All other options are ignored.
124 change was successful or nothing needed to be done.
127 generic error: wrong options, unreadable configuration file, etc.
130 QUEUEINTERVAL was already set.
133 COMMONOPTIONS was already set.
136 QUEUERUNNEROPTIONS was already set.
139 SMTPLISTENEROPTIONS was already set.
142 QFLAGS was already set.
145 \-\-remove\-something failed, i.e. the value of the option was not changed.
147 Exit codes 2 to 32 will be summed up, if more than one unsuccessful option was
152 .I /etc/default/exim4
153 The configuration file.
156 The Exim init\-script.
158 .I /etc/ppp/ip\-up.d/exim4
159 The queuerunner in this file also uses COMMONOPTIONS and QUEUERUNNEROPTIONS and
160 does not run if QUEUERUNNER=no.
164 This manual page needs a major re-work. If somebody knows better groff
165 than us and has more experience in writing manual pages, any patches
166 would be greatly appreciated.
170 /usr/share/doc/exim4\-base/
173 Andreas Metzler <ametzler at downhill.at.eu.org>