masqmail

annotate man/masqmail.conf.5 @ 246:4cff8638dd9b

find changesets by author, revision, files, or words in the commit message
SMTP client: tries EHLO now always first Changed the behavior of the SMTP client. Now always an EHLO greeting is sent, no matter what kind of greeting text the server had sent. If the EHLO failed, an HELO greeting is tried as fall back. This is the behavior RFC 2821 requires (section 3.2). This change will fix setups that were not possible to sent to a server because that requires AUTH but hadn't said ``ESMTP'' in its greeting message. See also: Debian bug #349211 Thanks to Steffen (inne)
author markus schnalke <meillo@marmaro.de>
date Thu, 28 Oct 2010 16:40:02 -0300
parents bc9d9cd9ee8e
children 95d536599fd7
rev   line source
meillo@228 1 .TH masqmail.conf 5 2010-07-23 masqmail-0.3.0 "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@34 62 Valid values are 0 to 6, increasing it further makes no difference.
meillo@34 63 Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive.
meillo@0 64
meillo@0 65 .TP
meillo@44 66 \fBlog_dir = \fIfile\fR
meillo@44 67
meillo@174 68 The directory where logs are stored, if syslog is not used.
meillo@174 69 Debug files are always stored in this directory if debugging is enabled.
meillo@44 70 \fIfile\fR must be an absolute path.
meillo@44 71
meillo@151 72 Default: \fI/var/log/masqmail\fR
meillo@151 73
meillo@44 74 .TP
meillo@34 75 \fBmail_dir = \fIfile\fR
meillo@0 76
meillo@34 77 The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR.
meillo@44 78 \fIfile\fR must be an absolute path.
meillo@0 79
meillo@152 80 Default: \fI/var/mail\fR
meillo@152 81
meillo@0 82 .TP
meillo@34 83 \fBspool_dir = \fIfile\fR
meillo@0 84
meillo@34 85 The directory where masqmail stores its spool files (and later also other stuff).
meillo@34 86 It must have a subdirectory \fIinput\fR.
meillo@34 87 Masqmail needs read and write permissions for this directory.
meillo@44 88 \fIfile\fR must be an absolute path.
meillo@0 89
meillo@151 90 Default: \fI/var/spool/masqmail\fR
meillo@151 91
meillo@0 92 .TP
meillo@133 93 \fBlock_dir = \fIfile\fR
meillo@133 94
meillo@133 95 The directory where masqmail stores its lock files.
meillo@133 96 Masqmail needs read and write permissions for this directory.
meillo@133 97 By default it is a directory ``lock'' inside of \fIspool_dir\fP.
meillo@133 98 \fIfile\fR must be an absolute path.
meillo@133 99
meillo@133 100 .TP
meillo@34 101 \fBhost_name = \fIstring\fR
meillo@0 102
meillo@34 103 This is used in different places: Masqmail identifies itself in the greeting banner
meillo@34 104 on incoming connections and in the HELO/EHLO command for outgoing connections with this name,
meillo@34 105 it is used in the Received: header and to qualify the sender of a locally originating message.
meillo@0 106
meillo@34 107 If the string begins with a slash `/', it it assumed that it is a filename,
meillo@34 108 and the first line of this file will be used.
meillo@34 109 Usually this will be `/etc/mailname' to make masqmail conform to Debian policies.
meillo@0 110
meillo@34 111 It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that.
meillo@0 112
meillo@156 113 Default: none; \fBhost_name\fP MUST be set in the config file
meillo@156 114
meillo@0 115 .TP
meillo@34 116 \fBlocal_hosts = \fIlist\fR
meillo@0 117
meillo@34 118 A semicolon `;' separated list of hostnames which are considered local.
meillo@153 119 Normally you should set it to "localhost;foo;foo.bar.com" if your host has the
meillo@34 120 fully qualified domain name `foo.bar.com'.
meillo@0 121
meillo@157 122 Default: localhost ; <value of \fBhost_name\fR cut at the first dot> ; <value of \fBhost_name\fR>
meillo@157 123
meillo@157 124 Example: \fIlocalhost;foo;foo.example.org\fR
meillo@157 125 (if you have set \fBhost_name\fR to \fIfoo.example.org\fR)
meillo@153 126
meillo@0 127 .TP
meillo@34 128 \fBlocal_addresses = \fIlist\fR
meillo@0 129
meillo@34 130 A semicolon `;' separated list of fully qualified email-addresses which are
meillo@34 131 considered local although their domain name part is not in the list of \fBlocal_hosts\fR.
meillo@238 132 This list can be seen as an addition to \fBlocal_hosts\fP.
meillo@0 133
meillo@34 134 For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain.
meillo@34 135 But there are other persons @yourdomain which are NOT local.
meillo@34 136 So you can not put yourdomain to the list of local_hosts.
meillo@34 137 If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put
meillo@0 138
meillo@0 139 local_addresses = "person1@yourdomain;person2@yourdomain"
meillo@0 140
meillo@0 141 to your masqmail.conf.
meillo@34 142
meillo@0 143 .TP
meillo@34 144 \fBnot_local_addresses = \fIlist\fR
meillo@0 145
meillo@34 146 A semicolon `;' separated list of fully qualified email-addresses which are
meillo@34 147 considered not local although their domain name part is in the list of \fBlocal_hosts\fR.
meillo@238 148 This list can be seen as a substraction to \fBlocal_hosts\fP.
meillo@0 149
meillo@34 150 This is the opposite of the previous case.
meillo@34 151 The majority of addresses of a specific domain are local.
meillo@34 152 But some users are not.
meillo@34 153 With this option you can easily exclude these users.
meillo@0 154
meillo@0 155 Example:
meillo@0 156
meillo@0 157 local_hosts = "localhost;myhost;mydomain.net"
meillo@0 158
meillo@0 159 not_local_addresses = "eric@mydomain.net"
meillo@34 160
meillo@0 161 .TP
meillo@238 162 \fBlocal_nets = \fIlist\fR
meillo@238 163
meillo@238 164 A semicolon `;' separated list of hostnames which are on the `local' net.
meillo@238 165 Delivery to these hosts is attempted immediately.
meillo@238 166 You can use patterns with `*', e.g. "*.bar.com".
meillo@238 167
meillo@238 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@34 177 Note that the names are resolved to IP addreses.
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@206 181 Default: \fI127.0.0.1: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@34 209 If this is set, mail will not be delivered immediately when accepted.
meillo@34 210 Same as calling masqmail with the \fB\-odq\fR option.
meillo@0 211
meillo@0 212 .TP
meillo@34 213 \fBonline_routes.\fIname\fR = \fIlist\fR
meillo@0 214
meillo@34 215 Replace \fIname\fR with a name to identify a connection.
meillo@34 216 Set this to a filename (or a list of filenames) for the special route configuration for that connection.
meillo@34 217 You will use that name to call masqmail with the \fB\-qo\fR option every time a
meillo@34 218 connection to your ISP is set up.
meillo@0 219
meillo@34 220 Example: Your ISP has the name FastNet.
meillo@34 221 Then you write the following line in the main configuration:
meillo@0 222
meillo@139 223 \fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR
meillo@0 224
meillo@34 225 \fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR.
meillo@34 226 As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR.
meillo@34 227 Masqmail will then read the specified file and send the mails.
meillo@0 228
meillo@0 229 .TP
meillo@34 230 \fBconnect_route.\fIname\fR = \fIlist\fR
meillo@0 231
meillo@34 232 Old name for \fBonline_routes\fR.
meillo@0 233
meillo@0 234 .TP
meillo@34 235 \fBlocal_net_route = \fIfile\fR
meillo@0 236
meillo@234 237 This is similar to \fBonline_routes.\fIname\fR but used for delilvery to the local net.
meillo@34 238 Recipient addresses that are in local_nets will be routed using this route configuration.
meillo@34 239 Main purpose is to define a mail server with mail_host in your local network.
meillo@34 240 In simple environments this can be left unset.
meillo@234 241 If unset, a default route configuration (named ``default local_net_route'') will be used.
meillo@0 242
meillo@0 243 .TP
meillo@34 244 \fBalias_file = \fIfile\fR
meillo@0 245
meillo@34 246 Set this to the location of your alias file.
meillo@238 247 If not set, no aliasing will be done.
meillo@238 248
meillo@238 249 Default: <not set> (i.e. no aliasing is done)
meillo@0 250
meillo@0 251 .TP
meillo@243 252 \fBcaseless_matching = \fIboolean\fR
meillo@0 253
meillo@242 254 If this is set, aliasing and the matching for \fBlocal_addresses\fP and
meillo@242 255 \fBnot_local_addresses\fP will be done caseless.
meillo@242 256
meillo@242 257 Note: Be sure to change this option only if the queue is empty as
meillo@242 258 correct processing of queued messages is not guaranteed otherwise.
meillo@34 259
meillo@238 260 Default: false
meillo@238 261
meillo@0 262 .TP
meillo@34 263 \fBpipe_fromline = \fIboolean\fR
meillo@0 264
meillo@34 265 If this is set, a from line will be prepended to the output stream whenever
meillo@34 266 a pipe command is called after an alias expansion.
meillo@34 267 Default is false.
meillo@0 268
meillo@0 269 .TP
meillo@34 270 \fBpipe_fromhack = \fIboolean\fR
meillo@0 271
meillo@34 272 If this is set, each line beginning with `From ' is replaced with `>From '
meillo@34 273 whenever a pipe command is called after an alias expansion.
meillo@34 274 You probably want this if you have set \fBpipe_fromline\fR above.
meillo@34 275 Default is false.
meillo@0 276
meillo@0 277 .TP
meillo@34 278 \fBmbox_default = \fIstring\fR
meillo@0 279
meillo@34 280 The default local delivery method.
meillo@205 281 Can be mbox or mda.
meillo@205 282 You can override this for each user by using the \fBmbox_users\fR or \fBmda_users\fR (see below).
meillo@0 283
meillo@238 284 Default: mbox.
meillo@238 285
meillo@0 286 .TP
meillo@34 287 \fBmbox_users = \fIlist\fR
meillo@0 288
meillo@0 289 A list of users which wish delivery to an mbox style mail folder.
meillo@34 290
meillo@0 291 .TP
meillo@34 292 \fBmda_users = \fIlist\fR
meillo@0 293
meillo@34 294 A list of users which wish local delivery to an mda.
meillo@34 295 You have to set \fBmda\fR (see below) as well.
meillo@0 296
meillo@0 297 .TP
meillo@34 298 \fBmda = \fIexpand string\fR
meillo@0 299
meillo@34 300 If you want local delivery to be transferred to an mda (Mail Delivery Agent),
meillo@34 301 set this to a command.
meillo@34 302 The argument will be expanded on delivery time,
meillo@34 303 you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces.
meillo@34 304 Variables you can use are:
meillo@0 305
meillo@34 306 uid - the unique message id.
meillo@34 307 This is not necessarily identical with the Message ID as given in the Message ID: header.
meillo@0 308
meillo@0 309 received_host - the host the mail was received from
meillo@0 310
meillo@34 311 ident - the ident, this is either the ident delivered by the ident protocol
meillo@34 312 or the user id of the sender if the message was received locally.
meillo@0 313
meillo@0 314 return_path_local - the local part of the return path (sender).
meillo@0 315
meillo@0 316 return_path_domain - the domain part of the return path (sender).
meillo@0 317
meillo@0 318 return_path - the complete return path (sender).
meillo@0 319
meillo@0 320 rcpt_local - the local part of the recipient.
meillo@0 321
meillo@0 322 rcpt_domain - the domain part of the recipient.
meillo@0 323
meillo@0 324 rcpt - the complete recipient address.
meillo@0 325
meillo@0 326 Example:
meillo@0 327
meillo@16 328 mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
meillo@0 329
meillo@34 330 For the mda, as for pipe commands, a few environment variables will be set as well.
meillo@34 331 See \fBmasqmail(8)\fR.
meillo@34 332 To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash,
meillo@34 333 otherwise they will be tried to be expanded with the internal variables.
meillo@34 334
meillo@0 335 .TP
meillo@34 336 \fBmda_fromline = \fIboolean\fR
meillo@0 337
meillo@34 338 If this is set, a from line will be prepended to the output stream whenever
meillo@34 339 a message is delivered to an mda.
meillo@34 340 Default is false.
meillo@0 341
meillo@0 342 .TP
meillo@34 343 \fBmda_fromhack = \fIboolean\fR
meillo@0 344
meillo@34 345 If this is set, each line beginning with `From ' is replaced with `>From '
meillo@34 346 whenever a message is delivered to an mda.
meillo@34 347 You probably want this if you have set \fBmda_fromline\fR above.
meillo@34 348 Default is false.
meillo@0 349
meillo@0 350 .TP
meillo@34 351 \fBonline_detect = \fIstring\fR
meillo@0 352
meillo@34 353 Defines the method masqmail uses to detect whether there is currently an online connection.
meillo@164 354 It can have the values \fIfile\fR or \fIpipe\fR.
meillo@0 355
meillo@112 356 When it is set to \fIfile\fR, masqmail first checks for the existence of \fBonline_file\fR
meillo@34 357 (see below) and if it exists, it reads it.
meillo@34 358 The content of the file should be the name of the current connection as defined
meillo@34 359 with \fBconnect_route.\fIname\fR (trailing whitespace is removed).
meillo@0 360
meillo@112 361 When it is set to \fIpipe\fR, masqmail calls the executable given by the
meillo@34 362 \fBonline_pipe\fR option (see below) and reads the current online status from its standard output.
meillo@0 363
meillo@34 364 No matter how masqmail detects the online status,
meillo@34 365 only messages that are accepted at online time will be delivered using the connection.
meillo@34 366 The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR.
meillo@0 367
meillo@0 368 .TP
meillo@34 369 \fBonline_file = \fIfile\fR
meillo@0 370
meillo@34 371 This is the name of the file checked for when masqmail determines whether it is online.
meillo@34 372 The file should only exist when there is currently a connection.
meillo@34 373 Create it in your ip-up script with e.g.
meillo@0 374
meillo@92 375 echo "connection-name" >/var/run/masqmail/masqmail-route
meillo@0 376
meillo@37 377 chmod 0644 /var/run/masqmail/masqmail-route
meillo@0 378
meillo@0 379 Do not forget to delete it in your ip-down script.
meillo@34 380
meillo@0 381 .TP
meillo@34 382 \fBonline_pipe = \fIfile\fR
meillo@0 383
meillo@34 384 This is the name of the executable which will be called to determine the online status.
meillo@34 385 This executable should just print the name of the current connection to
meillo@34 386 the standard output and return a zero status code.
meillo@34 387 masqmail assumes it is offline if the script returns with a non zero status.
meillo@34 388 Simple example:
meillo@0 389
meillo@0 390 #!/bin/sh
meillo@0 391
meillo@37 392 [ \-e /var/run/masqmail/masqmail-route ] || exit 1
meillo@0 393
meillo@37 394 cat /var/run/masqmail/masqmail-route
meillo@0 395
meillo@0 396 exit 0
meillo@0 397
meillo@129 398 Of course, instead of the example above you could as well use \fIfile\fR as
meillo@34 399 the online detection method, but you can do something more sophisticated.
meillo@34 400
meillo@158 401 \fIfile\fR must contain an absolute path to an executable program.
meillo@158 402 It can contain optional arguments.
meillo@0 403
meillo@158 404 Example: \fI/bin/echo foo\fR
meillo@158 405 (This tells masqmail to be always online with connection `foo'.)
meillo@158 406
meillo@164 407 For querying a masqdialer server
meillo@164 408 (= asking it whether a connection exists and what its name is)
meillo@164 409 use:
meillo@92 410
meillo@92 411 online_method=pipe
meillo@92 412
meillo@164 413 online_pipe="/usr/bin/mservdetect localhost 224"
meillo@92 414
meillo@0 415
meillo@0 416 .TP
meillo@34 417 \fBident_trusted_nets = \fIlist\fR
meillo@0 418
meillo@34 419 \fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24),
meillo@34 420 from which the ident given by the ident protocol will be trusted,
meillo@34 421 so a user can delete his mail from the queue if the ident is identical to his login name.
meillo@0 422
meillo@0 423 .TP
meillo@34 424 \fBerrmsg_file = \fIfile\fR
meillo@0 425
meillo@34 426 Set this to a template which will be used to generate delivery failure reports.
meillo@34 427 Variable parts within the template begin with a dollar sign and are identical
meillo@34 428 to those which can be used as arguments for the mda command, see \fBmda\fR above.
meillo@34 429 Additional information can be included with @failed_rcpts, @msg_headers and @msg_body,
meillo@34 430 these must be at the beginning of a line and will be replaced with the list of the failed recipients,
meillo@34 431 the message headers and the message body of the failed message.
meillo@0 432
meillo@0 433 Default is /usr/share/masqmail/tpl/failmsg.tpl.
meillo@34 434
meillo@0 435 .TP
meillo@34 436 \fBwarnmsg_file = \fIfile\fR
meillo@0 437
meillo@34 438 Set this to a template which will be used to generate delivery warning reports.
meillo@34 439 It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above.
meillo@0 440
meillo@0 441 Default is /usr/share/masqmail/tpl/warnmsg.tpl.
meillo@34 442
meillo@0 443 .TP
meillo@34 444 \fBwarn_intervals\fR = \fIlist\fR
meillo@0 445
meillo@34 446 Set this to a list of time intervals, at which delivery warnings
meillo@34 447 (starting with the receiving time of the message) shall be generated.
meillo@0 448
meillo@34 449 A warning will only be generated just after an attempt to deliver the mail
meillo@34 450 and if that attempt failed temporarily.
meillo@34 451 So a warning may be generated after a longer time, if there was no attempt before.
meillo@0 452
meillo@0 453 Default is "1h;4h;8h;1d;2d;3d"
meillo@34 454
meillo@0 455 .TP
meillo@34 456 \fBmax_defer_time\fR = \fItime\fR
meillo@0 457
meillo@34 458 This is the maximum time, in which a temporarily failed mail will be kept in the spool.
meillo@34 459 When this time is exceeded, it will be handled as a delivery failure,
meillo@34 460 and the message will be bounced.
meillo@0 461
meillo@34 462 The excedence of this time will only be noticed if the message was actually tried to be delivered.
meillo@34 463 If, for example, the message can only be delivered when online,
meillo@34 464 but you have not been online for that time, no bounce will be generated.
meillo@0 465
meillo@0 466 Default is 4d (4 days)
meillo@34 467
meillo@0 468 .TP
meillo@34 469 \fBlog_user = \fIname\fR
meillo@0 470
meillo@34 471 Replace \fIname\fR with a valid local or remote mail address.
meillo@0 472
meillo@44 473 If this option is set, then a copy of every mail,
meillo@44 474 that passes through the masqmail system will also be sent to the given mail address.
meillo@0 475
meillo@34 476 For example you can feed your mails into a program like hypermail
meillo@34 477 for archiving purpose by placing an appropriate pipe command in masqmail.alias
meillo@0 478
meillo@117 479 .TP
meillo@117 480 \fBmax_msg_size\fR = \fIbytes\fR
meillo@117 481
meillo@117 482 This option sets the maximum size in bytes masqmail will accept for delivery.
meillo@117 483 This value is advertised to the SMTP client by the `SIZE' message during SMTP
meillo@117 484 session setup.
meillo@117 485 Clients pretending to send, or actually send,
meillo@117 486 more than \fIbytes\fR will get a 552 error message.
meillo@117 487
meillo@120 488 `0' means no fixed maximum size limit is in force.
meillo@120 489
meillo@120 490 Default is 0 (= unlimited).
meillo@117 491
meillo@134 492 .TP
meillo@134 493 \fBdefer_all\fR = \fIboolean\fR
meillo@134 494
meillo@134 495 If set to true, masqmail replies with ``421 service temporarily unavailable''
meillo@134 496 to any SMTP request and shuts the connection down.
meillo@134 497 Note: This option is for debugging purposes only.
meillo@134 498
meillo@134 499 Default: false
meillo@134 500
meillo@34 501
meillo@0 502 .SH AUTHOR
meillo@0 503
meillo@34 504 Masqmail was written by Oliver Kurth.
meillo@34 505 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
meillo@0 506
meillo@95 507 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR.
meillo@26 508 There is also a mailing list, you will find information about it at masqmail's main site.
meillo@0 509
meillo@34 510
meillo@0 511 .SH BUGS
meillo@0 512
meillo@34 513 Please report bugs to the mailing list.
meillo@34 514
meillo@0 515
meillo@0 516 .SH SEE ALSO
meillo@0 517
meillo@192 518 \fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR