Merge branch 'vendor/OPENSSL'
[dragonfly.git] / contrib / sendmail-8.14 / sendmail / mailq.0
1 MAILQ(1)                                                              MAILQ(1)
2
3
4
5 N\bNA\bAM\bME\bE
6        mailq - print the mail queue
7
8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
9        m\bma\bai\bil\blq\bq [-\b-A\bAc\bc] [-\b-q\bq.\b..\b..\b.]  [-\b-v\bv]
10
11 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
12        M\bMa\bai\bil\blq\bq prints 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  *\b*  to
21        indicate the job is being processed; X\bX to indicate that the load is too
22        high to process the job; and -\b- to indicate that the job is too young to
23        process.  The following lines show message recipients, one per line.
24
25        M\bMa\bai\bil\blq\bq is identical to ``sendmail -bp''.
26
27        The relevant options are as follows:
28
29        -\b-A\bAc\bc    Show  the mail submission queue specified in _\b/_\be_\bt_\bc_\b/_\bm_\ba_\bi_\bl_\b/_\bs_\bu_\bb_\bm_\bi_\bt_\b._\bc_\bf
30               instead of the MTA queue specified in _\b/_\be_\bt_\bc_\b/_\bm_\ba_\bi_\bl_\b/_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b._\bc_\bf.
31
32        -\b-q\bqL\bL    Show the "lost" items in the mail queue instead  of  the  normal
33               queue items.
34
35        -\b-q\bqQ\bQ    Show the quarantined items in the mail queue instead of the nor-
36               mal queue items.
37
38        -\b-q\bq[_\b!]I substr
39               Limit processed jobs to those containing _\bs_\bu_\bb_\bs_\bt_\br as  a  substring
40               of the queue id or not when _\b!  is specified.
41
42        -\b-q\bq[_\b!]Q substr
43               Limit  processed jobs to quarantined jobs containing _\bs_\bu_\bb_\bs_\bt_\br as a
44               substring of the quarantine reason or not when _\b!  is  specified.
45
46        -\b-q\bq[_\b!]R substr
47               Limit  processed  jobs to those containing _\bs_\bu_\bb_\bs_\bt_\br as a substring
48               of one of the recipients or not when _\b!  is specified.
49
50        -\b-q\bq[_\b!]S substr
51               Limit processed jobs to those containing _\bs_\bu_\bb_\bs_\bt_\br as  a  substring
52               of the sender or not when _\b!  is specified.
53
54        -\b-v\bv     Print  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 m\bma\bai\bil\blq\bq util-
65        ity: The number of items printed  per  queue  group  is  restricted  by
66        M\bMa\bax\bxQ\bQu\bue\beu\bue\beR\bRu\bun\bnS\bSi\biz\bze\be  if  that  value is set.  The status character *\b* is not
67        printed for some values of Q\bQu\bue\beu\bue\beS\bSo\bor\brt\btO\bOr\brd\bde\ber\br,\b, e.g., filename, random, mod-
68        ification,  and none, unless a -\b-q\bq option is used to limit the processed
69        jobs.
70
71        The m\bma\bai\bil\blq\bq utility exits 0 on success, and >0 if an error occurs.
72
73 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
74        sendmail(8)
75
76 H\bHI\bIS\bST\bTO\bOR\bRY\bY
77        The m\bma\bai\bil\blq\bq command appeared in 4.0BSD.
78
79
80
81                          $Date: 2007/03/22 18:21:27 $                 MAILQ(1)