    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.

                                                                    1

    TRIVIAL-REWRITE(8)                             TRIVIAL-REWRITE(8)

    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.

    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.

                                                                    2

    TRIVIAL-REWRITE(8)                             TRIVIAL-REWRITE(8)

           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

                                                                    3