14
14
<b>trivial-rewrite</b> [generic Postfix daemon options]
17
The <b>trivial-rewrite</b> daemon processes three types of client
21
Rewrite an address to standard form. The <b>trivial-</b>
22
<b>rewrite</b> daemon by default appends local domain
23
information to unqualified addresses, swaps bang
24
paths to domain form, and strips source routing
25
information. This process is under control of sev-
26
eral configuration parameters (see below).
17
The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> daemon processes three types of
18
client service requests:
20
<b>rewrite</b> <i>context address</i>
21
Rewrite an address to standard form, according to
22
the address rewriting context:
24
<b>local</b> Append the domain names specified with <b>$<a href="postconf.5.html#myorigin">myo</a>-</b>
25
<b><a href="postconf.5.html#myorigin">rigin</a></b> or <b>$<a href="postconf.5.html#mydomain">mydomain</a></b> to incomplete addresses;
26
do <b><a href="postconf.5.html#swap_bangpath">swap_bangpath</a></b> and <b><a href="postconf.5.html#allow_percent_hack">allow_percent_hack</a></b> pro-
27
cessing as described below, and strip source
28
routed addresses (<i>@site,@site:user@domain</i>)
29
to <i>user@domain</i> form.
31
<b>remote</b> Append the domain name specified with
32
<b>$<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a></b> to incomplete
33
addresses. Otherwise the result is identical
34
to that of the <b>local</b> address rewriting con-
35
text. This prevents Postfix from appending
36
the <a href="ADDRESS_CLASS_README.html#local_domain_class">local domain</a> to spam from poorly written
39
<b>resolve</b> <i>address</i>
29
40
Resolve an address to a (<i>transport</i>, <i>nexthop</i>, <i>recip-</i>
30
<i>ient</i>) triple. The meaning of the results is as fol-
41
<i>ient</i>, <i>flags</i>) quadruple. The meaning of the results
34
45
The delivery agent to use. This is the first
35
46
field of an entry in the <b>master.cf</b> file.
38
The host to send to and optional delivery
49
The host to send to and optional delivery
39
50
method information.
42
The envelope recipient address that is
53
The envelope recipient address that is
43
54
passed on to <i>nexthop</i>.
45
<b>verify</b> Resolve an address for address verification pur-
56
<i>flags</i> The address class, whether the address
57
requires relaying, whether the address has
58
problems, and whether the request failed.
60
<b>verify</b> <i>address</i>
61
Resolve an address for address verification pur-
48
64
<b>SERVER PROCESS MANAGEMENT</b>
49
The trivial-rewrite servers run under control by the Post-
50
fix master server. Each server can handle multiple simul-
51
taneous connections. When all servers are busy while a
52
client connects, the master creates a new server process,
53
provided that the trivial-rewrite server process limit is
54
not exceeded. Each trivial-rewrite server terminates
55
after serving at least <b>$<a href="postconf.5.html#max_use">max_use</a></b> clients of after <b>$<a href="postconf.5.html#max_idle">max_idle</a></b>
65
The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> servers run under control by the
66
Postfix master server. Each server can handle multiple
67
simultaneous connections. When all servers are busy while
68
a client connects, the master creates a new server
69
process, provided that the trivial-rewrite server process
70
limit is not exceeded. Each trivial-rewrite server termi-
71
nates after serving at least <b>$<a href="postconf.5.html#max_use">max_use</a></b> clients of after
72
<b>$<a href="postconf.5.html#max_idle">max_idle</a></b> seconds of idle time.
59
None. The command does not interact with the outside
75
None. The command does not interact with the outside
63
The <b>trivial-rewrite</b> daemon is not security sensitive. By
64
default, this daemon does not talk to remote or local
65
users. It can run at a fixed low privilege in a chrooted
79
The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> daemon is not security sensitive.
80
By default, this daemon does not talk to remote or local
81
users. It can run at a fixed low privilege in a chrooted
71
87
<b>CONFIGURATION PARAMETERS</b>
72
88
On busy mail systems a long time may pass before a <b>main.cf</b>
73
change affecting trivial_rewrite(8) is picked up. Use the
89
change affecting <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> is picked up. Use the
74
90
command "<b>postfix reload</b>" to speed up a change.
76
The text below provides only a parameter summary. See
77
<a href="postconf.5.html">postconf(5)</a> for more details including examples.
92
The text below provides only a parameter summary. See
93
<a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
79
95
<b>COMPATIBILITY CONTROLS</b>
80
96
<b><a href="postconf.5.html#resolve_dequoted_address">resolve_dequoted_address</a> (yes)</b>
81
Resolve a recipient address safely instead of cor-
97
Resolve a recipient address safely instead of cor-
82
98
rectly, by looking inside quotes.
84
100
<b><a href="postconf.5.html#resolve_null_domain">resolve_null_domain</a> (no)</b>
89
105
<b>ADDRESS REWRITING CONTROLS</b>
90
106
<b><a href="postconf.5.html#myorigin">myorigin</a> ($<a href="postconf.5.html#myhostname">myhostname</a>)</b>
91
The default domain name that locally-posted mail
92
appears to come from, and that locally posted mail
107
The domain name that locally-posted mail appears to
108
come from, and that locally posted mail is deliv-
95
111
<b><a href="postconf.5.html#allow_percent_hack">allow_percent_hack</a> (yes)</b>
96
Enable the rewriting of the form "user%domain" to
112
Enable the rewriting of the form "user%domain" to
99
115
<b><a href="postconf.5.html#append_at_myorigin">append_at_myorigin</a> (yes)</b>
100
Append the string "@$<a href="postconf.5.html#myorigin">myorigin</a>" to mail addresses
101
without domain information.
116
With locally submitted mail, append the string
117
"@$<a href="postconf.5.html#myorigin">myorigin</a>" to mail addresses without domain
103
120
<b><a href="postconf.5.html#append_dot_mydomain">append_dot_mydomain</a> (yes)</b>
104
Append the string ".$<a href="postconf.5.html#mydomain">mydomain</a>" to addresses that
105
have no ".domain" information.
121
With locally submitted mail, append the string
122
".$<a href="postconf.5.html#mydomain">mydomain</a>" to addresses that have no ".domain"
107
125
<b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b>
108
126
The separator between user names and address exten-
109
127
sions (user+foo).
111
129
<b><a href="postconf.5.html#swap_bangpath">swap_bangpath</a> (yes)</b>
112
Enable the rewriting of "site!user" into
130
Enable the rewriting of "site!user" into
133
Available in Postfix 2.2 and later:
135
<b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b>
136
Don't rewrite message headers from remote clients
137
at all when this parameter is empty; otherwise, re-
138
write remote message headers and append the speci-
139
fied domain name to incomplete addresses.
115
141
<b>ROUTING CONTROLS</b>
116
142
The following is applicable to Postfix version 2.0 and
117
143
later. Earlier versions do not have support for: <a href="postconf.5.html#virtual_transport">vir</a>-