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> 7ERROR(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> 143