Mercurial > masqmail

annotate man/masqmail.route.5 @ 316:d596ac8b5afb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
heavy restructuring of masqmail.route(5) (sections)
author meillo@marmaro.de
date Mon, 25 Apr 2011 15:17:30 +0200
parents e230bcd0f1c6
children 55b7bde95d37
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
291
95d536599fd7 updated ChangeLog, NEWS and date/version in the man pages
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
1 .TH masqmail.route 5 2010-12-08 masqmail-0.3.1 "File Formats"
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
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.route \- masqmail route configuration file
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
5
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
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: 26
diff changeset
9 This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
10 Their usual locations are in \fI/etc/masqmail/\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
11
311
e230bcd0f1c6 removed protocol option from route config
meillo@marmaro.de
parents: 291
diff changeset
12 Mail will be sent with the SMTP protocol to its destination, unless
e230bcd0f1c6 removed protocol option from route config
meillo@marmaro.de
parents: 291
diff changeset
13 `pipe' is given.
e230bcd0f1c6 removed protocol option from route config
meillo@marmaro.de
parents: 291
diff changeset
14 In this case the message will be piped to the given program.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
15
311
e230bcd0f1c6 removed protocol option from route config
meillo@marmaro.de
parents: 291
diff changeset
16
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
17 .SH ROUTE CONDITIONS
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
18
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
19 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
20 \fBallowed_mail_locals\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
21
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
22 This is a semicolon `;' separated list of local parts of envelope
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
23 senders (= mail from = return path) which will be allowed
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
24 to send mail through this connection.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
25 If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
26
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
27 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
28 \fBnot_allowed_mail_locals\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
29
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
30 This is a semicolon `;' separated list of local parts of envelope
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
31 senders (= mail from = return path) which will be not allowed
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
32 to send mail through this connection.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
33 Local parts in this list will not be allowed to use this route even if they
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
34 are part of \fBallowed_mail_locals\fR (see above).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
35
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
36 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
37 \fBallowed_return_paths\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
38
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
39 This is a semicolon `;' separated list of addresses.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
40 Messages which have one of these addresses as the return path (=
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
41 envelope sender = mail from) will be used using this route
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
42 (if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
43
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
44 Patterns containing `?' and `*' can be used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
45 The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
46
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
47 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
48 \fBnot_allowed_return_paths\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
49
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
50 This is a semicolon `;' separated list of addresses.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
51 Messages which have one of these addresses as the return path (=
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
52 envelope sender = mail from) will not
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
53 be used using this route (even if also in \fBallowed_return_paths\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
54 or an item in \fBallowed_mail_locals\fR matches).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
55
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
56 Patterns containing `?' and `*' can be used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
57 The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
58
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
59 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
60 \fBallowed_rcpt_domains\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
61
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
62 A list of recipient domains (of envelope recipients) where mail will be sent to.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
63 This is for example useful if you use this route configuration when connected to another LAN via ppp.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
64 Patterns containing `?' and `*' can be used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
65
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
66 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
67 \fBnot_allowed_rcpt_domains\fR = \fIlist\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
68
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
69 A list of recipient domains (of envelope recipients) where mail will not be sent to.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
70 This is for example useful if you send mail directly (\fBmail_host\fR is not set)
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
71 and you know of hosts that will not accept mail from you because they use a dialup list
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
72 (eg. \fBhttp://maps.vix.com/dul/\fR).
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
73 If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR,
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
74 mail will not be sent to this domain.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
75 Patterns containing `?' and `*' can be used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
76
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
77 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
78 \fBlast_route\fR = \fIboolean\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
79
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
80 If this is set, a mail which would have been delivered using this route,
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
81 but has failed temporarily, will not be tried to be delivered using the next route.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
82
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
83 If you have set up a special route with filters using the lists `allowed_rcpt_domains',
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
84 `allowed_return_paths', and `allowed_mail_locals' or their complements (not_),
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
85 and the mail passing these rules should be delivered using this route only,
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
86 you should set this to `true'.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
87 Otherwise the mail would be passed to the next route (if any),
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
88 unless that route has rules which prevent that.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
89
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
90 Default is false.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
91
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
92
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
93 .SH SMTP CONFIGURATION
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
94
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
95 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
96 \fBmail_host\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
97
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
98 This is preferably the mail server of your ISP.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
99 All outgoing messages will be sent to this host which will distribute them to their destinations.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
100 If you do not set this mails will be sent directly.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
101 Because the mail server is probably `near' to you, mail transfer will be much faster if you use it.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
102
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
103 You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25".
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
104
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
105 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
106 \fBresolve_list\fR = \fIlist\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
107
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
108 Specify the method how the domain of the server is resolved.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
109 Possible values are dns_mx, dns_a, byname.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
110 For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
111 these will be tried each in order (lowest preference value first, equal preference values in random order).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
112 For `dns_a', the domain is assumed to be an A pointer.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
113 For `byname', the library function \fBgethostbyname(3)\fR will be used.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
114
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
115 The default is "dns_mx;dns_a;byname".
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
116
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
117 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
118 \fBconnect_error_fail\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
119
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
120 If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
121 If it is unset, it will just be defered.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
122
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
123 Default is false.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
124 The reason for this is that masqmail is designed for non permanent internet connections,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
125 where such errors may occur quite often, and a bounce would be annoying.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
126
171
15b3c71254cb documented the wrapper option of route files better
meillo@marmaro.de
parents: 142
diff changeset
127 For the default local_net route it is set to true.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
128
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
129 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
130 \fBhelo_name\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
131
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
132 Set the name given with the HELO/EHLO command. If this is not set,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
133 \fBhost_name\fR from \fImasqmail.conf\fR will be used,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
134 if the \fBdo_correct_helo\fR option (see below) is unset.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
135
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
136 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
137 \fBdo_correct_helo\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
138
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
139 If this is set, masqmail tries to look up your host name as it appears
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
140 on the internet and sends this in the HELO/EHLO command.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
141 Some servers are so picky that they want this.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
142 Which is really crazy.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
143 It just does not make any sense to lie about ones own identity,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
144 because it can always be looked up by the server.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
145 Nobody should believe in the name given by HELO/EHLO anyway.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
146 If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
147 the \fBhelo_name\fR (see above) will be used.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
148
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
149 .TP
222
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
150 \fBinstant_helo\fR = \fIboolean\fR
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
151
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
152 If this is set, masqmail does not wait for the greeting of the SMTP server
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
153 after opening the connection.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
154 Instead it says EHLO right away (ESMTP is assumed).
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
155 Use this option with wrappers that eat the 220 greeting of the SMTP server.
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
156 Common examples are STARTTLS wrappers, like `openssl s_client -starttls smtp ...'.
222
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
157
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
158 If this option is set and a 220 greeting is received though,
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
159 everything should still work.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
160 Please don't rely on that and keep in mind that RFC 2821 says that the client
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
161 SHOULD wait for the 220 greeting of the server.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
162
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
163 Default: false
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
164
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
165 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
166 \fBdo_pipelining\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
167
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
168 If this is set to false, masqmail will not use ESMTP PIPELINING,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
169 even if the server announces that it is able to cope with it.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
170 Default is true.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
171
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
172 You do not want to set this to false unless the mail setup on the
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
173 remote server side is really broken.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
174 Keywords: wingate.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
175
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
176
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
177 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
178 \fBauth_name\fR = \fIstring\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
179
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
180 Set the authentication type for ESMTP AUTH authentication.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
181 Currently only `cram-md5' and `login' are supported.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
182
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
183 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
184 \fBauth_login\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
185
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
186 Your account name for ESMTP AUTH authentication.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
187
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
188 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
189 \fBauth_secret\fR = \fIstring\fR
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
190
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
191 Your secret for ESMTP AUTH authentication.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
192
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
193 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
194 \fBwrapper\fR = \fIcommand\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
195
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
196 If set, instead of opening a connection to a remote server,
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
197 \fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
198 Purpose is to tunnel ip traffic, eg. for ssl.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
199
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
200 Example for SMTP over SSL tunneling:
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
201 .nf
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
202 wrapper="/usr/bin/openssl s_client \-quiet \-connect mail.gmx.net:465 2>/dev/null"
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
203 .fi
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
204
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
205 SMTP over SSL is supported since masqmail-0.1.8.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
206 It is marked obsolete by the IETF but is still in use.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
207
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
208
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
209 Example for encryption with STARTTLS (RFC-3207):
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
210 .nf
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
211 # don't forget the instant_helo, otherwise it won't work
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
212 instant_helo=true
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
213 wrapper="/usr/bin/openssl s_client \-quiet \-starttls smtp \-connect mail.gmx.net:25 2>/dev/null"
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
214 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
215
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
216 This is supported since masqmail-0.2.28.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
217 STARTTLS supersedes SMTP over SSL.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
218
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
219 Note for openssl:
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
220 Ensure that stderr is redirected.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
221 Do *not* use \-crlf in the wrapper command, because masqmail does already insert CRLF.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
222 However, you might want to specify \-crlf if you want to test your wrapper command
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
223 interactively on the command line.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
224
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
225
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
226 .SH PIPE CONFIGURATION
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
227
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
228 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
229 \fBpipe\fR = \fIcommand\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
230
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
231 \fIcommand\fR will be called and the message will be piped to its stdin.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
232 Purpose is to use gateways to uucp, fax, sms or whatever else.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
233
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
234 You can use variables to give as arguments to the command,
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
235 these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
236
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
237 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
238 \fBpipe_fromline = \fIboolean\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
239
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
240 Only if `pipe' is used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
241 A from line will be prepended to the output stream whenever a pipe command is called.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
242 Default is false.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
243
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
244 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
245 \fBpipe_fromhack = \fIboolean\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
246
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
247 Only if `pipe' is used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
248 Each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
249 You probably want this if you have set \fBpipe_fromline\fR above.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
250 Default is false.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
251
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
252
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
253 .SH ADDRESS REWRITE RULES
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
254
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
255 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
256 \fBset_h_from_domain\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
257
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
258 Replace the domain part in `From:' headers with this value.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
259 This may be useful if you use a private, outside unknown address on your local LAN
141
fc731510cc9d typo fixes in masqmail.route(5)
meillo@marmaro.de
parents: 138
diff changeset
260 and want this to be replaced by the domain of the address of your email address on the internet.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
261 Note that this is different to \fBset_return_path_domain\fR, see below.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
262
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
263 .TP
138
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
264 \fBset_h_reply_to_domain\fR = \fIstring\fR
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
265
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
266 Same as \fBset_h_from_domain\fP, but for the `Reply-To' header.
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
267
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
268 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
269 \fBset_return_path_domain\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
270
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
271 Sets the domain part of the envelope from address.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
272 Some hosts check whether this is the same as the net the connection is coming from.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
273 If not, they reject the mail because they suspect spamming.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
274 It should be a valid address, because some mail servers also check that.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
275 You can also use this to set it to your usual address on the internet
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
276 and put a local address only known on your LAN in the configuration of your mailer.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
277 Only the domain part will be changed, the local part remains unchanged.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
278 Use \fBmap_return_path_addresses\fR for rewriting local parts.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
279
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
280 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
281 \fBmap_h_from_addresses\fR = \fIlist\fR
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
282
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
283 This is similar to \fBset_h_from_domain\fR, but more flexible.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
284 Set this to a list which maps local parts to a full RFC 822 compliant email address,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
285 the local parts (the keys) are separated from the addresses (the values) by colons (`:').
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
286
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
287 Example:
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
288 .nf
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
289 map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; charlie: Charlie Miller <cmiller@mx.commercial.com>"
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
290 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
291
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
292 You can use patterns, eg. * as keys.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
293
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
294 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
295 \fBmap_h_reply_to_addresses\fR = \fIlist\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
296
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
297 Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
298
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
299 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
300 \fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
301
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
302 Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
303 Useful when replying to mailing lists.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
304
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: 26
diff changeset
306 \fBmap_return_path_addresses\fR = \fIlist\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: 26
diff changeset
308 This is similar to \fBset_return_path_domain\fR, but more flexible.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
309 Set this to a list which maps local parts to a full RFC 821 compliant email address,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
310 the local parts (the keys) are separated from the addresses (the values) by colons (`:').
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
311 Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
312 The most important difference is that RFC 821 addresses have no full name.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
313
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
314 Example:
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
315 .nf
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
316 map_return_path_addresses = "john: <jsmith@mail.academic.edu>; charlie: <cmiller@mx.commercial.com>"
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
317 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
318
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
319 You can use patterns, eg. * as keys.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
320
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
321 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
322 \fBexpand_h_sender_address\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
323
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
324 This sets the domain of the sender address as given by the Sender: header
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
325 to the same address as in the envelope return path address
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
326 (which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
327 This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
328 Though they should use the From: address, see RFC 821.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
329 If \fBfetchmail(1)\fR encounters an unqualified Sender: address,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
330 it will be expanded to the domain of the pop server, which is almost never correct.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
331 Default is true.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
332
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
333 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
334 \fBexpand_h_sender_domain\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
335
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
336 Like \fBexpand_h_sender_address\fR, but sets the domain only.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
337 Deprecated, will be removed in a later version.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
338
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
339
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
340 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
341
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
342 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
343 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
344
95
e01fed4846e4 masqmail's homepage moved prog.marmaro.de/masqmail -> marmaro.de/prog/masqmail
meillo@marmaro.de
parents: 57
diff changeset
345 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: 24
diff changeset
346 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
347
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
348
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
349 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
350
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
351 Please report bugs to the mailing list.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
352
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
353 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
354
192
89f951be358f REMOVED POP3 SUPPORT
meillo@marmaro.de
parents: 189
diff changeset
355 \fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR