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 three 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.

       verify Resolve  an  address  for address verification pur-
              poses.

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  virtual  alias  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.

Address verification
       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:  address_verify_local_transport,
       address_verify_virtual_transport,             address_ver-
       ify_relay_transport,     address_verify_default_transport,
       address_verify_relayhost, address_verify_transport_maps.

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)