Seth Woolley's Man Viewer

mailq(1) - mailq - print the mail queue - man 1 mailq

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

MAILQ(1)                                                              MAILQ(1)



NAME
       mailq - print the mail(1,8) queue(1,3)

SYNOPSIS
       mailq [-Ac] [-q...]  [-v]

DESCRIPTION
       Mailq prints a summary of the mail(1,8) messages queued for future delivery.

       The first line printed for each message shows the  internal  identifier
       used on this host(1,5) for the message with a possible status character, the
       size of the message in(1,8)  bytes,  the  date  and  time(1,2,n)  the  message  was
       accepted  into  the queue(1,3), and the envelope sender of the message.  The
       second line shows the error(8,n) message that  caused  this  message  to  be
       retained  in(1,8)  the queue(1,3); it will not be present if(3,n) the message is being
       processed for the first time.  The status characters are  either  *  to
       indicate the job is being processed; X to indicate that the load(7,n) is too
       high to process the job; and - to indicate that the job is too young to
       process.  The following lines show message recipients, one per line.

       Mailq is identical to ``sendmail(1,8) -bp''.

       The relevant options are as follows:

       -Ac    Show  the mail(1,8) submission queue(1,3) specified in(1,8) /etc/mail(1,8)/submit.cf
              instead of the MTA queue(1,3) specified in(1,8) /etc/mail(1,8)/sendmail.cf.

       -qL    Show the "lost" items in(1,8) the mail(1,8) queue(1,3) instead  of  the  normal
              queue(1,3) items.

       -qQ    Show the quarantined items in(1,8) the mail(1,8) queue(1,3) instead of the nor-
              mal queue(1,3) items.

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

       -q[!]Q substr
              Limit  processed jobs to quarantined jobs containing substr as a
              substring of the quarantine reason or not when !  is  specified.

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

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

       -v     Print  verbose  information.  This adds the priority of the mes-
              sage and a single character indicator (``+'' or blank)  indicat-
              ing whether a warning message has been sent on the first line of
              the message.  Additionally, extra lines may be  intermixed  with
              the  recipients indicating 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 expanded
              from, if(3,n) any.  Moreover, status messages for each recipient  are
              printed if(3,n) available.

       The mailq utility exits 0 on success, and >0 if(3,n) an error(8,n) occurs.

SEE ALSO
       sendmail(1,8)(8)

HISTORY
       The mailq command appeared in(1,8) 4.0BSD.



                         $Date: 2002/06/27 22:47:34 $                 MAILQ(1)

References for this manual (incoming links)