Mercurial > masqmail

comparison docs/masqmail.conf.5 @ 16:163aa299bedb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fixed man pages added backslashes to dashes (to satisfy Debian) removed wrong sentence about /etc/aliases. Thanks to Alexis. (Closes Debian bug #480477) fixed typos reported by Reuben Thomas. (Closes Debian bug #427096)
author meillo@marmaro.de
date Thu, 06 Nov 2008 09:33:32 +0100
parents 8c55886cacd8
children 607221b0dac1
comparison
equal deleted inserted replaced
15:f671821d8222 16:163aa299bedb
84 84
85 \fBnot_local_addresses = \fIlist\f1\fB\f1 85 \fBnot_local_addresses = \fIlist\f1\fB\f1
86 86
87 A semicolon ';' separated list of fully qualified email-addresses which are considered not local although their domain name part is in the list of \fBlocal_hosts\f1. 87 A semicolon ';' separated list of fully qualified email-addresses which are considered not local although their domain name part is in the list of \fBlocal_hosts\f1.
88 88
89 This ist the opposite of the previous case. The majority of addresses of a specific domain are local. But some users are not. With this option you can easily exclude these users. 89 This is the opposite of the previous case. The majority of addresses of a specific domain are local. But some users are not. With this option you can easily exclude these users.
90 90
91 Example: 91 Example:
92 92
93 local_hosts = "localhost;myhost;mydomain.net" 93 local_hosts = "localhost;myhost;mydomain.net"
94 94
120 Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients. 120 Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients.
121 .TP 121 .TP
122 122
123 \fBdo_queue = \fIboolean\f1\fB\f1 123 \fBdo_queue = \fIboolean\f1\fB\f1
124 124
125 If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB-odq\f1 option. 125 If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB\-odq\f1 option.
126 .TP 126 .TP
127 127
128 \fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1 128 \fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1
129 129
130 Replace \fIname\f1 with a name to identify a connection. Set this to a filename (or a list of filenames) for the special route configuration for that connection. You will use that name to call masqmail with the\fB-qo\f1 option every time a connection to your ISP is set up. 130 Replace \fIname\f1 with a name to identify a connection. Set this to a filename (or a list of filenames) for the special route configuration for that connection. You will use that name to call masqmail with the \fB\-qo\f1 option every time a connection to your ISP is set up.
131 131
132 Example: Your ISP has the name FastNet. Then you write the following line in the main configuration: 132 Example: Your ISP has the name FastNet. Then you write the following line in the main configuration:
133 133
134 \fBonline_routes.FastNet\f1 = \fI"/etc/masqmail/fastnet.route"\f1 134 \fBonline_routes.FastNet\f1 = \fI"/etc/masqmail/fastnet.route"\f1
135 135
136 \fI/etc/masqmail/fastnet.route\f1 is the route configuration file, see \fBmasqmail.route (5)\f1. As soon as a link to FastNet has been set up, you call masqmail \fB-qo\f1 \fIFastNet\f1. Masqmail will then read the specified file and send the mails. 136 \fI/etc/masqmail/fastnet.route\f1 is the route configuration file, see \fBmasqmail.route (5)\f1. As soon as a link to FastNet has been set up, you call masqmail \fB\-qo\f1 \fIFastNet\f1. Masqmail will then read the specified file and send the mails.
137 .TP 137 .TP
138 138
139 \fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1 139 \fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1
140 140
141 Old name for \fBonline_routes\f1. 141 Old name for \fBonline_routes\f1.
208 208
209 rcpt - the complete recipient address. 209 rcpt - the complete recipient address.
210 210
211 Example: 211 Example:
212 212
213 mda="/usr/bin/procmail -Y -d ${rcpt_local}" 213 mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
214 214
215 For the mda, as for pipe commands, a few environment variables will be set as well. See \fBmasqmail (8)\f1. To use environment variables for the mda, the '$' sign has to be escaped with a backslash, otherwise they will be tried to be expanded with the internal variables. 215 For the mda, as for pipe commands, a few environment variables will be set as well. See \fBmasqmail (8)\f1. To use environment variables for the mda, the '$' sign has to be escaped with a backslash, otherwise they will be tried to be expanded with the internal variables.
216 .TP 216 .TP
217 217
218 \fBmda_fromline = \fIboolean\f1\fB\f1 218 \fBmda_fromline = \fIboolean\f1\fB\f1
233 233
234 When it is set to \fBpipe\f1, MasqMail calls the executable given by the \fBonline_pipe\f1 option (see below) and reads the current online status from its standard output. 234 When it is set to \fBpipe\f1, MasqMail calls the executable given by the \fBonline_pipe\f1 option (see below) and reads the current online status from its standard output.
235 235
236 When it is set to \fBmserver\f1, MasqMail connects to the masqdialer server using the value of \fBmserver_iface\f1 and asks it whether a connection exists and for the name, which should be the name of the current connection as defined with \fBconnect_route.\fIname\f1\fB\f1. 236 When it is set to \fBmserver\f1, MasqMail connects to the masqdialer server using the value of \fBmserver_iface\f1 and asks it whether a connection exists and for the name, which should be the name of the current connection as defined with \fBconnect_route.\fIname\f1\fB\f1.
237 237
238 No matter how MasqMail detects the online status, only messages that are accepted at online time will be delivered using the connection. The spool still has to be emptied with masqmail \fB-qo\f1\fIconnection\f1. 238 No matter how MasqMail detects the online status, only messages that are accepted at online time will be delivered using the connection. The spool still has to be emptied with masqmail \fB\-qo\f1\fIconnection\f1.
239 .TP 239 .TP
240 240
241 \fBonline_file = \fIfile\f1\fB\f1 241 \fBonline_file = \fIfile\f1\fB\f1
242 242
243 This is the name of the file checked for when MasqMail determines whether it is online. The file should only exist when there is currently a connection. Create it in your ip-up script with eg. 243 This is the name of the file checked for when MasqMail determines whether it is online. The file should only exist when there is currently a connection. Create it in your ip-up script with eg.
244 244
245 echo -n <name> > /tmp/connect_route 245 echo \-n <name> > /tmp/connect_route
246 246
247 chmod 0644 /tmp/connect_route 247 chmod 0644 /tmp/connect_route
248 248
249 Do not forget to delete it in your ip-down script. 249 Do not forget to delete it in your ip-down script.
250 .TP 250 .TP
255 255
256 #!/bin/sh 256 #!/bin/sh
257 257
258 258
259 259
260 [ -e /tmp/connect_route ] || exit 1 260 [ \-e /tmp/connect_route ] || exit 1
261 261
262 cat /tmp/connect_route 262 cat /tmp/connect_route
263 263
264 exit 0 264 exit 0
265 265
271 The interface the masqdialer server is listening to. Usually this will be "localhost:224" if mserver is running on the same host as masqmail. But using this option, you can also let masqmail run on another host by setting \fBmserver_iface\f1 to another hostname, eg. "foo:224". 271 The interface the masqdialer server is listening to. Usually this will be "localhost:224" if mserver is running on the same host as masqmail. But using this option, you can also let masqmail run on another host by setting \fBmserver_iface\f1 to another hostname, eg. "foo:224".
272 .TP 272 .TP
273 273
274 \fBget.\fIname\f1\fB = \fIfile\f1\fB\f1 274 \fBget.\fIname\f1\fB = \fIfile\f1\fB\f1
275 275
276 Replace \fIname\f1 with a name to identify a get configuration. Set this to a filename for the get configuration. These files will be used to retrieve mail when called with the -g option. 276 Replace \fIname\f1 with a name to identify a get configuration. Set this to a filename for the get configuration. These files will be used to retrieve mail when called with the \-g option.
277 .TP 277 .TP
278 278
279 \fBonline_gets.\fIname\f1\fB = \fIlist\f1\fB\f1 279 \fBonline_gets.\fIname\f1\fB = \fIlist\f1\fB\f1
280 280
281 Replace \fIname\f1 with a name to identify an online configuration. Set this to a filename (or a list of filenames) for the get configuration. These files will be used to retrieve mail when called with the -go option. 281 Replace \fIname\f1 with a name to identify an online configuration. Set this to a filename (or a list of filenames) for the get configuration. These files will be used to retrieve mail when called with the \-go option.
282 .TP 282 .TP
283 283
284 \fBident_trusted_nets = \fIlist\f1\fB\f1 284 \fBident_trusted_nets = \fIlist\f1\fB\f1
285 285
286 \fIlist\f1 is a list of networks of the form a.b.c.d/e (eg. 192.168.1.0/24), from which the ident given by the ident protocol will be trusted, so a user can delete his mail from the queue if the ident is identical to his login name. 286 \fIlist\f1 is a list of networks of the form a.b.c.d/e (eg. 192.168.1.0/24), from which the ident given by the ident protocol will be trusted, so a user can delete his mail from the queue if the ident is identical to his login name.