postfix-master/error.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 - error(8) </title>
   6 </head> <body> <pre>
   7 ERROR(8)                                                              ERROR(8)
   8
   9 <b>NAME</b>
  10        error - Postfix error/retry mail delivery agent
  11
  12 <b>SYNOPSIS</b>
  13        <b>error</b> [generic Postfix daemon options]
  14
  15 <b>DESCRIPTION</b>
  16        The  Postfix  <a href="error.8.html"><b>error</b>(8)</a>  delivery  agent processes delivery
  17        requests from the queue manager. Each request specifies  a
  18        queue  file, a sender address, the reason for non-delivery
  19        (specified as the  next-hop  destination),  and  recipient
  20        information.   The  reason  may  be  prefixed  with an <a href="http://tools.ietf.org/html/rfc3463">RFC</a>
  21        <a href="http://tools.ietf.org/html/rfc3463">3463</a>-compatible  detail  code;  if  none  is  specified  a
  22        default 4.0.0 or 5.0.0 code is used instead.  This program
  23        expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
  24
  25        Depending on the  service  name  in  <a href="master.5.html">master.cf</a>,  <b>error</b>  or
  26        <b>retry</b>,  the server bounces or defers all recipients in the
  27        delivery request using the "next-hop" information  as  the
  28        reason  for  non-delivery.  The <b>retry</b> service name is sup-
  29        ported as of Postfix 2.4.
  30
  31        Delivery  status  reports  are  sent  to  the   <a href="bounce.8.html"><b>bounce</b>(8)</a>,
  32        <a href="defer.8.html"><b>defer</b>(8)</a> or <a href="trace.8.html"><b>trace</b>(8)</a> daemon as appropriate.
  33
  34 <b>SECURITY</b>
  35        The <a href="error.8.html"><b>error</b>(8)</a> mailer is not security-sensitive. It does not
  36        talk to the network, and can be run chrooted at fixed  low
  37        privilege.
  38
  39 <b>STANDARDS</b>
  40        <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a> (Enhanced Status Codes)
  41
  42 <b>DIAGNOSTICS</b>
  43        Problems and transactions are logged to <b>syslogd</b>(8).
  44
  45        Depending  on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter,
  46        the postmaster is notified of bounces and of  other  trou-
  47        ble.
  48
  49 <b>CONFIGURATION PARAMETERS</b>
  50        Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically as <a href="error.8.html"><b>error</b>(8)</a>
  51        processes run for only a limited amount of time.  Use  the
  52        command "<b>postfix reload</b>" to speed up a change.
  53
  54        The  text  below  provides  only  a parameter summary. See
  55        <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
  56
  57        <b><a href="postconf.5.html#2bounce_notice_recipient">2bounce_notice_recipient</a> (postmaster)</b>
  58               The recipient of undeliverable mail that cannot  be
  59               returned to the sender.
  60
  61        <b><a href="postconf.5.html#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
  62               The  recipient of postmaster notifications with the
  63               message  headers  of  mail  that  Postfix  did  not
  64               deliver  and  of  SMTP  conversation transcripts of
  65               mail that Postfix did not receive.
  66
  67        <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
  68               The default location of  the  Postfix  <a href="postconf.5.html">main.cf</a>  and
  69               <a href="master.5.html">master.cf</a> configuration files.
  70
  71        <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
  72               How  much time a Postfix daemon process may take to
  73               handle a request  before  it  is  terminated  by  a
  74               built-in watchdog timer.
  75
  76        <b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b>
  77               The  maximal  number  of  digits  after the decimal
  78               point when logging sub-second delay values.
  79
  80        <b><a href="postconf.5.html#double_bounce_sender">double_bounce_sender</a> (double-bounce)</b>
  81               The sender address of postmaster notifications that
  82               are generated by the mail system.
  83
  84        <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
  85               The time limit for sending or receiving information
  86               over an internal communication channel.
  87
  88        <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
  89               The maximum amount of time  that  an  idle  Postfix
  90               daemon  process  waits  for  an incoming connection
  91               before terminating voluntarily.
  92
  93        <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
  94               The maximal number of incoming connections  that  a
  95               Postfix  daemon  process will service before termi-
  96               nating voluntarily.
  97
  98        <b><a href="postconf.5.html#notify_classes">notify_classes</a> (resource, software)</b>
  99               The list of error classes that are reported to  the
 100               postmaster.
 101
 102        <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
 103               The  process  ID  of  a  Postfix  command or daemon
 104               process.
 105
 106        <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
 107               The process name of a  Postfix  command  or  daemon
 108               process.
 109
 110        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
 111               The  location of the Postfix top-level queue direc-
 112               tory.
 113
 114        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
 115               The syslog facility of Postfix logging.
 116
 117        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
 118               The mail system  name  that  is  prepended  to  the
 119               process  name  in  syslog  records, so that "smtpd"
 120               becomes, for example, "postfix/smtpd".
 121
 122 <b>SEE ALSO</b>
 123        <a href="qmgr.8.html">qmgr(8)</a>, queue manager
 124        <a href="bounce.8.html">bounce(8)</a>, delivery status reports
 125        <a href="discard.8.html">discard(8)</a>, Postfix discard delivery agent
 126        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
 127        <a href="master.5.html">master(5)</a>, generic daemon options
 128        <a href="master.8.html">master(8)</a>, process manager
 129        syslogd(8), system logging
 130
 131 <b>LICENSE</b>
 132        The Secure Mailer license must be  distributed  with  this
 133        software.
 134
 135 <b>AUTHOR(S)</b>
 136        Wietse Venema
 137        IBM T.J. Watson Research
 138        P.O. Box 704
 139        Yorktown Heights, NY 10598, USA
 140
 141                                                                       ERROR(8)
 142 </pre> </body> </html>