    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. 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 distin-
                  guishes between local and non-local mail. For finer
                  control  over mail routing, use the optional trans-
                  port(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 visible. This is techni-
                  cally  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  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
                  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.

           transport_null_address_lookup_key
                  Lookup key to be used for the null address.

    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)