117 lines
3.4 KiB
Groff
117 lines
3.4 KiB
Groff
.\" $NetBSD: showq.8,v 1.1.1.4 2004/05/31 00:24:19 heas Exp $
|
|
.\"
|
|
.TH SHOWQ 8
|
|
.ad
|
|
.fi
|
|
.SH NAME
|
|
showq
|
|
\-
|
|
list the Postfix mail queue
|
|
.SH "SYNOPSIS"
|
|
.na
|
|
.nf
|
|
\fBshowq\fR [generic Postfix daemon options]
|
|
.SH DESCRIPTION
|
|
.ad
|
|
.fi
|
|
The \fBshowq\fR daemon reports the Postfix mail queue status.
|
|
It is the program that emulates the sendmail `mailq' command.
|
|
|
|
The \fBshowq\fR 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.
|
|
.SH "SECURITY"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
The \fBshowq\fR 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 service can be
|
|
susceptible to denial of service attacks.
|
|
.SH "STANDARDS"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
None. The showq daemon does not interact with the outside world.
|
|
.SH DIAGNOSTICS
|
|
.ad
|
|
.fi
|
|
Problems and transactions are logged to \fBsyslogd\fR(8).
|
|
.SH BUGS
|
|
.ad
|
|
.fi
|
|
The \fBshowq\fR daemon runs at a fixed low privilege; consequently,
|
|
it cannot extract information from queue files in the
|
|
\fBmaildrop\fR directory.
|
|
.SH "CONFIGURATION PARAMETERS"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
Changes to \fBmain.cf\fR are picked up automatically as showq(8)
|
|
processes run for only a limited amount of time. Use the command
|
|
"\fBpostfix reload\fR" to speed up a change.
|
|
|
|
The text below provides only a parameter summary. See
|
|
postconf(5) for more details including examples.
|
|
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
|
|
The default location of the Postfix main.cf and master.cf
|
|
configuration files.
|
|
.IP "\fBdaemon_timeout (18000s)\fR"
|
|
How much time a Postfix daemon process may take to handle a
|
|
request before it is terminated by a built-in watchdog timer.
|
|
.IP "\fBduplicate_filter_limit (1000)\fR"
|
|
The maximal number of addresses remembered by the address
|
|
duplicate filter for aliases(5) or virtual(5) alias expansion, or
|
|
for showq(8) queue displays.
|
|
.IP "\fBempty_address_recipient (MAILER-DAEMON)\fR"
|
|
The recipient of mail addressed to the null address.
|
|
.IP "\fBipc_timeout (3600s)\fR"
|
|
The time limit for sending or receiving information over an internal
|
|
communication channel.
|
|
.IP "\fBmax_idle (100s)\fR"
|
|
The maximum amount of time that an idle Postfix daemon process
|
|
waits for the next service request before exiting.
|
|
.IP "\fBmax_use (100)\fR"
|
|
The maximal number of connection requests before a Postfix daemon
|
|
process terminates.
|
|
.IP "\fBprocess_id (read-only)\fR"
|
|
The process ID of a Postfix command or daemon process.
|
|
.IP "\fBprocess_name (read-only)\fR"
|
|
The process name of a Postfix command or daemon process.
|
|
.IP "\fBqueue_directory (see 'postconf -d' output)\fR"
|
|
The location of the Postfix top-level queue directory.
|
|
.IP "\fBsyslog_facility (mail)\fR"
|
|
The syslog facility of Postfix logging.
|
|
.IP "\fBsyslog_name (postfix)\fR"
|
|
The mail system name that is prepended to the process name in syslog
|
|
records, so that "smtpd" becomes, for example, "postfix/smtpd".
|
|
.SH "FILES"
|
|
.na
|
|
.nf
|
|
/var/spool/postfix, queue directories
|
|
.SH "SEE ALSO"
|
|
.na
|
|
.nf
|
|
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
|
|
.SH "LICENSE"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
The Secure Mailer license must be distributed with this software.
|
|
.SH "AUTHOR(S)"
|
|
.na
|
|
.nf
|
|
Wietse Venema
|
|
IBM T.J. Watson Research
|
|
P.O. Box 704
|
|
Yorktown Heights, NY 10598, USA
|