1TRIVIAL-REWRITE(8)          System Manager's Manual         TRIVIAL-REWRITE(8)
2
3
4

NAME

6       trivial-rewrite - Postfix address rewriting and resolving daemon
7

SYNOPSIS

9       trivial-rewrite [generic Postfix daemon options]
10

DESCRIPTION

12       The  trivial-rewrite(8)  daemon processes three types of client service
13       requests:
14
15       rewrite context address
16              Rewrite an address to standard form, according  to  the  address
17              rewriting context:
18
19              local  Append  the  domain  names  specified  with  $myorigin or
20                     $mydomain to incomplete addresses; do  swap_bangpath  and
21                     allow_percent_hack  processing  as  described  below, and
22                     strip source routed  addresses  (@site,@site:user@domain)
23                     to user@domain form.
24
25              remote Append  the domain name specified with $remote_header_re‐
26                     write_domain  to  incomplete  addresses.  Otherwise   the
27                     result  is identical to that of the local address rewrit‐
28                     ing context. This prevents  Postfix  from  appending  the
29                     local domain to spam from poorly written remote clients.
30
31       resolve sender address
32              Resolve  the address to a (transport, nexthop, recipient, flags)
33              quadruple. The meaning of the results is as follows:
34
35              transport
36                     The delivery agent to use. This is the first field of  an
37                     entry in the master.cf file.
38
39              nexthop
40                     The host to send to and optional delivery method informa‐
41                     tion.
42
43              recipient
44                     The envelope recipient address that is passed on to  nex‐
45                     thop.
46
47              flags  The address class, whether the address requires relaying,
48                     whether the address has problems, and whether the request
49                     failed.
50
51       verify sender address
52              Resolve the address for address verification purposes.
53

SERVER PROCESS MANAGEMENT

55       The  trivial-rewrite(8) servers run under control by the Postfix master
56       server.  Each server  can  handle  multiple  simultaneous  connections.
57       When all servers are busy while a client connects, the master creates a
58       new server process, provided that the  trivial-rewrite  server  process
59       limit  is  not  exceeded.  Each trivial-rewrite server terminates after
60       serving at least $max_use clients of after $max_idle  seconds  of  idle
61       time.
62

STANDARDS

64       None. The command does not interact with the outside world.
65

SECURITY

67       The  trivial-rewrite(8)  daemon is not security sensitive.  By default,
68       this daemon does not talk to remote or local users.  It can  run  at  a
69       fixed low privilege in a chrooted environment.
70

DIAGNOSTICS

72       Problems and transactions are logged to syslogd(8).
73

CONFIGURATION PARAMETERS

75       On  busy  mail  systems  a  long  time may pass before a main.cf change
76       affecting trivial-rewrite(8) is picked up.  Use  the  command  "postfix
77       reload" to speed up a change.
78
79       The  text  below provides only a parameter summary. See postconf(5) for
80       more details including examples.
81

COMPATIBILITY CONTROLS

