xref: /netbsd-src/external/ibm-public/postfix/dist/html/showq.8.html (revision 059c16a85b0b39d60ad6d18f53c09510815afa2b)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
6<title> Postfix manual - showq(8) </title>
7</head> <body> <pre>
8SHOWQ(8)                                                              SHOWQ(8)
9
10<b>NAME</b>
11       showq - list the Postfix mail queue
12
13<b>SYNOPSIS</b>
14       <b>showq</b> [generic Postfix daemon options]
15
16<b>DESCRIPTION</b>
17       The  <a href="showq.8.html"><b>showq</b>(8)</a> daemon reports the Postfix mail queue status.  The output
18       is meant to be formatted by the <a href="postqueue.1.html">postqueue(1)</a> command,  as  it  emulates
19       the Sendmail `mailq' command.
20
21       The  <a href="showq.8.html"><b>showq</b>(8)</a>  daemon  can also be run in stand-alone mode by the supe-
22       ruser. This mode of operation is used to emulate  the  `mailq'  command
23       while the Postfix mail system is down.
24
25<b>SECURITY</b>
26       The  <a href="showq.8.html"><b>showq</b>(8)</a>  daemon  can run in a chroot jail at fixed low privilege,
27       and takes no input from the client. Its service port is  accessible  to
28       local  untrusted  users, so the service can be susceptible to denial of
29       service attacks.
30
31<b>STANDARDS</b>
32       None. The <a href="showq.8.html"><b>showq</b>(8)</a> daemon does not interact with the outside world.
33
34<b>DIAGNOSTICS</b>
35       Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
36
37<b>CONFIGURATION PARAMETERS</b>
38       Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically  as  <a href="showq.8.html"><b>showq</b>(8)</a>  processes
39       run for only a limited amount of time. Use the command "<b>postfix reload</b>"
40       to speed up a change.
41
42       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
43       more details including examples.
44
45       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
46              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
47              figuration files.
48
49       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
50              How much time a Postfix daemon process  may  take  to  handle  a
51              request before it is terminated by a built-in watchdog timer.
52
53       <b><a href="postconf.5.html#duplicate_filter_limit">duplicate_filter_limit</a> (1000)</b>
54              The maximal number of addresses remembered by the address dupli-
55              cate filter for <a href="aliases.5.html"><b>aliases</b>(5)</a> or <a href="virtual.5.html"><b>virtual</b>(5)</a> alias expansion, or for
56              <a href="showq.8.html"><b>showq</b>(8)</a> queue displays.
57
58       <b><a href="postconf.5.html#empty_address_recipient">empty_address_recipient</a> (MAILER-DAEMON)</b>
59              The recipient of mail addressed to the null address.
60
61       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
62              The  time  limit  for  sending  or receiving information over an
63              internal communication channel.
64
65       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
66              The maximum amount of time that an idle Postfix  daemon  process
67              waits for an incoming connection before terminating voluntarily.
68
69       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
70              The maximal number of incoming connections that a Postfix daemon
71              process will service before terminating voluntarily.
72
73       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
74              The process ID of a Postfix command or daemon process.
75
76       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
77              The process name of a Postfix command or daemon process.
78
79       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
80              The location of the Postfix top-level queue directory.
81
82       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
83              The syslog facility of Postfix logging.
84
85       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
86              A  prefix  that  is  prepended  to  the  process  name in syslog
87              records, so that, for example, "smtpd" becomes "prefix/smtpd".
88
89       Available in Postfix version 2.9 and later:
90
91       <b><a href="postconf.5.html#enable_long_queue_ids">enable_long_queue_ids</a> (no)</b>
92              Enable long, non-repeating, queue IDs (queue file names).
93
94       Available in Postfix 3.3 and later:
95
96       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
97              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
98
99<b>FILES</b>
100       /var/spool/postfix, queue directories
101
102<b>SEE ALSO</b>
103       <a href="pickup.8.html">pickup(8)</a>, local mail pickup service
104       <a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail
105       <a href="qmgr.8.html">qmgr(8)</a>, queue manager
106       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
107       <a href="master.8.html">master(8)</a>, process manager
108       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
109       syslogd(8), system logging
110
111<b>LICENSE</b>
112       The Secure Mailer license must be distributed with this software.
113
114<b>AUTHOR(S)</b>
115       Wietse Venema
116       IBM T.J. Watson Research
117       P.O. Box 704
118       Yorktown Heights, NY 10598, USA
119
120       Wietse Venema
121       Google, Inc.
122       111 8th Avenue
123       New York, NY 10011, USA
124
125                                                                      SHOWQ(8)
126</pre> </body> </html>
127