postfix-master/bounce.8.html

   1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
   2         "http://www.w3.org/TR/html4/loose.dtd">
   3 <html> <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
   5 <title> Postfix manual - bounce(8) </title>
   6 </head> <body> <pre>
   7 BOUNCE(8)                                                            BOUNCE(8)
   8
   9 <b>NAME</b>
  10        bounce - Postfix delivery status reports
  11
  12 <b>SYNOPSIS</b>
  13        <b>bounce</b> [generic Postfix daemon options]
  14
  15 <b>DESCRIPTION</b>
  16        The  <a href="bounce.8.html"><b>bounce</b>(8)</a> daemon maintains per-message log files with
  17        delivery status information. Each log file is named  after
  18        the  queue  file  that it corresponds to, and is kept in a
  19        queue subdirectory named after the  service  name  in  the
  20        <a href="master.5.html"><b>master.cf</b></a> file (either <b>bounce</b>, <b>defer</b> or <b>trace</b>).  This pro-
  21        gram expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
  22
  23        The  <a href="bounce.8.html"><b>bounce</b>(8)</a>  daemon  processes  two  types  of  service
  24        requests:
  25
  26        <b>o</b>      Append a recipient (non-)delivery status record  to
  27               a per-message log file.
  28
  29        <b>o</b>      Enqueue  a  delivery  status  notification message,
  30               with a copy of a per-message log file  and  of  the
  31               corresponding  message.   When  the delivery status
  32               notification message is enqueued successfully,  the
  33               per-message log file is deleted.
  34
  35        The software does a best notification effort. A non-deliv-
  36        ery notification is sent even when the  log  file  or  the
  37        original message cannot be read.
  38
  39        Optionally,  a  bounce  (defer,  trace) client can request
  40        that  the  per-message  log  file  be  deleted  when   the
  41        requested  operation  fails.  This is used by clients that
  42        cannot retry transactions by themselves, and  that  depend
  43        on retry logic in their own client.
  44
  45 <b>STANDARDS</b>
  46        <a href="http://tools.ietf.org/html/rfc822">RFC 822</a> (ARPA Internet Text Messages)
  47        <a href="http://tools.ietf.org/html/rfc2045">RFC 2045</a> (Format of Internet Message Bodies)
  48        <a href="http://tools.ietf.org/html/rfc2822">RFC 2822</a> (Internet Message Format)
  49        <a href="http://tools.ietf.org/html/rfc3462">RFC 3462</a> (Delivery Status Notifications)
  50        <a href="http://tools.ietf.org/html/rfc3464">RFC 3464</a> (Delivery Status Notifications)
  51        <a href="http://tools.ietf.org/html/rfc3834">RFC 3834</a> (Auto-Submitted: message header)
  52        <a href="http://tools.ietf.org/html/rfc5322">RFC 5322</a> (Internet Message Format)
  53
  54 <b>DIAGNOSTICS</b>
  55        Problems and transactions are logged to <b>syslogd</b>(8).
  56
  57 <b>CONFIGURATION PARAMETERS</b>
  58        Changes   to  <a href="postconf.5.html"><b>main.cf</b></a>  are  picked  up  automatically,  as
  59        <a href="bounce.8.html"><b>bounce</b>(8)</a> processes run for only a limited amount of time.
  60        Use the command "<b>postfix reload</b>" to speed up a change.
  61
  62        The  text  below  provides  only  a parameter summary. See
  63        <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
  64
  65        <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
  66               The recipient of undeliverable mail that cannot  be
  67               returned to the sender.
  68
  69        <b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b>
  70               Produce  additional  <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that
  71               can be read by Postfix versions before 2.0.
  72
  73        <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
  74               The recipient of postmaster notifications with  the
  75               message  headers  of  mail  that  Postfix  did  not
  76               deliver and of  SMTP  conversation  transcripts  of
  77               mail that Postfix did not receive.
  78
  79        <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
  80               The maximal amount of original message text that is
  81               sent in a non-delivery notification.
  82
  83        <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
  84               Pathname of a configuration file with  bounce  mes-
  85               sage templates.
  86
  87        <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
  88               The  default  location  of  the Postfix <a href="postconf.5.html">main.cf</a> and
  89               <a href="master.5.html">master.cf</a> configuration files.
  90
  91        <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
  92               How much time a Postfix daemon process may take  to
  93               handle  a  request  before  it  is  terminated by a
  94               built-in watchdog timer.
  95
  96        <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b>
  97               The recipient of postmaster notifications with  the
  98               message  headers  of  mail that cannot be delivered
  99               within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units.
 100
 101        <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
 102               The maximal number of attempts to acquire an exclu-
 103               sive lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
 104
 105        <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
 106               The  time  between attempts to acquire an exclusive
 107               lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
 108
 109        <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
 110               The time limit for sending or receiving information
 111               over an internal communication channel.
 112
 113        <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b>
 114               What  categories of Postfix-generated mail are sub-
 115               ject  to   before-queue   content   inspection   by
 116               <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>.
 117
 118        <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b>
 119               The mail system name that is displayed in Received:
 120               headers,  in  the  SMTP  greeting  banner,  and  in
 121               bounced mail.
 122
 123        <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
 124               The  maximum  amount  of  time that an idle Postfix
 125               daemon process waits  for  an  incoming  connection
 126               before terminating voluntarily.
 127
 128        <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
 129               The  maximal  number of incoming connections that a
 130               Postfix daemon process will service  before  termi-
 131               nating voluntarily.
 132
 133        <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
 134               The  list of error classes that are reported to the
 135               postmaster.
 136
 137        <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
 138               The process ID  of  a  Postfix  command  or  daemon
 139               process.
 140
 141        <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
 142               The  process  name  of  a Postfix command or daemon
 143               process.
 144
 145        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
 146               The location of the Postfix top-level queue  direc-
 147               tory.
 148
 149        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
 150               The syslog facility of Postfix logging.
 151
 152        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
 153               The  mail  system  name  that  is  prepended to the
 154               process name in syslog  records,  so  that  "smtpd"
 155               becomes, for example, "postfix/smtpd".
 156
 157 <b>FILES</b>
 158        /var/spool/postfix/bounce/* non-delivery records
 159        /var/spool/postfix/defer/* non-delivery records
 160        /var/spool/postfix/trace/* delivery status records
 161
 162 <b>SEE ALSO</b>
 163        <a href="bounce.5.html">bounce(5)</a>, bounce message template format
 164        <a href="qmgr.8.html">qmgr(8)</a>, queue manager
 165        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
 166        <a href="master.5.html">master(5)</a>, generic daemon options
 167        <a href="master.8.html">master(8)</a>, process manager
 168        syslogd(8), system logging
 169
 170 <b>LICENSE</b>
 171        The  Secure  Mailer  license must be distributed with this
 172        software.
 173
 174 <b>AUTHOR(S)</b>
 175        Wietse Venema
 176        IBM T.J. Watson Research
 177        P.O. Box 704
 178        Yorktown Heights, NY 10598, USA
 179
 180                                                                      BOUNCE(8)
 181 </pre> </body> </html>