src/mailq.0

   1 MAILQ(1)                                                              MAILQ(1)
   2
   3
   4
   5 \e[1mNAME\e[0m
   6        mailq - print the mail queue
   7
   8 \e[1mSYNOPSIS\e[0m
   9        \e[1mmailq \e[22m[\e[1m-Ac\e[22m] [\e[1m-q...\e[22m]  [\e[1m-v\e[22m]
  10
  11 \e[1mDESCRIPTION\e[0m
  12        \e[1mMailq \e[22mprints a summary of the mail messages queued for future delivery.
  13
  14        The first line printed for each message shows the  internal  identifier
  15        used on this host for the message with a possible status character, the
  16        size of the message in  bytes,  the  date  and  time  the  message  was
  17        accepted  into  the queue, and the envelope sender of the message.  The
  18        second line shows the error message that  caused  this  message  to  be
  19        retained  in  the queue; it will not be present if the message is being
  20        processed for the first time.  The status characters are  either  \e[1m*  \e[22mto
  21        indicate the job is being processed; \e[1mX \e[22mto indicate that the load is too
  22        high to process the job; and \e[1m- \e[22mto indicate that the job is too young to
  23        process.  The following lines show message recipients, one per line.
  24
  25        \e[1mMailq \e[22mis identical to ``sendmail -bp''.
  26
  27        The relevant options are as follows:
  28
  29        \e[1m-Ac    \e[22mShow  the mail submission queue specified in \e[4m/etc/mail/submit.cf\e[0m
  30               instead of the MTA queue specified in \e[4m/etc/mail/sendmail.cf\e[24m.
  31
  32        \e[1m-qL    \e[22mShow the "lost" items in the mail queue instead  of  the  normal
  33               queue items.
  34
  35        \e[1m-qQ    \e[22mShow the quarantined items in the mail queue instead of the nor-
  36               mal queue items.
  37
  38        \e[1m-q\e[22m[\e[4m!\e[24m]I substr
  39               Limit processed jobs to those containing \e[4msubstr\e[24m as  a  substring
  40               of the queue id or not when \e[4m!\e[24m  is specified.
  41
  42        \e[1m-q\e[22m[\e[4m!\e[24m]Q substr
  43               Limit  processed jobs to quarantined jobs containing \e[4msubstr\e[24m as a
  44               substring of the quarantine reason or not when \e[4m!\e[24m  is  specified.
  45
  46        \e[1m-q\e[22m[\e[4m!\e[24m]R substr
  47               Limit  processed  jobs to those containing \e[4msubstr\e[24m as a substring
  48               of one of the recipients or not when \e[4m!\e[24m  is specified.
  49
  50        \e[1m-q\e[22m[\e[4m!\e[24m]S substr
  51               Limit processed jobs to those containing \e[4msubstr\e[24m as  a  substring
  52               of the sender or not when \e[4m!\e[24m  is specified.
  53
  54        \e[1m-v     \e[22mPrint  verbose  information.  This adds the priority of the mes-
  55               sage and a single character indicator (``+'' or blank)  indicat-
  56               ing whether a warning message has been sent on the first line of
  57               the message.  Additionally, extra lines may be  intermixed  with
  58               the  recipients indicating the ``controlling user'' information;
  59               this shows who will own any programs that are executed on behalf
  60               of  this message and the name of the alias this command expanded
  61               from, if any.  Moreover, status messages for each recipient  are
  62               printed if available.
  63
  64        Several  sendmail.cf  options influence the behavior of the \e[1mmailq \e[22mutil-
  65        ity: The number of items printed  per  queue  group  is  restricted  by
  66        \e[1mMaxQueueRunSize  \e[22mif  that  value is set.  The status character \e[1m* \e[22mis not
  67        printed for some values of \e[1mQueueSortOrder, \e[22me.g., filename, random, mod-
  68        ification,  and none, unless a \e[1m-q \e[22moption is used to limit the processed
  69        jobs.
  70
  71        The \e[1mmailq \e[22mutility exits 0 on success, and >0 if an error occurs.
  72
  73 \e[1mSEE ALSO\e[0m
  74        sendmail(8)
  75
  76 \e[1mHISTORY\e[0m
  77        The \e[1mmailq \e[22mcommand appeared in 4.0BSD.
  78
  79
  80
  81                          $Date: 2013-11-22 20:51:55 $                 MAILQ(1)