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.name  pat-
              terns  to  match  sub.domain.name  (as  opposed  to
              requiring .domain.name 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)