BOUNCE(8)                                               BOUNCE(8)

NAME
       bounce - Postfix message bounce or defer daemon

SYNOPSIS
       bounce [generic Postfix daemon options]

DESCRIPTION
       The  bounce  daemon  maintains  per-message log files with
       non-delivery status information. Each log  file  is  named
       after  the  queue file that it corresponds to, and is kept
       in a queue subdirectory named after the  service  name  in
       the  master.cf file (either bounce, defer or trace).  This
       program expects to be run from the master(8) process  man-
       ager.

       The bounce daemon processes two types of service requests:

       o      Append a recipient (non-)delivery status record  to
              a per-message log file.

       o      Enqueue a bounce message, with a copy of a per-mes-
              sage log file and  of  the  corresponding  message.
              When  the  bounce message is enqueued successfully,
              the per-message log file is deleted.

       The software does a best notification effort. A non-deliv-
       ery  notification  is  sent  even when the log file or the
       original message cannot be read.

       Optionally, a bounce (defer,  trace)  client  can  request
       that   the  per-message  log  file  be  deleted  when  the
       requested operation fails.  This is used by  clients  that
       cannot  retry  transactions by themselves, and that depend
       on retry logic in their own client.

STANDARDS
       RFC 822 (ARPA Internet Text Messages)
       RFC 1894 (Delivery Status Notifications)
       RFC 2045 (Format of Internet Message Bodies)

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

CONFIGURATION PARAMETERS
       Changes  to  main.cf  are  picked  up  automatically,   as
       bounce(8) processes run for only a limited amount of time.
       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.

       2bounce_notice_recipient (postmaster)
              The  recipient of undeliverable mail that cannot be
              returned to the sender.

       backwards_bounce_logfile_compatibility (yes)
              Produce additional bounce(8) logfile  records  that
              can be read by older Postfix versions.

       bounce_notice_recipient (postmaster)
              The  recipient of postmaster notifications with the
              message  headers  of  mail  that  Postfix  did  not
              deliver  and  of  SMTP  conversation transcripts of
              mail that Postfix did not receive.

       bounce_size_limit (50000)
              The maximal amount of original message text that is
              sent in a non-delivery notification.

       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.

       delay_notice_recipient (postmaster)
              The recipient of postmaster notifications with  the
              message  headers  of  mail that cannot be delivered
              within $delay_warning_time time units.

       deliver_lock_attempts (20)
              The maximal number of attempts to acquire an exclu-
              sive lock on a mailbox file or bounce(8) logfile.

       deliver_lock_delay (1s)
              The  time  between attempts to acquire an exclusive
              lock on a mailbox file or bounce(8) logfile.

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

       mail_name (Postfix)
              The mail system name that is displayed in Received:
              headers,  in  the  SMTP  greeting  banner,  and  in
              bounced mail.

       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.

       notify_classes (resource, software)
              The list of error classes that are reported to  the
              postmaster.

       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.

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

FILES
       /var/spool/postfix/bounce/* non-delivery records
       /var/spool/postfix/defer/* non-delivery records
       /var/spool/postfix/trace/* delivery status records

SEE ALSO
       qmgr(8), queue manager
       postconf(5), configuration parameters
       master(5), generic daemon options
       master(8), process manager
       syslogd(8), system logging

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

                                                        BOUNCE(8)