    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.

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

    CONFIGURATION PARAMETERS
           On busy mail systems a long time may pass before a main.cf
           change affecting trivial_rewrite(8) is picked up. Use  the
           command "postfix reload" to speed up a change.

           The  text  below  provides  only  a parameter summary. See
           postconf(5) for more details including examples.

    COMPATIBILITY CONTROLS
           resolve_dequoted_address (yes)
                  Resolve a recipient address safely instead of  cor-
                  rectly, by looking inside quotes.

           resolve_null_domain (no)
                  Resolve an address that ends in the "@" null domain
                  as if the local hostname were specified, instead of
                  rejecting the address as invalid.

    ADDRESS REWRITING CONTROLS
           myorigin ($myhostname)
                  The domain name that locally-posted mail appears to
                  come from, and that locally posted mail  is  deliv-
                  ered to.

           allow_percent_hack (yes)
                  Enable  the  rewriting of the form "user%domain" to
                  "user@domain".

           append_at_myorigin (yes)
                  Append the string "@$myorigin"  to  mail  addresses
                  without domain information.

           append_dot_mydomain (yes)
                  Append  the  string  ".$mydomain" to addresses that
                  have no ".domain" information.

           recipient_delimiter (empty)
                  The separator between user names and address exten-
                  sions (user+foo).

           swap_bangpath (yes)
                  Enable    the   rewriting   of   "site!user"   into
                  "user@site".

    ROUTING CONTROLS
           The following is applicable to  Postfix  version  2.0  and
           later.   Earlier  versions  do  not have support for: vir-
           tual_transport,  relay_transport,   virtual_alias_domains,
           virtual_mailbox_domains or proxy_interfaces.

           local_transport (local:$myhostname)
                  The  default  mail  delivery  transport for domains
                  that  match  $mydestination,  $inet_interfaces   or
                  $proxy_interfaces.

           virtual_transport (virtual)
                  The  default  mail  delivery  transport for domains
                  that match the  $virtual_mailbox_domains  parameter
                  value.

           relay_transport (relay)
                  The  default  mail  delivery transport and next-hop
                  information   for   domains    that    match    the
                  $relay_domains parameter value.

           default_transport (smtp)
                  The  default  mail  delivery  transport for domains
                  that do not match $mydestination, $inet_interfaces,
                  $proxy_interfaces,   $virtual_alias_domains,  $vir-
                  tual_mailbox_domains, or $relay_domains.

           parent_domain_matches_subdomains (see 'postconf  -d'  out-
           put)
                  What   Postfix   features   match   subdomains   of
                  "domain.tld" automatically, instead of requiring an
                  explicit ".domain.tld" pattern.

           relayhost (empty)
                  The default host to send non-local mail to when  no
                  entry  is  matched  in  the  optional  transport(5)
                  table.

           transport_maps (empty)
                  Optional lookup tables with mappings from recipient
                  address  to  (message  delivery transport, next-hop
                  destination).

    ADDRESS VERIFICATION CONTROLS
           Postfix  version  2.1  introduces  sender  and   recipient
           address  verification.   This  feature  is  implemented by
           sending probe email messages that are not actually  deliv-
           ered.   By  default,  address  verification probes use the
           same route as regular mail. To override  specific  aspects
           of  message routing for address verification probes, spec-
           ify one or more of the following:

           address_verify_local_transport ($local_transport)
                  Overrides the local_transport parameter setting for
                  address verification probes.

           address_verify_virtual_transport ($virtual_transport)
                  Overrides  the  virtual_transport parameter setting
                  for address verification probes.

           address_verify_relay_transport ($relay_transport)
                  Overrides the relay_transport parameter setting for
                  address verification probes.

           address_verify_default_transport ($default_transport)
                  Overrides  the  default_transport parameter setting
                  for address verification probes.

           address_verify_relayhost ($relayhost)
                  Overrides  the  relayhost  parameter  setting   for
                  address verification probes.

           address_verify_transport_maps ($transport_maps)
                  Overrides  the transport_maps parameter setting for
                  address verification probes.

    MISCELLANEOUS CONTROLS
           config_directory (see 'postconf -d' output)
                  The default location of  the  Postfix  main.cf  and
                  master.cf configuration files.

           daemon_timeout (18000s)
                  How  much time a Postfix daemon process may take to
                  handle a request  before  it  is  terminated  by  a
                  built-in watchdog timer.

           empty_address_recipient (MAILER-DAEMON)
                  The   recipient  of  mail  addressed  to  the  null
                  address.

           ipc_timeout (3600s)
                  The time limit for sending or receiving information
                  over an internal communication channel.

           max_idle (100s)
                  The  maximum  amount  of  time that an idle Postfix
                  daemon process waits for the next  service  request
                  before exiting.

           max_use (100)
                  The  maximal number of connection requests before a
                  Postfix daemon process terminates.

           relocated_maps (empty)
                  Optional lookup tables with new contact information
                  for users or domains that no longer exist.

           process_id (read-only)
                  The  process ID of a Postfix command or daemon pro-
                  cess.

           process_name (read-only)
                  The process name of a  Postfix  command  or  daemon
                  process.

           queue_directory (see 'postconf -d' output)
                  The  location of the Postfix top-level queue direc-
                  tory.

           show_user_unknown_table_name (yes)
                  Display the name of  the  recipient  table  in  the
                  "User unknown" responses.

           syslog_facility (mail)
                  The syslog facility of Postfix logging.

           syslog_name (postfix)
                  The  mail system name that is prepended to the pro-
                  cess  name  in  syslog  records,  so  that  "smtpd"
                  becomes, for example, "postfix/smtpd".

           Available in Postfix version 2.0 and later:

           helpful_warnings (yes)
                  Log  warnings  about problematic configuration set-
                  tings, and provide helpful suggestions.

    SEE ALSO
           postconf(5), configuration parameters
           transport(5), transport table format
           relocated(5), format of the "user has moved" table
           master(8), process manager
           syslogd(8), system logging

    README FILES
           ADDRESS_CLASS_README, Postfix address classes howto
           ADDRESS_VERIFICATION_README, Postfix address verification

    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)