.\" You may copy, distribute and modify under the terms of the LDP General
.\" Public License as specified in the LICENSE file that comes with the
.\" gnumaniak distribution
.\"
.\" The author kindly requests that no comments regarding the "better"
.\" suitability or up-to-date notices of any info documentation alternative
.\" is added without contacting him first.
.\"
.\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
.\"
.\"	GNU tail man page
.\"	man pages are NOT obsolete!
.\"	<ragnar@ragnar-hojland.com>
.\"
.\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
.\" Translated Sun 12 Mar 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified Sat Jan 24 21:07:42 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.\"WORD:	inode		i-ノード
.\"
.TH TAIL 1 "7 October 2002" "GNU textutils 2.1"
.SH 名前
tail \- ファイルの末尾の部分を表示する
.SH 書式
.B tail
[<\fB\-\fR|\fB+\fR>\fICOUNTOPTIONS\fR] [\fB\-fqvF\fR] [\fB\-c \fIBYTES\fR]
[\fB\-n \fILINES\fR] [\fB\-\-follow\fR] [\fB\-\-bytes=\fIBYTES\fR]
[\fB\-\-lines=\fILINES\fR]
[\fB\-\-follow\fR[\fB=\fIHOW\fR]]
[\fB\-\-max\-consecutive\-size\-changes=\fINUMBER\fR]
[\fB\-\-max\-unchanged\-stats=\fINUMBER\fR]
[\fB\-\-pid=\fIPID\fR]
[\fB\-\-retry\fR]
[\fB\-\-sleep\-interval=\fISECS\fR]
.RB [ \-\-quiet "] [" \-\-silent "] [" \-\-verbose ]
.RI [ FILE... ]

