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.

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

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