postfix-master/discard.8.html

   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>
   7 DISCARD(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>