275 lines
14 KiB
HTML
275 lines
14 KiB
HTML
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
<html> <head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
|
<title> Postfix manual - trivial-rewrite(8) </title>
|
|
</head> <body> <pre>
|
|
TRIVIAL-REWRITE(8) TRIVIAL-REWRITE(8)
|
|
|
|
<b>NAME</b>
|
|
trivial-rewrite - Postfix address rewriting and resolving
|
|
daemon
|
|
|
|
<b>SYNOPSIS</b>
|
|
<b>trivial-rewrite</b> [generic Postfix daemon options]
|
|
|
|
<b>DESCRIPTION</b>
|
|
The <b>trivial-rewrite</b> daemon processes three types of client
|
|
service requests:
|
|
|
|
<b>rewrite</b>
|
|
Rewrite an address to standard form. The <b>trivial-</b>
|
|
<b>rewrite</b> daemon by default appends local domain
|
|
information to unqualified addresses, swaps bang
|
|
paths to domain form, and strips source routing
|
|
information. This process is under control of sev-
|
|
eral configuration parameters (see below).
|
|
|
|
<b>resolve</b>
|
|
Resolve an address to a (<i>transport</i>, <i>nexthop</i>, <i>recip-</i>
|
|
<i>ient</i>) triple. The meaning of the results is as fol-
|
|
lows:
|
|
|
|
<i>transport</i>
|
|
The delivery agent to use. This is the first
|
|
field of an entry in the <b>master.cf</b> file.
|
|
|
|
<i>nexthop</i>
|
|
The host to send to and optional delivery
|
|
method information.
|
|
|
|
<i>recipient</i>
|
|
The envelope recipient address that is
|
|
passed on to <i>nexthop</i>.
|
|
|
|
<b>verify</b> Resolve an address for address verification pur-
|
|
poses.
|
|
|
|
<b>SERVER PROCESS MANAGEMENT</b>
|
|
The trivial-rewrite servers run under control by the Post-
|
|
fix master server. Each server can handle multiple simul-
|
|
taneous connections. When all servers are busy while a
|
|
client connects, the master creates a new server process,
|
|
provided that the trivial-rewrite server process limit is
|
|
not exceeded. Each trivial-rewrite server terminates
|
|
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 idle time.
|
|
|
|
<b>STANDARDS</b>
|
|
None. The command does not interact with the outside
|
|
world.
|
|
|
|
<b>SECURITY</b>
|
|
The <b>trivial-rewrite</b> daemon is not security sensitive. By
|
|
default, this daemon does not talk to remote or local
|
|
users. It can run at a fixed low privilege in a chrooted
|
|
environment.
|
|
|
|
<b>DIAGNOSTICS</b>
|
|
Problems and transactions are logged to <b>syslogd</b>(8).
|
|
|
|
<b>CONFIGURATION PARAMETERS</b>
|
|
On busy mail systems a long time may pass before a <b>main.cf</b>
|
|
change affecting trivial_rewrite(8) is picked up. Use the
|
|
command "<b>postfix reload</b>" to speed up a change.
|
|
|
|
The text below provides only a parameter summary. See
|
|
<a href="postconf.5.html">postconf(5)</a> for more details including examples.
|
|
|
|
<b>COMPATIBILITY CONTROLS</b>
|
|
<b><a href="postconf.5.html#resolve_dequoted_address">resolve_dequoted_address</a> (yes)</b>
|
|
Resolve a recipient address safely instead of cor-
|
|
rectly, by looking inside quotes.
|
|
|
|
<b><a href="postconf.5.html#resolve_null_domain">resolve_null_domain</a> (no)</b>
|
|
Resolve an address that ends in the "@" null domain
|
|
as if the local hostname were specified, instead of
|
|
rejecting the address as invalid.
|
|
|
|
<b>ADDRESS REWRITING CONTROLS</b>
|
|
<b><a href="postconf.5.html#myorigin">myorigin</a> ($<a href="postconf.5.html#myhostname">myhostname</a>)</b>
|
|
The default domain name that locally-posted mail
|
|
appears to come from, and that locally posted mail
|
|
is delivered to.
|
|
|
|
<b><a href="postconf.5.html#allow_percent_hack">allow_percent_hack</a> (yes)</b>
|
|
Enable the rewriting of the form "user%domain" to
|
|
"user@domain".
|
|
|
|
<b><a href="postconf.5.html#append_at_myorigin">append_at_myorigin</a> (yes)</b>
|
|
Append the string "@$<a href="postconf.5.html#myorigin">myorigin</a>" to mail addresses
|
|
without domain information.
|
|
|
|
<b><a href="postconf.5.html#append_dot_mydomain">append_dot_mydomain</a> (yes)</b>
|
|
Append the string ".$<a href="postconf.5.html#mydomain">mydomain</a>" to addresses that
|
|
have no ".domain" information.
|
|
|
|
<b><a href="postconf.5.html#recipient_delimiter">recipient_delimiter</a> (empty)</b>
|
|
The separator between user names and address exten-
|
|
sions (user+foo).
|
|
|
|
<b><a href="postconf.5.html#swap_bangpath">swap_bangpath</a> (yes)</b>
|
|
Enable the rewriting of "site!user" into
|
|
"user@site".
|
|
|
|
<b>ROUTING CONTROLS</b>
|
|
The following is applicable to Postfix version 2.0 and
|
|
later. Earlier versions do not have support for: <a href="postconf.5.html#virtual_transport">vir</a>-
|
|
<a href="postconf.5.html#virtual_transport">tual_transport</a>, <a href="postconf.5.html#relay_transport">relay_transport</a>, <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>.
|
|
|
|
<b><a href="postconf.5.html#local_transport">local_transport</a> (local:$<a href="postconf.5.html#myhostname">myhostname</a>)</b>
|
|
The default mail delivery transport for domains
|
|
that match $<a href="postconf.5.html#mydestination">mydestination</a>, $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a> or
|
|
$<a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a>.
|
|
|
|
<b><a href="postconf.5.html#virtual_transport">virtual_transport</a> (virtual)</b>
|
|
The default mail delivery transport for domains
|
|
that match the $<a href="postconf.5.html#virtual_mailbox_domains">virtual_mailbox_domains</a> parameter
|
|
value.
|
|
|
|
<b><a href="postconf.5.html#relay_transport">relay_transport</a> (relay)</b>
|
|
The default mail delivery transport and next-hop
|
|
information for domains that match the
|
|
$<a href="postconf.5.html#relay_domains">relay_domains</a> parameter value.
|
|
|
|
<b><a href="postconf.5.html#default_transport">default_transport</a> (smtp)</b>
|
|
The default mail delivery transport for domains
|
|
that do not match $<a href="postconf.5.html#mydestination">mydestination</a>, $<a href="postconf.5.html#inet_interfaces">inet_interfaces</a>,
|
|
$<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">vir</a>-
|
|
<a href="postconf.5.html#virtual_mailbox_domains">tual_mailbox_domains</a>, or $<a href="postconf.5.html#relay_domains">relay_domains</a>.
|
|
|
|
<b><a href="postconf.5.html#parent_domain_matches_subdomains">parent_domain_matches_subdomains</a> (see 'postconf -d' out-</b>
|
|
<b>put)</b>
|
|
What Postfix features match subdomains of
|
|
"domain.tld" automatically, instead of requiring an
|
|
explicit ".domain.tld" pattern.
|
|
|
|
<b><a href="postconf.5.html#relayhost">relayhost</a> (empty)</b>
|
|
The default host to send non-local mail to when no
|
|
entry is matched in the optional <a href="transport.5.html">transport(5)</a>
|
|
table.
|
|
|
|
<b><a href="postconf.5.html#transport_maps">transport_maps</a> (empty)</b>
|
|
Optional lookup tables with mappings from recipient
|
|
address to (message delivery transport, next-hop
|
|
destination).
|
|
|
|
<b>ADDRESS VERIFICATION CONTROLS</b>
|
|
Postfix version 2.1 introduces sender and address verifi-
|
|
cation. This feature is implemented by sending probe
|
|
email messages that are not actually delivered. By
|
|
default, address verification probes use the same route as
|
|
regular mail. To override specific aspects of message
|
|
routing for address verification probes, specify one or
|
|
more of the following:
|
|
|
|
<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>
|
|
Overrides the <a href="postconf.5.html#local_transport">local_transport</a> parameter setting for
|
|
address verification probes.
|
|
|
|
<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>
|
|
Overrides the <a href="postconf.5.html#virtual_transport">virtual_transport</a> parameter setting
|
|
for address verification probes.
|
|
|
|
<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>
|
|
Overrides the <a href="postconf.5.html#relay_transport">relay_transport</a> parameter setting for
|
|
address verification probes.
|
|
|
|
<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>
|
|
Overrides the <a href="postconf.5.html#default_transport">default_transport</a> parameter setting
|
|
for address verification probes.
|
|
|
|
<b><a href="postconf.5.html#address_verify_relayhost">address_verify_relayhost</a> ($<a href="postconf.5.html#relayhost">relayhost</a>)</b>
|
|
Overrides the <a href="postconf.5.html#relayhost">relayhost</a> parameter setting for
|
|
address verification probes.
|
|
|
|
<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>
|
|
Overrides the <a href="postconf.5.html#transport_maps">transport_maps</a> parameter setting for
|
|
address verification probes.
|
|
|
|
<b>MISCELLANEOUS CONTROLS</b>
|
|
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
|
|
The default location of the Postfix main.cf and
|
|
master.cf configuration files.
|
|
|
|
<b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
|
|
How much time a Postfix daemon process may take to
|
|
handle a request before it is terminated by a
|
|
built-in watchdog timer.
|
|
|
|
<b><a href="postconf.5.html#empty_address_recipient">empty_address_recipient</a> (MAILER-DAEMON)</b>
|
|
The recipient of mail addressed to the null
|
|
address.
|
|
|
|
<b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
|
|
The time limit for sending or receiving information
|
|
over an internal communication channel.
|
|
|
|
<b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
|
|
The maximum amount of time that an idle Postfix
|
|
daemon process waits for the next service request
|
|
before exiting.
|
|
|
|
<b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
|
|
The maximal number of connection requests before a
|
|
Postfix daemon process terminates.
|
|
|
|
<b><a href="postconf.5.html#relocated_maps">relocated_maps</a> (empty)</b>
|
|
Optional lookup tables with new contact information
|
|
for users or domains that no longer exist.
|
|
|
|
<b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
|
|
The process ID of a Postfix command or daemon pro-
|
|
cess.
|
|
|
|
<b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
|
|
The process name of a Postfix command or daemon
|
|
process.
|
|
|
|
<b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
|
|
The location of the Postfix top-level queue direc-
|
|
tory.
|
|
|
|
<b><a href="postconf.5.html#show_user_unknown_table_name">show_user_unknown_table_name</a> (yes)</b>
|
|
Display the name of the recipient table in the
|
|
"User unknown" responses.
|
|
|
|
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
|
|
The syslog facility of Postfix logging.
|
|
|
|
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (postfix)</b>
|
|
The mail system name that is prepended to the pro-
|
|
cess name in syslog records, so that "smtpd"
|
|
becomes, for example, "postfix/smtpd".
|
|
|
|
Available in Postfix version 2.0 and later:
|
|
|
|
<b><a href="postconf.5.html#helpful_warnings">helpful_warnings</a> (yes)</b>
|
|
Log warnings about problematic configuration set-
|
|
tings, and provide helpful suggestions.
|
|
|
|
<b>SEE ALSO</b>
|
|
<a href="postconf.5.html">postconf(5)</a>, configuration parameters
|
|
<a href="transport.5.html">transport(5)</a>, transport table format
|
|
<a href="relocated.5.html">relocated(5)</a>, format of the "user has moved" table
|
|
<a href="master.8.html">master(8)</a>, process manager
|
|
syslogd(8), system logging
|
|
|
|
<b>README FILES</b>
|
|
<a href="ADDRESS_CLASS_README.html">ADDRESS_CLASS_README</a>, Postfix address classes howto
|
|
<a href="ADDRESS_VERIFICATION_README.html">ADDRESS_VERIFICATION_README</a>, Postfix address verification
|
|
|
|
<b>LICENSE</b>
|
|
The Secure Mailer license must be distributed with this
|
|
software.
|
|
|
|
<b>AUTHOR(S)</b>
|
|
Wietse Venema
|
|
IBM T.J. Watson Research
|
|
P.O. Box 704
|
|
Yorktown Heights, NY 10598, USA
|
|
|
|
TRIVIAL-REWRITE(8)
|
|
</pre> </body> </html>
|