Home | History | Annotate | Line # | Download | only in html
      1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
      2         "https://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>
      8 SHOWQ(8)                                                              SHOWQ(8)
      9 
     10 <b><a name="name">NAME</a></b>
     11        showq - list the Postfix mail queue
     12 
     13 <b><a name="synopsis">SYNOPSIS</a></b>
     14        <b>showq</b> [generic Postfix daemon options]
     15 
     16 <b><a name="description">DESCRIPTION</a></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><a name="security">SECURITY</a></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><a name="standards">STANDARDS</a></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><a name="diagnostics">DIAGNOSTICS</a></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><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></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><a name="files">FILES</a></b>
    100        /var/spool/postfix, queue directories
    101 
    102 <b><a name="see_also">SEE ALSO</a></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><a name="license">LICENSE</a></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