.BR tail " [" \-\-help "] [" \-\-version ]
.SH 説明
.B tail
は引数に与えられた
.I FILE
それぞれの末尾の部分 (デフォルトでは 10 行) を表示する。
.I FILE
が 1 つも与えられないと標準入力から読み込む。また
.I FILE
が
.RB ` \- '
だった場合には、そのファイルには標準入力が用いられる。

2 つ以上の
.I FILE
が指定されると、
.B tail
は以下のような 1 行のヘッダを各出力
.I FILE
の前に表示する:
.sp
.nf
     ==> \fIFILENAME\fR <==
.fi
.\"nakano: commented next .sp because of the trailing blank line.
.\".sp

.B tail
は 2 つのオプション形式を受付ける。新しい形式は、
数値をオプションの引数として与える (`\fB\-n 1\fP') ものであり、
古い形式はあらゆる文字オプションの前に数値を指定する
(`\fB\-1\fP' や `\fB+1\fR') ものである。

オプション引数に数値 \fIN\fR が `\fB+\fR' を前置して指定された場合は、
.B tail
は各ファイルの先頭から \fIN\fR 番目の項目以降を表示する。
通常の動作では末尾から数える。
この構文は推奨されない。

.I FILE
が切り詰められた場合は、
.B tail
はファイルが短くなったことを検知し、新たなファイル末尾に移動し、
そこから読み込みを始める。

.B tail
では出力の大きさの指定に制限が無い (GNU 版以外の
.B tail
にはそうでないものもある)。
また
.I \-r
オプション (逆順表示) は無い。
ファイルを逆順に表示するのは、
ファイルの末尾を表示するのとは本質的に異なるからである。
BSD 版
.B tail
(\fB\-r\fR オプションを持っている) はバッファ
(通常 32k) よりも小さいファイルを逆順表示できるに過ぎない。
この目的には GNU 版の
.B tac
コマンドを用いる方が、信頼性も融通性も高い。
.SH オプション
.TP
.B \fR<\fB-\fR|\fB+\fR>\fICOUNTOPTIONS
このオプションは最初に指定した場合に限って認識される。
.I COUNT
は 10 進数の数値。
単位を表す文字
.RB (` b "', `" k "', `" m ')
を後置したり (それぞれの意味は `\fB\-c\fP' のものと同じ)、
行単位のカウントを指定する `\fBl\fP' を後置したり、
他のオプション文字 (`\fBcqv\fR') を後置したりできる。
.\"nakano: 訳注 :-p
何も文字が後置されなかった場合は `\fBl\fP' が指定されたのと同じことになる。
短いオプション形式 \fB\-\fR と \fB+\fR は推奨されない。
.TP
.B \-c \fIBYTES\fB, \-\-bytes=\fIBYTES
行単位ではなく、末尾の
.I BYTES
バイトを表示する。
.RB ` b '
を追加すると \fIBYTES\fR の 512 倍、
.RB ` k '
は 1024 倍、
.RB ` m '
は 1048576 倍を指定したことになる。
.TP
.B \-f, \-\-follow\fR[\fB=\fIHOW\fR]
ファイルの内容がどんどん増え続けているものと仮定し、
ファイルの最終部分の文字を読み続けようと無限にループする。
パイプから読み込んでいる場合は無視される。
2 つ以上のファイルが指定された場合は、
.B tail
は異なったファイルの追加分を受け付けるごとにヘッダを表示し、
出力がどのファイルに由来するものかがわかるようにする。
ファイルの追跡方法を指定することもできる。
.RS
.TP
.B descriptor
ファイル末尾の追跡を、ファイルが unlink されたり
rename されたりした後に行う。つまり永遠に行う。
.TP
.B name
ファイル末尾の追跡を、ファイルが remove された後に行う。
.B tail
は
.I FILE
が (unlink や rename によって) もう存在しないことを確認すると、
もう一度オープンしようと試みる。
.RE
.TP
.B \-n \fILINES\fB, \-\-lines=\fILINES
末尾の
.I LINES
行を表示する。
.TP
.B \-q, \-\-quiet, \-\-silent
ファイル名のヘッダを出力しない。
.TP
.B \-v, \-\-verbose
常にファイル名のヘッダを出力する。
.TP
.B \-F
\fB\-\-follow=name \-\-retry と等価である。
.TP
.B \-\-max\-consecutive\-size\-changes=\fINUMBER
名前で追跡するとき、連続
.I NUMBER
回のサイズ変更が検知されるまで (rename や remove されても) 追跡する。
検知されたらファイル名がまだ以前と同じ「デバイス / i-ノード」
の組み合わせに対応しているかどうかを、
ファイルをオープンして fstat することによって調べる。デフォルトは 200。
.TP
.B \-\-max\-unchanged\-stats=\fINUMBER
名前で追跡するとき、
連続
.I NUMBER
回サイズが変わらなかったら、ファイル名がまだ以前と同じ「デバイス / i-ノード」
の組み合わせに対応しているかどうかを、
ファイルをオープンして fstat することによって調べる。デフォルトは 5。
.TP
.B \-\-pid=\fIPID
ファイルを追跡するとき、
.B tail
は pid が
.I PID
のプロセスが終了したら終了する。そのようなプロセスがなければ、
1 回分のループを行って終了する。
.TP
.B \-\-retry
.B tail
がファイルを名前で追跡していて、ファイルがなくなったことを検知したら、
再オープンを成功するまで繰り返す。
このオプションを指定しなければ、
.\"nakano: だと思うんだけど... > otherwise
.B tail
は単にファイルが存在しないことを報告して以降のチェックを行わない。
.TP
.B \-\-sleep\-interval=\fISECS\fR
追跡しているファイルのチェックを
.I SECS
秒ごとに行う (デフォルトは 1 秒)。
.TP
.B "\-\-help"
標準出力に使用方法のメッセージを出力して正常終了する。
.TP
.B "\-\-version"
標準出力にバージョン情報を出力して正常終了する。
.SH 注意
プログラムのバグについては bug-textutils@gnu.org に報告してください。
.br
man ページは Ragnar Hojland Espinosa
<ragnar@ragnar-hojland.com> が作成しました。