TRIVIAL-REWRITE(8)                             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 sev-
              eral configuration parameters (see below).
       resolve
              Resolve an address to a (transport, nexthop, recip-
              ient) triple. The meaning of the results is as fol-
              lows:
              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 and optional delivery
                     method information.
              recipient
                     The  envelope  recipient  address  that   is
                     passed on to nexthop.
DEFAULT DELIVERY METHODS
       By  default,  Postfix  uses  one of the following delivery
       methods.  This may be overruled with the  optional  trans-
       port(5) table.  The default delivery method is selected by
       matching the recipient address domain against one  of  the
       following:
       $mydestination
       $inet_interfaces
              The  transport  and  optional nexthop are specified
              with $local_transport.  The default nexthop is  the
              recipient domain.
       $virtual_alias_domains
              The   recipient   address  is  undeliverable  (user
              unknown).  By definition, all known addresses in  a
              virtual   alias   domain   are   aliased  to  other
              addresses.
       $virtual_mailbox_domains
              The transport and optional  nexthop  are  specified
              with  $virtual_transport.   The  default nexthop is
              the recipient domain.
       $relay_domains
              The transport and optional  nexthop  are  specified
              with  $relay_transport. This overrides the optional
              nexthop information that is specified with  $relay-
              host.  The default nexthop is the recipient domain.
       none of the above
              The transport and optional  nexthop  are  specified
              with   $default_transport.    This   overrides  the
              optional nexthop information that is specified with
              $relayhost.   The  default nexthop is the recipient
              domain.
SERVER PROCESS MANAGEMENT
       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 $max_use clients of after $max_idle
       seconds of idle time.
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
       empty_address_recipient
              The recipient that  is  substituted  for  the  null
              address.
       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.  Mail for  local  users  is  given  to  the
              $local_transport.
       mydestination
              List of domains that are given to the $local_trans-
              port.
       virtual_alias_domains
              List of simulated virtual domains (domains with all
              recipients  aliased  to  some other local or remote
              domain).
       virtual_mailbox_domains
              List  of  domains  that  are  given  to  the  $vir-
              tual_transport.
       relay_domains
              List of domains that are given to the $relay_trans-
              port.
       resolve_unquoted_address
              When resolving an address, do not quote the address
              localpart  as  per RFC 822, so that additional @, %
              or !  characters remain visible.  This  is  techni-
              cally  incorrect,  but  allows  us  to  stop  relay
              attacks when forwarding mail to a Sendmail  primary
              MX host.
       relocated_maps
              Tables with contact information for users, hosts or
              domains that no longer exist. See relocated(5).
Rewriting
       myorigin
              The domain that locally-posted mail appears to come
              from.
       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:$myhostname.
              Syntax  is  transport:nexthop; see transport(5) for
              details. The :nexthop part is optional.
       virtual_transport
              Where to deliver mail for  non-local  domains  that
              match $virtual_mailbox_domains.  The default trans-
              port is virtual.
              Syntax is transport:nexthop; see  transport(5)  for
              details. The :nexthop part is optional.
       relay_transport
              Where  to  deliver  mail for non-local domains that
              match $relay_domains.   The  default  transport  is
              relay (which normally is a clone of the smtp trans-
              port).
              Syntax is transport:nexthop; see  transport(5)  for
              details. The :nexthop part is optional.
       default_transport
              Where  to  deliver  all  other non-local mail.  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 pat-
              terns  to  match  sub.domain.tld  (as  opposed   to
              requiring .domain.tld patterns).
       relayhost
              The  default host to send non-local mail to when no
              host  is   specified   with   $relay_transport   or
              $default_transport,  and when the recipient address
              does not match the optional the transport(5) table.
       transport_maps
              List  of tables with recipient or domain to (trans-
              port, nexthop) mappings.
SEE ALSO
       master(8) process manager
       syslogd(8) system logging
       transport(5) transport table format
       relocated(5) format of the "user has moved" table
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)