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