TRIVIAL-REWRITE(8)					      System Manager's Manual						TRIVIAL-REWRITE(8)

NAME

       trivial-rewrite - Postfix address rewriting and resolving daemon

SYNOPSIS

       trivial-rewrite [generic Postfix daemon options]

DESCRIPTION

       The trivial-rewrite daemon processes two types of client service requests:

       rewrite
	      Rewrite  an  address  to	standard  form.  The  trivial-rewrite  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 several configu-
	      ration parameters (see below).

       resolve
	      Resolve an address to a (transport, nexthop, recipient) triple. The meaning of the results is as follows:

	      transport
		     The delivery agent to use. This is the first field of an entry in the master.cf file.

	      nexthop
		     The host to send to. For local delivery this is an empty string.

	      recipient
		     The envelope recipient address that is passed on to nexthop.

	      The  trivial-rewrite daemon by default only distinguishes between local and non-local mail. For finer control over mail routing, use
	      the optional transport(5) lookup table.

       This program expects to be run from the master(8) process manager.

STANDARDS

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

SECURITY

       The trivial-rewrite 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.

DIAGNOSTICS

       Problems and transactions are logged to syslogd(8).

BUGS

CONFIGURATION PARAMETERS

       The  following  main.cf parameters are especially relevant to this program. See the Postfix main.cf file for syntax details and for default
       values. Use the postfix reload command after a configuration change.

Miscellaneous
       inet_interfaces
	      The network interfaces that this mail system receives mail on.  This information is used to determine if user@[net.work.addr.ess] is
	      local or remote.

       mydestination
	      List of domains that this machine considers local.

       myorigin
	      The domain that locally-posted mail appears to come from.

       resolve_unquoted_address
	      When  resolving an address, do not quote the address localpart as per RFC 822, so that additional @, % or !  characters remain visi-
	      ble. This is technically incorrect, but allows us to stop relay attacks when forwarding mail to a Sendmail primary MX host.

Rewriting
       allow_percent_hack
	      Rewrite user%domain to user@domain.

       append_at_myorigin
	      Rewrite user to user@$myorigin.

       append_dot_mydomain
	      Rewrite user@host to user@host.$mydomain.

       swap_bangpath
	      Rewrite site!user to user@site.

Routing
       local_transport
	      Where to deliver mail for destinations that match $mydestination or $inet_interfaces.  The default transport is local.

	      Syntax is transport:nexthop; see transport(5) for details. The :nexthop part is optional.

       default_transport
	      Where to deliver non-local mail when no information is explicitly given in the transport(5) table.  The default transport is smtp.

	      Syntax is transport:nexthop; see transport(5) for details. The :nexthop part is optional.

       parent_domain_matches_subdomains
	      List of Postfix features that use domain.tld patterns to match sub.domain.tld (as opposed to requiring .domain.tld patterns).

       relayhost
	      The default host to send non-local mail to when no entry is matched in the transport(5) table.

	      When no relayhost is specified, mail is routed directly to the destination's mail exchanger.

       transport_maps
	      List of tables with domain to (transport, nexthop) mappings.

SEE ALSO

       master(8) process manager
       syslogd(8) system logging
       transport(5) transport table format

LICENSE

       The Secure Mailer license must be distributed with this software.

AUTHOR(S)
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

																TRIVIAL-REWRITE(8)