diff options
Diffstat (limited to 'contrib/sendmail/contrib/qtool.8')
-rw-r--r-- | contrib/sendmail/contrib/qtool.8 | 66 |
1 files changed, 45 insertions, 21 deletions
diff --git a/contrib/sendmail/contrib/qtool.8 b/contrib/sendmail/contrib/qtool.8 index 1106d07..5c40142 100644 --- a/contrib/sendmail/contrib/qtool.8 +++ b/contrib/sendmail/contrib/qtool.8 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1999 Sendmail, Inc. and its suppliers. +.\" Copyright (c) 1999, 2001 Sendmail, Inc. and its suppliers. .\" All rights reserved. .\" .\" By using this file, you agree to the terms and conditions set @@ -6,18 +6,18 @@ .\" the sendmail distribution. .\" .\" -.\" $Id: qtool.8,v 8.9.16.2 2000/12/15 19:50:41 gshapiro Exp $ +.\" $Id: qtool.8,v 8.16 2001/11/21 19:21:20 gshapiro Exp $ .\" -.TH QTOOL 8 "$Date: 2000/12/15 19:50:41 $" +.TH QTOOL 8 "$Date: 2001/11/21 19:21:20 $" .SH NAME qtool \- manipulate sendmail queues .SH SYNOPSIS .B qtool.pl -.RB [options] +.RB [options] target_directory source [source ...] .PP -.B qtool.pl [-d/-b] +.B qtool.pl [-Q][-d|-b] .RB [options] source [source ...] .SH DESCRIPTION @@ -28,8 +28,8 @@ running. .PP With no options, .B qtool -will move any queue files as specified by \fIsource\fP into -\fItarget_directory\fP. \fISource\fP can be either an individual +will move any queue files as specified by \fIsource\fP into +\fItarget_directory\fP. \fISource\fP can be either an individual queue control file, a queue file id, or a queue directory. .PP If the -d option is specified, qtool will delete the messages specified by @@ -38,19 +38,27 @@ source instead of moving them. If the -b option is specified, the selected messages will be bounced by running sendmail with the -OTimeout.queuereturn=now option. .SS Options -.TP +.TP \fB\-b\fP Bounce all of the messages specified by source. The messages will be bounced immediately. No attempt will be made to deliver the messages. .TP +\fB\-C\fP configfile +Specify the sendmail config file. +Defaults to /etc/mail/sendmail.cf. +.TP \fB\-d\fP Delete all of the messages specified by source. -.TP +.TP \fB\-e\fP \fIperl_expression\fP -Evalute \fIperl_expression\fP for each queue file as specified -by \fIsource\fP. If \fIperl_expression\fP evaluates to true, then that +Evalute \fIperl_expression\fP for each queue file as specified +by \fIsource\fP. If \fIperl_expression\fP evaluates to true, then that queue file is moved. See below for more detail on \fIperl_expression\fP. -.TP +.TP +\fB\-Q\fP +Operate on quarantined items +(queue control file begins with hf instead of qf). +.TP \fB\-s\fP \fIseconds\fP Move only the queue files specified by \fIsource\fP that have a modification time older than \fIseconds\fP. @@ -74,9 +82,6 @@ The last time the body was modified since the epoch in seconds. \fBbody_size\fP The size of the body file in bytes. .TP -\fBcharset\fP -Character set (for future use). -.TP \fBcontent-length\fP Content-Length: header value (Solaris sendmail only). .TP @@ -84,7 +89,7 @@ Content-Length: header value (Solaris sendmail only). The controlling user. .TP \fBcontrol_last_mod_time\fP -The last time the body was modified since the epoch in seconds. +The last time the control file was modified since the epoch in seconds. .TP \fBcontrol_size\fP The size of the control file in bytes. @@ -92,15 +97,24 @@ The size of the control file in bytes. \fBcreation_time\fP The time when the control file was created. .TP +\fBcurrent_delay\fP +Current delay for queue delay algorithm if _FFR_QUEUEDELAY is enabled. +.TP \fBdata_file_name\fP The data file name (deprecated). .TP +\fBdeliver_by\fP +Deliver by flag and deadline for DELIVERBY ESMTP extension. +.TP \fBenvid\fP Original envelope id form ESMTP. .TP \fBerror_recipient\fP The error recipient (deprecated). .TP +\fBfinal_recipient\fP +Final recipient (for DSNs). +.TP \fBflags\fP Array of characters that can be the following values: .PD 0 @@ -110,7 +124,7 @@ w warning message has been sent .TP 8 r -This is an error respone or DSN +This is an error response or DSN .TP 8 8 has 8 bit data in body @@ -153,6 +167,13 @@ Original recipient (ORCPT= parameter). \fBpriority\fP Adjusted priority of message. .TP +\fBquarantine_reason\fP +Quarantine reason for quarantined (held) envelopes if _FFR_QUARANTINE is +enabled. +.TP +\fBqueue_delay\fP +Queue delay algorithm if _FFR_QUEUEDELAY is enabled. +.TP \fBrecipient\fP Array of character flags followed by colon and recipient name. Flags: .PD 0 @@ -191,16 +212,19 @@ Moves the message with id d6CLQh100847 in queue q1 to queue q2. \fBqtool.pl q2 q1/qfd6CLQh100847\fP Moves the message with id d6CLQh100847 in queue q1 to queue q2. .TP -\fBqtool.pl q2 q1/dfd6CLQh100847\fP -Moves the message with id d6CLQh100847 in queue q1 to queue q2. -.TP \fBqtool.pl -e '$msg{num_delivery_attempts} == 3' /q2 /q1\fP Moves all of the queue files that have had three attempted deliveries from queue q1 to queue q2. +.SH BUGS +In sendmail 8.12, it is possible for a message's queue and data files (df) +to be stored in different queues. +In this situation, you must give qtool the pathname of the queue file, +not of the data file (df). +To be safe, never feed qtool the pathname of a data file (df). .SH SEE ALSO sendmail(8) .SH HISTORY The .B qtool -command appeared in +command appeared in sendmail 8.10. |