Tribblix: manual page: mailq.1

MAILQ(1) User Commands MAILQ(1)

NAME

mailq - print the mail queue

SYNOPSIS

/usr/bin/mailq [-Ac] [-q subarg] [-v]

DESCRIPTION

The mailq utility displays a summary of the mail messages queued for
future delivery.

The first line displayed for each mail message shows the internal
identifier used on this host for the message, the size of the message
in bytes, the date and time the message was accepted into the queue,
and the envelope sender of the message. The second line of the
display shows the error message that caused this message to be
retained in the queue. This line will not be displayed if the message
is being processed for the first time.

The mailq utility used to be identical to sendmail -bp. Now it checks
for the authorization attribute, solaris.mail.mailq. If the check for
the invoking user succeeds, sendmail -bp is executed with the
remaining argument vector. Otherwise, an error message is printed.
This authorization attribute is by default enabled for all users. It
can be disabled by modifying the Basic Solaris User entry in
prof_attr(5).

OPTIONS

The following options are supported:

-Ac
Like sendmail(8), this flag tells mailq to use
submit.cf rather than sendmail.cf even if the
operation mode does not indicate an initial mail
submission. This will result in the client queue
/var/spool/clientmqueue being displayed rather than
the default server queue /var/spool/mqueue.

-qp[time]
Similar to -qtime, except that instead of
periodically forking a child to process the queue,
sendmail forks a single persistent child for each
queue that alternates between processing the queue
and sleeping. The sleep time is given as the
argument. The sleep time default is 1 second. The
process will always sleep at least 5 seconds if the
queue was empty in the previous queue run.

-qf
Processes saved messages in the queue once and does
not fork(), but runs in the foreground.

-qG name
Processes jobs in the queue group called name only.

-q[!]I substr
Limits processed jobs to those containing substr as
a substring of the queue id, or not when ! is
specified.

-q[!]R substr
Limits processed jobs to those containing substr as
a substring of one of the recipients, or not when !
is specified.

-q[!]S substr
Limits processed jobs to those containing substr as
a substring of the sender, or not when ! is
specified.

-v
Prints verbose information. This adds the priority
of the message and a single character indicator (+
or blank) indicating whether a warning message has
been sent on the first line of the message.
Additionally, extra lines may be intermixed with the
recipients that indicate the "controlling user"
information. This shows who will own any programs
that are executed on behalf of this message and the
name of the alias this command is expanded from, if
any.

EXIT STATUS

0
Successful completion.

>0
An error occurred.

FILES