xref: /original-bsd/usr.sbin/sendmail/src/mailq.1 (revision 3b235ced)
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.1 (Berkeley) 02/02/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 completely equivalent to
36.Pa /usr/sbin/sendmail
37.Fl bp .
38.Ss Parameters
39.Bl -tag -width Fl
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.Sh SEE ALSO
52.Xr sendmail 8
53.Sh HISTORY
54The
55.Nm mailq
56command appeared in
57.Bx 4.0 .
58