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