Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / sendmail / draft / man8 / qtool.8

.\" Copyright (c) 1999 Sendmail, Inc. and its suppliers.
.\"      All rights reserved.
.\"
.\" By using this file, you agree to the terms and conditions set
.\" forth in the LICENSE file which can be found at the top level of
.\" the sendmail distribution.
.\"
.\"
.\"     $Id: qtool.8,v 8.9.16.2 2000/12/15 19:50:41 gshapiro Exp $
.\"
.\" Japanese Version Copyright (c) 2000-2002 Yuichi SATO
.\"         all rights reserved.
.\" Translated Tue Nov 14 20:51:09 JST 2000
.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\" Updated and Modified Thu Feb 15 03:19:13 JST 2001 by Yuichi SATO 
.\" Updated and Modified Mon Jan 14 17:58:43 JST 2002
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\"
.TH QTOOL 8 "$Date: 2000/12/15 19:50:41 $"
.\"O .SH NAME
.SH ̾Á°
qtool
.\"O \- manipulate sendmail queues
\- sendmail ¤Î¥­¥å¡¼¤òÁàºî¤¹¤ë
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.B qtool.pl
.RB [options] 
target_directory source [source ...]
.PP
.B qtool.pl [-d|-b]
.RB [options]
source [source ...]
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O .B Qtool
.\"O moves the queue files used by sendmail between queues. It uses the same
.\"O locking mechanism as sendmail so can be safely used while sendmail is
.\"O running.
.B qtool
¤Ï sendmail ¤¬»ÈÍѤ¹¤ë¥­¥å¡¼¥Õ¥¡¥¤¥ë¤ò¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê´Ö¤Ç°ÜÆ°¤¹¤ë¡£
sendmail ¤ÈƱ¤¸¥í¥Ã¥¯µ¡¹½¤ò»È¤¦¤Î¤Ç¡¢
sendmail ¤¬²ÔƯ¤·¤Æ¤¤¤ë´Ö¤â°ÂÁ´¤Ë»ÈÍѤǤ­¤ë¡£
.PP
.\"O With no options,
.\"O .B qtool
.\"O will move any queue files as specified by \fIsource\fP into 
.\"O \fItarget_directory\fP. \fISource\fP can be either an individual 
.\"O queue control file, a queue file id, or a queue directory.
¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
.B qtool
¤Ï \fIsource\fP ¤Ç»ØÄꤵ¤ì¤¿Á´¤Æ¤Î¥­¥å¡¼¥Õ¥¡¥¤¥ë¤ò
¥Ç¥£¥ì¥¯¥È¥ê \fItarget_directory\fP ¤Ë°ÜÆ°¤¹¤ë¡£
\fIsource\fP ¤Ï¡¢¥­¥å¡¼À©¸æ¥Õ¥¡¥¤¥ë¡¦¥­¥å¡¼¥Õ¥¡¥¤¥ë¤Î ID¡¦
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê¤Î¤É¤ì¤Ç¤â¤è¤¤¡£
.PP
.\"O If the -d option is specified, qtool will delete the messages specified by
.\"O source instead of moving them.
-d ¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¡¢qtool ¤Ï source ¤Ç»ØÄꤵ¤ì¤¿¥á¥Ã¥»¡¼¥¸¤ò
°ÜÆ°¤Ç¤Ï¤Ê¤¯ºï½ü¤¹¤ë¡£
.PP
.\"O If the -b option is specified, the selected messages will be bounced by
.\"O running sendmail with the -OTimeout.queuereturn=now option.
-b ¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤¿¾ì¹ç¡¢ÁªÂò¤µ¤ì¤¿¥á¥Ã¥»¡¼¥¸¤Ï
-OTimeout.queuereturn=now ¥ª¥×¥·¥ç¥ó¤ò¤Ä¤±¤¿ sendmail ¤ò¼Â¹Ô¤¹¤ë¤³¤È¤Ë¤è¤ê
¥Ð¥¦¥ó¥¹¤µ¤ì¤ë (Á÷¿®¼Ô¤ËÁ÷¤êÊÖ¤µ¤ì¤ë)¡£ 
.\"O .SS Options
.SS ¥ª¥×¥·¥ç¥ó
.TP  
\fB\-b\fP
.\"O Bounce all of the messages specified by source. The messages will be bounced
.\"O immediately. No attempt will be made to deliver the messages.
source ¤Ç»ØÄꤵ¤ì¤¿Á´¤Æ¤Î¥á¥Ã¥»¡¼¥¸¤ò¥Ð¥¦¥ó¥¹¤¹¤ë¡£
¥á¥Ã¥»¡¼¥¸¤Ï¤¹¤°¤Ë¥Ð¥¦¥ó¥¹¤µ¤ì¤ë¡£
¥á¥Ã¥»¡¼¥¸¤ÎÇÛÁ÷¤ò»î¤ß¤Ê¤¤¡£
.TP  
\fB\-C\fP configfile
.\"O Specify the sendmail config file.
.\"O Defaults to /etc/mail/sendmail.cf.
sendmail ¤ÎÀßÄê¥Õ¥¡¥¤¥ë¤ò»ØÄꤹ¤ë¡£
¥Ç¥Õ¥©¥ë¥È¤Ï /etc/mail/sendmail.cf ¤Ç¤¢¤ë¡£
.TP
\fB\-d\fP
.\"O Delete all of the messages specified by source.
source ¤Ç»ØÄꤵ¤ì¤¿Á´¤Æ¤Î¥á¥Ã¥»¡¼¥¸¤òºï½ü¤¹¤ë¡£
.TP  
\fB\-e\fP \fIperl_expression\fP
.\"O Evalute \fIperl_expression\fP for each queue file as specified 
.\"O by \fIsource\fP. If \fIperl_expression\fP evaluates to true, then that 
.\"O queue file is moved. See below for more detail on \fIperl_expression\fP.
\fIsource\fP ¤Ç»ØÄꤵ¤ì¤¿¥­¥å¡¼¥Õ¥¡¥¤¥ë¤Ë¤Ä¤¤¤Æ¡¢
\fIperl_expression\fP ¤òɾ²Á¤¹¤ë¡£
\fIperl_expression\fP ¤¬¿¿¤Èɾ²Á¤µ¤ì¤¿¾ì¹ç¡¢¤½¤Î¥­¥å¡¼¥Õ¥¡¥¤¥ë¤Ï°ÜÆ°¤µ¤ì¤ë¡£
\fIperl_expression\fP ¤Î¾ÜºÙ¤Ë¤Ä¤¤¤Æ¤Ï¡¢²¼µ­¤ò»²¾È¤¹¤ë¤³¤È¡£
.TP 
\fB\-s\fP \fIseconds\fP
.\"O Move only the queue files specified by \fIsource\fP that have a
.\"O modification time older than \fIseconds\fP.
\fIsource\fP ¤Ç»ØÄꤵ¤ì¤¿¥­¥å¡¼¥Õ¥¡¥¤¥ë¤Î¤¦¤Á
½¤Àµ»þ¹ï¤¬ \fIseconds\fP Éäè¤êÁ°¤Î¤â¤Î¤À¤±¤ò°ÜÆ°¤¹¤ë¡£
.\"O .SS Perl Expressions
.SS Perl ɽ¸½
.\"O You can use any valid perl expression. Inside the expression you have
.\"O access to a hash that contains many of the fields in the control file as
.\"O well as some other data about that queued message. The hash is called
.\"O \fI%msg\fP. If a field has multiple values (e.g. 'Recipient'), it will be
.\"O returned as an array, otherwise it will be returned as a scalar. Through
.\"O \fI%msg\fP, you can access the following variables:
¤³¤Î¥×¥í¥°¥é¥à¤Ç¤Ï Perl ɽ¸½¤ò»È¤¦¤³¤È¤¬¤Ç¤­¤ë¡£
Perl ɽ¸½¤ÎÃæ¤Ç¤Ï¡¢¥­¥å¡¼¤ËÆþ¤ì¤é¤ì¤¿¥á¥Ã¥»¡¼¥¸¤Î¥Ç¡¼¥¿¤À¤±¤Ç¤Ê¤¯¡¢
À©¸æ¥Õ¥¡¥¤¥ë¤Î¥Õ¥£¡¼¥ë¥É¤ÎÆâÍƤò´Þ¤à¥Ï¥Ã¥·¥å¤Ë¤â¥¢¥¯¥»¥¹¤Ç¤­¤ë¡£
¥Ï¥Ã¥·¥å¤Ï \fI%msg\fP ¤È¤¤¤¦Ì¾Á°¤Ç¤¢¤ë¡£
¥Õ¥£¡¼¥ë¥É¤ËÊ£¿ô¤ÎÃͤ¬¤¢¤ë ('Recipient' ¤Î¤è¤¦¤Ê) ¾ì¹ç¡¢
ÃͤÏÇÛÎó¤È¤·¤ÆÊÖ¤µ¤ì¤ë¡£
Ãͤ¬ 1 ¤Ä¤Î¾ì¹ç¡¢Ãͤϥ¹¥«¥é¡¼¤ÇÊÖ¤µ¤ì¤ë¡£
¥Ï¥Ã¥·¥å \fI%msg\fP ¤ò»È¤Ã¤Æ¡¢°Ê²¼¤ÎÃͤ˥¢¥¯¥»¥¹¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
.TP
\fBauth\fP
.\"O AUTH= parameter.
AUTH= ¥Ñ¥é¥á¡¼¥¿¡£
.TP
\fBbody_type\fP
.\"O Body type (\fB8BITMIME\fP, \fB7BIT\fP, or undefined).
¥Ü¥Ç¥£¥¿¥¤¥× (\fB8BITMIME\fP, \fB7BIT\fP, ¤Þ¤¿¤Ï̤ÄêµÁ)¡£
.TP
\fBbody_last_mod_time\fP
.\"O The last time the body was modified since the epoch in seconds.
¥Ü¥Ç¥£¤¬ºÇ¸å¤Ë½¤Àµ¤µ¤ì¤¿»þ¹ï¡£µª¸µÇ¯ (epoch) ¤«¤éÉÿô¤Çɽ¤¹¡£
.TP
\fBbody_size\fP
.\"O The size of the body file in bytes.
¥Ü¥Ç¥£¥Õ¥¡¥¤¥ë¤Î¥µ¥¤¥º (¥Ð¥¤¥Èñ°Ì)¡£
.TP
\fBcharset\fP
.\"O Character set (for future use).
ʸ»ú¥»¥Ã¥È (¾­Íè»ÈÍѤ¹¤ë¤¿¤á¤Ë¤¢¤ë)¡£
.TP
\fBcontent-length\fP
.\"O Content-Length: header value (Solaris sendmail only).
Content-Length: ¥Ø¥Ã¥À¡¼ÃÍ (Solaris ¤Î sendmail ¤Î¤ß)¡£
.TP
\fBcontrolling_user\fP
.\"O The controlling user.
À©¸æ¤·¤Æ¤¤¤ë¥æ¡¼¥¶¡¼¡£
.TP
\fBcontrol_last_mod_time\fP
.\"O The last time the body was modified since the epoch in seconds.
À©¸æ¥Õ¥¡¥¤¥ë¤¬ºÇ¸å¤Ë½¤Àµ¤µ¤ì¤¿»þ¹ï¡£µª¸µÇ¯ (epoch) ¤«¤éÉÿô¤Çɽ¤¹¡£
.TP
\fBcontrol_size\fP
.\"O The size of the control file in bytes.
À©¸æ¥Õ¥¡¥¤¥ë¤Î¥µ¥¤¥º (¥Ð¥¤¥Èñ°Ì)¡£
.TP
\fBcreation_time\fP
.\"O The time when the control file was created.
À©¸æ¥Õ¥¡¥¤¥ë¤¬À¸À®¤µ¤ì¤¿»þ¹ï¡£
.TP
\fBdata_file_name\fP
.\"O The data file name (deprecated).
¥Ç¡¼¥¿¥Õ¥¡¥¤¥ë̾ (»È¤ï¤Ê¤¤Êý¤¬Îɤ¤)¡£
.TP
\fBenvid\fP
.\"O Original envelope id form ESMTP.
ESMTP ¤ÇÁ÷¤é¤ì¤Æ¤­¤¿¥ª¥ê¥¸¥Ê¥ë¤Î¥¨¥ó¥Ù¥í¡¼¥×¤Î ID¡£
.TP
\fBerror_recipient\fP
.\"O The error recipient (deprecated).
¥¨¥é¡¼¤Î¾ì¹ç¤Î¼õ¿®¼Ô (»È¤ï¤Ê¤¤Êý¤¬Îɤ¤)¡£
.TP
\fBflags\fP
.\"O Array of characters that can be the following values:
°Ê²¼¤ÎÃͤò»ý¤Ä¤³¤È¤Ç¤­¤ëʸ»úÇÛÎó¡£
.PD 0
.RS +8
.TP 8
w
.\"O warning message has been sent
·Ù¹ð¥á¥Ã¥»¡¼¥¸¤¬Á÷¿®¤µ¤ì¤¿¡£
.TP 8
r
.\"O This is an error respone or DSN
¥¨¥é¡¼±þÅú¡¢¤Þ¤¿¤Ï DSN¡£
.TP 8
8
.\"O has 8 bit data in body
¥Ü¥Ç¥£¤Ë 8 ¥Ó¥Ã¥È¤Î¥Ç¡¼¥¿¤¬¤¢¤ë¡£
.TP 8
b
.\"O delete Bcc: headers
Bcc: ¥Ø¥Ã¥À¡¼¤òºï½ü¤¹¤ë¡£
.TP 8
d
.\"O envelope has DSN RET= parameter
¥¨¥ó¥Ù¥í¡¼¥×¤Ë DSN RET= ¥Ñ¥é¥á¡¼¥¿¤¬¤¢¤ë¡£
.TP 8
n
.\"O don't return body
¥Ü¥Ç¥£¤òÊÖ¤µ¤Ê¤¤¡£
.PD
.RE
.TP
\fBheaders\fP
.\"O This is a Perl hash where the keys are rfc822 field names and the values
.\"O are rfc822 field values. If a field has only one value it will be returned
.\"O as a string. If a field has more than one value (e.g. 'Received') it will
.\"O be returned as a list of strings.
¤³¤ì¤Ï Perl ¤Î¥Ï¥Ã¥·¥å¤Ç¡¢rfc822 ¥Õ¥£¡¼¥ë¥É̾¤ò¥­¡¼¡¢
rfc822 ¥Õ¥£¡¼¥ë¥ÉÃͤòÃͤˤ·¤Æ¤¤¤ë¡£
¥Õ¥£¡¼¥ë¥É¤Ë 1 ¤Ä¤·¤«Ãͤ¬¤Ê¤¤¾ì¹ç¡¢ÃͤÏʸ»úÎó¤È¤·¤ÆÊÖ¤µ¤ì¤ë¡£
('Received' ¤Î¤è¤¦¤Ë) ¥Õ¥£¡¼¥ë¥É¤Ë 2 ¤Ä°Ê¾å¤ÎÃͤ¬¤¢¤ë¾ì¹ç¡¢
ÃͤÏʸ»úÎó¤Î¥ê¥¹¥È¤È¤·¤ÆÊÖ¤µ¤ì¤ë¡£
.TP
\fBinode_number\fP
.\"O The inode number for the data (body) file.
¥Ç¡¼¥¿ (¥Ü¥Ç¥£) ¥Õ¥¡¥¤¥ë¤Î i ¥Î¡¼¥ÉÈֹ档
.TP
\fBnext_delivery_time\fP
.\"O Earliest time of next delivery attempt.
¼¡¤ÎÇÛÁ÷¤¬»î¤ß¤é¤ì¤ëºÇ¤âÁᤤ»þ¹ï¡£
.TP
\fBnum_delivery_attempts\fP
.\"O Number of delivery attempts that have been made.
ÇÛÁ÷¤ò»î¤ß¤¿²ó¿ô¡£
.TP
\fBmacro\fP
.\"O Defined macro.
ÄêµÁ¤µ¤ì¤¿¥Þ¥¯¥í¡£
.TP
\fBmessage\fP
.\"O Envelope status message.
¥¨¥ó¥Ù¥í¡¼¥×¾õÂ֤Υá¥Ã¥»¡¼¥¸¡£
.TP
\fBoriginal_recipient\fP
.\"O Original recipient (ORCPT= parameter).
ËÜÍè¤Î¼õ¿®¼Ô (ORCPT= ¥Ñ¥é¥á¡¼¥¿)¡£
.TP
\fBpriority\fP
.\"O Adjusted priority of message.
Êѹ¹¤µ¤ì¤¿¥á¥Ã¥»¡¼¥¸¤ÎÍ¥ÀèÅÙ¡£
.TP
\fBrecipient\fP
.\"O Array of character flags followed by colon and recipient name. Flags:
¥³¥í¥ó¤È¼õ¿®¼Ô̾¤¬¸å¤Ë³¤¯Ê¸»ú¥Õ¥é¥°¤ÎÇÛÎ󡣥ե饰¤ò°Ê²¼¤Ë¼¨¤¹¡£
.PD 0
.RS +8
.TP 8
N
.\"O Has NOTIFY= parameter.
NOTIFY= ¥Ñ¥é¥á¡¼¥¿¤¬¤¢¤ë¡£
.TP 8
S
.\"O Success DSN requested.
Í׵ᤷ¤¿ DSN ¤¬À®¸ù¤·¤¿¡£
.TP 8
F
.\"O Failure DSN requested.
Í׵ᤷ¤¿ DSN ¤¬¼ºÇÔ¤·¤¿¡£
.TP 8
D
.\"O Delay DSN requested.
Í׵ᤷ¤¿ DSN ¤¬ÃÙ¤ì¤Æ¤¤¤ë¡£
.TP 8
P
.\"O Primary address (not the result of alias/forward expansion).
(alias ¤Þ¤¿¤Ï forward ¤ÇŸ³«¤µ¤ì¤ëÁ°¤Î) ¸µ¡¹¤Î¥¢¥É¥ì¥¹¡£
.PD
.RE
.TP
\fBsender\fP
.\"O Sender
Á÷¿®¼Ô¡£
.TP
\fBversion\fP
.\"O Version of control file.
À©¸æ¥Õ¥¡¥¤¥ë¤Î¥Ð¡¼¥¸¥ç¥ó¡£
.\"O .SH EXAMPLES
.SH Îã
.TP
\fBqtool.pl q2 q1\fP
.\"O Moves all of the queue files in queue q1 to queue q2.
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q1 ¤Ë¤¢¤ë¥­¥å¡¼¥Õ¥¡¥¤¥ë¤ò
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q2 ¤Ë°ÜÆ°¤¹¤ë¡£
.TP
\fBqtool.pl q2 q1/d6CLQh100847\fP
.\"O Moves the message with id d6CLQh100847 in queue q1 to queue q2.
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q1 ¤Ë¤¢¤ë ID ¤¬ d6CLQh100847 ¤Î¥á¥Ã¥»¡¼¥¸¤ò
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q2 ¤Ë°ÜÆ°¤¹¤ë¡£
.TP
\fBqtool.pl q2 q1/qfd6CLQh100847\fP
.\"O Moves the message with id d6CLQh100847 in queue q1 to queue q2.
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q1 ¤Ë¤¢¤ë ID ¤¬ d6CLQh100847 ¤Î¥á¥Ã¥»¡¼¥¸¤ò
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q2 ¤Ë°ÜÆ°¤¹¤ë¡£
.TP
\fBqtool.pl -e '$msg{num_delivery_attempts} == 3' /q2 /q1\fP
.\"O Moves all of the queue files that have had three attempted deliveries from
.\"O queue q1 to queue q2.
º£¤Þ¤Ç¤Ë 3 ²óÇÛÁ÷¤¬»î¤ß¤é¤ì¤¿Á´¤Æ¤Î¥­¥å¡¼¥Õ¥¡¥¤¥ë¤ò
¥­¥å¡¼¥Ç¥£¥ì¥¯¥È¥ê q1 ¤«¤é q2 ¤Ë°ÜÆ°¤¹¤ë¡£
.\"O .SH BUGS
.SH ¥Ð¥°
.\"O In sendmail 8.12, it is possible for a message's qf and df files
.\"O to be stored in different queues.
.\"O In this situation, you must give qtool the pathname of the qf file,
.\"O not of the df file.
.\"O To be safe, never feed qtool the pathname of a df file.
sendmail 8.12 ¤Ç¤Ï¡¢¥á¥Ã¥»¡¼¥¸¤Î qf ¥Õ¥¡¥¤¥ë¤È df ¥Õ¥¡¥¤¥ë¤ò
ÊÌ¡¹¤Î¥­¥å¡¼¤Ë³ÊǼ¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
¤³¤Î¾ì¹ç¡¢qtool ¤Ë¤Ï df ¥Õ¥¡¥¤¥ë¤Î¥Ñ¥¹Ì¾¤Ç¤Ï¤Ê¤¯¡¢
qf ¥Õ¥¡¥¤¥ë¤Î¥Ñ¥¹Ì¾¤ò»ØÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
°ÂÁ´¤Î¤¿¤á¡¢ÀäÂÐ¤Ë qtool ¤Ë df ¥Õ¥¡¥¤¥ë¤Î¥Ñ¥¹Ì¾¤ò»ØÄꤷ¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
.\"O .SH SEE ALSO
.SH ´ØÏ¢¹àÌÜ
sendmail(8)
.\"O .SH HISTORY
.SH ÍúÎò
.\"O The
.\"O .B qtool
.\"O command appeared in 
.\"O sendmail 8.10.
.B qtool
¥³¥Þ¥ó¥É¤Ï
sendmail 8.10
¤ÇÅо줷¤¿¡£