SHOWQ(8) SHOWQ(8)
NAME
showq - list the Postfix mail queue
SYNOPSIS
showq [generic Postfix daemon options]
DESCRIPTION
T Separate command names by white space or commas,
and use quotes to protect white space from the
shell. Command names are case-insensitive.
-r command,command,...
Reject the specified commands with a soft (4xx)
error code. This option implies -p.
Examples of commands are CONNECT, HELO, EHLO, LHLO,
MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT.
Separate command names by white space or commas,
and use quotes to protect white space from the
shell. Command names are case-insensitive.
-R root-directory
Change the process root directory to the specified
location. This option requires super-user privi-
leges. See also the -u option.
-s command,command,...
Log the named commands to syslogd.
Examples of commands are CONNECT, HELO, EHLO, LHLO,
MAIL, RCPT, VRFY, DATA, ., RSET, NOOP, and QUIT.
Separate command names by white space or commas,
and use quotes to protect white space from the
shell. Command names are case-insensitive.
-S start-string
An optional string that is prepended to each mes-
sage that is written to a dump file (see the dump
file format description below). The following C
escape sequences are supported: \a (bell), \b
(backslace), \f (formfeed), \n (newline), \r (car-
riage return), \t (horizontal tab), \v (vertical
tab), \ddd (up to three octal digits) and \\ (the
backslash character).
-t timeout (default: 100)
Limit the time for receiving a command or sending a
response. The time limit is specified in seconds.
-u username
Switch to the specified user privileges after open-
ing the network socket and optionally changing the
process root directory. This option is required
when the process runs with super-user privileges.
See also the -R option.
-v Show the SMTP conversations.
-w delay
Wait delay seconds before responding to a DATA com-
mand.
-W command:delay[:odds]
Wait delay seconds before responding to command.
If odds is also specified (a number between 1-99
inclusive), wait for a random multiple of delay.
The random multiplier is equal to the number of
times the program needs to roll a dice with a range
of 0..99 inclusive, before the dice produces a
result greater than or equal to odds.
[inet:][host]:port
Listen on network interface host (default: any
interface) TCP port port. Both host and port may be
specified in numeric or symbolic form.
unix:pathname
Listen on the UNIX-domain socket at pathname.
backlog
The maximum length the queue of pending connec-
tions, as defined by the listen(2) system call.
DUMP FILE FORMAT
Each dumped message contains a sequence of text lines,
terminated with the newline character. The sequence of
information is as follows:
o The optional string specified with the -S option.
o The smtp-sink generated headers as documented
below.
o The message header and body as received from the
SMTP client.
o An empty line.
The format of the smtp-sink generated headers is as fol-
lows:
X-Client-Addr: text
The client IP address without enclosing []. An IPv6
address is prefixed with "ipv6:". This record is
always present.
X-Client-Proto: text
The client protocol: SMTP, ESMTP or LMTP. This
record is always present.
X-Helo-Args: text
The arguments of the last HELO or EHLO command
before this mail delivery transaction. This record
is present only if the client sent a recognizable
HELO or EHLO command before the DATA command.
X-Mail-Args: text
The arguments of the MAIL command that started this
mail delive