← Back to branch summary

~ubuntu-branches/ubuntu/raring/postfix/raring

« back to all changes in this revision

Viewing changes to man/man1/postsuper.1

Tags: upstream-2.2.6
Import upstream version 2.2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/man1/postsuper.1
16
16
.SH DESCRIPTION
17
17
.ad
18
18
.fi
19
 
The \fBpostsuper\fR command does maintenance jobs on the Postfix
 
19
The \fBpostsuper\fR(1) command does maintenance jobs on the Postfix
20
20
queue. Use of the command is restricted to the superuser.
21
 
See the \fBpostqueue\fR command for unprivileged queue operations
 
21
See the \fBpostqueue\fR(1) command for unprivileged queue operations
22
22
such as listing or flushing the mail queue.
23
23
 
24
 
By default, \fBpostsuper\fR performs the operations requested with the
 
24
By default, \fBpostsuper\fR(1) performs the operations
 
25
requested with the
25
26
\fB-s\fR and \fB-p\fR command-line options on all Postfix queue
26
27
directories - this includes the \fBincoming\fR, \fBactive\fR and
27
28
\fBdeferred\fR directories with mail files and the \fBbounce\fR,
36
37
Delete one message with the named queue ID from the named
37
38
mail queue(s) (default: \fBhold\fR, \fBincoming\fR, \fBactive\fR and
38
39
\fBdeferred\fR).
 
40
 
39
41
If a \fIqueue_id\fR of \fB-\fR is specified, the program reads
40
42
queue IDs from standard input. For example, to delete all mail
41
 
from or to \fBuser@example.com\fR:
 
43
with exactly one recipient \fBuser@example.com\fR:
42
44
.sp
43
 
mailq | tail +2 | awk  \'BEGIN { RS = "" } \e
44
 
.ti +4
45
 
/ user@example\e.com$/ { print $1 } \e
 
45
mailq | tail +2 | awk  \'BEGIN { RS = "" }
 
46
.ti +4
 
47
# $7=sender, $8=recipient1, $9=recipient2
 
48
.ti +4
 
49
{ if ($8 == "user@example.com" && $9 == "")
 
50
.ti +10
 
51
print $1 }
46
52
.br
47
53
\' | tr -d '*!' | postsuper -d -
48
54
.sp
59
65
The scenario is as follows:
60
66
.RS
61
67
.IP 1)
62
 
The Postfix queue manager deletes the message that \fBpostsuper\fR
 
68
The Postfix queue manager deletes the message that \fBpostsuper\fR(1)
63
69
is asked to delete, because Postfix is finished with the
64
70
message (it is delivered, or it is returned to the sender).
65
71
.IP 2)
66
72
New mail arrives, and the new message is given the same queue ID
67
 
as the message that \fBpostsuper\fR is supposed to delete.
 
73
as the message that \fBpostsuper\fR(1) is supposed to delete.
68
74
The probability for reusing a deleted queue ID is about 1 in 2**15
69
75
(the number of different microsecond values that the system clock
70
76
can distinguish within a second).
71
77
.IP 3)
72
 
\fBpostsuper\fR deletes the new message, instead of the old
 
78
\fBpostsuper\fR(1) deletes the new message, instead of the old
73
79
message that it should have deleted.
74
80
.RE
75
81
.IP "\fB-h \fIqueue_id\fR"
77
83
Move one message with the named queue ID from the named
78
84
mail queue(s) (default: \fBincoming\fR, \fBactive\fR and
79
85
\fBdeferred\fR) to the \fBhold\fR queue.
 
86
 
80
87
If a \fIqueue_id\fR of \fB-\fR is specified, the program reads
81
88
queue IDs from standard input.
82
89
.sp
93
100
Release mail that was put "on hold".
94
101
Move one message with the named queue ID from the named
95
102
mail queue(s) (default: \fBhold\fR) to the \fBdeferred\fR queue.
 
103
 
96
104
If a \fIqueue_id\fR of \fB-\fR is specified, the program reads
97
105
queue IDs from standard input.
98
106
.sp
 
107
Note: use "\fBpostsuper -r\fR" to release mail that was kept on
 
108
hold for a significant fraction of \fB$maximal_queue_lifetime\fR
 
109
or \fB$bounce_queue_lifetime\fR, or longer.
 
110
.sp
99
111
Specify \fB-H ALL\fR to release all mail that is "on hold".
100
112
As a safety measure, the word \fBALL\fR must be specified in upper
101
113
case.
108
120
\fBdeferred\fR).
109
121
To requeue multiple messages, specify multiple \fB-r\fR
110
122
command-line options.
 
123
 
111
124
Alternatively, if a \fIqueue_id\fR of \fB-\fR is specified,
112
125
the program reads queue IDs from standard input.
113
126
.sp
122
135
mappings have changed.
123
136
.sp
124
137
Warning: Postfix queue IDs are reused.
125
 
There is a very small possibility that \fBpostsuper\fR requeues
 
138
There is a very small possibility that \fBpostsuper\fR(1) requeues
126
139
the wrong message file when it is executed while the Postfix mail
127
140
system is running, but no harm should be done.
128
141
.IP \fB-s\fR
149
162
Problems are reported to the standard error stream and to
150
163
\fBsyslogd\fR(8).
151
164
 
152
 
\fBpostsuper\fR reports the number of messages deleted with \fB-d\fR,
 
165
\fBpostsuper\fR(1) reports the number of messages deleted with \fB-d\fR,
153
166
the number of messages requeued with \fB-r\fR, and the number of
154
167
messages whose queue file name was fixed with \fB-s\fR. The report
155
168
is written to the standard error stream and to \fBsyslogd\fR(8).
173
186
The following \fBmain.cf\fR parameters are especially relevant to
174
187
this program.
175
188
The text below provides only a parameter summary. See
176
 
postconf(5) for more details including examples.
 
189
\fBpostconf\fR(5) for more details including examples.
177
190
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
178
191
The default location of the Postfix main.cf and master.cf
179
192
configuration files.
180
193
.IP "\fBhash_queue_depth (1)\fR"
181
194
The number of subdirectory levels for queue directories listed with
182
195
the hash_queue_names parameter.
183
 
.IP "\fBhash_queue_names (see 'postconf -d' output)\fR"
 
196
.IP "\fBhash_queue_names (deferred, defer)\fR"
184
197
The names of queue directories that are split across multiple
185
198
subdirectory levels.
186
199
.IP "\fBqueue_directory (see 'postconf -d' output)\fR"