components/mail/sendmail/files/man/sendmail-mailq.1

   1 '\" te
   2 .\" Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved.
   3 .TH mailq 1 "8 Mar 2016" "SunOS 5.12" "User Commands"
   4 .SH NAME
   5 mailq \- print the mail queue
   6 .SH SYNOPSIS
   7 .LP
   8 .nf
   9 \fB/usr/bin/mailq\fR [\fB-Ac\fR] [\fB-q\fR \fIsubarg\fR] [\fB-v\fR]
  10 .fi
  11
  12 .SH DESCRIPTION
  13 .sp
  14 .LP
  15 The \fBmailq\fR utility displays a summary of the mail messages queued for future delivery.
  16 .sp
  17 .LP
  18 The first line displayed for each mail message shows the internal identifier 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 processed for the first time.
  19 .sp
  20 .LP
  21 The \fBmailq\fR utility used to be identical to \fBsendmail\fR \fB-bp\fR. Now it checks for the authorization attribute, \fBsolaris.mail.mailq\fR. If the check for the invoking user succeeds, \fBsendmail\fR \fB-bp\fR is executed with the remaining argument vector. Otherwise, an error message is printed. This authorization attribute is by default enabled for all users. It can be disabled by modifying the Basic Solaris User entry in \fBprof_attr\fR(5).
  22 .SH OPTIONS
  23 .sp
  24 .LP
  25 The following options are supported:
  26 .sp
  27 .ne 2
  28 .mk
  29 .na
  30 \fB\fB-Ac\fR\fR
  31 .ad
  32 .RS 17n
  33 .rt
  34 Like \fBsendmail\fR(8), this flag tells \fBmailq\fR to use \fBsubmit.cf\fR rather than \fBsendmail.cf\fR even  if  the  operation  mode  does  not indicate an initial mail submission. This will result in the client queue \fB/var/spool/clientmqueue\fR being displayed rather than the default server queue \fB/var/spool/mqueue\fR.
  35 .RE
  36
  37 .sp
  38 .ne 2
  39 .mk
  40 .na
  41 \fB\fB-q\fR\fBp\fR[\fItime\fR] \fR
  42 .ad
  43 .RS 17n
  44 .rt
  45 Similar to \fB-q\fR\fItime\fR, except that instead of periodically forking a child to process the queue, \fBsendmail\fR 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 \fB1\fR second. The process will always sleep at least 5 seconds if the queue was empty in the previous queue run.
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .mk
  51 .na
  52 \fB\fB-q\fR\fBf\fR\fR
  53 .ad
  54 .RS 17n
  55 .rt
  56 Processes saved  messages in the queue once and does not \fBfork()\fR, but runs in the foreground.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .mk
  62 .na
  63 \fB\fB-q\fR\fBG\fR \fIname\fR\fR
  64 .ad
  65 .RS 17n
  66 .rt
  67 Processes jobs in the queue group called \fIname\fR only.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .mk
  73 .na
  74 \fB\fB-q\fR[\fB!\fR]\fBI\fR \fIsubstr\fR\fR
  75 .ad
  76 .RS 17n
  77 .rt
  78 Limits processed jobs to those containing \fIsubstr\fR as a substring of the queue id, or not when \fB!\fR is specified.
  79 .RE
  80
  81 .sp
  82 .ne 2
  83 .mk
  84 .na
  85 \fB\fB-q\fR[\fB!\fR]\fBR\fR \fIsubstr\fR\fR
  86 .ad
  87 .RS 17n
  88 .rt
  89 Limits processed jobs to those containing \fIsubstr\fR as a substring of one of the recipients, or not when \fB!\fR is specified.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .mk
  95 .na
  96 \fB\fB-q\fR[\fB!\fR]\fBS\fR \fIsubstr\fR\fR
  97 .ad
  98 .RS 17n
  99 .rt
 100 Limits processed jobs to those containing \fIsubstr\fR as a substring of the sender, or not when \fB!\fR is specified.
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .mk
 106 .na
 107 \fB\fB-v\fR \fR
 108 .ad
 109 .RS 17n
 110 .rt
 111 Prints verbose information. This adds the priority of the message and a single character indicator (\fB+\fR 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.
 112 .RE
 113
 114 .SH EXIT STATUS
 115 .sp
 116 .ne 2
 117 .mk
 118 .na
 119 \fB\fB0\fR \fR
 120 .ad
 121 .RS 7n
 122 .rt
 123 Successful completion.
 124 .RE
 125
 126 .sp
 127 .ne 2
 128 .mk
 129 .na
 130 \fB\fB>0\fR \fR
 131 .ad
 132 .RS 7n
 133 .rt
 134 An error occurred.
 135 .RE
 136
 137 .SH FILES
 138 .sp
 139 .ne 2
 140 .mk
 141 .na
 142 \fB\fB/etc/security/prof_attr\fR\fR
 143 .ad
 144 .RS 27n
 145 .rt
 146 local source for execution profile attributes
 147 .RE
 148
 149 .sp
 150 .ne 2
 151 .mk
 152 .na
 153 \fB\fB/var/spool/mqueue\fR\fR
 154 .ad
 155 .RS 27n
 156 .rt
 157 default server queue
 158 .RE
 159
 160 .sp
 161 .ne 2
 162 .mk
 163 .na
 164 \fB\fB/var/spool/clientmqueue\fR\fR
 165 .ad
 166 .RS 27n
 167 .rt
 168 client queue
 169 .RE
 170
 171 .SH ATTRIBUTES
 172 .sp
 173 .LP
 174 See \fBattributes\fR(7) for descriptions of the following attributes:
 175 .sp
 176
 177 .sp
 178 .TS
 179 tab(\a) box;
 180 cw(2.75i) |cw(2.75i)
 181 lw(2.75i) |lw(2.75i)
 182 .
 183 ATTRIBUTE TYPE\aATTRIBUTE VALUE
 184 _
 185 Availability\aservice/network/smtp/sendmail
 186 .TE
 187
 188 .SH SEE ALSO
 189 .sp
 190 .LP
 191 \fBprof_attr\fR(5), \fBattributes\fR(7), \fBsendmail\fR(8)