Before printing the queue's contents, sendmail prereads
qf files in the queue and sorts the mail messages
internally. This is done so that the queue's contents are
displayed in the same order in which the messages will be processed
during a queue run.
If there are no messages in the queue (no
sendmail prints the following message and exits:
Mail queue is empty
Otherwise, sendmail prints the number of messages (number
qf files) in the queue:
Mail Queue (# requests)
# is the number of queued messages (requests) in
the queue directory. If there are more than the maximum number of messages that may be processed at one time (defined by
MaxQueueRunSize option (see Section 34.8.38, MaxQueueRunSize),
 Prior to V8.7 this was determined by defining QUEUESIZE in conf.h.
Mail Queue (# requests, only ## printed)
## is the value of the
Next, sendmail prints an attractive heading that looks like the following:
-Q-ID- -Size- ---Q-Time--- ------Sender/Recipient------ MAA12345 354 Fri Mar 15 08:32 firstname.lastname@example.org email@example.com MAA12346* 1972 Fri Mar 15 08:45 firstname.lastname@example.org 8BITMIME (Timed out waiting to connect to wash.dc.gov) email@example.com MAA12347- 23 Fri Mar 15 09:32 firstname.lastname@example.org (Timed out waiting to connect to wash.dc.gov) email@example.com bob
The heading shows the information that is printed about
each message in the queue. The items in that heading and their meanings are the following:
The queue identifier for the message: the hour character, the clocked
part, and the
pid numeric part (like
This item can be followed by a character showing the item's status.
An asterisk (
* as in the second item above),
means that the message is locked (an
lf file was found or the
qf file is locked depending on the kind of locking your
version of sendmail uses).
X means that the load average is currently too high to allow delivery of the message.
A minus (
- as in the third item above)
means that the message is too young to be processed
(based on the
MinQueueAge option, see Section 34.8.41, MinQueueAge).
The size in bytes of the
df file. If there is no
df file (because sendmail is currently receiving
this message and hasn't created one yet), this item is absent.
If the message has completed processing, this prints as:
qf file is empty, this prints as
(no control file)
The date and time that the message was first placed into the queue.
This is the
T line (see Section 23.9.15, T line) in the
qf file converted
from an unsigned integer into a more understandable date and time.
The sender of the message as taken from the
S line (see Section 23.9.14, S line)
qf file. Only the first 45 characters of the sender
address are printed. If there is a
B line (see Section 23.9.1, B line) in the
(as the 8BITMIME in the second item in the example above)
sendmail prints that body-type (see the
-B switch in
Section 36.7.1, -B) on the line following the sender.
If there is an
M line (see Section 23.9.9, M line) in the
file, sendmail prints the text of the error message in parentheses.
After all of the above items have been printed, a list of the recipients
R line, see Section 23.9.13, R line, in the
is printed in the order in which they are found.
In the above example there is one recipient for each of the first two
items and two recipients for the last item.
-Q-ID- -Size- -
Priority- --Q-Time-- ------Sender/Recipient------ MAA12345 354
30020Fri Mar 15 08:32 firstname.lastname@example.org email@example.com MAA12346* 1972
48764Fri Mar 15 08:45 firstname.lastname@example.org 8BITMIME (Timed out waiting to connect to wash.dc.gov) email@example.com MAA12347- 23
54321+Fri Mar 15 09:32 firstname.lastname@example.org (Timed out waiting to connect to wash.dc.gov) email@example.com
is the value from the
P line (see Section 23.9.11, P line) in the
Printing the queue does not
change a message's priority, whereas processing the queue does.
y) option (Section 34.8.53, RecipientFactor (y))
for a description of how the priority is calculated.
Verbose mode also causes a
+ to print after the
(as in the third item above)
if a warning message has been sent.
Timeout.queuewarn option (Section 34.8.70, Timeout (r))
for a description of how messages time out.
R line is preceded by a
controlling user (
C line in the
qf file; see Section 23.9.2, C line),
verbose mode causes that controlling user's name to be put in parentheses
and prepended to the recipient name.
The third item in the preceding example illustrates this.