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