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 $my‐
20                     domain to incomplete addresses; do swap_bangpath and  al‐
21                     low_percent_hack processing as described below, and strip
22                     source  routed  addresses  (@site,@site:user@domain)   to
23                     user@domain form.
24
25              remote Append  the domain name specified with $remote_header_re‐
26                     write_domain to incomplete addresses. Otherwise  the  re‐
27                     sult  is identical to that of the local address rewriting
28                     context. This prevents Postfix from appending  the  local
29                     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) or postlogd(8).
73

CONFIGURATION PARAMETERS

75       On  busy  mail systems a long time may pass before a main.cf change af‐
76       fecting 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       Available with Postfix version 2.1 and later:
88
89       resolve_null_domain (no)
90              Resolve  an  address  that ends in the "@" null domain as if the
91              local hostname were specified, instead of rejecting the  address
92              as invalid.
93
94       Available with Postfix version 2.3 and later:
95
96       resolve_numeric_domain (no)
97              Resolve  "user@ipaddress"  as "user@[ipaddress]", instead of re‐
98              jecting the address as invalid.
99
100       Available with Postfix version 2.5 and later:
101
102       allow_min_user (no)
103              Allow a sender or recipient address to have  `-'  as  the  first
104              character.
105

ADDRESS REWRITING CONTROLS

107       myorigin ($myhostname)
108              The  domain  name that locally-posted mail appears to come from,
109              and that locally posted mail is delivered to.
110
111       allow_percent_hack (yes)
112              Enable the rewriting of the form "user%domain" to "user@domain".
113
114       append_at_myorigin (yes)
115              With locally submitted mail, append the string  "@$myorigin"  to
116              mail addresses without domain information.
117
118       append_dot_mydomain (Postfix >= 3.0: no, Postfix < 3.0: yes)
119              With  locally  submitted mail, append the string ".$mydomain" to
120              addresses that have no ".domain" information.
121
122       recipient_delimiter (empty)
123              The set of characters that can separate a user name from its ex‐
124              tension  (example:  user+foo),  or a .forward file name from its
125              extension (example: .forward+foo).
126
127       swap_bangpath (yes)
128              Enable the rewriting of "site!user" into "user@site".
129
130       Available in Postfix 2.2 and later:
131
132       remote_header_rewrite_domain (empty)
133              Don't rewrite message headers from remote clients  at  all  when
134              this  parameter is empty; otherwise, rewrite message headers and
135              append the specified domain name to incomplete addresses.
136

ROUTING CONTROLS

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

ADDRESS VERIFICATION CONTROLS

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

MISCELLANEOUS CONTROLS

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

SEE ALSO

303       postconf(5), configuration parameters
304       transport(5), transport table format
305       relocated(5), format of the "user has moved" table
306       master(8), process manager
307       postlogd(8), Postfix logging
308       syslogd(8), system logging
309

README FILES

311       Use "postconf readme_directory" or "postconf html_directory" to  locate
312       this information.
313       ADDRESS_CLASS_README, Postfix address classes howto
314       ADDRESS_VERIFICATION_README, Postfix address verification
315

LICENSE

317       The Secure Mailer license must be distributed with this software.
318

AUTHOR(S)

320       Wietse Venema
321       IBM T.J. Watson Research
322       P.O. Box 704
323       Yorktown Heights, NY 10598, USA
324
325       Wietse Venema
326       Google, Inc.
327       111 8th Avenue
328       New York, NY 10011, USA
329
330
331
332                                                            TRIVIAL-REWRITE(8)
Impressum