<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <title> Postfix manual - discard(8) </title> </head> <body> <pre> DISCARD(8) DISCARD(8) <b>NAME</b> discard - Postfix discard mail delivery agent <b>SYNOPSIS</b> <b>discard</b> [generic Postfix daemon options] <b>DESCRIPTION</b> The Postfix <a href="discard.8.html"><b>discard</b>(8)</a> delivery agent processes delivery requests from the queue manager. Each request specifies a queue file, a sender address, a next-hop destination that is treated as the reason for dis- carding the mail, and recipient information. The reason may be pre- fixed with an <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a>-compatible detail code. This program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager. The <a href="discard.8.html"><b>discard</b>(8)</a> delivery agent pretends to deliver all recipients in the delivery request, logs the "next-hop" destination as the reason for discarding the mail, updates the queue file, and either marks recipi- ents as finished or informs the queue manager that delivery should be tried again at a later time. Delivery status reports are sent to the <a href="trace.8.html"><b>trace</b>(8)</a> daemon as appropriate. <b>SECURITY</b> The <a href="discard.8.html"><b>discard</b>(8)</a> mailer is not security-sensitive. It does not talk to the network, and can be run chrooted at fixed low privilege. <b>STANDARDS</b> <a href="http://tools.ietf.org/html/rfc3463">RFC 3463</a> (Enhanced Status Codes) <b>DIAGNOSTICS</b> Problems and transactions are logged to <b>syslogd</b>(8). Depending on the setting of the <b><a href="postconf.5.html#notify_classes">notify_classes</a></b> parameter, the postmas- ter is notified of bounces and of other trouble. <b>CONFIGURATION PARAMETERS</b> 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 run for only a limited amount of time. Use the command "<b>postfix reload</b>" to speed up a change. The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples. <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- figuration files. <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b> How much time a Postfix daemon process may take to handle a request before it is terminated by a built-in watchdog timer. <b><a href="postconf.5.html#delay_logging_resolution_limit">delay_logging_resolution_limit</a> (2)</b> The maximal number of digits after the decimal point when log- ging sub-second delay values. <b><a href="postconf.5.html#double_bounce_sender">double_bounce_sender</a> (double-bounce)</b> The sender address of postmaster notifications that are gener- ated by the mail system. <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b> The time limit for sending or receiving information over an internal communication channel. <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b> The maximum amount of time that an idle Postfix daemon process waits for an incoming connection before terminating voluntarily. <b><a href="postconf.5.html#max_use">max_use</a> (100)</b> The maximal number of incoming connections that a Postfix daemon process will service before terminating voluntarily. <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b> The process ID of a Postfix command or daemon process. <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b> The process name of a Postfix command or daemon process. <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b> The location of the Postfix top-level queue directory. <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> The syslog facility of Postfix logging. <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> The mail system name that is prepended to the process name in syslog records, so that "smtpd" becomes, for example, "post- fix/smtpd". <b>SEE ALSO</b> <a href="qmgr.8.html">qmgr(8)</a>, queue manager <a href="bounce.8.html">bounce(8)</a>, delivery status reports <a href="error.8.html">error(8)</a>, Postfix error delivery agent <a href="postconf.5.html">postconf(5)</a>, configuration parameters <a href="master.5.html">master(5)</a>, generic daemon options <a href="master.8.html">master(8)</a>, process manager syslogd(8), system logging <b>LICENSE</b> The Secure Mailer license must be distributed with this software. <b>HISTORY</b> This service was introduced with Postfix version 2.2. <b>AUTHOR(S)</b> Victor Duchovni Morgan Stanley Based on code by: Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA DISCARD(8) </pre> </body> </html>