Mercurial > masqmail

annotate man/masqmail.route.5 @ 413:7c5e51c53f72

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Finally found the newline that was to much in spool_read_header().
author markus schnalke <meillo@marmaro.de>
date Wed, 29 Feb 2012 14:22:44 +0100
parents 35c5239ebcc1
children 5593964ec779
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
380
35c5239ebcc1 Updated version number.
markus schnalke <meillo@marmaro.de>
parents: 354
diff changeset
1 .TH masqmail.route 5 2012-01-18 masqmail-0.3.4 "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
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
20 \fBallowed_senders\fR = \fIlist\fR
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
21
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
22 This is a semicolon `;' separated list of envelope sender addresses.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
23 Messages which have one of these addresses as the return path (= mail
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
24 from) are allowed to use this route
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
25 (if not also in \fBdenied_senders\fR).
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
26
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
27 Glob patterns containing `?' and `*' can be used.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
28 The special item "<>" matches the null sender address
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
29 (eg. failure notices or delivery notifications).
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
30 If the pattern doesn't contain an `@', it is seen as a pattern for the
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
31 local part only.
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
32
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
33 Example: \fImeillo;*@*example.org;web*@example.com\fP
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
34
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
35 (``meillo'' equals ``meillo@*'', i.e. the local part.)
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
36
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
37 .TP
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
38 \fBdenied_senders\fR = \fIlist\fR
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
39
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
40 This is a semicolon `;' separated list of envelope sender addresses.
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
41 Messages which have one of these addresses as the return path (=
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
42 mail from) will not
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
43 be sent using this route (even if also in \fBallowed_senders\fR).
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
44
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
45 Glob patterns containing `?' and `*' can be used.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
46 The special item "<>" matches the null sender address
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
47 (eg. failure notices or delivery notifications).
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
48 If the pattern doesn't contain an `@', it is seen as a pattern for the
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
49 local part only.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
50
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
51 Example: (see \fIallowed_senders\fP)
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
52
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
53 .TP
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
54 \fBallowed_recipients\fR = \fIlist\fR
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
55
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
56 A list of envelope recipient addresses where mail can be sent to using
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
57 this route.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
58 This is for example useful if you use this route configuration when connected to another LAN via ppp.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
59 Glob patterns containing `?' and `*' can be used.
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
60
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
61 Example: \fI*@example.org;*@*foo.bar\fP
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
62
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
63 (See also examples for \fIallowed_senders\fP)
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
64
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
65 .TP
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
66 \fBdenied_recipients\fR = \fIlist\fR
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
67
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
68 A list of envelope recipient addresses where mail will not be sent to
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
69 using this route.
316
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).
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
73 \fBdenied_recipients\fR overrules \fBallowed_recipients\fR.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
74 Glob patterns containing `?' and `*' can be used.
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
75
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
76 Example: \fI*@spamblocker.example.org\fP
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
77
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
78 (See also examples for \fIallowed_senders\fP)
316
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 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
81 \fBlast_route\fR = \fIboolean\fR
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 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
84 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
85
317
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
86 If you have set up a special route with filters using the lists
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
87 `allowed_recipients' and `allowed_senders' or their complements
55b7bde95d37 reworked allowed and denied addrs for routes
meillo@marmaro.de
parents: 316
diff changeset
88 (denied_),
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
89 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
90 you should set this to `true'.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
91 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
92 unless that route has rules which prevent that.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
93
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
94 Default is false.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
95
318
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
96 .TP
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
97 \fBconnect_error_fail\fR = \fIboolean\fR
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
98
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
99 If this is set, a connection error (or if a pipe command could not be
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
100 executed) will cause a mail delivery to fail, ie. it will be bounced.
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
101 If it is unset, it will just be defered.
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
102
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
103 Default is false.
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
104 The reason for this is that masqmail is designed for non permanent internet connections,
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
105 where such errors may occur quite often, and a bounce would be annoying.
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
106
354
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
107 You probably want to set this to true for permanent routes.
318
290da1595311 connect_error_fail affects pipe commands too
meillo@marmaro.de
parents: 317
diff changeset
108
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
109
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
110 .SH SMTP CONFIGURATION
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
111
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
112 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
113 \fBmail_host\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
114
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
115 This is preferably the mail server of your ISP.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
116 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
117 If you do not set this mails will be sent directly.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
118 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
119
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
120 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
121
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
122 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
123 \fBresolve_list\fR = \fIlist\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
124
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
125 Specify the method how the domain of the server is resolved.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
126 Possible values are dns_mx, dns_a, byname.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
127 For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
354
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
128 these will be tried each in order
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
129 (lowest preference value first, equal preference values in random order).
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
130 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
131 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
132
354
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
133 For routes to a local network, where you likely don't have a DNS service,
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
134 use only `byname'.
08932c629849 reworked the route concept; removed the idea of the localnet
markus schnalke <meillo@marmaro.de>
parents: 337
diff changeset
135
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
136 The default is "dns_mx;dns_a;byname".
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
137
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
138 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
139 \fBhelo_name\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
140
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
141 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
142 \fBhost_name\fR from \fImasqmail.conf\fR will be used,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
143 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
144
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
145 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
146 \fBdo_correct_helo\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
147
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
148 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
149 on the internet and sends this in the HELO/EHLO command.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
150 Some servers are so picky that they want this.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
151 Which is really crazy.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
152 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
153 because it can always be looked up by the server.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
154 Nobody should believe in the name given by HELO/EHLO anyway.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
155 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
156 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
157
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
158 .TP
222
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
159 \fBinstant_helo\fR = \fIboolean\fR
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
160
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
161 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
162 after opening the connection.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
163 Instead it says EHLO right away (ESMTP is assumed).
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
164 Use this option with wrappers that eat the 220 greeting of the SMTP server.
337
fe00f7952a7c Minor fixes in man pages, reported by lintian(1)
markus schnalke <meillo@marmaro.de>
parents: 335
diff changeset
165 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
166
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
167 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
168 everything should still work.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
169 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
170 SHOULD wait for the 220 greeting of the server.
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
171
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
172 Default: false
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
173
8cddc65765bd added support for STARTTLS wrappers
meillo@marmaro.de
parents: 192
diff changeset
174 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
175 \fBdo_pipelining\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
176
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
177 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
178 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
179 Default is true.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
180
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
181 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
182 remote server side is really broken.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
183 Keywords: wingate.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
184
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
185
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
186 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
187 \fBauth_name\fR = \fIstring\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
188
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
189 Set the authentication type for ESMTP AUTH authentication.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
190 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
191
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
192 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
193 \fBauth_login\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
194
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
195 Your account name for ESMTP AUTH authentication.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
196
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
197 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
198 \fBauth_secret\fR = \fIstring\fR
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
199
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
200 Your secret for ESMTP AUTH authentication.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
201
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
202 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
203 \fBwrapper\fR = \fIcommand\fR
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 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
206 \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
207 Purpose is to tunnel ip traffic, eg. for ssl.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
208
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
209 Example for SMTP over SSL tunneling:
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 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
212 .fi
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
213
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
214 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
215 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
216
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
217
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
218 Example for encryption with STARTTLS (RFC-3207):
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
219 .nf
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
220 # 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
221 instant_helo=true
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
222 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
223 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
224
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
225 This is supported since masqmail-0.2.28.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
226 STARTTLS supersedes SMTP over SSL.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
227
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
228 Note for openssl:
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
229 Ensure that stderr is redirected.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
230 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
231 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
232 interactively on the command line.
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
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
235 .SH PIPE CONFIGURATION
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\fR = \fIcommand\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
239
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
240 \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
241 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
242
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
243 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
244 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
245
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
246 .TP
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
247 \fBpipe_fromline = \fIboolean\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
248
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
249 Only if `pipe' is used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
250 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
251 Default is false.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
252
316
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
253 .TP
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
254 \fBpipe_fromhack = \fIboolean\fR
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
255
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
256 Only if `pipe' is used.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
257 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
258 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
259 Default is false.
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
260
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
261
d596ac8b5afb heavy restructuring of masqmail.route(5) (sections)
meillo@marmaro.de
parents: 311
diff changeset
262 .SH ADDRESS REWRITE RULES
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
263
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
264 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
265 \fBset_h_from_domain\fR = \fIstring\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
266
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
267 Replace the domain part in `From:' headers with this value.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
268 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
269 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
270 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
271
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
272 .TP
138
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
273 \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
274
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
275 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
276
80b207e8b8af documented, yet undocumented, set_h_reply_to_domain config option
meillo@marmaro.de
parents: 95
diff changeset
277 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
278 \fBset_return_path_domain\fR = \fIstring\fR
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 Sets the domain part of the envelope from address.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
281 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
282 If not, they reject the mail because they suspect spamming.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
283 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
284 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
285 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
286 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
287 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
288
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
289 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
290 \fBmap_h_from_addresses\fR = \fIlist\fR
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
291
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
292 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
293 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
294 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
295
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
296 Example:
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
297 .nf
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
298 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
299 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
300
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
301 You can use patterns, eg. * as keys.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
302
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
303 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
304 \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
305
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
306 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
307
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
308 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
309 \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
310
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
311 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
312 Useful when replying to mailing lists.
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 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
315 \fBmap_return_path_addresses\fR = \fIlist\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
316
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
317 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
318 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
319 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
320 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
321 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
322
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
323 Example:
223
9814e75de61c updated docs to STARTTLS wrappers
meillo@marmaro.de
parents: 222
diff changeset
324 .nf
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
325 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
326 .fi
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
327
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
328 You can use patterns, eg. * as keys.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
329
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
330 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
331 \fBexpand_h_sender_address\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
332
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
333 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
334 to the same address as in the envelope return path address
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
335 (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
336 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
337 Though they should use the From: address, see RFC 821.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
338 If \fBfetchmail(1)\fR encounters an unqualified Sender: address,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
339 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
340 Default is true.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
341
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
342 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
343 \fBexpand_h_sender_domain\fR = \fIboolean\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
344
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
345 Like \fBexpand_h_sender_address\fR, but sets the domain only.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
346 Deprecated, will be removed in a later version.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
347
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 AUTHOR
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 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
352 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
353
95
e01fed4846e4 masqmail's homepage moved prog.marmaro.de/masqmail -> marmaro.de/prog/masqmail
meillo@marmaro.de
parents: 57
diff changeset
354 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
355 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
356
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
357
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
358 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
359
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
360 Please report bugs to the mailing list.
0
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 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
363
192
89f951be358f REMOVED POP3 SUPPORT
meillo@marmaro.de
parents: 189
diff changeset
364 \fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR