← Back to branch summary

~ubuntu-branches/ubuntu/hardy/exim4/hardy-proposed

« back to all changes in this revision

Viewing changes to debian/exim4-config-medium/debian/manpages/update-exim4defaults.8

  • Committer: Bazaar Package Importer
  • Author(s): Marc Haber
  • Date: 2005-07-02 06:08:34 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050702060834-qk17pd52kb9nt3bj
Tags: 4.52-1
http://bugs.debian.org/315775
* new upstream version 4.51. (mh)
  * adapt 70_remove_exim-users_references
  * remove 37_gnutlsparams
  * adapt 36_pcre
  * adapt 31_eximmanpage
* fix package priorities to have them in sync with override again. (mh)
* Fix error in nb (Norwegian) translation.
  Thanks to Helge Hafting. (mh). Closes: #315775
* Standards-Version: 3.6.2, no changes needed. (mh)

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/exim4-config-medium/debian/manpages/update-exim4defaults.8
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.
7
 
.\"
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
20
 
.SH NAME
21
 
update\-exim4defaults \- Manage exim4 daemon default file.
22
 
.SH SYNOPSIS
23
 
.B update\-exim4defaults
24
 
.I [ \-\-qflags flags ]
25
 
.I [ \-\-queuerunner combined|separate|ppp|no ]
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 ]
33
 
.I [ \-\-force|\-f ]
34
 
.I [ \-\-help|\-h ]
35
 
.I [ \-\-init ]
36
 
 
37
 
.SH DESCRIPTION
38
 
.B update\-exim4defaults
39
 
allows to set run parameters for the
40
 
.B Exim
41
 
daemon in
42
 
.I /etc/default/exim4.
43
 
Its main purpose is for interaction with packages enhancing
44
 
.B Exim
45
 
like virus-scanners that need to change the way the exim daemon is started.
46
 
.PP
47
 
 
48
 
.SH OPTIONS
49
 
.TP
50
 
.I \-\-help|\-h
51
 
Print short usage instructions and exit.
52
 
.TP
53
 
.I \-\-qflags flags
54
 
Set qflags, special flags given to exim directly after the \(lq\-q\(rq. See
55
 
.B exim(8)
56
 
for more information.
57
 
.TP
58
 
.I \-\-queuerunner combined|separate|ppp|no
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
61
 
.I (combined)
62
 
, or should it start two separate daemons, one listening on the smtp port,
63
 
the other running the queue
64
 
.I (separate)
65
 
, or should the queue only be run by /etc/ppp/ip\-up.d/exim4
66
 
.I (ppp)
67
 
, or shouldn't we run the queue at all, for example if you'd rather do this
68
 
with
69
 
.B cron?
70
 
.TP
71
 
.I \-\-queuetime time
72
 
In which intervals should we run the queue? This passed as option
73
 
.I \-q<qflags>time
74
 
to Exim, e.g. \-q30m or \-qq1h.
75
 
.TP
76
 
.I \-\-commonoptions options
77
 
Options passed both to queue\-running and listening instances of Exim.
78
 
.TP
79
 
.I \-\-queuerunneroptions options
80
 
Options only passed to the instance of Exim running the queue.
81
 
.TP
82
 
.I \-\-smtplisteneroptions options
83
 
Options only passed to the instance of Exim listening on the SMTP port.
84
 
.TP
85
 
.I \-\-force|\-f
86
 
Without this option
87
 
.B update\-exim4defaults
88
 
exits with an error if at least one of the options \-\-queuetime,
89
 
\-\-commonoptions, \-\-queuerunneroptions or \-\-smtplisteneroptions is used and the
90
 
corresponding value in /etc/default/exim4 is
91
 
.I already
92
 
set to a nonempty value.
93
 
.TP
94
 
.I \-\-remove\-common option
95
 
Try to remove the given option from COMMONOPTIONS.
96
 
.TP
97
 
.I \-\-remove\-queue option
98
 
Try to remove the given option from QUEUERUNNEROPTIONS.
99
 
.TP
100
 
.I \-\-remove\-smtp option
101
 
Try to remove the given option from SMTPLISTENEROPTIONS.
102
 
.PP
103
 
The \-\-remove\-commands cannot be used at the same time as any of \-\-commonoptions,
104
 
\-\-queuerunneroptions or \-\-smtplisteneroptions. The \-\-remove\-commands will
105
 
additionally remove whitespace at the begining and the end of the option and
106
 
exchange multiple spaces wi a single one.
107
 
.TP
108
 
.I \-\-init
109
 
create a default /etc/default/exim4 file and exit immediately. Unless
110
 
.I \-\-force
111
 
was also specified
112
 
.B update\-exim4defaults
113
 
exits (successfully) without doing anything if /etc/default/exim4 already
114
 
exists. All other options are ignored.
115
 
 
116
 
.SH EXIT STATUS
117
 
.TP
118
 
.I 0
119
 
change was successfull or nothing needed to be done.
120
 
.TP
121
 
.I 1
122
 
generic error: wrong options, unreadable configuration file, etc.
123
 
.TP
124
 
.I 2
125
 
QUEUEINTERVAL was already set.
126
 
.TP
127
 
.I 4
128
 
COMMONOPTIONS was already set.
129
 
.TP
130
 
.I 8
131
 
QUEUERUNNEROPTIONS was already set.
132
 
.TP
133
 
.I 16
134
 
SMTPLISTENEROPTIONS was already set.
135
 
.TP
136
 
.I 32
137
 
QFLAGS was already set.
138
 
.TP
139
 
.I 64
140
 
\-\-remove\-something failed, i.e. the value of the option was not changed.
141
 
.PP
142
 
Exit codes 2 to 32 will be summed up, if more than one unsuccesful option was
143
 
given.
144
 
 
145
 
.SH FILES
146
 
.TP
147
 
.I /etc/default/exim4
148
 
The configuration file.
149
 
.TP
150
 
.I /etc/init.d/exim4
151
 
The Exim init\-script.
152
 
.TP
153
 
.I /etc/ppp/ip\-up.d/exim4
154
 
The queuerunner in this file also uses COMMONOPTIONS and QUEUERUNNEROPTIONS and
155
 
does not run if QUEUERUNNER=no.
156
 
 
157
 
.SH SEE ALSO
158
 
.BR exim (8),
159
 
/usr/share/doc/exim4\-base/
160
 
 
161
 
.SH AUTHOR
162
 
Andreas Metzler <ametzler at downhill.at.eu.org>