{ "content": [ { "type": "text", "text": "# discard (man)\n\n## NAME\n\ndiscard - Postfix discard mail delivery agent\n\n## SYNOPSIS\n\ndiscard [generic Postfix daemon options]\n\n## DESCRIPTION\n\nThe Postfix discard(8) delivery agent processes delivery requests from the queue manager.\nEach request specifies a queue file, a sender address, a next-hop destination that is treated\nas the reason for discarding the mail, and recipient information. The reason may be prefixed\nwith an RFC 3463-compatible detail code. This program expects to be run from the master(8)\nprocess manager.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **SECURITY**\n- **STANDARDS**\n- **DIAGNOSTICS**\n- **CONFIGURATION PARAMETERS** (13 subsections)\n- **SEE ALSO**\n- **LICENSE**\n- **HISTORY**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "discard", "section": "", "mode": "man", "summary": "discard - Postfix discard mail delivery agent", "synopsis": "discard [generic Postfix daemon options]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [ { "name": "qmgr", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/qmgr/8/json" }, { "name": "bounce", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/bounce/8/json" }, { "name": "error", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/error/8/json" }, { "name": "postconf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/postconf/5/json" }, { "name": "master", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/master/5/json" }, { "name": "master", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/master/8/json" }, { "name": "postlogd", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/postlogd/8/json" }, { "name": "syslogd", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/syslogd/8/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 13, "subsections": [] }, { "name": "SECURITY", "lines": 3, "subsections": [] }, { "name": "STANDARDS", "lines": 2, "subsections": [] }, { "name": "DIAGNOSTICS", "lines": 5, "subsections": [] }, { "name": "CONFIGURATION PARAMETERS", "lines": 6, "subsections": [ { "name": "config_directory (see 'postconf -d' output)", "lines": 2 }, { "name": "daemon_timeout (18000s)", "lines": 3 }, { "name": "delay_logging_resolution_limit (2)", "lines": 3 }, { "name": "double_bounce_sender (double-bounce)", "lines": 2 }, { "name": "ipc_timeout (3600s)", "lines": 3 }, { "name": "max_idle (100s)", "lines": 3 }, { "name": "max_use (100)", "lines": 3 }, { "name": "process_id (read-only)", "lines": 2 }, { "name": "process_name (read-only)", "lines": 2 }, { "name": "queue_directory (see 'postconf -d' output)", "lines": 2 }, { "name": "syslog_facility (mail)", "lines": 2 }, { "name": "syslog_name (see 'postconf -d' output)", "lines": 5 }, { "name": "service_name (read-only)", "lines": 2 } ] }, { "name": "SEE ALSO", "lines": 9, "subsections": [] }, { "name": "LICENSE", "lines": 2, "subsections": [] }, { "name": "HISTORY", "lines": 18, "subsections": [] } ], "sections": { "NAME": { "content": "discard - Postfix discard mail delivery agent\n", "subsections": [] }, "SYNOPSIS": { "content": "discard [generic Postfix daemon options]\n", "subsections": [] }, "DESCRIPTION": { "content": "The Postfix discard(8) delivery agent processes delivery requests from the queue manager.\nEach request specifies a queue file, a sender address, a next-hop destination that is treated\nas the reason for discarding the mail, and recipient information. The reason may be prefixed\nwith an RFC 3463-compatible detail code. This program expects to be run from the master(8)\nprocess manager.\n\nThe discard(8) delivery agent pretends to deliver all recipients in the delivery request,\nlogs the \"next-hop\" destination as the reason for discarding the mail, updates the queue\nfile, and either marks recipients as finished or informs the queue manager that delivery\nshould be tried again at a later time.\n\nDelivery status reports are sent to the trace(8) daemon as appropriate.\n", "subsections": [] }, "SECURITY": { "content": "The discard(8) mailer is not security-sensitive. It does not talk to the network, and can be\nrun chrooted at fixed low privilege.\n", "subsections": [] }, "STANDARDS": { "content": "RFC 3463 (Enhanced Status Codes)\n", "subsections": [] }, "DIAGNOSTICS": { "content": "Problems and transactions are logged to syslogd(8) or postlogd(8).\n\nDepending on the setting of the notifyclasses parameter, the postmaster is notified of\nbounces and of other trouble.\n", "subsections": [] }, "CONFIGURATION PARAMETERS": { "content": "Changes to main.cf are picked up automatically as discard(8) processes run for only a limited\namount of time. Use the command \"postfix reload\" to speed up a change.\n\nThe text below provides only a parameter summary. See postconf(5) for more details including\nexamples.\n", "subsections": [ { "name": "config_directory (see 'postconf -d' output)", "content": "The default location of the Postfix main.cf and master.cf configuration files.\n" }, { "name": "daemon_timeout (18000s)", "content": "How much time a Postfix daemon process may take to handle a request before it is ter‐\nminated by a built-in watchdog timer.\n" }, { "name": "delay_logging_resolution_limit (2)", "content": "The maximal number of digits after the decimal point when logging sub-second delay\nvalues.\n" }, { "name": "double_bounce_sender (double-bounce)", "content": "The sender address of postmaster notifications that are generated by the mail system.\n" }, { "name": "ipc_timeout (3600s)", "content": "The time limit for sending or receiving information over an internal communication\nchannel.\n" }, { "name": "max_idle (100s)", "content": "The maximum amount of time that an idle Postfix daemon process waits for an incoming\nconnection before terminating voluntarily.\n" }, { "name": "max_use (100)", "content": "The maximal number of incoming connections that a Postfix daemon process will service\nbefore terminating voluntarily.\n" }, { "name": "process_id (read-only)", "content": "The process ID of a Postfix command or daemon process.\n" }, { "name": "process_name (read-only)", "content": "The process name of a Postfix command or daemon process.\n" }, { "name": "queue_directory (see 'postconf -d' output)", "content": "The location of the Postfix top-level queue directory.\n" }, { "name": "syslog_facility (mail)", "content": "The syslog facility of Postfix logging.\n" }, { "name": "syslog_name (see 'postconf -d' output)", "content": "A prefix that is prepended to the process name in syslog records, so that, for exam‐\nple, \"smtpd\" becomes \"prefix/smtpd\".\n\nAvailable in Postfix 3.3 and later:\n" }, { "name": "service_name (read-only)", "content": "The master.cf service name of a Postfix daemon process.\n" } ] }, "SEE ALSO": { "content": "qmgr(8), queue manager\nbounce(8), delivery status reports\nerror(8), Postfix error delivery agent\npostconf(5), configuration parameters\nmaster(5), generic daemon options\nmaster(8), process manager\npostlogd(8), Postfix logging\nsyslogd(8), system logging\n", "subsections": [] }, "LICENSE": { "content": "The Secure Mailer license must be distributed with this software.\n", "subsections": [] }, "HISTORY": { "content": "This service was introduced with Postfix version 2.2.\n\nAUTHOR(S)\nVictor Duchovni\nMorgan Stanley\n\nBased on code by:\nWietse Venema\nIBM T.J. Watson Research\nP.O. Box 704\nYorktown Heights, NY 10598, USA\n\nWietse Venema\nGoogle, Inc.\n111 8th Avenue\nNew York, NY 10011, USA\n\nDISCARD(8postfix)", "subsections": [] } } } }