1 <!doctype html public
"-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=us-ascii">
5 <title> Postfix manual - postqueue(
1)
</title>
7 POSTQUEUE(
1) POSTQUEUE(
1)
10 postqueue - Postfix queue control
13 <b>postqueue
</b> [
<b>-v
</b>] [
<b>-c
</b> <i>config
</i><b>_
</b><i>dir
</i>]
<b>-f
</b>
14 <b>postqueue
</b> [
<b>-v
</b>] [
<b>-c
</b> <i>config
</i><b>_
</b><i>dir
</i>]
<b>-i
</b> <i>queue
</i><b>_
</b><i>id
</i>
15 <b>postqueue
</b> [
<b>-v
</b>] [
<b>-c
</b> <i>config
</i><b>_
</b><i>dir
</i>]
<b>-p
</b>
16 <b>postqueue
</b> [
<b>-v
</b>] [
<b>-c
</b> <i>config
</i><b>_
</b><i>dir
</i>]
<b>-s
</b> <i>site
</i>
19 The
<a href=
"postqueue.1.html"><b>postqueue
</b>(
1)
</a> command implements the Postfix user
20 interface for queue management. It implements operations
21 that are traditionally available via the
<a href=
"sendmail.1.html"><b>sendmail
</b>(
1)
</a> com-
22 mand. See the
<a href=
"postsuper.1.html"><b>postsuper
</b>(
1)
</a> command for queue operations
23 that require super-user privileges such as deleting a mes-
24 sage from the queue or changing the status of a message.
26 The following options are recognized:
28 <b>-c
</b> <i>config
</i><b>_
</b><i>dir
</i>
29 The
<a href=
"postconf.5.html"><b>main.cf
</b></a> configuration file is in the named
30 directory instead of the default configuration
31 directory. See also the MAIL_CONFIG environment
34 <b>-f
</b> Flush the queue: attempt to deliver all queued
37 This option implements the traditional
"<b>sendmail</b>
38 <b>-q</b>" command, by contacting the Postfix
<a href=
"qmgr.8.html"><b>qmgr
</b>(
8)
</a> dae-
41 Warning: flushing undeliverable mail frequently
42 will result in poor delivery performance of all
45 <b>-i
</b> <i>queue
</i><b>_
</b><i>id
</i>
46 Schedule immediate delivery of deferred mail with
47 the specified queue ID.
49 This option implements the traditional
<b>sendmail -qI
</b>
50 command, by contacting the
<a href=
"flush.8.html"><b>flush
</b>(
8)
</a> server.
52 This feature is available with Postfix version
2.4
55 <b>-p
</b> Produce a traditional sendmail-style queue listing.
56 This option implements the traditional
<b>mailq
</b> com-
57 mand, by contacting the Postfix
<a href=
"showq.8.html"><b>showq
</b>(
8)
</a> daemon.
59 Each queue entry shows the queue file ID, message
60 size, arrival time, sender, and the recipients that
61 still need to be delivered. If mail could not be
62 delivered upon the last attempt, the reason for
63 failure is shown. The queue ID string is followed
64 by an optional status character:
66 <b>*
</b> The message is in the
<b>active
</b> queue, i.e. the
67 message is selected for delivery.
69 <b>!
</b> The message is in the
<b>hold
</b> queue, i.e. no
70 further delivery attempt will be made until
71 the mail is taken off hold.
74 Schedule immediate delivery of all mail that is
75 queued for the named
<i>site
</i>. A numerical site must be
76 specified as a valid
<a href=
"http://tools.ietf.org/html/rfc2821">RFC
2821</a> address literal
77 enclosed in [], just like in email addresses. The
78 site must be eligible for the
"fast flush" service.
79 See
<a href=
"flush.8.html"><b>flush
</b>(
8)
</a> for more information about the
"fast
82 This option implements the traditional
"<b>sendmail</b>
83 <b>-qR</b><i>site</i>" command, by contacting the Postfix
84 <a href=
"flush.8.html"><b>flush
</b>(
8)
</a> daemon.
86 <b>-v
</b> Enable verbose logging for debugging purposes. Mul-
87 tiple
<b>-v
</b> options make the software increasingly
88 verbose. As of Postfix
2.3, this option is avail-
89 able for the super-user only.
92 This program is designed to run with set-group ID privi-
93 leges, so that it can connect to Postfix daemon processes.
96 Problems are logged to
<b>syslogd
</b>(
8) and to the standard
101 Directory with the
<a href=
"postconf.5.html"><b>main.cf
</b></a> file. In order to avoid
102 exploitation of set-group ID privileges, a non-
103 standard directory is allowed only if:
105 <b>o
</b> The name is listed in the standard
<a href=
"postconf.5.html"><b>main.cf
</b></a>
106 file with the
<b><a href=
"postconf.5.html#alternate_config_directories">alternate_config_directories
</a></b>
107 configuration parameter.
109 <b>o
</b> The command is invoked by the super-user.
111 <b>CONFIGURATION PARAMETERS
</b>
112 The following
<a href=
"postconf.5.html"><b>main.cf
</b></a> parameters are especially relevant
113 to this program. The text below provides only a parameter
114 summary. See
<a href=
"postconf.5.html"><b>postconf
</b>(
5)
</a> for more details including exam-
117 <b><a href=
"postconf.5.html#alternate_config_directories">alternate_config_directories
</a> (empty)
</b>
118 A list of non-default Postfix configuration direc-
119 tories that may be specified with
"-c <a href="postconf
.5.html#config_directory
">config_direc</a>-
120 <a href="postconf
.5.html#config_directory
">tory</a>" on the command line, or via the MAIL_CONFIG
121 environment parameter.
123 <b><a href=
"postconf.5.html#config_directory">config_directory
</a> (see 'postconf -d' output)
</b>
124 The default location of the Postfix
<a href=
"postconf.5.html">main.cf
</a> and
125 <a href=
"master.5.html">master.cf
</a> configuration files.
127 <b><a href=
"postconf.5.html#command_directory">command_directory
</a> (see 'postconf -d' output)
</b>
128 The location of all postfix administrative com-
131 <b><a href=
"postconf.5.html#fast_flush_domains">fast_flush_domains
</a> ($
<a href=
"postconf.5.html#relay_domains">relay_domains
</a>)
</b>
132 Optional list of destinations that are eligible for
133 per-destination logfiles with mail that is queued
134 to those destinations.
136 <b><a href=
"postconf.5.html#import_environment">import_environment
</a> (see 'postconf -d' output)
</b>
137 The list of environment parameters that a Postfix
138 process will import from a non-Postfix parent
141 <b><a href=
"postconf.5.html#queue_directory">queue_directory
</a> (see 'postconf -d' output)
</b>
142 The location of the Postfix top-level queue direc-
145 <b><a href=
"postconf.5.html#syslog_facility">syslog_facility
</a> (mail)
</b>
146 The syslog facility of Postfix logging.
148 <b><a href=
"postconf.5.html#syslog_name">syslog_name
</a> (see 'postconf -d' output)
</b>
149 The mail system name that is prepended to the
150 process name in syslog records, so that
"smtpd"
151 becomes, for example,
"postfix/smtpd".
153 <b><a href=
"postconf.5.html#trigger_timeout">trigger_timeout
</a> (
10s)
</b>
154 The time limit for sending a trigger to a Postfix
155 daemon (for example, the
<a href=
"pickup.8.html"><b>pickup
</b>(
8)
</a> or
<a href=
"qmgr.8.html"><b>qmgr
</b>(
8)
</a> dae-
158 Available in Postfix version
2.2 and later:
160 <b><a href=
"postconf.5.html#authorized_flush_users">authorized_flush_users
</a> (static:anyone)
</b>
161 List of users who are authorized to flush the
164 <b><a href=
"postconf.5.html#authorized_mailq_users">authorized_mailq_users
</a> (static:anyone)
</b>
165 List of users who are authorized to view the queue.
168 /var/spool/postfix, mail queue
171 <a href=
"qmgr.8.html">qmgr(
8)
</a>, queue manager
172 <a href=
"showq.8.html">showq(
8)
</a>, list mail queue
173 <a href=
"flush.8.html">flush(
8)
</a>, fast flush service
174 <a href=
"sendmail.1.html">sendmail(
1)
</a>, Sendmail-compatible user interface
175 <a href=
"postsuper.1.html">postsuper(
1)
</a>, privileged queue operations
178 <a href=
"ETRN_README.html">ETRN_README
</a>, Postfix ETRN howto
181 The Secure Mailer license must be distributed with this
185 The postqueue command was introduced with Postfix version
190 IBM T.J. Watson Research
192 Yorktown Heights, NY
10598, USA
195 </pre> </body> </html>