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