external/ibm-public/postfix/dist/html/defer.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> (ARPA Internet Text Messages)
  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
  53 <b>DIAGNOSTICS</b>
  54        Problems and transactions are logged to <b>syslogd</b>(8).
  55
  56 <b>CONFIGURATION PARAMETERS</b>
  57        Changes   to  <a href="postconf.5.html"><b>main.cf</b></a>  are  picked  up  automatically,  as
  58        <a href="bounce.8.html"><b>bounce</b>(8)</a> processes run for only a limited amount of time.
  59        Use the command "<b>postfix reload</b>" to speed up a change.
  60
  61        The  text  below  provides  only  a parameter summary. See
  62        <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
  63
  64        <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
  65               The recipient of undeliverable mail that cannot  be
  66               returned to the sender.
  67
  68        <b><a href="postconf.5.html#backwards_bounce_logfile_compatibility">backwards_bounce_logfile_compatibility</a> (yes)</b>
  69               Produce  additional  <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile records that
  70               can be read by Postfix versions before 2.0.
  71
  72        <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
  73               The recipient of postmaster notifications with  the
  74               message  headers  of  mail  that  Postfix  did  not
  75               deliver and of  SMTP  conversation  transcripts  of
  76               mail that Postfix did not receive.
  77
  78        <b><a href="postconf.5.html#bounce_size_limit">bounce_size_limit</a> (50000)</b>
  79               The maximal amount of original message text that is
  80               sent in a non-delivery notification.
  81
  82        <b><a href="postconf.5.html#bounce_template_file">bounce_template_file</a> (empty)</b>
  83               Pathname of a configuration file with  bounce  mes-
  84               sage templates.
  85
  86        <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
  87               The  default  location  of  the Postfix <a href="postconf.5.html">main.cf</a> and
  88               <a href="master.5.html">master.cf</a> configuration files.
  89
  90        <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
  91               How much time a Postfix daemon process may take  to
  92               handle  a  request  before  it  is  terminated by a
  93               built-in watchdog timer.
  94
  95        <b><a href="postconf.5.html#delay_notice_recipient">delay_notice_recipient</a> (postmaster)</b>
  96               The recipient of postmaster notifications with  the
  97               message  headers  of  mail that cannot be delivered
  98               within $<a href="postconf.5.html#delay_warning_time">delay_warning_time</a> time units.
  99
 100        <b><a href="postconf.5.html#deliver_lock_attempts">deliver_lock_attempts</a> (20)</b>
 101               The maximal number of attempts to acquire an exclu-
 102               sive lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
 103
 104        <b><a href="postconf.5.html#deliver_lock_delay">deliver_lock_delay</a> (1s)</b>
 105               The  time  between attempts to acquire an exclusive
 106               lock on a mailbox file or <a href="bounce.8.html"><b>bounce</b>(8)</a> logfile.
 107
 108        <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
 109               The time limit for sending or receiving information
 110               over an internal communication channel.
 111
 112        <b><a href="postconf.5.html#internal_mail_filter_classes">internal_mail_filter_classes</a> (empty)</b>
 113               What  categories of Postfix-generated mail are sub-
 114               ject  to   before-queue   content   inspection   by
 115               <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>.
 116
 117        <b><a href="postconf.5.html#mail_name">mail_name</a> (Postfix)</b>
 118               The mail system name that is displayed in Received:
 119               headers,  in  the  SMTP  greeting  banner,  and  in
 120               bounced mail.
 121
 122        <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
 123               The  maximum  amount  of  time that an idle Postfix
 124               daemon process waits  for  an  incoming  connection
 125               before terminating voluntarily.
 126
 127        <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
 128               The  maximal  number of incoming connections that a
 129               Postfix daemon process will service  before  termi-
 130               nating voluntarily.
 131
 132        <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
 133               The  list of error classes that are reported to the
 134               postmaster.
 135
 136        <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
 137               The process ID  of  a  Postfix  command  or  daemon
 138               process.
 139
 140        <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
 141               The  process  name  of  a Postfix command or daemon
 142               process.
 143
 144        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
 145               The location of the Postfix top-level queue  direc-
 146               tory.
 147
 148        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
 149               The syslog facility of Postfix logging.
 150
 151        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
 152               The  mail  system  name  that  is  prepended to the
 153               process name in syslog  records,  so  that  "smtpd"
 154               becomes, for example, "postfix/smtpd".
 155
 156 <b>FILES</b>
 157        /var/spool/postfix/bounce/* non-delivery records
 158        /var/spool/postfix/defer/* non-delivery records
 159        /var/spool/postfix/trace/* delivery status records
 160
 161 <b>SEE ALSO</b>
 162        <a href="bounce.5.html">bounce(5)</a>, bounce message template format
 163        <a href="qmgr.8.html">qmgr(8)</a>, queue manager
 164        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
 165        <a href="master.5.html">master(5)</a>, generic daemon options
 166        <a href="master.8.html">master(8)</a>, process manager
 167        syslogd(8), system logging
 168
 169 <b>LICENSE</b>
 170        The  Secure  Mailer  license must be distributed with this
 171        software.
 172
 173 <b>AUTHOR(S)</b>
 174        Wietse Venema
 175        IBM T.J. Watson Research
 176        P.O. Box 704
 177        Yorktown Heights, NY 10598, USA
 178
 179                                                                      BOUNCE(8)
 180 </pre> </body> </html>