trace.8.html   [plain text]

<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - bounce(8) </title>
</head> <body> <pre>
BOUNCE(8)                                                            BOUNCE(8)

       bounce - Postfix delivery status reports

       <b>bounce</b> [generic Postfix daemon options]

       The  <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon maintains per-message log files with
       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
       <a href="master.5.html"><b></b></a> file (either <b>bounce</b>, <b>defer</b> or <b>trace</b>).  This pro-
       gram expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.

       The  <a href="bounce.8.html"><b>bounce</b>(8)</a>  daemon  processes  two  types  of  service

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

       <b>o</b>      Enqueue  a  delivery  status  notification message,
              with a copy of a per-message log file  and  of  the
              corresponding  message.   When  the delivery status
              notification 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.

       <a href="">RFC 822</a> (ARPA Internet Text Messages)
       <a href="">RFC 2045</a> (Format of Internet Message Bodies)
       <a href="">RFC 2822</a> (Internet Message Format)
       <a href="">RFC 3462</a> (Delivery Status Notifications)
       <a href="">RFC 3464</a> (Delivery Status Notifications)
       <a href="">RFC 3834</a> (Auto-Submitted: message header)
       <a href="">RFC 5322</a> (Internet Message Format)

       Problems and transactions are logged to <b>syslogd</b>(8).

       Changes   to  <a href="postconf.5.html"><b></b></a>  are  picked  up  automatically,  as
       <a href="bounce.8.html"><b>bounce</b>(8)</a> processes run for only a limited amount of time.
       Use the command "<b>postfix reload</b>" to speed up a change.

       The  text  below  provides  only  a parameter summary. See
       <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.

       <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
              The recipient of undeliverable mail that cannot  be
              returned to the sender.

       <b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b>
              Produce  additional  <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that
              can be read by Postfix versions before 2.0.

       <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
              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.

       <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
              The maximal amount of original message text that is
              sent in a non-delivery notification.

       <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
              Pathname of a configuration file with  bounce  mes-
              sage templates.

       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
              The  default  location  of  the Postfix <a href="postconf.5.html"></a> and
              <a href="master.5.html"></a> configuration files.

       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
              How much time a Postfix daemon process may take  to
              handle  a  request  before  it  is  terminated by a
              built-in watchdog timer.

       <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b>
              The recipient of postmaster notifications with  the
              message  headers  of  mail that cannot be delivered
              within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units.

       <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
              The maximal number of attempts to acquire an exclu-
              sive lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.

       <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
              The  time  between attempts to acquire an exclusive
              lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.

       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
              The time limit for sending or receiving information
              over an internal communication channel.

       <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b>
              What  categories of Postfix-generated mail are sub-
              ject  to   before-queue   content   inspection   by
              <a href="postconf.5.html#non_smtpd_milters">non_smtpd_milters</a>, <a href="postconf.5.html#header_checks">header_checks</a> and <a href="postconf.5.html#body_checks">body_checks</a>.

       <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b>
              The mail system name that is displayed in Received:
              headers,  in  the  SMTP  greeting  banner,  and  in
              bounced mail.

       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
              The  maximum  amount  of  time that an idle Postfix
              daemon process waits  for  an  incoming  connection
              before terminating voluntarily.

       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
              The  maximal  number of incoming connections that a
              Postfix daemon process will service  before  termi-
              nating voluntarily.

       <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
              The  list of error classes that are reported to the

       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
              The process ID  of  a  Postfix  command  or  daemon

       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
              The  process  name  of  a Postfix command or daemon

       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
              The location of the Postfix top-level queue  direc-

       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
              The syslog facility of Postfix logging.

       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
              The  mail  system  name  that  is  prepended to the
              process name in syslog  records,  so  that  "smtpd"
              becomes, for example, "postfix/smtpd".

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

<b>SEE ALSO</b>
       <a href="bounce.5.html">bounce(5)</a>, bounce message template format
       <a href="qmgr.8.html">qmgr(8)</a>, queue manager
       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
       <a href="master.5.html">master(5)</a>, generic daemon options
       <a href="master.8.html">master(8)</a>, process manager
       syslogd(8), system logging

       The  Secure  Mailer  license must be distributed with this

       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

</pre> </body> </html>