cleanup - canonicalize and enqueue Postfix message
cleanup [generic Postfix daemon options]
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 transformations:
o Insert missing message headers: (Resent-) From:, To:, Message-Id:, and Date:.
o Extract envelope recipient addresses from (Resent-) To:, Cc: and Bcc: message head-
ers when no recipients 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
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). By default,
address masquerading does not affect envelope recipients.
o Optionally, expand envelope recipients according to information found in the vir-
tual(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.
RFC 822 (ARPA Internet Text Messages)
Problems and transactions are logged to syslogd(8).
Table-driven rewriting rules make it hard to express if then else and other logical rela-
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.
Lookup tables with content filters for message body lines. These filters see phys-
ical lines one at a time, in chunks of at most line_length_limit bytes.
Lookup tables with content filters for message header lines. These filters see
logical headers one at a time, including headers that span multiple lines.
Address to send a copy of each message that enters the system.
Limit the number of Received: message headers.
The header line that is inserted when no recipients were specified in (Resent-)To:
or (Resent-)Cc: message headers.
The destination for undeliverable mail from <>. This substitution is done before
all other address rewriting.
Address mapping lookup table for sender and recipient addresses in envelopes and
Address mapping lookup table for envelope and header recipient addresses.
Address mapping lookup table for envelope and header sender addresses.
List of address classes subject to masquerading: zero or more of envelope_sender,
envelope_recipient, header_sender, header_recipient.
List of domains that hide their subdomain structure.
List of user names that are not subject to address masquerading.
Address mapping lookup table for envelope recipient addresses.
Limit the number of envelope recipients that are remembered.
Limit the amount of memory in bytes used to process a message header.
Amount of time to pause before accepting a message, when the message arrival rate
exceeds the message delivery rate.
Limit the amount of recipients extracted from message headers.
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
/etc/postfix/canonical*, canonical mapping table
/etc/postfix/virtual*, virtual mapping table
The Secure Mailer license must be distributed with this software.
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA