.TH CQUEUE 1L \" \" mmuegel \" /usr/local/ustart/src/mail-tools/dist/foo/man/cqueue.1,v 1.1 1993/07/28 08:08:25 mmuegel Exp \" .ds mp \fBcqueue\fR .de IB .IP \(bu 2 .. .SH NAME \*(mp - check sendmail queue for problems .SH SYNOPSIS .IP \*(mp 7 [ \fB-abdms\fR ] [ \fB-q\fR \fIqueue-dir\fI ] [ \fB-t\fR \fItime\fR ] [ \fB-u\fR \fIusers\fR ] [ \fB-w\fR \fIwidth\fR ] .SH DESCRIPTION Reports on problems in the sendmail queue. With no options this simply means listing messages that have been in the queue longer than a default period along with a summary of queue mail by host and status message. .SH OPTIONS .IP \fB-a\fR 14 Report on all messages in the queue. This is equivalent to saying \fB-t\fR 0s. You may like this command so much that you use it as a replacement for \fBmqueue\fR. For example: .sp 1 .RS .RS \fBalias mqueue cqueue -a\fR .RE .RE .IP \fB-b\fR 14 Also report on bogus queue files. Those are files that have data files and no control files or vice versa. .IP \fB-d\fR Print a detailed report of mail messages that have been queued longer than the specified or default time. Information that is presented includes: .RS .RS .IB Sendmail queue identifier. .IB Date the message was first queued. .IB Sender of the message. .IB One or more recipients of the message. .IB An optional status of the message. This usually indicates why the message has not been delivered. .RE .RE .IP \fB-m\fR 14 Mail off the results if any problems were found. Normaly results are printed to stdout. If this option is specified they are mailed to one or more users. Results are not printed to stdout in this case. Results are \fBonly\fR mailed if \*(mp found something wrong. .IP "\fB-q\fR \fIqueue-dir\fI" The sendmail mail queue directory. Default is \fB/usr/spool/mqueue\fR or some other site configured value. .IP "\fB-t\fR \fItime\fR" List messages that have been in the queue longer than \fItime\fR. Time should of the form: .sp 1 .RS .RS ((s|m|h|d))+ .sp 1 .RE .RE .RS 14 The second portion of the above definition specifies seconds, minutes, hours, or days, respectfully. The first portion is the number of those units. There can be any number of such specifiers. As an example, 1h30m means 1 hour and 30 minutes. .sp 1 The default is 2 hours. .RE .IP \fB-s\fR 14 Print a summary of messages that have been queued longer than the specified or default time. Two separate types of summaries are printed. The first summarizes the queue messages by destination host. The host name is gleaned from the recipient addresses for each message. Thus the actual host names for this summary should be taken with a grain of salt since ruleset 0 has not been applied to the address the host was taken from nor were MX records consulted. It would be possible to add this; however, the execution time of the script would increase dramatically. The second summary is by status message. .IP "\fB-u\fR \fIusers\fR" Specify list of users to send a mail report to other than the invoker. This option is only valid when \fB-m\fR has been specified. Multiple recipients may be separated by spaces. .IP "\fB-w\fR \fIwidth\fR" Specify the page width to which the output should tailored. \fIwidth\fR should be an integer representing some character position. The default is 80 or some other site configured value. Output is folded neatly to match \fIwidth\fR. .SH EXAMPLES .nf % \fBdate\fR Tue Jan 19 12:07:20 CST 1993 % \fBcqueue -t 21h45m -w 70\fR Summary of messages in queue longer than 21:45:00 by destination host: Number of Messages Destination Host --------- ---------------- 2 cigseg.rtsg.mot.com 1 mnesouth.corp.mot.com --------- 3 Summary of messages in queue longer than 21:45:00 by status message: Number of Messages Status Message --------- -------------- 1 Deferred: Connection refused by mnesouth.corp.mot.com 2 Deferred: Host Name Lookup Failure --------- 3 Detail of messages in queue longer than 21:45:00 sorted by creation date: ID: AA20573 Date: 02:09:27 PM 01/18/93 Sender: melrose-place-owner@ferkel.ucsb.edu Recipient: pbaker@cigseg.rtsg.mot.com Status: Deferred: Host Name Lookup Failure ID: AA20757 Date: 02:11:30 PM 01/18/93 Sender: 90210-owner@ferkel.ucsb.edu Recipient: pbaker@cigseg.rtsg.mot.com Status: Deferred: Host Name Lookup Failure ID: AA21110 Date: 02:17:01 PM 01/18/93 Sender: rd_lap_wg@mdd.comm.mot.com Recipient: jim_mathis@mnesouth.corp.mot.com Status: Deferred: Connection refused by mnesouth.corp.mot.com .fi .SH AUTHOR .nf Michael S. Muegel (mmuegel@mot.com) UNIX Applications Startup Group Corporate Information Office, Schaumburg, IL Motorola, Inc. .fi .SH COPYRIGHT NOTICE Copyright 1993, Motorola, Inc. .sp 1 Permission to use, copy, modify and distribute without charge this software, documentation, etc. is granted, provided that this comment and the author's name is retained. The author nor Motorola assume any responsibility for problems resulting from the use of this software. .SH SEE ALSO .nf \fBsendmail(8)\fR \fISendmail Installation and Operation Guide\fR. .fi