1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "http://www.w3.org/TR/html4/loose.dtd"> 3<html> <head> 4<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5<link rel='stylesheet' type='text/css' href='postfix-doc.css'> 6<title> Postfix manual - trivial-rewrite(8) </title> 7</head> <body> <pre> 8TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8) 9 10<b>NAME</b> 11 trivial-rewrite - Postfix address rewriting and resolving daemon 12 13<b>SYNOPSIS</b> 14 <b>trivial-rewrite</b> [generic Postfix daemon options] 15 16<b>DESCRIPTION</b> 17 The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> daemon processes three types of client service 18 requests: 19 20 <b>rewrite</b> <i>context address</i> 21 Rewrite an address to standard form, according to the address 22 rewriting context: 23 24 <b>local</b> Append the domain names specified with <b>$<a href="postconf.5.html#myorigin">myorigin</a></b> or 25 <b>$<a href="postconf.5.html#mydomain">mydomain</a></b> to incomplete addresses; do <b><a href="postconf.5.html#swap_bangpath">swap_bangpath</a></b> and 26 <b><a href="postconf.5.html#allow_percent_hack">allow_percent_hack</a></b> processing as described below, and 27 strip source routed addresses (<i>@site,@site:user@domain</i>) 28 to <i>user@domain</i> form. 29 30 <b>remote</b> Append the domain name specified with <b>$<a href="postconf.5.html#remote_header_rewrite_domain">remote_header_re</a>-</b> 31 <b><a href="postconf.5.html#remote_header_rewrite_domain">write_domain</a></b> to incomplete addresses. Otherwise the 32 result is identical to that of the <b>local</b> address rewrit- 33 ing context. This prevents Postfix from appending the 34 local domain to spam from poorly written remote clients. 35 36 <b>resolve</b> <i>sender address</i> 37 Resolve the address to a (<i>transport</i>, <i>nexthop</i>, <i>recipient</i>, <i>flags</i>) 38 quadruple. The meaning of the results is as follows: 39 40 <i>transport</i> 41 The delivery agent to use. This is the first field of an 42 entry in the <a href="master.5.html"><b>master.cf</b></a> file. 43 44 <i>nexthop</i> 45 The host to send to and optional delivery method informa- 46 tion. 47 48 <i>recipient</i> 49 The envelope recipient address that is passed on to <i>nex-</i> 50 <i>thop</i>. 51 52 <i>flags</i> The address class, whether the address requires relaying, 53 whether the address has problems, and whether the request 54 failed. 55 56 <b>verify</b> <i>sender address</i> 57 Resolve the address for address verification purposes. 58 59<b>SERVER PROCESS MANAGEMENT</b> 60 The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> servers run under control by the Postfix <a href="master.8.html">mas-</a> 61 <a href="master.8.html">ter(8)</a> server. Each server can handle multiple simultaneous connec- 62 tions. When all servers are busy while a client connects, the master 63 creates a new server process, provided that the trivial-rewrite server 64 process limit is not exceeded. Each trivial-rewrite server terminates 65 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> seconds of 66 idle time. 67 68<b>STANDARDS</b> 69 None. The command does not interact with the outside world. 70 71<b>SECURITY</b> 72 The <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> daemon is not security sensitive. By default, 73 this daemon does not talk to remote or local users. It can run at a 74 fixed low privilege in a chrooted environment. 75 76<b>DIAGNOSTICS</b> 77 Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>. 78 79<b>CONFIGURATION PARAMETERS</b> 80 On busy mail systems a long time may pass before a <a href="postconf.5.html"><b>main.cf</b></a> change 81 affecting <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a> is picked up. Use the command "<b>postfix</b> 82 <b>reload</b>" to speed up a change. 83 84 The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for 85 more details including examples. 86 87<b>COMPATIBILITY CONTROLS</b> 88 <b><a href="postconf.5.html#resolve_dequoted_address">resolve_dequoted_address</a> (yes)</b> 89 Resolve a recipient address safely instead of correctly, by 90 looking inside quotes. 91 92 Available with Postfix version 2.1 and later: 93 94 <b><a href="postconf.5.html#resolve_null_domain">resolve_null_domain</a> (no)</b> 95 Resolve an address that ends in the "@" null domain as if the 96 local hostname were specified, instead of rejecting the address 97 as invalid. 98 99 Available with Postfix version 2.3 and later: 100 101 <b><a href="postconf.5.html#resolve_numeric_domain">resolve_numeric_domain</a> (no)</b> 102 Resolve "user@ipaddress" as "user@[ipaddress]", instead of 103 rejecting the address as invalid. 104 105 Available with Postfix version 2.5 and later: 106 107 <b><a href="postconf.5.html#allow_min_user">allow_min_user</a> (no)</b> 108 Allow a sender or recipient address to have `-' as the first 109 character. 110 111<b>ADDRESS REWRITING CONTROLS</b> 112 <b><a href="postconf.5.html#myorigin">myorigin</a> ($<a href="postconf.5.html#myhostname">myhostname</a>)</b> 113 The domain name that locally-posted mail appears to come from, 114 and that locally posted mail is delivered to. 115 116 <b><a href="postconf.5.html#allow_percent_hack">allow_percent_hack</a> (yes)</b> 117 Enable the rewriting of the form "user%domain" to "user@domain". 118 119 <b><a href="postconf.5.html#append_at_myorigin">append_at_myorigin</a> (yes)</b> 120 With locally submitted mail, append the string "@$<a href="postconf.5.html#myorigin">myorigin</a>" to 121 mail addresses without domain information. 122 123 <b><a href="postconf.5.html#append_dot_mydomain">append_dot_mydomain</a> (Postfix</b> ><b>= 3.0: no, Postfix</b> < <b>3.0: yes)</b> 124 With locally submitted mail, append the string ".$<a href="postconf.5.html#mydomain">mydomain</a>" to 125 addresses that have no ".domain" information. 126 127 <b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b> 128 The set of characters that can separate an email address local- 129 part, user name, or a .forward file name from its extension. 130 131 <b><a href="postconf.5.html#swap_bangpath">swap_bangpath</a> (yes)</b> 132 Enable the rewriting of "site!user" into "user@site". 133 134 Available in Postfix 2.2 and later: 135 136 <b><a href="postconf.5.html#remote_header_rewrite_domain">remote_header_rewrite_domain</a> (empty)</b> 137 Don't rewrite message headers from remote clients at all when 138 this parameter is empty; otherwise, rewrite message headers and 139 append the specified domain name to incomplete addresses. 140 141<b>ROUTING CONTROLS</b> 142 The following is applicable to Postfix version 2.0 and later. Earlier 143 versions do not have support for: <a href="postconf.5.html#virtual_transport">virtual_transport</a>, <a href="postconf.5.html#relay_transport">relay_transport</a>, 144 <a href="postconf.5.html#virtual_alias_domains">virtual_alias_domains</a>, <a href="postconf.5.html#virtual_mailbox_domains">virtual_mailbox_domains</a> or <a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>. 145 146 <b><a href="postconf.5.html#local_transport">local_transport</a> (<a href="local.8.html">local</a>:$<a href="postconf.5.html#myhostname">myhostname</a>)</b> 147 The default mail delivery transport and next-hop destination for 148 final delivery to domains listed with <a href="postconf.5.html#mydestination">mydestination</a>, and for 149 [ipaddress] destinations that match $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a> or 150 $<a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>. 151 152 <b><a href="postconf.5.html#virtual_transport">virtual_transport</a> (virtual)</b> 153 The default mail delivery transport and next-hop destination for 154 final delivery to domains listed with $<a href="postconf.5.html#virtual_mailbox_domains">virtual_mailbox_domains</a>. 155 156 <b><a href="postconf.5.html#relay_transport">relay_transport</a> (relay)</b> 157 The default mail delivery transport and next-hop destination for 158 remote delivery to domains listed with $<a href="postconf.5.html#relay_domains">relay_domains</a>. 159 160 <b><a href="postconf.5.html#default_transport">default_transport</a> (smtp)</b> 161 The default mail delivery transport and next-hop destination for 162 destinations that do not match $<a href="postconf.5.html#mydestination">mydestination</a>, $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a>, 163 $<a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>, $<a href="postconf.5.html#virtual_alias_domains">virtual_alias_domains</a>, $<a href="postconf.5.html#virtual_mailbox_domains">virtual_mail</a>- 164 <a href="postconf.5.html#virtual_mailbox_domains">box_domains</a>, or $<a href="postconf.5.html#relay_domains">relay_domains</a>. 165 166 <b><a href="postconf.5.html#parent_domain_matches_subdomains">parent_domain_matches_subdomains</a> (see 'postconf -d' output)</b> 167 A list of Postfix features where the pattern "example.com" also 168 matches subdomains of example.com, instead of requiring an 169 explicit ".example.com" pattern. 170 171 <b><a href="postconf.5.html#relayhost">relayhost</a> (empty)</b> 172 The next-hop destination(s) for non-local mail; overrides 173 non-<a href="ADDRESS_CLASS_README.html#local_domain_class">local domains</a> in recipient addresses. 174 175 <b><a href="postconf.5.html#transport_maps">transport_maps</a> (empty)</b> 176 Optional lookup tables with mappings from recipient address to 177 (message delivery transport, next-hop destination). 178 179 Available in Postfix version 2.3 and later: 180 181 <b><a href="postconf.5.html#sender_dependent_relayhost_maps">sender_dependent_relayhost_maps</a> (empty)</b> 182 A sender-dependent override for the global <a href="postconf.5.html#relayhost">relayhost</a> parameter 183 setting. 184 185 Available in Postfix version 2.5 and later: 186 187 <b><a href="postconf.5.html#empty_address_relayhost_maps_lookup_key">empty_address_relayhost_maps_lookup_key</a> (</b><><b>)</b> 188 The <a href="postconf.5.html#sender_dependent_relayhost_maps">sender_dependent_relayhost_maps</a> search string that will be 189 used instead of the null sender address. 190 191 Available in Postfix version 2.7 and later: 192 193 <b><a href="postconf.5.html#empty_address_default_transport_maps_lookup_key">empty_address_default_transport_maps_lookup_key</a> (</b><><b>)</b> 194 The <a href="postconf.5.html#sender_dependent_default_transport_maps">sender_dependent_default_transport_maps</a> search string that 195 will be used instead of the null sender address. 196 197 <b><a href="postconf.5.html#sender_dependent_default_transport_maps">sender_dependent_default_transport_maps</a> (empty)</b> 198 A sender-dependent override for the global <a href="postconf.5.html#default_transport">default_transport</a> 199 parameter setting. 200 201<b>ADDRESS VERIFICATION CONTROLS</b> 202 Postfix version 2.1 introduces sender and recipient address verifica- 203 tion. This feature is implemented by sending probe email messages that 204 are not actually delivered. By default, address verification probes 205 use the same route as regular mail. To override specific aspects of 206 message routing for address verification probes, specify one or more of 207 the following: 208 209 <b><a href="postconf.5.html#address_verify_local_transport">address_verify_local_transport</a> ($<a href="postconf.5.html#local_transport">local_transport</a>)</b> 210 Overrides the <a href="postconf.5.html#local_transport">local_transport</a> parameter setting for address ver- 211 ification probes. 212 213 <b><a href="postconf.5.html#address_verify_virtual_transport">address_verify_virtual_transport</a> ($<a href="postconf.5.html#virtual_transport">virtual_transport</a>)</b> 214 Overrides the <a href="postconf.5.html#virtual_transport">virtual_transport</a> parameter setting for address 215 verification probes. 216 217 <b><a href="postconf.5.html#address_verify_relay_transport">address_verify_relay_transport</a> ($<a href="postconf.5.html#relay_transport">relay_transport</a>)</b> 218 Overrides the <a href="postconf.5.html#relay_transport">relay_transport</a> parameter setting for address ver- 219 ification probes. 220 221 <b><a href="postconf.5.html#address_verify_default_transport">address_verify_default_transport</a> ($<a href="postconf.5.html#default_transport">default_transport</a>)</b> 222 Overrides the <a href="postconf.5.html#default_transport">default_transport</a> parameter setting for address 223 verification probes. 224 225 <b><a href="postconf.5.html#address_verify_relayhost">address_verify_relayhost</a> ($<a href="postconf.5.html#relayhost">relayhost</a>)</b> 226 Overrides the <a href="postconf.5.html#relayhost">relayhost</a> parameter setting for address verifica- 227 tion probes. 228 229 <b><a href="postconf.5.html#address_verify_transport_maps">address_verify_transport_maps</a> ($<a href="postconf.5.html#transport_maps">transport_maps</a>)</b> 230 Overrides the <a href="postconf.5.html#transport_maps">transport_maps</a> parameter setting for address veri- 231 fication probes. 232 233 Available in Postfix version 2.3 and later: 234 235 <b><a href="postconf.5.html#address_verify_sender_dependent_relayhost_maps">address_verify_sender_dependent_relayhost_maps</a> ($<a href="postconf.5.html#sender_dependent_relayhost_maps">sender_depen</a>-</b> 236 <b><a href="postconf.5.html#sender_dependent_relayhost_maps">dent_relayhost_maps</a>)</b> 237 Overrides the <a href="postconf.5.html#sender_dependent_relayhost_maps">sender_dependent_relayhost_maps</a> parameter setting 238 for address verification probes. 239 240 Available in Postfix version 2.7 and later: 241 242 <b><a href="postconf.5.html#address_verify_sender_dependent_default_transport_maps">address_verify_sender_dependent_default_transport_maps</a> ($<a href="postconf.5.html#sender_dependent_default_transport_maps">sender_depen</a>-</b> 243 <b><a href="postconf.5.html#sender_dependent_default_transport_maps">dent_default_transport_maps</a>)</b> 244 Overrides the <a href="postconf.5.html#sender_dependent_default_transport_maps">sender_dependent_default_transport_maps</a> parameter 245 setting for address verification probes. 246 247<b>MISCELLANEOUS CONTROLS</b> 248 <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 249 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 250 figuration files. 251 252 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 253 How much time a Postfix daemon process may take to handle a 254 request before it is terminated by a built-in watchdog timer. 255 256 <b><a href="postconf.5.html#empty_address_recipient">empty_address_recipient</a> (MAILER-DAEMON)</b> 257 The recipient of mail addressed to the null address. 258 259 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 260 The time limit for sending or receiving information over an 261 internal communication channel. 262 263 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 264 The maximum amount of time that an idle Postfix daemon process 265 waits for an incoming connection before terminating voluntarily. 266 267 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 268 The maximal number of incoming connections that a Postfix daemon 269 process will service before terminating voluntarily. 270 271 <b><a href="postconf.5.html#relocated_maps">relocated_maps</a> (empty)</b> 272 Optional lookup tables with new contact information for users or 273 domains that no longer exist. 274 275 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 276 The process ID of a Postfix command or daemon process. 277 278 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 279 The process name of a Postfix command or daemon process. 280 281 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 282 The location of the Postfix top-level queue directory. 283 284 <b><a href="postconf.5.html#show_user_unknown_table_name">show_user_unknown_table_name</a> (yes)</b> 285 Display the name of the recipient table in the "User unknown" 286 responses. 287 288 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 289 The syslog facility of Postfix logging. 290 291 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 292 A prefix that is prepended to the process name in syslog 293 records, so that, for example, "smtpd" becomes "prefix/smtpd". 294 295 Available in Postfix version 2.0 and later: 296 297 <b><a href="postconf.5.html#helpful_warnings">helpful_warnings</a> (yes)</b> 298 Log warnings about problematic configuration settings, and pro- 299 vide helpful suggestions. 300 301 Available in Postfix 3.3 and later: 302 303 <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b> 304 The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process. 305 306<b>SEE ALSO</b> 307 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 308 <a href="transport.5.html">transport(5)</a>, transport table format 309 <a href="relocated.5.html">relocated(5)</a>, format of the "user has moved" table 310 <a href="master.8.html">master(8)</a>, process manager 311 <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging 312 syslogd(8), system logging 313 314<b>README FILES</b> 315 <a href="ADDRESS_CLASS_README.html">ADDRESS_CLASS_README</a>, Postfix address classes howto 316 <a href="ADDRESS_VERIFICATION_README.html">ADDRESS_VERIFICATION_README</a>, Postfix address verification 317 318<b>LICENSE</b> 319 The Secure Mailer license must be distributed with this software. 320 321<b>AUTHOR(S)</b> 322 Wietse Venema 323 IBM T.J. Watson Research 324 P.O. Box 704 325 Yorktown Heights, NY 10598, USA 326 327 Wietse Venema 328 Google, Inc. 329 111 8th Avenue 330 New York, NY 10011, USA 331 332 TRIVIAL-REWRITE(8) 333</pre> </body> </html> 334