xref: /netbsd-src/external/ibm-public/postfix/dist/html/error.8.html (revision 865c57e0098351fba0d2d2a97b33e7e0270e62c6)
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=utf-8">
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="https://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="https://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) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
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              A  prefix  that  is  prepended  to  the  process  name in syslog
107              records, so that, for example, "smtpd" becomes "prefix/smtpd".
108
109       Available in Postfix 3.3 and later:
110
111       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
112              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
113
114<b>SEE ALSO</b>
115       <a href="qmgr.8.html">qmgr(8)</a>, queue manager
116       <a href="bounce.8.html">bounce(8)</a>, delivery status reports
117       <a href="discard.8.html">discard(8)</a>, Postfix discard delivery agent
118       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
119       <a href="master.5.html">master(5)</a>, generic daemon options
120       <a href="master.8.html">master(8)</a>, process manager
121       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
122       syslogd(8), system logging
123
124<b>LICENSE</b>
125       The Secure Mailer license must be distributed with this software.
126
127<b>AUTHOR(S)</b>
128       Wietse Venema
129       IBM T.J. Watson Research
130       P.O. Box 704
131       Yorktown Heights, NY 10598, USA
132
133       Wietse Venema
134       Google, Inc.
135       111 8th Avenue
136       New York, NY 10011, USA
137
138                                                                      ERROR(8)
139</pre> </body> </html>
140