Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sendmail-mailq (1)

Name

sendmail-mailq - print the mail queue

Synopsis

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

Description

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 iden-
       tifier  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 pro-
       cessed 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 autho-
       rization attribute is by default enabled for all users. It can be  dis-
       abled 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 sub-
                        mit.cf rather than sendmail.cf even  if   the   opera-
                        tion  mode  does  not indicate an initial mail submis-
                        sion.  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
       /etc/security/prof_attr    local   source   for    execution    profile
                                  attributes


       /var/spool/mqueue          default server queue


       /var/spool/clientmqueue    client queue


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:




       +-----------------------------+------------------------------+
       |      ATTRIBUTE TYPE         |       ATTRIBUTE VALUE        |
       +-----------------------------+------------------------------+
       |Availability                 |service/network/smtp/sendmail |
       +-----------------------------+------------------------------+

SEE ALSO
       prof_attr(5), attributes(7), sendmail(8)



Solaris 11.4                      8 Mar 2016                          mailq(1)