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 17 requests from the queue manager. Each request specifies a 18 queue file, a sender address, a domain or host name that 19 is treated as the reason for discarding the mail, and 20 recipient information. The reason may be prefixed with an 21 <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a>-compatible detail code. This program expects to 22 be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager. 23 24 The <a href="discard.8.html"><b>discard</b>(8)</a> delivery agent pretends to deliver all 25 recipients in the delivery request, logs the "next-hop" 26 domain or host information as the reason for discarding 27 the mail, updates the queue file and marks recipients as 28 finished or informs the queue manager that delivery should 29 be tried again at a later time. 30 31 Delivery status reports are sent to the <a href="trace.8.html"><b>trace</b>(8)</a> daemon as 32 appropriate. 33 34<b>SECURITY</b> 35 The <a href="discard.8.html"><b>discard</b>(8)</a> mailer is not security-sensitive. It does 36 not talk to the network, and can be run chrooted at fixed 37 low privilege. 38 39<b>STANDARDS</b> 40 None. 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="discard.8.html"><b>dis-</b></a> 51 <a href="discard.8.html"><b>card</b>(8)</a> processes run for only a limited amount of time. 52 Use the 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#config_directory">config_directory</a> (see 'postconf -d' output)</b> 58 The default location of the Postfix <a href="postconf.5.html">main.cf</a> and 59 <a href="master.5.html">master.cf</a> configuration files. 60 61 <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> 62 How much time a Postfix daemon process may take to 63 handle a request before it is terminated by a 64 built-in watchdog timer. 65 66 <b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b> 67 The maximal number of digits after the decimal 68 point when logging sub-second delay values. 69 70 <b><a href="postconf.5.html#double_bounce_sender">double_bounce_sender</a> (double-bounce)</b> 71 The sender address of postmaster notifications that 72 are generated by the mail system. 73 74 <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> 75 The time limit for sending or receiving information 76 over an internal communication channel. 77 78 <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> 79 The maximum amount of time that an idle Postfix 80 daemon process waits for an incoming connection 81 before terminating voluntarily. 82 83 <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> 84 The maximal number of incoming connections that a 85 Postfix daemon process will service before termi- 86 nating voluntarily. 87 88 <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> 89 The process ID of a Postfix command or daemon 90 process. 91 92 <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> 93 The process name of a Postfix command or daemon 94 process. 95 96 <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> 97 The location of the Postfix top-level queue direc- 98 tory. 99 100 <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 101 The syslog facility of Postfix logging. 102 103 <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 104 The mail system name that is prepended to the 105 process name in syslog records, so that "smtpd" 106 becomes, for example, "postfix/smtpd". 107 108<b>SEE ALSO</b> 109 <a href="qmgr.8.html">qmgr(8)</a>, queue manager 110 <a href="bounce.8.html">bounce(8)</a>, delivery status reports 111 <a href="error.8.html">error(8)</a>, Postfix error delivery agent 112 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 113 <a href="master.5.html">master(5)</a>, generic daemon options 114 <a href="master.8.html">master(8)</a>, process manager 115 syslogd(8), system logging 116 117<b>LICENSE</b> 118 The Secure Mailer license must be distributed with this 119 software. 120 121<b>HISTORY</b> 122 This service was introduced with Postfix version 2.2. 123 124<b>AUTHOR(S)</b> 125 Victor Duchovni 126 Morgan Stanley 127 128 Based on code by: 129 Wietse Venema 130 IBM T.J. Watson Research 131 P.O. Box 704 132 Yorktown Heights, NY 10598, USA 133 134 DISCARD(8) 135</pre> </body> </html> 136