postfix-master/showq.8.html

   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>
   7 SHOWQ(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.
  17        It is the program that emulates the sendmail `mailq'  com-
  18        mand.
  19
  20        The <a href="showq.8.html"><b>showq</b>(8)</a> daemon can also be run in stand-alone mode by
  21        the superuser. This mode of operation is used  to  emulate
  22        the `mailq' command while the Postfix mail system is down.
  23
  24 <b>SECURITY</b>
  25        The <a href="showq.8.html"><b>showq</b>(8)</a> daemon can run in a chroot jail at fixed  low
  26        privilege, and takes no input from the client. Its service
  27        port is accessible to local untrusted users, so  the  ser-
  28        vice can be susceptible to denial of service attacks.
  29
  30 <b>STANDARDS</b>
  31        None.  The <a href="showq.8.html"><b>showq</b>(8)</a> daemon does not interact with the out-
  32        side world.
  33
  34 <b>DIAGNOSTICS</b>
  35        Problems and transactions are logged to <b>syslogd</b>(8).
  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>
  39        processes  run  for only a limited amount of time. Use the
  40        command "<b>postfix reload</b>" to speed up a change.
  41
  42        The text below provides  only  a  parameter  summary.  See
  43        <a href="postconf.5.html"><b>postconf</b>(5)</a> for 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
  47               <a href="master.5.html">master.cf</a> configuration 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
  51               handle  a  request  before  it  is  terminated by a
  52               built-in watchdog timer.
  53
  54        <b><a href="postconf.5.html#duplicate_filter_limit">duplicate_filter_limit</a> (1000)</b>
  55               The maximal number of addresses remembered  by  the
  56               address  duplicate  filter  for  <a href="aliases.5.html"><b>aliases</b>(5)</a> or <a href="virtual.5.html"><b>vir-</b></a>
  57               <a href="virtual.5.html"><b>tual</b>(5)</a> alias expansion, or for <a href="showq.8.html"><b>showq</b>(8)</a> queue dis-
  58               plays.
  59
  60        <b><a href="postconf.5.html#empty_address_recipient">empty_address_recipient</a> (MAILER-DAEMON)</b>
  61               The   recipient  of  mail  addressed  to  the  null
  62               address.
  63
  64        <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
  65               The time limit for sending or receiving information
  66               over an internal communication channel.
  67
  68        <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
  69               The  maximum  amount  of  time that an idle Postfix
  70               daemon process waits  for  an  incoming  connection
  71               before terminating voluntarily.
  72
  73        <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
  74               The  maximal  number of incoming connections that a
  75               Postfix daemon process will service  before  termi-
  76               nating voluntarily.
  77
  78        <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
  79               The  process  ID  of  a  Postfix  command or daemon
  80               process.
  81
  82        <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
  83               The process name of a  Postfix  command  or  daemon
  84               process.
  85
  86        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
  87               The  location of the Postfix top-level queue direc-
  88               tory.
  89
  90        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
  91               The syslog facility of Postfix logging.
  92
  93        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
  94               The mail system  name  that  is  prepended  to  the
  95               process  name  in  syslog  records, so that "smtpd"
  96               becomes, for example, "postfix/smtpd".
  97
  98        Available in Postfix version 2.9 and later:
  99
 100        <b><a href="postconf.5.html#enable_long_queue_ids">enable_long_queue_ids</a> (no)</b>
 101               Enable long, non-repeating, queue IDs  (queue  file
 102               names).
 103
 104 <b>FILES</b>
 105        /var/spool/postfix, queue directories
 106
 107 <b>SEE ALSO</b>
 108        <a href="pickup.8.html">pickup(8)</a>, local mail pickup service
 109        <a href="cleanup.8.html">cleanup(8)</a>, canonicalize and enqueue mail
 110        <a href="qmgr.8.html">qmgr(8)</a>, queue manager
 111        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
 112        <a href="master.8.html">master(8)</a>, process manager
 113        syslogd(8), system logging
 114
 115 <b>LICENSE</b>
 116        The  Secure  Mailer  license must be distributed with this
 117        software.
 118
 119 <b>AUTHOR(S)</b>
 120        Wietse Venema
 121        IBM T.J. Watson Research
 122        P.O. Box 704
 123        Yorktown Heights, NY 10598, USA
 124
 125                                                                       SHOWQ(8)
 126 </pre> </body> </html>