SHOWQ(8)                                                 SHOWQ(8)

NAME
       showq - list the Postfix mail queue

SYNOPSIS
       showq [generic Postfix daemon options]

DESCRIPTION
       The  showq  daemon  reports the Postfix mail queue status.
       It is the program that emulates the sendmail `mailq'  com-
       mand.

       The  showq  daemon  can also be run in stand-alone mode by
       the superuser. This mode of operation is used  to  emulate
       the `mailq' command while the Postfix mail system is down.

SECURITY
       The showq daemon can run in a chroot  jail  at  fixed  low
       privilege, and takes no input from the client. Its service
       port is accessible to local untrusted users, so  the  ser-
       vice can be susceptible to denial of service attacks.

STANDARDS
       None.  The showq daemon does not interact with the outside
       world.

DIAGNOSTICS
       Problems and transactions are logged to syslogd(8).

BUGS
       The showq daemon runs at a  fixed  low  privilege;  conse-
       quently, it cannot extract information from queue files in
       the maildrop directory.

CONFIGURATION PARAMETERS
       Changes to main.cf are picked up automatically as showq(8)
       processes  run  for only a limited amount of time. Use the
       command "postfix reload" to speed up a change.

       The text below provides  only  a  parameter  summary.  See
       postconf(5) for more details including examples.

       config_directory (see 'postconf -d' output)
              The  default  location  of  the Postfix main.cf and
              master.cf configuration files.

       daemon_timeout (18000s)
              How much time a Postfix daemon process may take  to
              handle  a  request  before  it  is  terminated by a
              built-in watchdog timer.

       duplicate_filter_limit (1000)
              The maximal number of addresses remembered  by  the
              address  duplicate  filter  for  aliases(5) or vir-
              tual(5) alias expansion, or for showq(8) queue dis-
              plays.

       empty_address_recipient (MAILER-DAEMON)
              The   recipient  of  mail  addressed  to  the  null
              address.

       ipc_timeout (3600s)
              The time limit for sending or receiving information
              over an internal communication channel.

       max_idle (100s)
              The  maximum  amount  of  time that an idle Postfix
              daemon process waits for the next  service  request
              before exiting.

       max_use (100)
              The  maximal number of connection requests before a
              Postfix daemon process terminates.

       process_id (read-only)
              The process ID of a Postfix command or daemon  pro-
              cess.

       process_name (read-only)
              The  process  name  of  a Postfix command or daemon
              process.

       queue_directory (see 'postconf -d' output)
              The location of the Postfix top-level queue  direc-
              tory.

       syslog_facility (mail)
              The syslog facility of Postfix logging.

       syslog_name (postfix)
              The  mail system name that is prepended to the pro-
              cess  name  in  syslog  records,  so  that  "smtpd"
              becomes, for example, "postfix/smtpd".

FILES
       /var/spool/postfix, queue directories

SEE ALSO
       pickup(8), local mail pickup service
       cleanup(8), canonicalize and enqueue mail
       qmgr(8), queue manager
       postconf(5), configuration parameters
       master(8), process manager
       syslogd(8), system logging

LICENSE
       The  Secure  Mailer  license must be distributed with this
       software.

AUTHOR(S)
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

                                                         SHOWQ(8)