masqmail

annotate man/masqmail.conf.5 @ 396:6f2a8113a79e

find changesets by author, revision, files, or words in the commit message
Fixed conf.c: read_lval().
author markus schnalke <meillo@marmaro.de>
date Sat, 18 Feb 2012 19:57:39 +0100
parents 35c5239ebcc1
children b033fd9b96e4
rev   line source
meillo@380 1 .TH masqmail.conf 5 2012-01-18 masqmail-0.3.4 "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@354 28 Most lists (exceptions: \fBlocal_hosts\fR, \fBlisten_addresses\fR,
meillo@354 29 \fBquery_routes.\fIname\fR and \fBpermanent_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@375 125 Can contain glob patterns, like
meillo@375 126 `*example.org' or `mail?.*mydomain.net'.
meillo@153 127 Normally you should set it to "localhost;foo;foo.bar.com" if your host has the
meillo@34 128 fully qualified domain name `foo.bar.com'.
meillo@0 129
meillo@157 130 Default: localhost ; <value of \fBhost_name\fR cut at the first dot> ; <value of \fBhost_name\fR>
meillo@157 131
meillo@157 132 Example: \fIlocalhost;foo;foo.example.org\fR
meillo@157 133 (if you have set \fBhost_name\fR to \fIfoo.example.org\fR)
meillo@153 134
meillo@0 135 .TP
meillo@34 136 \fBlocal_addresses = \fIlist\fR
meillo@0 137
meillo@34 138 A semicolon `;' separated list of fully qualified email-addresses which are
meillo@34 139 considered local although their domain name part is not in the list of \fBlocal_hosts\fR.
meillo@238 140 This list can be seen as an addition to \fBlocal_hosts\fP.
meillo@0 141
meillo@306 142 Further more only the local part of the addresses will be regarded,
meillo@306 143 seeing it as a local user.
meillo@0 144
meillo@306 145 Example: \fIlocal_addresses = "person1@yourdomain;person2@yourdomain"\fP
meillo@0 146
meillo@306 147 This means mail to person1@yourdomain will effectively go to
meillo@306 148 person1@localhost, if not redirected by an alias.
meillo@34 149
meillo@0 150 .TP
meillo@34 151 \fBnot_local_addresses = \fIlist\fR
meillo@0 152
meillo@34 153 A semicolon `;' separated list of fully qualified email-addresses which are
meillo@34 154 considered not local although their domain name part is in the list of \fBlocal_hosts\fR.
meillo@238 155 This list can be seen as a substraction to \fBlocal_hosts\fP.
meillo@0 156
meillo@34 157 This is the opposite of the previous case.
meillo@34 158 The majority of addresses of a specific domain are local.
meillo@34 159 But some users are not.
meillo@34 160 With this option you can easily exclude these users.
meillo@0 161
meillo@0 162 Example:
meillo@0 163
meillo@0 164 local_hosts = "localhost;myhost;mydomain.net"
meillo@0 165
meillo@0 166 not_local_addresses = "eric@mydomain.net"
meillo@34 167
meillo@0 168 .TP
meillo@34 169 \fBlisten_addresses = \fIlist\fR
meillo@0 170
meillo@34 171 A semicolon `;' separated list of interfaces on which connections will be accepted.
meillo@34 172 An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port.
meillo@34 173 If this is left out, port 25 will be used.
meillo@0 174
meillo@34 175 You can set this to "localhost:25;foo:25" if your hostname is `foo'.
meillo@0 176
meillo@337 177 Note that the names are resolved to IP addresses.
meillo@34 178 If your host has different names which resolve to the same IP,
meillo@34 179 use only one of them, otherwise you will get an error message.
meillo@0 180
meillo@329 181 Default: \fIlocalhost:25\fR (i.e. only local processes can connect)
meillo@161 182
meillo@0 183 .TP
meillo@34 184 \fBdo_save_envelope_to = \fIboolean\fR
meillo@0 185
meillo@34 186 If this is set to true, a possibly existing Envelope-to: header in an incoming mail
meillo@34 187 which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header.
meillo@0 188
meillo@192 189 This is useful if you retrieve mail from a pop3 server with fetchmail,
meillo@34 190 and the server supports Envelope-to: headers,
meillo@34 191 and you want to make use of those with a mail filtering tool, e.g. procmail.
meillo@34 192 It cannot be preserved because masqmail sets such a header by itself.
meillo@0 193
meillo@0 194 Default is false.
meillo@34 195
meillo@0 196 .TP
meillo@34 197 \fBdo_relay = \fIboolean\fR
meillo@0 198
meillo@34 199 If this is set to false, mail with a return path that is not local and a destination
meillo@34 200 that is also not local will not be accepted via smtp and a 550 reply will be given.
meillo@34 201 Default is true.
meillo@0 202
meillo@34 203 Note that this will not protect you from spammers using open relays,
meillo@34 204 but from users unable to set their address in their mail clients.
meillo@0 205
meillo@0 206 .TP
meillo@34 207 \fBdo_queue = \fIboolean\fR
meillo@0 208
meillo@346 209 If this is set, masqmail will not try to deliver mail immediately when accepted.
meillo@346 210 Instead it will always queue it.
meillo@346 211 (Note: Masqmail will always automatically queue mail if neccesary,
meillo@346 212 i.e. if it cannot deliver because no suitable route was available for example.)
meillo@346 213
meillo@34 214 Same as calling masqmail with the \fB\-odq\fR option.
meillo@346 215 Usually you should leave this option unset.
meillo@346 216
meillo@346 217 Default: false
meillo@0 218
meillo@0 219 .TP
meillo@354 220 \fBpermanent_routes\fR = \fIlist\fR
meillo@0 221
meillo@354 222 Set this to the filename (or a semicolon-separated list of filenames)
meillo@354 223 of the route configuration for always available connections.
meillo@354 224 Main purpose is to define a mail server with mail_host in your local network,
meillo@354 225 or if masqmail should send mail directly to the target host.
meillo@354 226 If you have only a single host, you can leave it unset.
meillo@354 227
meillo@354 228 A setting `\fBlocal_nets\fR = \fI"*home.net"\fR' in versions <= 0.3.3
meillo@354 229 is in newer versions configured as:
meillo@354 230 `\fBpermanent_routes\fR = \fI"/etc/masqmail/homenet.route"\fR'
meillo@354 231 and the route file `homenet.route' containing:
meillo@354 232 .in +1in
meillo@354 233 .nf
meillo@354 234 allowed_recipients = "*@*home.net"
meillo@354 235 connect_error_fail = true
meillo@354 236 resolve_list = byname
meillo@354 237 .fi
meillo@354 238 .in 0
meillo@354 239 This is just as it had been with \fBlocal_net_route\fP,
meillo@354 240 with the exception that the filtering for appropriate addresses
meillo@354 241 is only in the route file and not with \fBlocal_nets\fR.
meillo@354 242
meillo@354 243 .TP
meillo@354 244 \fBquery_routes.\fIname\fR = \fIlist\fR
meillo@354 245
meillo@354 246 Replace \fIname\fR with a name to identify the connection.
meillo@354 247 Set this to a filename (or a semicolon-separated list of filenames)
meillo@354 248 for the route configuration for that connection.
meillo@354 249
meillo@354 250 Routes of this kind cannot be expected to be online always.
meillo@354 251 Masqmail will query which of the routes are online.
meillo@354 252
meillo@354 253 You can use the name to call masqmail with the \fB\-qo\fR option every time a
meillo@354 254 connection to your ISP is set up, in order to send queued mail through this
meillo@354 255 route.
meillo@0 256
meillo@34 257 Example: Your ISP has the name FastNet.
meillo@34 258 Then you write the following line in the main configuration:
meillo@0 259
meillo@354 260 \fBquery_routes.\fBFastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR
meillo@0 261
meillo@354 262 \fI/etc/masqmail/fastnet.route\fR is the route configuration file,
meillo@354 263 see \fBmasqmail.route(5)\fR.
meillo@354 264 As soon as a link to FastNet has been set up,
meillo@354 265 you call `masqmail \fB\-qo \fIFastNet\fR'.
meillo@34 266 Masqmail will then read the specified file and send the mails.
meillo@0 267
meillo@354 268 See \fBonline_query\fP.
meillo@0 269
meillo@0 270 .TP
meillo@34 271 \fBalias_file = \fIfile\fR
meillo@0 272
meillo@34 273 Set this to the location of your alias file.
meillo@238 274 If not set, no aliasing will be done.
meillo@238 275
meillo@238 276 Default: <not set> (i.e. no aliasing is done)
meillo@0 277
meillo@0 278 .TP
meillo@387 279 \fBglobalias_file = \fIfile\fR
meillo@387 280
meillo@387 281 Set this to the location of a glob-pattern alias file.
meillo@387 282 This kind of aliasing matches glob patterns against full email addresses,
meillo@387 283 not strings against local parts like in normal aliasing.
meillo@387 284 You can use this to handle catch-all maildrops (``*@example.org'')
meillo@387 285 and to split between virtual hosts on a single machine
meillo@387 286 (e.g. ``info@foo.ex.org'' and ``info@bar.ex.org'').
meillo@387 287
meillo@387 288 Glob aliasing is done before normal aliasing.
meillo@387 289 If you have both kinds, glob and normal aliasing, then the results of the
meillo@387 290 glob aliasing may be expanded further by the normal aliasing mechanism.
meillo@387 291
meillo@387 292 Default: <not set> (i.e. no glob aliasing is done)
meillo@387 293
meillo@387 294 .TP
meillo@243 295 \fBcaseless_matching = \fIboolean\fR
meillo@0 296
meillo@242 297 If this is set, aliasing and the matching for \fBlocal_addresses\fP and
meillo@242 298 \fBnot_local_addresses\fP will be done caseless.
meillo@242 299
meillo@242 300 Note: Be sure to change this option only if the queue is empty as
meillo@242 301 correct processing of queued messages is not guaranteed otherwise.
meillo@34 302
meillo@238 303 Default: false
meillo@238 304
meillo@0 305 .TP
meillo@34 306 \fBpipe_fromline = \fIboolean\fR
meillo@0 307
meillo@34 308 If this is set, a from line will be prepended to the output stream whenever
meillo@34 309 a pipe command is called after an alias expansion.
meillo@34 310 Default is false.
meillo@0 311
meillo@0 312 .TP
meillo@34 313 \fBpipe_fromhack = \fIboolean\fR
meillo@0 314
meillo@34 315 If this is set, each line beginning with `From ' is replaced with `>From '
meillo@34 316 whenever a pipe command is called after an alias expansion.
meillo@34 317 You probably want this if you have set \fBpipe_fromline\fR above.
meillo@34 318 Default is false.
meillo@0 319
meillo@0 320 .TP
meillo@34 321 \fBmbox_default = \fIstring\fR
meillo@0 322
meillo@34 323 The default local delivery method.
meillo@205 324 Can be mbox or mda.
meillo@205 325 You can override this for each user by using the \fBmbox_users\fR or \fBmda_users\fR (see below).
meillo@0 326
meillo@238 327 Default: mbox.
meillo@238 328
meillo@0 329 .TP
meillo@34 330 \fBmbox_users = \fIlist\fR
meillo@0 331
meillo@0 332 A list of users which wish delivery to an mbox style mail folder.
meillo@34 333
meillo@0 334 .TP
meillo@34 335 \fBmda_users = \fIlist\fR
meillo@0 336
meillo@34 337 A list of users which wish local delivery to an mda.
meillo@34 338 You have to set \fBmda\fR (see below) as well.
meillo@0 339
meillo@0 340 .TP
meillo@34 341 \fBmda = \fIexpand string\fR
meillo@0 342
meillo@34 343 If you want local delivery to be transferred to an mda (Mail Delivery Agent),
meillo@34 344 set this to a command.
meillo@34 345 The argument will be expanded on delivery time,
meillo@34 346 you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces.
meillo@34 347 Variables you can use are:
meillo@0 348
meillo@34 349 uid - the unique message id.
meillo@34 350 This is not necessarily identical with the Message ID as given in the Message ID: header.
meillo@0 351
meillo@0 352 received_host - the host the mail was received from
meillo@0 353
meillo@378 354 ident - the user id of the sender if the message was received locally.
meillo@0 355
meillo@0 356 return_path_local - the local part of the return path (sender).
meillo@0 357
meillo@0 358 return_path_domain - the domain part of the return path (sender).
meillo@0 359
meillo@0 360 return_path - the complete return path (sender).
meillo@0 361
meillo@0 362 rcpt_local - the local part of the recipient.
meillo@0 363
meillo@0 364 rcpt_domain - the domain part of the recipient.
meillo@0 365
meillo@0 366 rcpt - the complete recipient address.
meillo@0 367
meillo@0 368 Example:
meillo@0 369
meillo@16 370 mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
meillo@0 371
meillo@34 372 For the mda, as for pipe commands, a few environment variables will be set as well.
meillo@34 373 See \fBmasqmail(8)\fR.
meillo@34 374 To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash,
meillo@34 375 otherwise they will be tried to be expanded with the internal variables.
meillo@34 376
meillo@0 377 .TP
meillo@34 378 \fBmda_fromline = \fIboolean\fR
meillo@0 379
meillo@34 380 If this is set, a from line will be prepended to the output stream whenever
meillo@34 381 a message is delivered to an mda.
meillo@34 382 Default is false.
meillo@0 383
meillo@0 384 .TP
meillo@34 385 \fBmda_fromhack = \fIboolean\fR
meillo@0 386
meillo@34 387 If this is set, each line beginning with `From ' is replaced with `>From '
meillo@34 388 whenever a message is delivered to an mda.
meillo@34 389 You probably want this if you have set \fBmda_fromline\fR above.
meillo@34 390 Default is false.
meillo@0 391
meillo@0 392 .TP
meillo@310 393 \fBonline_query = \fIcommand line\fR
meillo@0 394
meillo@310 395 Defines the method masqmail uses to detect whether there exists an online connection currently.
meillo@0 396
meillo@310 397 Masqmail executes the command given and reads from its standard output.
meillo@310 398 The command should just print a route name, as defined
meillo@354 399 with \fBquery_routes.\fIname\fR, to standard output and return a zero status code.
meillo@310 400 Masqmail assumes it is offline if the script returns with a non-zero status.
meillo@310 401 Leading and trailing whitespace is removed from the output.
meillo@0 402
meillo@310 403 Simple example:
meillo@310 404
meillo@310 405 .nf
meillo@310 406 #!/bin/sh
meillo@310 407 test \-e /var/run/masqmail/masqmail-route || exit 1
meillo@310 408 cat /var/run/masqmail/masqmail-route
meillo@310 409 exit 0
meillo@310 410 .fi
meillo@0 411
meillo@34 412 No matter how masqmail detects the online status,
meillo@34 413 only messages that are accepted at online time will be delivered using the connection.
meillo@310 414 The mail spool still needs to be emptied manually
meillo@310 415 (\fB\-qo\fIconnection\fR).
meillo@0 416
meillo@310 417 \fIcommand line\fR must start with an absolute path to an executable program.
meillo@158 418 It can contain optional arguments.
meillo@0 419
meillo@310 420 To simulate the old online_method=file, use:
meillo@310 421 \fI/bin/cat /path/to/file\fP
meillo@158 422
meillo@310 423 To be always online with connection `foo', use:
meillo@310 424 \fI/bin/echo foo\fP
meillo@310 425
meillo@310 426 To query a masqdialer server
meillo@310 427 (i.e. asking it whether a connection exists and what its name is)
meillo@164 428 use:
meillo@310 429 \fI/usr/bin/mservdetect localhost 224\fP
meillo@92 430
meillo@0 431 .TP
meillo@34 432 \fBerrmsg_file = \fIfile\fR
meillo@0 433
meillo@34 434 Set this to a template which will be used to generate delivery failure reports.
meillo@34 435 Variable parts within the template begin with a dollar sign and are identical
meillo@34 436 to those which can be used as arguments for the mda command, see \fBmda\fR above.
meillo@34 437 Additional information can be included with @failed_rcpts, @msg_headers and @msg_body,
meillo@34 438 these must be at the beginning of a line and will be replaced with the list of the failed recipients,
meillo@34 439 the message headers and the message body of the failed message.
meillo@0 440
meillo@0 441 Default is /usr/share/masqmail/tpl/failmsg.tpl.
meillo@34 442
meillo@0 443 .TP
meillo@34 444 \fBwarnmsg_file = \fIfile\fR
meillo@0 445
meillo@34 446 Set this to a template which will be used to generate delivery warning reports.
meillo@34 447 It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above.
meillo@0 448
meillo@0 449 Default is /usr/share/masqmail/tpl/warnmsg.tpl.
meillo@34 450
meillo@0 451 .TP
meillo@34 452 \fBwarn_intervals\fR = \fIlist\fR
meillo@0 453
meillo@34 454 Set this to a list of time intervals, at which delivery warnings
meillo@34 455 (starting with the receiving time of the message) shall be generated.
meillo@0 456
meillo@34 457 A warning will only be generated just after an attempt to deliver the mail
meillo@34 458 and if that attempt failed temporarily.
meillo@34 459 So a warning may be generated after a longer time, if there was no attempt before.
meillo@0 460
meillo@0 461 Default is "1h;4h;8h;1d;2d;3d"
meillo@34 462
meillo@0 463 .TP
meillo@34 464 \fBmax_defer_time\fR = \fItime\fR
meillo@0 465
meillo@34 466 This is the maximum time, in which a temporarily failed mail will be kept in the spool.
meillo@34 467 When this time is exceeded, it will be handled as a delivery failure,
meillo@34 468 and the message will be bounced.
meillo@0 469
meillo@34 470 The excedence of this time will only be noticed if the message was actually tried to be delivered.
meillo@34 471 If, for example, the message can only be delivered when online,
meillo@34 472 but you have not been online for that time, no bounce will be generated.
meillo@0 473
meillo@0 474 Default is 4d (4 days)
meillo@34 475
meillo@0 476 .TP
meillo@34 477 \fBlog_user = \fIname\fR
meillo@0 478
meillo@34 479 Replace \fIname\fR with a valid local or remote mail address.
meillo@0 480
meillo@44 481 If this option is set, then a copy of every mail,
meillo@44 482 that passes through the masqmail system will also be sent to the given mail address.
meillo@0 483
meillo@34 484 For example you can feed your mails into a program like hypermail
meillo@34 485 for archiving purpose by placing an appropriate pipe command in masqmail.alias
meillo@0 486
meillo@117 487 .TP
meillo@117 488 \fBmax_msg_size\fR = \fIbytes\fR
meillo@117 489
meillo@117 490 This option sets the maximum size in bytes masqmail will accept for delivery.
meillo@117 491 This value is advertised to the SMTP client by the `SIZE' message during SMTP
meillo@117 492 session setup.
meillo@117 493 Clients pretending to send, or actually send,
meillo@117 494 more than \fIbytes\fR will get a 552 error message.
meillo@117 495
meillo@120 496 `0' means no fixed maximum size limit is in force.
meillo@120 497
meillo@120 498 Default is 0 (= unlimited).
meillo@117 499
meillo@134 500 .TP
meillo@134 501 \fBdefer_all\fR = \fIboolean\fR
meillo@134 502
meillo@134 503 If set to true, masqmail replies with ``421 service temporarily unavailable''
meillo@134 504 to any SMTP request and shuts the connection down.
meillo@134 505 Note: This option is for debugging purposes only.
meillo@134 506
meillo@134 507 Default: false
meillo@134 508
meillo@34 509
meillo@0 510 .SH AUTHOR
meillo@0 511
meillo@34 512 Masqmail was written by Oliver Kurth.
meillo@34 513 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
meillo@0 514
meillo@95 515 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR.
meillo@26 516 There is also a mailing list, you will find information about it at masqmail's main site.
meillo@0 517
meillo@34 518
meillo@0 519 .SH BUGS
meillo@0 520
meillo@34 521 Please report bugs to the mailing list.
meillo@34 522
meillo@0 523
meillo@0 524 .SH SEE ALSO
meillo@0 525
meillo@192 526 \fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR