DISCARD(8)                                             DISCARD(8)

NAME
       discard - Postfix discard mail delivery agent

SYNOPSIS
       discard [generic Postfix daemon options]

DESCRIPTION
       The  Postfix  discard(8) delivery agent processes delivery
       requests from the queue manager. Each request specifies  a
       queue  file,  a sender address, a domain or host name that
       is treated as the reason  for  discarding  the  mail,  and
       recipient  information.   This  program  expects to be run
       from the master(8) process manager.

       The discard(8) delivery  agent  pretends  to  deliver  all
       recipients  in  the  delivery request, logs the "next-hop"
       domain or host information as the  reason  for  discarding
       the  mail,  updates the queue file and marks recipients as
       finished or informs the queue manager that delivery should
       be tried again at a later time.

       Delivery status reports are sent to the trace(8) daemon as
       appropriate.

SECURITY
       The discard(8) mailer is not security-sensitive.  It  does
       not  talk to the network, and can be run chrooted at fixed
       low privilege.

STANDARDS
       None.

DIAGNOSTICS
       Problems and transactions are logged to syslogd(8).

       Depending on the setting of the notify_classes  parameter,
       the  postmaster  is notified of bounces and of other trou-
       ble.

CONFIGURATION PARAMETERS
       Changes to main.cf are picked  up  automatically  as  dis-
       card(8)  processes  run for only a limited amount of time.
       Use the command "postfix reload" to speed up a change.

       The text below provides  only  a  parameter  summary.  See
       postconf(5) for more details including examples.

       config_directory (see 'postconf -d' output)
              The  default  location  of  the Postfix main.cf and
              master.cf configuration files.

       daemon_timeout (18000s)
              How much time a Postfix daemon process may take  to
              handle  a  request  before  it  is  terminated by a
              built-in watchdog timer.

       double_bounce_sender (double-bounce)
              The sender address of postmaster notifications that
              are generated by the mail system.

       ipc_timeout (3600s)
              The time limit for sending or receiving information
              over an internal communication channel.

       max_idle (100s)
              The maximum amount of time  that  an  idle  Postfix
              daemon  process  waits for the next service request
              before exiting.

       max_use (100)
              The maximal number of connection requests before  a
              Postfix daemon process terminates.

       process_id (read-only)
              The  process ID of a Postfix command or daemon pro-
              cess.

       process_name (read-only)
              The process name of a  Postfix  command  or  daemon
              process.

       queue_directory (see 'postconf -d' output)
              The  location of the Postfix top-level queue direc-
              tory.

       syslog_facility (mail)
              The syslog facility of Postfix logging.

       syslog_name (postfix)
              The mail system name that is prepended to the  pro-
              cess  name  in  syslog  records,  so  that  "smtpd"
              becomes, for example, "postfix/smtpd".

SEE ALSO
       qmgr(8), queue manager
       bounce(8), delivery status reports
       error(8), Postfix error delivery agent
       postconf(5), configuration parameters
       master(5), generic daemon options
       master(8), process manager
       syslogd(8), system logging

LICENSE
       The Secure Mailer license must be  distributed  with  this
       software.

HISTORY
       This service was introduced with Postfix version 2.2.

AUTHOR(S)
       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)