dist/html/error.8.html

<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "https://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - error(8) </title>
</head> <body> <pre>
ERROR(8)                                                              ERROR(8)

<b><a name="name">NAME</a></b>
       error - Postfix error/retry mail delivery agent

<b><a name="synopsis">SYNOPSIS</a></b>
       <b>error</b> [generic Postfix daemon options]

<b><a name="description">DESCRIPTION</a></b>
       The  Postfix  <a href="error.8.html"><b>error</b>(8)</a>  delivery agent processes delivery requests from
       the queue manager. Each  request  specifies  a  queue  file,  a  sender
       address,  the reason for non-delivery (specified as the next-hop desti-
       nation), and recipient information.  The reason may be prefixed with an
       <a href="https://tools.ietf.org/html/rfc3463">RFC  3463</a>-compatible  detail code; if none is specified a default 4.0.0
       or 5.0.0 code is used instead.  This program expects to be run from the
       <a href="master.8.html"><b>master</b>(8)</a> process manager.

       Depending  on the service name in <a href="master.5.html">master.cf</a>, <b>error</b> or <b>retry</b>, the server
       bounces or defers all recipients in  the  delivery  request  using  the
       "next-hop"  information  as the reason for non-delivery. The <b>retry</b> ser-
       vice name is supported as of Postfix 2.4.

       Delivery status reports are sent to the <a href="bounce.8.html"><b>bounce</b>(8)</a>, <a href="defer.8.html"><b>defer</b>(8)</a> or <a href="trace.8.html"><b>trace</b>(8)</a>
       daemon as appropriate.

<b><a name="security">SECURITY</a></b>
       The  <a href="error.8.html"><b>error</b>(8)</a> mailer is not security-sensitive. It does not talk to the
       network, and can be run chrooted at fixed low privilege.

<b><a name="standards">STANDARDS</a></b>
       <a href="https://tools.ietf.org/html/rfc3463">RFC 3463</a> (Enhanced Status Codes)

<b><a name="diagnostics">DIAGNOSTICS</a></b>
       Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.

       Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the  postmas-
       ter is notified of bounces and of other trouble.

<b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
       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> 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#bounce_notice_recipient">bounce_notice_recipient</a> (postmaster)</b>
              The recipient of postmaster notifications with the message head-
              ers of mail that Postfix did not deliver and of  SMTP  conversa-
              tion transcripts of mail that Postfix did not receive.

       <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">main.cf</a> and <a href="master.5.html">master.cf</a> con-
              figuration 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_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b>
              The  maximal  number of digits after the decimal point when log-
              ging delay values.

       <b><a href="postconf.5.html#double_bounce_sender">double_bounce_sender</a> (double-bounce)</b>
              The sender address of postmaster notifications that  are  gener-
              ated by the mail system.

       <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#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 terminating 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 postmaster.

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

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

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

       <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>
              A  prefix  that  is  prepended  to  the  process  name in syslog
              records, so that, for example, "smtpd" becomes "prefix/smtpd".

       Available in Postfix 3.3 and later:

       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.

<b><a name="see_also">SEE ALSO</a></b>
       <a href="qmgr.8.html">qmgr(8)</a>, queue manager
       <a href="bounce.8.html">bounce(8)</a>, delivery status reports
       <a href="discard.8.html">discard(8)</a>, Postfix discard delivery agent
       <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
       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
       syslogd(8), system logging

<b><a name="license">LICENSE</a></b>
       The Secure Mailer license must be distributed with this software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

                                                                      ERROR(8)
</pre> </body> </html>