xref: /original-bsd/usr.sbin/sendmail/src/mailq.1 (revision f737e041)
1.\" Copyright (c) 1985, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)mailq.1	8.4 (Berkeley) 02/22/94
7.\"
8.Dd
9.Dt MAILQ 1
10.Os BSD 4
11.Sh NAME
12.Nm mailq
13.Nd print the mail queue
14.Sh SYNOPSIS
15.Nm mailq
16.Op Fl v
17.Sh DESCRIPTION
18.Nm Mailq
19prints a summary of the mail messages queued for future delivery.
20.Pp
21The first line printed for each message
22shows the internal identifier used on this host
23for the message,
24the size of the message in bytes,
25the date and time the message was accepted into the queue,
26and the envelope sender of the message.
27The second line shows the error message that caused this message
28to be retained in the queue;
29it will not be present if the message is being processed
30for the first time.
31The following lines show message recipients,
32one per line.
33.Pp
34.Nm Mailq
35is identical to
36.Dq Li "sendmail -bp" .
37.Pp
38The options are as follows:
39.Bl -tag -width Ds
40.It Fl v
41Print verbose information.
42This adds the priority of the message and
43a single character indicator (``+'' or blank)
44indicating whether a warning message has been sent
45on the first line of the message.
46Additionally, extra lines may be intermixed with the recipients
47indicating the ``controlling user'' information;
48this shows who will own any programs that are executed
49on behalf of this message
50and the name of the alias this command expanded from, if any.
51.El
52.Pp
53The
54.Nm mailq
55utility exits 0 on success, and >0 if an error occurs.
56.Sh SEE ALSO
57.Xr sendmail 8
58.Sh HISTORY
59The
60.Nm mailq
61command appeared in
62.Bx 4.0 .
63