83       resolve_dequoted_address (yes)
84              Resolve a recipient address  safely  instead  of  correctly,  by
85              looking inside quotes.
86
87       resolve_null_domain (no)
88              Resolve  an  address  that ends in the "@" null domain as if the
89              local hostname were specified, instead of rejecting the  address
90              as invalid.
91
92       resolve_numeric_domain (no)
93              Resolve   "user@ipaddress"  as  "user@[ipaddress]",  instead  of
94              rejecting the address as invalid.
95
96       Available with Postfix version 2.5 and later:
97
98       allow_min_user (no)
99              Allow a sender or recipient address to have  `-'  as  the  first
100              character.
101

ADDRESS REWRITING CONTROLS

103       myorigin ($myhostname)
104              The  domain  name that locally-posted mail appears to come from,
105              and that locally posted mail is delivered to.
106
107       allow_percent_hack (yes)
108              Enable the rewriting of the form "user%domain" to "user@domain".
109
110       append_at_myorigin (yes)
111              With locally submitted mail, append the string  "@$myorigin"  to
112              mail addresses without domain information.
113
114       append_dot_mydomain (yes)
115              With  locally  submitted mail, append the string ".$mydomain" to
116              addresses that have no ".domain" information.
117
118       recipient_delimiter (empty)
119              The  separator  between  user  names  and   address   extensions
120              (user+foo).
121
122       swap_bangpath (yes)
123              Enable the rewriting of "site!user" into "user@site".
124
125       Available in Postfix 2.2 and later:
126
127       remote_header_rewrite_domain (empty)
128              Don't  rewrite  message  headers from remote clients at all when
129              this parameter is empty; otherwise, rewrite message headers  and
130              append the specified domain name to incomplete addresses.
131

ROUTING CONTROLS

133       The  following is applicable to Postfix version 2.0 and later.  Earlier
134       versions do not have support for:  virtual_transport,  relay_transport,
135       virtual_alias_domains, virtual_mailbox_domains or proxy_interfaces.
136
137       local_transport (local:$myhostname)
138              The default mail delivery transport and next-hop destination for
139              final delivery to domains listed  with  mydestination,  and  for
140              [ipaddress]   destinations   that   match   $inet_interfaces  or
141              $proxy_interfaces.
142
143       virtual_transport (virtual)
144              The default mail delivery transport and next-hop destination for
145              final delivery to domains listed with $virtual_mailbox_domains.
146
147       relay_transport (relay)
148              The default mail delivery transport and next-hop destination for
149              remote delivery to domains listed with $relay_domains.
150
151       default_transport (smtp)
152              The default mail delivery transport and next-hop destination for
153              destinations that do not match $mydestination, $inet_interfaces,
154              $proxy_interfaces,    $virtual_alias_domains,     $virtual_mail‐
155              box_domains, or $relay_domains.
156
157       parent_domain_matches_subdomains (see 'postconf -d' output)
158              What Postfix features match subdomains of "domain.tld" automati‐
159              cally, instead of requiring an explicit ".domain.tld" pattern.
160
161       relayhost (empty)
162              The next-hop destination of non-local mail; overrides  non-local
163              domains in recipient addresses.
164
165       transport_maps (empty)
166              Optional  lookup  tables with mappings from recipient address to
167              (message delivery transport, next-hop destination).
168
169       Available in Postfix version 2.3 and later:
170
171       sender_dependent_relayhost_maps (empty)
172              A sender-dependent override for the global  relayhost  parameter
173              setting.
174
175       Available in Postfix version 2.5 and later:
176
177       empty_address_relayhost_maps_lookup_key (<>)
178              The  sender_dependent_relayhost_maps  search string that will be
179              used instead of the null sender address.
180
181       Available in Postfix version 2.7 and later:
182
183       empty_address_default_transport_maps_lookup_key (<>)
184              The sender_dependent_default_transport_maps search  string  that
185              will be used instead of the null sender address.
186
187       sender_dependent_default_transport_maps (empty)
188              A  sender-dependent  override  for  the global default_transport
189              parameter setting.
190

ADDRESS VERIFICATION CONTROLS

192       Postfix version 2.1 introduces sender and recipient  address  verifica‐
193       tion.  This feature is implemented by sending probe email messages that
194       are not actually delivered.  By default,  address  verification  probes
195       use  the  same  route  as regular mail. To override specific aspects of
196       message routing for address verification probes, specify one or more of
197       the following:
198
199       address_verify_local_transport ($local_transport)
200              Overrides the local_transport parameter setting for address ver‐
201              ification probes.
202
203       address_verify_virtual_transport ($virtual_transport)
204              Overrides the virtual_transport parameter  setting  for  address
205              verification probes.
206
207       address_verify_relay_transport ($relay_transport)
208              Overrides the relay_transport parameter setting for address ver‐
209              ification probes.
210
211       address_verify_default_transport ($default_transport)
212              Overrides the default_transport parameter  setting  for  address
213              verification probes.
214
215       address_verify_relayhost ($relayhost)
216              Overrides  the relayhost parameter setting for address verifica‐
217              tion probes.
218
219       address_verify_transport_maps ($transport_maps)
220              Overrides the transport_maps parameter setting for address veri‐
221              fication probes.
222
223       Available in Postfix version 2.3 and later:
224
225       address_verify_sender_dependent_relayhost_maps          ($sender_depen‐
226       dent_relayhost_maps)
227              Overrides the sender_dependent_relayhost_maps parameter  setting
228              for address verification probes.
229
230       Available in Postfix version 2.7 and later:
231
232       address_verify_sender_dependent_default_transport_maps  ($sender_depen‐
233       dent_default_transport_maps)
234              Overrides the sender_dependent_default_transport_maps  parameter
235              setting for address verification probes.
236

MISCELLANEOUS CONTROLS

238       config_directory (see 'postconf -d' output)
239              The  default  location of the Postfix main.cf and master.cf con‐
240              figuration files.
241
242       daemon_timeout (18000s)
243              How much time a Postfix daemon process  may  take  to  handle  a
244              request before it is terminated by a built-in watchdog timer.
245
246       empty_address_recipient (MAILER-DAEMON)
247              The recipient of mail addressed to the null address.
248
249       ipc_timeout (3600s)
250              The  time  limit  for  sending  or receiving information over an
251              internal communication channel.
252
253       max_idle (100s)
254              The maximum amount of time that an idle Postfix  daemon  process
255              waits for an incoming connection before terminating voluntarily.
256
257       max_use (100)
258              The maximal number of incoming connections that a Postfix daemon
259              process will service before terminating voluntarily.
260
261       relocated_maps (empty)
262              Optional lookup tables with new contact information for users or
263              domains that no longer exist.
264
265       process_id (read-only)
266              The process ID of a Postfix command or daemon process.
267
268       process_name (read-only)
269              The process name of a Postfix command or daemon process.
270
271       queue_directory (see 'postconf -d' output)
272              The location of the Postfix top-level queue directory.
273
274       show_user_unknown_table_name (yes)
275              Display  the  name  of the recipient table in the "User unknown"
276              responses.
277
278       syslog_facility (mail)
279              The syslog facility of Postfix logging.
280
281       syslog_name (see 'postconf -d' output)
282              The mail system name that is prepended to the  process  name  in
283              syslog  records,  so  that  "smtpd" becomes, for example, "post‐
284              fix/smtpd".
285
286       Available in Postfix version 2.0 and later:
287
288       helpful_warnings (yes)
289              Log warnings about problematic configuration settings, and  pro‐
290              vide helpful suggestions.
291

SEE ALSO

293       postconf(5), configuration parameters
294       transport(5), transport table format
295       relocated(5), format of the "user has moved" table
296       master(8), process manager
297       syslogd(8), system logging
298

README FILES

300       Use  "postconf readme_directory" or "postconf html_directory" to locate
301       this information.
302       ADDRESS_CLASS_README, Postfix address classes howto
303       ADDRESS_VERIFICATION_README, Postfix address verification
304

LICENSE

306       The Secure Mailer license must be distributed with this software.
307

AUTHOR(S)

309       Wietse Venema
310       IBM T.J. Watson Research
311       P.O. Box 704
312       Yorktown Heights, NY 10598, USA
313
314
315
316                                                            TRIVIAL-REWRITE(8)
Impressum