~ubuntu-branches/ubuntu/vivid/postfix/vivid-proposed

« back to all changes in this revision

Viewing changes to man/man8/discard.8

Tags: upstream-2.2.6
ImportĀ upstreamĀ versionĀ 2.2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH DISCARD 8 
 
2
.ad
 
3
.fi
 
4
.SH NAME
 
5
discard
 
6
\-
 
7
Postfix discard mail delivery agent
 
8
.SH "SYNOPSIS"
 
9
.na
 
10
.nf
 
11
\fBdiscard\fR [generic Postfix daemon options]
 
12
.SH DESCRIPTION
 
13
.ad
 
14
.fi
 
15
The Postfix \fBdiscard\fR(8) delivery agent processes
 
16
delivery requests from
 
17
the queue manager. Each request specifies a queue file, a sender
 
18
address, a domain or host name that is treated as the reason for
 
19
discarding the mail, and recipient information.
 
20
This program expects to be run from the \fBmaster\fR(8) process
 
21
manager.
 
22
 
 
23
The \fBdiscard\fR(8) delivery agent pretends to deliver all recipients
 
24
in the delivery request, logs the "next-hop" domain or host
 
25
information as the reason for discarding the mail, updates the
 
26
queue file and marks recipients as finished or informs the
 
27
queue manager that delivery should be tried again at a later time.
 
28
 
 
29
Delivery status reports are sent to the \fBtrace\fR(8)
 
30
daemon as appropriate.
 
31
.SH "SECURITY"
 
32
.na
 
33
.nf
 
34
.ad
 
35
.fi
 
36
The \fBdiscard\fR(8) mailer is not security-sensitive. It does not talk
 
37
to the network, and can be run chrooted at fixed low privilege.
 
38
.SH "STANDARDS"
 
39
.na
 
40
.nf
 
41
None.
 
42
.SH DIAGNOSTICS
 
43
.ad
 
44
.fi
 
45
Problems and transactions are logged to \fBsyslogd\fR(8).
 
46
 
 
47
Depending on the setting of the \fBnotify_classes\fR parameter,
 
48
the postmaster is notified of bounces and of other trouble.
 
49
.SH "CONFIGURATION PARAMETERS"
 
50
.na
 
51
.nf
 
52
.ad
 
53
.fi
 
54
Changes to \fBmain.cf\fR are picked up automatically as \fBdiscard\fR(8)
 
55
processes run for only a limited amount of time. Use the command
 
56
"\fBpostfix reload\fR" to speed up a change.
 
57
 
 
58
The text below provides only a parameter summary. See
 
59
\fBpostconf\fR(5) for more details including examples.
 
60
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
 
61
The default location of the Postfix main.cf and master.cf
 
62
configuration files.
 
63
.IP "\fBdaemon_timeout (18000s)\fR"
 
64
How much time a Postfix daemon process may take to handle a
 
65
request before it is terminated by a built-in watchdog timer.
 
66
.IP "\fBdouble_bounce_sender (double-bounce)\fR"
 
67
The sender address of postmaster notifications that are generated
 
68
by the mail system.
 
69
.IP "\fBipc_timeout (3600s)\fR"
 
70
The time limit for sending or receiving information over an internal
 
71
communication channel.
 
72
.IP "\fBmax_idle (100s)\fR"
 
73
The maximum amount of time that an idle Postfix daemon process
 
74
waits for the next service request before exiting.
 
75
.IP "\fBmax_use (100)\fR"
 
76
The maximal number of connection requests before a Postfix daemon
 
77
process terminates.
 
78
.IP "\fBprocess_id (read-only)\fR"
 
79
The process ID of a Postfix command or daemon process.
 
80
.IP "\fBprocess_name (read-only)\fR"
 
81
The process name of a Postfix command or daemon process.
 
82
.IP "\fBqueue_directory (see 'postconf -d' output)\fR"
 
83
The location of the Postfix top-level queue directory.
 
84
.IP "\fBsyslog_facility (mail)\fR"
 
85
The syslog facility of Postfix logging.
 
86
.IP "\fBsyslog_name (postfix)\fR"
 
87
The mail system name that is prepended to the process name in syslog
 
88
records, so that "smtpd" becomes, for example, "postfix/smtpd".
 
89
.SH "SEE ALSO"
 
90
.na
 
91
.nf
 
92
qmgr(8), queue manager
 
93
bounce(8), delivery status reports
 
94
error(8), Postfix error delivery agent
 
95
postconf(5), configuration parameters
 
96
master(5), generic daemon options
 
97
master(8), process manager
 
98
syslogd(8), system logging
 
99
.SH "LICENSE"
 
100
.na
 
101
.nf
 
102
.ad
 
103
.fi
 
104
The Secure Mailer license must be distributed with this software.
 
105
.SH "HISTORY"
 
106
.na
 
107
.nf
 
108
This service was introduced with Postfix version 2.2.
 
109
.SH "AUTHOR(S)"
 
110
.na
 
111
.nf
 
112
Victor Duchovni
 
113
Morgan Stanley
 
114
 
 
115
Based on code by:
 
116
Wietse Venema
 
117
IBM T.J. Watson Research
 
118
P.O. Box 704
 
119
Yorktown Heights, NY 10598, USA