annotate man/masqmail.conf.5 @ 388:aa40710f09fe

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