unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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(4).

OPTIONS
       The following options are supported:

       -Ac             Like  sendmail(1M),  this  flag tells mailq to use sub-
                       mit.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/client-
                       mqueue  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(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWsndmu


SEE ALSO
       sendmail(1M), prof_attr(4), attributes(5)



SunOS 5.10                        10 Jul 2002                         mailq(1)