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 39The options are as follows: 40.Bl -tag -width Ds 41.It Fl v 42Print verbose information. 43This adds the priority of the message and 44a single character indicator (``+'' or blank) 45indicating whether a warning message has been sent 46on the first line of the message. 47Additionally, extra lines may be intermixed with the recipients 48indicating the ``controlling user'' information; 49this shows who will own any programs that are executed 50on behalf of this message 51and the name of the alias this command expanded from, if any. 52.El 53.Pp 54The 55.Nm mailq 56utility exits 0 on success, and >0 if an error occurs. 57.Sh NOTES 58.Nm Mailq 59is identical to 60.Dq Li "sendmail -bp" . 61Most of the options which apply to 62.Xr sendmail 8 63also apply to 64.Nm mailq . 65.Sh SEE ALSO 66.Xr sendmail 8 67.Sh HISTORY 68The 69.Nm mailq 70command appeared in 71.Bx 4.0 . 72