rev |
line source |
meillo@335
|
1 .TH masqmail.conf 5 2011-08-27 masqmail-0.3.3 "File Formats"
|
meillo@34
|
2
|
meillo@0
|
3 .SH NAME
|
meillo@0
|
4 masqmail.conf \- masqmail configuration file
|
meillo@34
|
5
|
meillo@34
|
6
|
meillo@0
|
7 .SH DESCRIPTION
|
meillo@0
|
8
|
meillo@34
|
9 This man page describes the syntax of the main configuration file of masqmail.
|
meillo@34
|
10 Its usual location is \fI/etc/masqmail/masqmail.conf\fR
|
meillo@0
|
11
|
meillo@0
|
12 The configuration consists of lines of the form
|
meillo@0
|
13
|
meillo@34
|
14 \fBval\fR = \fIexpression\fR
|
meillo@0
|
15
|
meillo@34
|
16 Where \fBval\fR is a variable name and \fIexpression\fR a string,
|
meillo@34
|
17 which can be quoted with double quotes `"'.
|
meillo@34
|
18 If the expression is on multiple lines or contains characters other than letters,
|
meillo@174
|
19 digits or the characters `.', `-', `_', `/', ';', '@', ':', it must be quoted.
|
meillo@34
|
20 You can use quotes inside quotes by escaping them with a backslash.
|
meillo@0
|
21
|
meillo@174
|
22 Each \fBval\fP has a type, which can be boolean, numeric, string or list.
|
meillo@34
|
23 A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'.
|
meillo@34
|
24 List items are separated with semicolons `;'.
|
meillo@174
|
25 For some values, patterns (like `*',`?') can be used.
|
meillo@174
|
26 The spaces in front of and after the equal sign `=' are optional.
|
meillo@0
|
27
|
meillo@34
|
28 Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR,
|
meillo@192
|
29 and \fBonline_routes\fR) accept files.
|
meillo@34
|
30 These will be recognized by a leading slash `/'.
|
meillo@34
|
31 The contents of these files will be included at the position of the file name,
|
meillo@34
|
32 there can be items or other files before and after the file entry.
|
meillo@174
|
33 The format of the files is different though, within these files each entry is on another line
|
meillo@174
|
34 and the entries are not separated by semicolons.
|
meillo@34
|
35 This makes it easy to include large lists which are common in different configuration files,
|
meillo@34
|
36 so they do not have to appear in every configuration file.
|
meillo@0
|
37
|
meillo@34
|
38 Blank lines and lines starting with a hash `#' are ignored.
|
meillo@34
|
39
|
meillo@0
|
40
|
meillo@0
|
41 .SH OPTIONS
|
meillo@34
|
42
|
meillo@0
|
43 .TP
|
meillo@34
|
44 \fBrun_as_user = \fIboolean\fR
|
meillo@0
|
45
|
meillo@34
|
46 If this is set, masqmail runs with the user id of the user who invoked it and never changes it.
|
meillo@34
|
47 This is for debugging purposes only.
|
meillo@34
|
48 If the user is not root, masqmail will not be able to listen on a port < 1024
|
meillo@34
|
49 and will not be able to deliver local mail to others than the user.
|
meillo@0
|
50
|
meillo@0
|
51 .TP
|
meillo@34
|
52 \fBuse_syslog = \fIboolean\fR
|
meillo@0
|
53
|
meillo@34
|
54 If this is set, masqmail uses syslogd for logging.
|
meillo@34
|
55 It uses facility MAIL.
|
meillo@34
|
56 You still have to set \fBlog_dir\fR for debug files.
|
meillo@0
|
57
|
meillo@0
|
58 .TP
|
meillo@34
|
59 \fBdebug_level = \fIn\fR
|
meillo@0
|
60
|
meillo@34
|
61 Set the debug level.
|
meillo@333
|
62 Valid values are 0 to 6 and 9.
|
meillo@333
|
63 Be careful if you set this as high as 5 or higher,
|
meillo@333
|
64 the logs may very soon fill your hard drive.
|
meillo@333
|
65 Level 9 enables printing of debug messages to stderr during reading of
|
meillo@333
|
66 the config file.
|
meillo@333
|
67 The debug file comes available for the first time after this step.
|
meillo@333
|
68 Thus nothing but stderr is available.
|
meillo@333
|
69 Level 9 is almost never interesting.
|
meillo@0
|
70
|
meillo@0
|
71 .TP
|
meillo@44
|
72 \fBlog_dir = \fIfile\fR
|
meillo@44
|
73
|
meillo@174
|
74 The directory where logs are stored, if syslog is not used.
|
meillo@174
|
75 Debug files are always stored in this directory if debugging is enabled.
|
meillo@44
|
76 \fIfile\fR must be an absolute path.
|
meillo@44
|
77
|
meillo@151
|
78 Default: \fI/var/log/masqmail\fR
|
meillo@151
|
79
|
meillo@44
|
80 .TP
|
meillo@34
|
81 \fBmail_dir = \fIfile\fR
|
meillo@0
|
82
|
meillo@34
|
83 The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR.
|
meillo@44
|
84 \fIfile\fR must be an absolute path.
|
meillo@0
|
85
|
meillo@152
|
86 Default: \fI/var/mail\fR
|
meillo@152
|
87
|
meillo@0
|
88 .TP
|
meillo@34
|
89 \fBspool_dir = \fIfile\fR
|
meillo@0
|
90
|
meillo@34
|
91 The directory where masqmail stores its spool files (and later also other stuff).
|
meillo@34
|
92 It must have a subdirectory \fIinput\fR.
|
meillo@34
|
93 Masqmail needs read and write permissions for this directory.
|
meillo@44
|
94 \fIfile\fR must be an absolute path.
|
meillo@0
|
95
|
meillo@151
|
96 Default: \fI/var/spool/masqmail\fR
|
meillo@151
|
97
|
meillo@0
|
98 .TP
|
meillo@133
|
99 \fBlock_dir = \fIfile\fR
|
meillo@133
|
100
|
meillo@133
|
101 The directory where masqmail stores its lock files.
|
meillo@133
|
102 Masqmail needs read and write permissions for this directory.
|
meillo@133
|
103 By default it is a directory ``lock'' inside of \fIspool_dir\fP.
|
meillo@133
|
104 \fIfile\fR must be an absolute path.
|
meillo@133
|
105
|
meillo@133
|
106 .TP
|
meillo@34
|
107 \fBhost_name = \fIstring\fR
|
meillo@0
|
108
|
meillo@34
|
109 This is used in different places: Masqmail identifies itself in the greeting banner
|
meillo@34
|
110 on incoming connections and in the HELO/EHLO command for outgoing connections with this name,
|
meillo@34
|
111 it is used in the Received: header and to qualify the sender of a locally originating message.
|
meillo@0
|
112
|
meillo@34
|
113 If the string begins with a slash `/', it it assumed that it is a filename,
|
meillo@34
|
114 and the first line of this file will be used.
|
meillo@34
|
115 Usually this will be `/etc/mailname' to make masqmail conform to Debian policies.
|
meillo@0
|
116
|
meillo@34
|
117 It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that.
|
meillo@0
|
118
|
meillo@156
|
119 Default: none; \fBhost_name\fP MUST be set in the config file
|
meillo@156
|
120
|
meillo@0
|
121 .TP
|
meillo@34
|
122 \fBlocal_hosts = \fIlist\fR
|
meillo@0
|
123
|
meillo@34
|
124 A semicolon `;' separated list of hostnames which are considered local.
|
meillo@153
|
125 Normally you should set it to "localhost;foo;foo.bar.com" if your host has the
|
meillo@34
|
126 fully qualified domain name `foo.bar.com'.
|
meillo@0
|
127
|
meillo@157
|
128 Default: localhost ; <value of \fBhost_name\fR cut at the first dot> ; <value of \fBhost_name\fR>
|
meillo@157
|
129
|
meillo@157
|
130 Example: \fIlocalhost;foo;foo.example.org\fR
|
meillo@157
|
131 (if you have set \fBhost_name\fR to \fIfoo.example.org\fR)
|
meillo@153
|
132
|
meillo@0
|
133 .TP
|
meillo@34
|
134 \fBlocal_addresses = \fIlist\fR
|
meillo@0
|
135
|
meillo@34
|
136 A semicolon `;' separated list of fully qualified email-addresses which are
|
meillo@34
|
137 considered local although their domain name part is not in the list of \fBlocal_hosts\fR.
|
meillo@238
|
138 This list can be seen as an addition to \fBlocal_hosts\fP.
|
meillo@0
|
139
|
meillo@306
|
140 Further more only the local part of the addresses will be regarded,
|
meillo@306
|
141 seeing it as a local user.
|
meillo@0
|
142
|
meillo@306
|
143 Example: \fIlocal_addresses = "person1@yourdomain;person2@yourdomain"\fP
|
meillo@0
|
144
|
meillo@306
|
145 This means mail to person1@yourdomain will effectively go to
|
meillo@306
|
146 person1@localhost, if not redirected by an alias.
|
meillo@34
|
147
|
meillo@0
|
148 .TP
|
meillo@34
|
149 \fBnot_local_addresses = \fIlist\fR
|
meillo@0
|
150
|
meillo@34
|
151 A semicolon `;' separated list of fully qualified email-addresses which are
|
meillo@34
|
152 considered not local although their domain name part is in the list of \fBlocal_hosts\fR.
|
meillo@238
|
153 This list can be seen as a substraction to \fBlocal_hosts\fP.
|
meillo@0
|
154
|
meillo@34
|
155 This is the opposite of the previous case.
|
meillo@34
|
156 The majority of addresses of a specific domain are local.
|
meillo@34
|
157 But some users are not.
|
meillo@34
|
158 With this option you can easily exclude these users.
|
meillo@0
|
159
|
meillo@0
|
160 Example:
|
meillo@0
|
161
|
meillo@0
|
162 local_hosts = "localhost;myhost;mydomain.net"
|
meillo@0
|
163
|
meillo@0
|
164 not_local_addresses = "eric@mydomain.net"
|
meillo@34
|
165
|
meillo@0
|
166 .TP
|
meillo@238
|
167 \fBlocal_nets = \fIlist\fR
|
meillo@238
|
168
|
meillo@238
|
169 A semicolon `;' separated list of hostnames which are on the `local' net.
|
meillo@238
|
170 Delivery to these hosts is attempted immediately.
|
meillo@238
|
171 You can use patterns with `*', e.g. "*.bar.com".
|
meillo@238
|
172
|
meillo@238
|
173 .TP
|
meillo@34
|
174 \fBlisten_addresses = \fIlist\fR
|
meillo@0
|
175
|
meillo@34
|
176 A semicolon `;' separated list of interfaces on which connections will be accepted.
|
meillo@34
|
177 An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port.
|
meillo@34
|
178 If this is left out, port 25 will be used.
|
meillo@0
|
179
|
meillo@34
|
180 You can set this to "localhost:25;foo:25" if your hostname is `foo'.
|
meillo@0
|
181
|
meillo@34
|
182 Note that the names are resolved to IP addreses.
|
meillo@34
|
183 If your host has different names which resolve to the same IP,
|
meillo@34
|
184 use only one of them, otherwise you will get an error message.
|
meillo@0
|
185
|
meillo@329
|
186 Default: \fIlocalhost:25\fR (i.e. only local processes can connect)
|
meillo@161
|
187
|
meillo@0
|
188 .TP
|
meillo@34
|
189 \fBdo_save_envelope_to = \fIboolean\fR
|
meillo@0
|
190
|
meillo@34
|
191 If this is set to true, a possibly existing Envelope-to: header in an incoming mail
|
meillo@34
|
192 which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header.
|
meillo@0
|
193
|
meillo@192
|
194 This is useful if you retrieve mail from a pop3 server with fetchmail,
|
meillo@34
|
195 and the server supports Envelope-to: headers,
|
meillo@34
|
196 and you want to make use of those with a mail filtering tool, e.g. procmail.
|
meillo@34
|
197 It cannot be preserved because masqmail sets such a header by itself.
|
meillo@0
|
198
|
meillo@0
|
199 Default is false.
|
meillo@34
|
200
|
meillo@0
|
201 .TP
|
meillo@34
|
202 \fBdo_relay = \fIboolean\fR
|
meillo@0
|
203
|
meillo@34
|
204 If this is set to false, mail with a return path that is not local and a destination
|
meillo@34
|
205 that is also not local will not be accepted via smtp and a 550 reply will be given.
|
meillo@34
|
206 Default is true.
|
meillo@0
|
207
|
meillo@34
|
208 Note that this will not protect you from spammers using open relays,
|
meillo@34
|
209 but from users unable to set their address in their mail clients.
|
meillo@0
|
210
|
meillo@0
|
211 .TP
|
meillo@34
|
212 \fBdo_queue = \fIboolean\fR
|
meillo@0
|
213
|
meillo@34
|
214 If this is set, mail will not be delivered immediately when accepted.
|
meillo@34
|
215 Same as calling masqmail with the \fB\-odq\fR option.
|
meillo@0
|
216
|
meillo@0
|
217 .TP
|
meillo@34
|
218 \fBonline_routes.\fIname\fR = \fIlist\fR
|
meillo@0
|
219
|
meillo@34
|
220 Replace \fIname\fR with a name to identify a connection.
|
meillo@34
|
221 Set this to a filename (or a list of filenames) for the special route configuration for that connection.
|
meillo@34
|
222 You will use that name to call masqmail with the \fB\-qo\fR option every time a
|
meillo@34
|
223 connection to your ISP is set up.
|
meillo@0
|
224
|
meillo@34
|
225 Example: Your ISP has the name FastNet.
|
meillo@34
|
226 Then you write the following line in the main configuration:
|
meillo@0
|
227
|
meillo@139
|
228 \fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR
|
meillo@0
|
229
|
meillo@34
|
230 \fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR.
|
meillo@34
|
231 As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR.
|
meillo@34
|
232 Masqmail will then read the specified file and send the mails.
|
meillo@0
|
233
|
meillo@0
|
234 .TP
|
meillo@34
|
235 \fBconnect_route.\fIname\fR = \fIlist\fR
|
meillo@0
|
236
|
meillo@34
|
237 Old name for \fBonline_routes\fR.
|
meillo@0
|
238
|
meillo@0
|
239 .TP
|
meillo@34
|
240 \fBlocal_net_route = \fIfile\fR
|
meillo@0
|
241
|
meillo@234
|
242 This is similar to \fBonline_routes.\fIname\fR but used for delilvery to the local net.
|
meillo@34
|
243 Recipient addresses that are in local_nets will be routed using this route configuration.
|
meillo@34
|
244 Main purpose is to define a mail server with mail_host in your local network.
|
meillo@34
|
245 In simple environments this can be left unset.
|
meillo@234
|
246 If unset, a default route configuration (named ``default local_net_route'') will be used.
|
meillo@0
|
247
|
meillo@0
|
248 .TP
|
meillo@34
|
249 \fBalias_file = \fIfile\fR
|
meillo@0
|
250
|
meillo@34
|
251 Set this to the location of your alias file.
|
meillo@238
|
252 If not set, no aliasing will be done.
|
meillo@238
|
253
|
meillo@238
|
254 Default: <not set> (i.e. no aliasing is done)
|
meillo@0
|
255
|
meillo@0
|
256 .TP
|
meillo@243
|
257 \fBcaseless_matching = \fIboolean\fR
|
meillo@0
|
258
|
meillo@242
|
259 If this is set, aliasing and the matching for \fBlocal_addresses\fP and
|
meillo@242
|
260 \fBnot_local_addresses\fP will be done caseless.
|
meillo@242
|
261
|
meillo@242
|
262 Note: Be sure to change this option only if the queue is empty as
|
meillo@242
|
263 correct processing of queued messages is not guaranteed otherwise.
|
meillo@34
|
264
|
meillo@238
|
265 Default: false
|
meillo@238
|
266
|
meillo@0
|
267 .TP
|
meillo@34
|
268 \fBpipe_fromline = \fIboolean\fR
|
meillo@0
|
269
|
meillo@34
|
270 If this is set, a from line will be prepended to the output stream whenever
|
meillo@34
|
271 a pipe command is called after an alias expansion.
|
meillo@34
|
272 Default is false.
|
meillo@0
|
273
|
meillo@0
|
274 .TP
|
meillo@34
|
275 \fBpipe_fromhack = \fIboolean\fR
|
meillo@0
|
276
|
meillo@34
|
277 If this is set, each line beginning with `From ' is replaced with `>From '
|
meillo@34
|
278 whenever a pipe command is called after an alias expansion.
|
meillo@34
|
279 You probably want this if you have set \fBpipe_fromline\fR above.
|
meillo@34
|
280 Default is false.
|
meillo@0
|
281
|
meillo@0
|
282 .TP
|
meillo@34
|
283 \fBmbox_default = \fIstring\fR
|
meillo@0
|
284
|
meillo@34
|
285 The default local delivery method.
|
meillo@205
|
286 Can be mbox or mda.
|
meillo@205
|
287 You can override this for each user by using the \fBmbox_users\fR or \fBmda_users\fR (see below).
|
meillo@0
|
288
|
meillo@238
|
289 Default: mbox.
|
meillo@238
|
290
|
meillo@0
|
291 .TP
|
meillo@34
|
292 \fBmbox_users = \fIlist\fR
|
meillo@0
|
293
|
meillo@0
|
294 A list of users which wish delivery to an mbox style mail folder.
|
meillo@34
|
295
|
meillo@0
|
296 .TP
|
meillo@34
|
297 \fBmda_users = \fIlist\fR
|
meillo@0
|
298
|
meillo@34
|
299 A list of users which wish local delivery to an mda.
|
meillo@34
|
300 You have to set \fBmda\fR (see below) as well.
|
meillo@0
|
301
|
meillo@0
|
302 .TP
|
meillo@34
|
303 \fBmda = \fIexpand string\fR
|
meillo@0
|
304
|
meillo@34
|
305 If you want local delivery to be transferred to an mda (Mail Delivery Agent),
|
meillo@34
|
306 set this to a command.
|
meillo@34
|
307 The argument will be expanded on delivery time,
|
meillo@34
|
308 you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces.
|
meillo@34
|
309 Variables you can use are:
|
meillo@0
|
310
|
meillo@34
|
311 uid - the unique message id.
|
meillo@34
|
312 This is not necessarily identical with the Message ID as given in the Message ID: header.
|
meillo@0
|
313
|
meillo@0
|
314 received_host - the host the mail was received from
|
meillo@0
|
315
|
meillo@34
|
316 ident - the ident, this is either the ident delivered by the ident protocol
|
meillo@34
|
317 or the user id of the sender if the message was received locally.
|
meillo@0
|
318
|
meillo@0
|
319 return_path_local - the local part of the return path (sender).
|
meillo@0
|
320
|
meillo@0
|
321 return_path_domain - the domain part of the return path (sender).
|
meillo@0
|
322
|
meillo@0
|
323 return_path - the complete return path (sender).
|
meillo@0
|
324
|
meillo@0
|
325 rcpt_local - the local part of the recipient.
|
meillo@0
|
326
|
meillo@0
|
327 rcpt_domain - the domain part of the recipient.
|
meillo@0
|
328
|
meillo@0
|
329 rcpt - the complete recipient address.
|
meillo@0
|
330
|
meillo@0
|
331 Example:
|
meillo@0
|
332
|
meillo@16
|
333 mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
|
meillo@0
|
334
|
meillo@34
|
335 For the mda, as for pipe commands, a few environment variables will be set as well.
|
meillo@34
|
336 See \fBmasqmail(8)\fR.
|
meillo@34
|
337 To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash,
|
meillo@34
|
338 otherwise they will be tried to be expanded with the internal variables.
|
meillo@34
|
339
|
meillo@0
|
340 .TP
|
meillo@34
|
341 \fBmda_fromline = \fIboolean\fR
|
meillo@0
|
342
|
meillo@34
|
343 If this is set, a from line will be prepended to the output stream whenever
|
meillo@34
|
344 a message is delivered to an mda.
|
meillo@34
|
345 Default is false.
|
meillo@0
|
346
|
meillo@0
|
347 .TP
|
meillo@34
|
348 \fBmda_fromhack = \fIboolean\fR
|
meillo@0
|
349
|
meillo@34
|
350 If this is set, each line beginning with `From ' is replaced with `>From '
|
meillo@34
|
351 whenever a message is delivered to an mda.
|
meillo@34
|
352 You probably want this if you have set \fBmda_fromline\fR above.
|
meillo@34
|
353 Default is false.
|
meillo@0
|
354
|
meillo@0
|
355 .TP
|
meillo@310
|
356 \fBonline_query = \fIcommand line\fR
|
meillo@0
|
357
|
meillo@310
|
358 Defines the method masqmail uses to detect whether there exists an online connection currently.
|
meillo@0
|
359
|
meillo@310
|
360 Masqmail executes the command given and reads from its standard output.
|
meillo@310
|
361 The command should just print a route name, as defined
|
meillo@310
|
362 with \fBonline_routes.\fIname\fR, to standard output and return a zero status code.
|
meillo@310
|
363 Masqmail assumes it is offline if the script returns with a non-zero status.
|
meillo@310
|
364 Leading and trailing whitespace is removed from the output.
|
meillo@0
|
365
|
meillo@310
|
366 Simple example:
|
meillo@310
|
367
|
meillo@310
|
368 .nf
|
meillo@310
|
369 #!/bin/sh
|
meillo@310
|
370 test \-e /var/run/masqmail/masqmail-route || exit 1
|
meillo@310
|
371 cat /var/run/masqmail/masqmail-route
|
meillo@310
|
372 exit 0
|
meillo@310
|
373 .fi
|
meillo@0
|
374
|
meillo@34
|
375 No matter how masqmail detects the online status,
|
meillo@34
|
376 only messages that are accepted at online time will be delivered using the connection.
|
meillo@310
|
377 The mail spool still needs to be emptied manually
|
meillo@310
|
378 (\fB\-qo\fIconnection\fR).
|
meillo@0
|
379
|
meillo@310
|
380 \fIcommand line\fR must start with an absolute path to an executable program.
|
meillo@158
|
381 It can contain optional arguments.
|
meillo@0
|
382
|
meillo@310
|
383 To simulate the old online_method=file, use:
|
meillo@310
|
384 \fI/bin/cat /path/to/file\fP
|
meillo@158
|
385
|
meillo@310
|
386 To be always online with connection `foo', use:
|
meillo@310
|
387 \fI/bin/echo foo\fP
|
meillo@310
|
388
|
meillo@310
|
389 To query a masqdialer server
|
meillo@310
|
390 (i.e. asking it whether a connection exists and what its name is)
|
meillo@164
|
391 use:
|
meillo@310
|
392 \fI/usr/bin/mservdetect localhost 224\fP
|
meillo@92
|
393
|
meillo@0
|
394
|
meillo@0
|
395 .TP
|
meillo@34
|
396 \fBident_trusted_nets = \fIlist\fR
|
meillo@0
|
397
|
meillo@34
|
398 \fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24),
|
meillo@34
|
399 from which the ident given by the ident protocol will be trusted,
|
meillo@34
|
400 so a user can delete his mail from the queue if the ident is identical to his login name.
|
meillo@0
|
401
|
meillo@0
|
402 .TP
|
meillo@34
|
403 \fBerrmsg_file = \fIfile\fR
|
meillo@0
|
404
|
meillo@34
|
405 Set this to a template which will be used to generate delivery failure reports.
|
meillo@34
|
406 Variable parts within the template begin with a dollar sign and are identical
|
meillo@34
|
407 to those which can be used as arguments for the mda command, see \fBmda\fR above.
|
meillo@34
|
408 Additional information can be included with @failed_rcpts, @msg_headers and @msg_body,
|
meillo@34
|
409 these must be at the beginning of a line and will be replaced with the list of the failed recipients,
|
meillo@34
|
410 the message headers and the message body of the failed message.
|
meillo@0
|
411
|
meillo@0
|
412 Default is /usr/share/masqmail/tpl/failmsg.tpl.
|
meillo@34
|
413
|
meillo@0
|
414 .TP
|
meillo@34
|
415 \fBwarnmsg_file = \fIfile\fR
|
meillo@0
|
416
|
meillo@34
|
417 Set this to a template which will be used to generate delivery warning reports.
|
meillo@34
|
418 It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above.
|
meillo@0
|
419
|
meillo@0
|
420 Default is /usr/share/masqmail/tpl/warnmsg.tpl.
|
meillo@34
|
421
|
meillo@0
|
422 .TP
|
meillo@34
|
423 \fBwarn_intervals\fR = \fIlist\fR
|
meillo@0
|
424
|
meillo@34
|
425 Set this to a list of time intervals, at which delivery warnings
|
meillo@34
|
426 (starting with the receiving time of the message) shall be generated.
|
meillo@0
|
427
|
meillo@34
|
428 A warning will only be generated just after an attempt to deliver the mail
|
meillo@34
|
429 and if that attempt failed temporarily.
|
meillo@34
|
430 So a warning may be generated after a longer time, if there was no attempt before.
|
meillo@0
|
431
|
meillo@0
|
432 Default is "1h;4h;8h;1d;2d;3d"
|
meillo@34
|
433
|
meillo@0
|
434 .TP
|
meillo@34
|
435 \fBmax_defer_time\fR = \fItime\fR
|
meillo@0
|
436
|
meillo@34
|
437 This is the maximum time, in which a temporarily failed mail will be kept in the spool.
|
meillo@34
|
438 When this time is exceeded, it will be handled as a delivery failure,
|
meillo@34
|
439 and the message will be bounced.
|
meillo@0
|
440
|
meillo@34
|
441 The excedence of this time will only be noticed if the message was actually tried to be delivered.
|
meillo@34
|
442 If, for example, the message can only be delivered when online,
|
meillo@34
|
443 but you have not been online for that time, no bounce will be generated.
|
meillo@0
|
444
|
meillo@0
|
445 Default is 4d (4 days)
|
meillo@34
|
446
|
meillo@0
|
447 .TP
|
meillo@34
|
448 \fBlog_user = \fIname\fR
|
meillo@0
|
449
|
meillo@34
|
450 Replace \fIname\fR with a valid local or remote mail address.
|
meillo@0
|
451
|
meillo@44
|
452 If this option is set, then a copy of every mail,
|
meillo@44
|
453 that passes through the masqmail system will also be sent to the given mail address.
|
meillo@0
|
454
|
meillo@34
|
455 For example you can feed your mails into a program like hypermail
|
meillo@34
|
456 for archiving purpose by placing an appropriate pipe command in masqmail.alias
|
meillo@0
|
457
|
meillo@117
|
458 .TP
|
meillo@117
|
459 \fBmax_msg_size\fR = \fIbytes\fR
|
meillo@117
|
460
|
meillo@117
|
461 This option sets the maximum size in bytes masqmail will accept for delivery.
|
meillo@117
|
462 This value is advertised to the SMTP client by the `SIZE' message during SMTP
|
meillo@117
|
463 session setup.
|
meillo@117
|
464 Clients pretending to send, or actually send,
|
meillo@117
|
465 more than \fIbytes\fR will get a 552 error message.
|
meillo@117
|
466
|
meillo@120
|
467 `0' means no fixed maximum size limit is in force.
|
meillo@120
|
468
|
meillo@120
|
469 Default is 0 (= unlimited).
|
meillo@117
|
470
|
meillo@134
|
471 .TP
|
meillo@134
|
472 \fBdefer_all\fR = \fIboolean\fR
|
meillo@134
|
473
|
meillo@134
|
474 If set to true, masqmail replies with ``421 service temporarily unavailable''
|
meillo@134
|
475 to any SMTP request and shuts the connection down.
|
meillo@134
|
476 Note: This option is for debugging purposes only.
|
meillo@134
|
477
|
meillo@134
|
478 Default: false
|
meillo@134
|
479
|
meillo@34
|
480
|
meillo@0
|
481 .SH AUTHOR
|
meillo@0
|
482
|
meillo@34
|
483 Masqmail was written by Oliver Kurth.
|
meillo@34
|
484 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
|
meillo@0
|
485
|
meillo@95
|
486 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR.
|
meillo@26
|
487 There is also a mailing list, you will find information about it at masqmail's main site.
|
meillo@0
|
488
|
meillo@34
|
489
|
meillo@0
|
490 .SH BUGS
|
meillo@0
|
491
|
meillo@34
|
492 Please report bugs to the mailing list.
|
meillo@34
|
493
|
meillo@0
|
494
|
meillo@0
|
495 .SH SEE ALSO
|
meillo@0
|
496
|
meillo@192
|
497 \fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR
|