Mercurial > masqmail

comparison man/masqmail.route.5 @ 317:55b7bde95d37

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
reworked allowed and denied addrs for routes The following refactorings had been made: - allowed_mail_locals + allowed_return_paths -> allowed_senders - not_allowed_mail_locals + not_allowed_return_paths -> denied_senders - allowed_rcpt_domains -> allowed_recipients - not_allowed_rcpt_domains -> denied_recipients The new options allow more consistent and more flexible matching.
author meillo@marmaro.de
date Thu, 28 Apr 2011 09:55:06 +0200
parents d596ac8b5afb
children 290da1595311
comparison
equal deleted inserted replaced
316:d596ac8b5afb 317:55b7bde95d37
15 15
16 16
17 .SH ROUTE CONDITIONS 17 .SH ROUTE CONDITIONS
18 18
19 .TP 19 .TP
20 \fBallowed_mail_locals\fR = \fIlist\fR 20 \fBallowed_senders\fR = \fIlist\fR
21 21
22 This is a semicolon `;' separated list of local parts of envelope 22 This is a semicolon `;' separated list of envelope sender addresses.
23 senders (= mail from = return path) which will be allowed 23 Messages which have one of these addresses as the return path (= mail
24 to send mail through this connection. 24 from) are allowed to use this route
25 If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed. 25 (if not also in \fBdenied_senders\fR).
26 26
27 .TP 27 Glob patterns containing `?' and `*' can be used.
28 \fBnot_allowed_mail_locals\fR = \fIlist\fR 28 The special item "<>" matches the null sender address
29 29 (eg. failure notices or delivery notifications).
30 This is a semicolon `;' separated list of local parts of envelope 30 If the pattern doesn't contain an `@', it is seen as a pattern for the
31 senders (= mail from = return path) which will be not allowed 31 local part only.
32 to send mail through this connection. 32
33 Local parts in this list will not be allowed to use this route even if they 33 Example: \fImeillo;*@*example.org;web*@example.com\fP
34 are part of \fBallowed_mail_locals\fR (see above). 34
35 35 (``meillo'' equals ``meillo@*'', i.e. the local part.)
36 .TP 36
37 \fBallowed_return_paths\fR = \fIlist\fR 37 .TP
38 38 \fBdenied_senders\fR = \fIlist\fR
39 This is a semicolon `;' separated list of addresses. 39
40 This is a semicolon `;' separated list of envelope sender addresses.
40 Messages which have one of these addresses as the return path (= 41 Messages which have one of these addresses as the return path (=
41 envelope sender = mail from) will be used using this route 42 mail from) will not
42 (if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches). 43 be sent using this route (even if also in \fBallowed_senders\fR).
43 44
44 Patterns containing `?' and `*' can be used. 45 Glob patterns containing `?' and `*' can be used.
45 The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). 46 The special item "<>" matches the null sender address
46 47 (eg. failure notices or delivery notifications).
47 .TP 48 If the pattern doesn't contain an `@', it is seen as a pattern for the
48 \fBnot_allowed_return_paths\fR = \fIlist\fR 49 local part only.
49 50
50 This is a semicolon `;' separated list of addresses. 51 Example: (see \fIallowed_senders\fP)
51 Messages which have one of these addresses as the return path (= 52
52 envelope sender = mail from) will not 53 .TP
53 be used using this route (even if also in \fBallowed_return_paths\fR 54 \fBallowed_recipients\fR = \fIlist\fR
54 or an item in \fBallowed_mail_locals\fR matches). 55
55 56 A list of envelope recipient addresses where mail can be sent to using
56 Patterns containing `?' and `*' can be used. 57 this route.
57 The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
58
59 .TP
60 \fBallowed_rcpt_domains\fR = \fIlist\fR
61
62 A list of recipient domains (of envelope recipients) where mail will be sent to.
63 This is for example useful if you use this route configuration when connected to another LAN via ppp. 58 This is for example useful if you use this route configuration when connected to another LAN via ppp.
64 Patterns containing `?' and `*' can be used. 59 Glob patterns containing `?' and `*' can be used.
65 60
66 .TP 61 Example: \fI*@example.org;*@*foo.bar\fP
67 \fBnot_allowed_rcpt_domains\fR = \fIlist\fR 62
68 63 (See also examples for \fIallowed_senders\fP)
69 A list of recipient domains (of envelope recipients) where mail will not be sent to. 64
65 .TP
66 \fBdenied_recipients\fR = \fIlist\fR
67
68 A list of envelope recipient addresses where mail will not be sent to
69 using this route.
70 This is for example useful if you send mail directly (\fBmail_host\fR is not set) 70 This is for example useful if you send mail directly (\fBmail_host\fR is not set)
71 and you know of hosts that will not accept mail from you because they use a dialup list 71 and you know of hosts that will not accept mail from you because they use a dialup list
72 (eg. \fBhttp://maps.vix.com/dul/\fR). 72 (eg. \fBhttp://maps.vix.com/dul/\fR).
73 If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR, 73 \fBdenied_recipients\fR overrules \fBallowed_recipients\fR.
74 mail will not be sent to this domain. 74 Glob patterns containing `?' and `*' can be used.
75 Patterns containing `?' and `*' can be used. 75
76 Example: \fI*@spamblocker.example.org\fP
77
78 (See also examples for \fIallowed_senders\fP)
76 79
77 .TP 80 .TP
78 \fBlast_route\fR = \fIboolean\fR 81 \fBlast_route\fR = \fIboolean\fR
79 82
80 If this is set, a mail which would have been delivered using this route, 83 If this is set, a mail which would have been delivered using this route,
81 but has failed temporarily, will not be tried to be delivered using the next route. 84 but has failed temporarily, will not be tried to be delivered using the next route.
82 85
83 If you have set up a special route with filters using the lists `allowed_rcpt_domains', 86 If you have set up a special route with filters using the lists
84 `allowed_return_paths', and `allowed_mail_locals' or their complements (not_), 87 `allowed_recipients' and `allowed_senders' or their complements
88 (denied_),
85 and the mail passing these rules should be delivered using this route only, 89 and the mail passing these rules should be delivered using this route only,
86 you should set this to `true'. 90 you should set this to `true'.
87 Otherwise the mail would be passed to the next route (if any), 91 Otherwise the mail would be passed to the next route (if any),
88 unless that route has rules which prevent that. 92 unless that route has rules which prevent that.
89 93