    CLEANUP(8)                                             CLEANUP(8)

    NAME
           cleanup - canonicalize and enqueue Postfix message

    SYNOPSIS
           cleanup [generic Postfix daemon options]

    DESCRIPTION
           The cleanup daemon processes inbound mail, inserts it into
           the incoming mail queue, and informs the queue manager  of
           its arrival.

           The cleanup daemon always performs the following transfor-
           mations:

           o      Insert missing message  headers:  (Resent-)  From:,
                  To:, Message-Id:, and Date:.

           o      Extract envelope recipient addresses from (Resent-)
                  To:, Cc: and Bcc: message headers when  no  recipi-
                  ents are specified in the message envelope.

           o      Transform  envelope  and  header  addresses  to the
                  standard user@fully-qualified-domain form  that  is
                  expected  by  other Postfix programs.  This task is
                  delegated to the trivial-rewrite(8) daemon.

           o      Eliminate duplicate envelope recipient addresses.

           The following address transformations are optional:

           o      Optionally,  rewrite  all   envelope   and   header
                  addresses  according  to  the mappings specified in
                  the canonical(5) lookup tables.

           o      Optionally, masquerade  envelope  sender  addresses
                  and  message  header  addresses (i.e. strip host or
                  domain information below all domains listed in  the
                  masquerade_domains parameter, except for user names
                  listed  in  masquerade_exceptions).   Address  mas-
                  querading does not affect envelope recipients.

           o      Optionally, expand envelope recipients according to
                  information found in the virtual(5) lookup  tables.

           The  cleanup  daemon performs sanity checks on the content
           of each message. When it finds a problem,  by  default  it
           returns  a  diagnostic status to the client, and leaves it
           up to the client to deal with the problem.  Alternatively,
           the  client  can  request the cleanup daemon to bounce the
           message back to the sender in case of trouble.

    STANDARDS
           RFC 822 (ARPA Internet Text Messages)

                                                                    1

    CLEANUP(8)                                             CLEANUP(8)

    DIAGNOSTICS
           Problems and transactions are logged to syslogd(8).

    BUGS
           Table-driven rewriting rules make it hard  to  express  if
           then else and other logical relationships.

    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.

    Content filtering
           body_checks
                  Lookup tables with content filters for message body
                  lines.   These  filters see physical lines one at a
                  time, in chunks of at most line_length_limit bytes.

           header_checks
                  Lookup  tables  with  content  filters  for message
                  header lines.  These filters  see  logical  headers
                  one at a time, including headers that span multiple
                  lines.

    Miscellaneous
           always_bcc
                  Address to send a copy of each message that  enters
                  the system.

           hopcount_limit
                  Limit the number of Received: message headers.

           undisclosed_recipients_header
                  The header line that is inserted when no recipients
                  were specified in (Resent-)To: or (Resent-)Cc: mes-
                  sage headers.

    Address transformations
           empty_address_recipient
                  The  destination  for  undeliverable  mail from <>.
                  This substitution is done before all other  address
                  rewriting.

           canonical_maps
                  Address mapping lookup table for sender and recipi-
                  ent addresses in envelopes and headers.

           recipient_canonical_maps
                  Address  mapping  lookup  table  for  envelope  and
                  header recipient addresses.

           sender_canonical_maps
                  Address  mapping  lookup  table  for  envelope  and

                                                                    2

    CLEANUP(8)                                             CLEANUP(8)

                  header sender addresses.

           masquerade_domains
                  List of domains that hide  their  subdomain  struc-
                  ture.

           masquerade_exceptions
                  List  of user names that are not subject to address
                  masquerading.

           virtual_maps
                  Address mapping lookup table for envelope recipient
                  addresses.

    Resource controls
           duplicate_filter_limit
                  Limit  the  number  of envelope recipients that are
                  remembered.

           header_size_limit
                  Limit the amount of memory in bytes used to process
                  a message header.

           extract_recipient_limit
                  Limit  the amount of recipients extracted from mes-
                  sage headers.

    SEE ALSO
           canonical(5) canonical address lookup table format
           qmgr(8) queue manager daemon
           syslogd(8) system logging
           trivial-rewrite(8) address rewriting
           virtual(5) virtual address lookup table format

    FILES
           /etc/postfix/canonical*, canonical mapping table
           /etc/postfix/virtual*, virtual mapping 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

                                                                    3