1POSTQUEUE(1)                General Commands Manual               POSTQUEUE(1)
2
3
4

NAME

6       postqueue - Postfix queue control
7

SYNOPSIS

9       postqueue [-v] [-c config_dir] -f
10       postqueue [-v] [-c config_dir] -i queue_id
11       postqueue [-v] [-c config_dir] -p
12       postqueue [-v] [-c config_dir] -s site
13

DESCRIPTION

15       The  postqueue(1)  command  implements  the  Postfix user interface for
16       queue management.  It  implements  operations  that  are  traditionally
17       available  via  the  sendmail(1) command.  See the postsuper(1) command
18       for queue operations that require super-user privileges such as  delet‐
19       ing a message from the queue or changing the status of a message.
20
21       The following options are recognized:
22
23       -c config_dir
24              The main.cf configuration file is in the named directory instead
25              of the default configuration directory. See also the MAIL_CONFIG
26              environment setting below.
27
28       -f     Flush the queue: attempt to deliver all queued mail.
29
30              This option implements the traditional "sendmail -q" command, by
31              contacting the Postfix qmgr(8) daemon.
32
33              Warning: flushing undeliverable mail frequently will  result  in
34              poor delivery performance of all other mail.
35
36       -i queue_id
37              Schedule  immediate delivery of deferred mail with the specified
38              queue ID.
39
40              This option implements the traditional sendmail -qI command,  by
41              contacting the flush(8) server.
42
43              This feature is available with Postfix version 2.4 and later.
44
45       -p     Produce a traditional sendmail-style queue listing.  This option
46              implements the traditional  mailq  command,  by  contacting  the
47              Postfix showq(8) daemon.
48
49              Each  queue entry shows the queue file ID, message size, arrival
50              time, sender, and the recipients that still need  to  be  deliv‐
51              ered.  If mail could not be delivered upon the last attempt, the
52              reason for failure is shown. The queue ID string is followed  by
53              an optional status character:
54
55              *      The  message  is in the active queue, i.e. the message is
56                     selected for delivery.
57
58              !      The message is in the hold queue, i.e. no further  deliv‐
59                     ery  attempt  will  be  made  until the mail is taken off
60                     hold.
61
62       -s site
63              Schedule immediate delivery of all mail that is queued  for  the
64              named  site.  A  numerical site must be specified as a valid RFC
65              2821  address  literal  enclosed  in  [],  just  like  in  email
66              addresses.   The site must be eligible for the "fast flush" ser‐
67              vice.  See flush(8) for more information about the "fast  flush"
68              service.
69
70              This  option  implements the traditional "sendmail -qRsite" com‐
71              mand, by contacting the Postfix flush(8) daemon.
72
73       -v     Enable verbose  logging  for  debugging  purposes.  Multiple  -v
74              options  make  the  software increasingly verbose. As of Postfix
75              2.3, this option is available for the super-user only.
76

SECURITY

78       This program is designed to run with set-group ID privileges,  so  that
79       it can connect to Postfix daemon processes.
80

DIAGNOSTICS

82       Problems are logged to syslogd(8) and to the standard error stream.
83

ENVIRONMENT

85       MAIL_CONFIG
86              Directory  with the main.cf file. In order to avoid exploitation
87              of set-group ID privileges, a non-standard directory is  allowed
88              only if:
89
90              ·      The  name is listed in the standard main.cf file with the
91                     alternate_config_directories configuration parameter.
92
93              ·      The command is invoked by the super-user.
94

CONFIGURATION PARAMETERS

96       The following main.cf parameters are especially relevant to  this  pro‐
97       gram.   The  text  below  provides  only a parameter summary. See post‐
98       conf(5) for more details including examples.
99
100       alternate_config_directories (empty)
101              A list of non-default Postfix configuration directories that may
102              be  specified with "-c config_directory" on the command line, or
103              via the MAIL_CONFIG environment parameter.
104
105       config_directory (see 'postconf -d' output)
106              The default location of the Postfix main.cf and  master.cf  con‐
107              figuration files.
108
109       command_directory (see 'postconf -d' output)
110              The location of all postfix administrative commands.
111
112       fast_flush_domains ($relay_domains)
113              Optional list of destinations that are eligible for per-destina‐
114              tion logfiles with mail that is queued to those destinations.
115
116       import_environment (see 'postconf -d' output)
117              The list of environment parameters that a Postfix  process  will
118              import from a non-Postfix parent process.
119
120       queue_directory (see 'postconf -d' output)
121              The location of the Postfix top-level queue directory.
122
123       syslog_facility (mail)
124              The syslog facility of Postfix logging.
125
126       syslog_name (see 'postconf -d' output)
127              The  mail  system  name that is prepended to the process name in
128              syslog records, so that "smtpd"  becomes,  for  example,  "post‐
129              fix/smtpd".
130
131       trigger_timeout (10s)
132              The  time  limit  for sending a trigger to a Postfix daemon (for
133              example, the pickup(8) or qmgr(8) daemon).
134
135       Available in Postfix version 2.2 and later:
136
137       authorized_flush_users (static:anyone)
138              List of users who are authorized to flush the queue.
139
140       authorized_mailq_users (static:anyone)
141              List of users who are authorized to view the queue.
142

FILES

144       /var/spool/postfix, mail queue
145

SEE ALSO

147       qmgr(8), queue manager
148       showq(8), list mail queue
149       flush(8), fast flush service
150       sendmail(1), Sendmail-compatible user interface
151       postsuper(1), privileged queue operations
152

README FILES

154       Use "postconf readme_directory" or "postconf html_directory" to  locate
155       this information.
156       ETRN_README, Postfix ETRN howto
157

LICENSE

159       The Secure Mailer license must be distributed with this software.
160

HISTORY

162       The postqueue command was introduced with Postfix version 1.1.
163

AUTHOR(S)

165       Wietse Venema
166       IBM T.J. Watson Research
167       P.O. Box 704
168       Yorktown Heights, NY 10598, USA
169
170
171
172                                                                  POSTQUEUE(1)
Impressum