Catch up to 3.0-19980827-SNAP and some fixes.

Submitted by:	Kazuo Horikawa <k-horik@yk.rim.or.jp>

1 files changed, 182 insertions, 168 deletions

diff --git a/ja_JP.eucJP/man/man1/tcpslice.1 b/ja_JP.eucJP/man/man1/tcpslice.1
index f017a570a8..699836e09c 100644
--- a/ja_JP.eucJP/man/man1/tcpslice.1
+++ b/ja_JP.eucJP/man/man1/tcpslice.1
@@ -20,235 +20,249 @@
 .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
 .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 .\"
-.TH TCPSLICE 1  "14 Oct 1991"
-.SH 名称
-tcpslice \- tcpdump ファイルの分割/結合
-.SH 書式
-.na
-.B tcpslice
-[
-.B \-dRrt
-] [
-.B \-w
-.I file
-]
-.br
-.ti +9
-[
-.I start-time
-[
-.I end-time
-] ]
-.I file ...
-.br
-.ad
-.SH 解説
-.LP
-.I tcpslice
+.Dd October 14, 1991
+.Dt TCPSLICE 1
+.Os
+.Sh 名称
+.Nm tcpslice
+.Nd tcpdump ファイルの切り出し/結合
+.Sh 書式
+.Nm tcpslice
+.Op Fl dRrt
+.Op Fl w Ar file
+.Op Ar start-time Op end-time
+.Ar
+.Sh 解説
+.Nm
 は、
-\fItcpdump(1)\fP
+.Xr tcpdump 1
 の
-.B \-w
+.Fl w
 フラグ
 を用いて作成されたパケットトレースファイルの一部を切り出すプログラムです。
 また、以下に示すように、複数のパケットトレースファイルを結合する事も
 できます。
-.LP
-.I tcpslice
-の基本機能は、入力となるファイルに含まれるパケットの時刻が与えられた範囲に
-あるものを
-.I stdout
-にコピーする事です。
+.Pp
+.Nm
+の基本機能は、入力ファイルに含まれるパケットのうち、指定された時間内の
+ものを
+.Pa stdout
+に出力する事です。
 開始時刻および終了時刻の範囲は、コマンド行で指定できます。範囲は指定した
-時刻自身を含みます。開始時刻のデフォルトは最初の入力ファイルの最初の
-パケットの時刻で、これを
-.I first time
-と呼びます。終了時刻のデフォルトは開始時刻の 10 年後です。
+時刻自身を含みます。デフォルトでは、開始時刻は最初の入力ファイルの一つ目の
+パケットの時刻です。この時刻を
+.Em first time
+と呼びます。デフォルトでは、終了時刻は開始時刻の 10 年後です。
 したがって、
-.I tcpslice trace-file
+.Nm
+.Ar trace-file
 というコマンドは単に
-.I trace-file
-を \fIstdout\fP にコピーします(ファイルには 10 年分のデータがない事を
+.Ar trace-file
+を
+.Pa stdout
+に出力します(ファイルには 10 年分のデータがない事を
 想定しています)。
-.LP
+.Pp
 時刻の指定にはいくつかの方法があります。ひとつは
-.I sssssssss.uuuuuu
-の形式の Unix 時刻形式を用いる方法です
-(これは、\fItcpdump\fP の
-.B \-tt
+.Em sssssssss.uuuuuu
+の形をとる Unix 時刻形式を用いる方法です
+(これは、
+.Xr tcpdump 1
+の
+.Fl tt
 フラグで指定される形式です)。
 例えば、
-.B 654321098.7654
+.Em 654321098.7654
 は、1990 年 9 月 25 日、午後 8 時 51 分 (PDT) から、
 38 秒と 765,400 マイクロ秒後の時刻を示します。
-.LP
+.Pp
 このマニュアルの例は全て PDT の時刻で示しますが、
 以下で示すように時刻を表示したり解釈したりする場合、
-.I tcpslice
-は、\fItcpdump\fP のファイルがどのタイムゾーンで生成されたかに関わらず、
+.Nm
+は、
+.Xr tcpdump 1
+のファイルがどのタイムゾーンで生成されたかに関わらず、
 ローカルのタイムゾーンを使用します。
 夏時間の設定は、対象となる日のローカルのタイムゾーンで適切な物が用いられます。
-例えば、夏季の期間の時刻は、夏時間の影響を反映し、冬季の期間の時刻は
+例えば、夏季の時刻には、夏時間の影響を反映し、冬季の時刻には
 影響しません。
-.LP
+.Pp
 時刻は
-秒数の前に `+' を付けて指定する事により、
-.I first time
-(開始時刻を指定する場合)
-や開始時刻(終了時刻を指定する場合)
-からの相対的な時刻として指定する事もできます。
+.Em first time
+から(開始時刻を指定する場合)、
+あるいは開始時刻から(終了時刻を指定する場合)
+の相対的な時刻として指定する事もできます。
+指定するには秒数の前に `+' を付けます。
 例えば、
-.B +200
-は
-.I first time
-から 200 秒後を示し、ふたつの引数
-.B +200 +300
+.Em +200
+は開始時刻が
+.Em first time
+から 200 秒後であることを示し、ふたつの引数
+.Em +200 +300
 は
-.I first time
+.Em first time
 から 200 秒後から、
-.I first time
-から 500 秒後までを示します。
-.LP
+.Em first time
+から 500 秒後までの範囲を示します。
+.Pp
 時刻は、年 (y)、月 (m)、日 (d)、時 (h)、分 (m)、秒 (s)、マイクロ秒 (u) で
-指定する事もできます。例えば、上記で示した Unix 時刻 654321098.7654 は、
-.B 90y9m25d20h51m38s765400u
+指定する事もできます。例えば、上記の Unix 時刻 654321098.7654 は、
+.Em 90y9m25d20h51m38s765400u
 と指定する事もできます。
-.LP
-この形式で時刻を指定した場合、省略されたフィールドのデフォルトは以下の様に
-なります。省略されたフィールドが最初に指定されたフィールドより
-.I 大きい
-単位ならば、そのデフォルト値は、
-.I first time
+.Pp
+この形式で時刻を指定した場合、省略されたフィールドのデフォルト値は以下
+のようになります。最初に指定されたフィールドより
+.Em 大きい
+単位の省略されたフィールドについてのデフォルト値は、
+.Em first time
 (開始時刻を指定する場合) または開始時刻(終了時刻を指定する場合)と同じ
 値となります。
-省略されたフィールドが最初に指定されたフィールドより
-.I 小さい
-単位ならば、そのデフォルト値はゼロとなります。
+最初に指定されたフィールドより
+.Em 小さい
+単位の省略されたフィールドについてのデフォルト値はゼロとなります。
 例えば、入力ファイルの
-.I first time
-の Unix 時刻が上記の値、すなわち、1990 年 9 月 25 日、午後 8 時 51 分 (PDT)
+.Em first time
+が Unix 時刻で上記の値、すなわち、1990 年 9 月 25 日、午後 8 時 51 分 (PDT)
 から 38 秒と 765,400 マイクロ秒後としましょう。この時、同じ日の 午後 9 時
 36 分 (PDT) ちょうどを指定するには、
-.B 21h36m
+.Em 21h36m
 と表す事ができます。
 午後 9 時 36 分 (PDT) から翌日の午前 1 時 54 分 (PDT) までを指定するには、
-.B 21h36m 26d1h54m
+.Em 21h36m 26d1h54m
 と表す事ができます。
-.LP
-.I ymdhmsu
-形式を使用する時にも相対時刻を指定する事ができます。
-この時、省略されたフィールドが指定された最初のフィールドより
-.I 大きい
+.Pp
+.Em ymdhmsu
+形式を使用する時にも相対時刻で指定する事ができます。
+この時、省略されたフィールドの単位が指定された最初のフィールドより
+.Em 大きい
 単位ならば、デフォルト値は 0 となり、
-省略されたフィールドが指定された最初のフィールドより
-.I 小さい
+省略されたフィールドの単位が指定された最初のフィールドより
+.Em 小さい
 単位ならば、デフォルト値は
-.I first time
+.Em first time
 あるいは開始時刻と同じ値となります。
-.I first time
-が上記で示した Unix 時刻だった場合、
-.B 22h +1h10m
+.Em first time
+が上記の Unix 時刻だった場合、
+.Em 22h +1h10m
 はその日の午後 10 時 00 分 (PDT) から 午後 11 時 10 分 (PDT) までを示し、
-.B +1h +1h10m
+.Em +1h +1h10m
 は午後 9 時 51 分 (PDT) の 38.7654 秒後から 午後 11 時 01 分 (PDT) の
 38.7654 秒後までを示します。
-.B +0 +1h
+.Em +0 +1h
 と指定すれば、ファイルの最初から 1 時間分のデータを取り出す事ができます。
-.LP
-.I ymdhmsu
+.Pp
+.Em ymdhmsu
 形式を用いる場合、
-.I m
+.Em m
 が、`月' を示すのか `分' を示すのかが曖昧になります。
-この曖昧さは、以下のように決定されます。もし、
-.I m
+いずれになるかは、以下のように決定されます。
+.Em m
 フィールドの後に
-.I d
-フィールドが来た場合、それは月であると判断され、それ以外の場合は、
-分であると判断されます。
-.LP
+.Em d
+フィールドが来た場合、月が指定されたと判断します。それ以外の場合は、
+分が指定された判断します。
+.Pp
 複数の入力ファイルが指定された場合、
-.I tcpslice
-はまず、最初のファイルの与えられた時刻の範囲にあるパケットをコピーします。
+.Nm
+はまず、最初のファイル内の指定された時刻の範囲にあるパケットを出力します。
 次に、範囲の開始時刻を最初のファイルの最後のパケットの時刻の直後に変更し、
-次のファイルを処理し、以降これを繰り返します。したがって、時間的に
-分散したパケットを含むような複数のファイルをまとめる事は
-.I できません。
+次のファイルを処理し、以降これを繰り返します。したがって、時間順に
+ならんでいないパケットを含む複数のファイルをまとめる事は
+.Em できません。
 与えられたファイルのうち、先に処理されたファイルより新しいパケットに対して
 のみ処理されます。この機構によりひとつのパケットが複数回出力に現れる
 事を防ぐ事ができます。
-.SH オプション
-.LP
-.B \-R,
-.B \-r,
-.B \-t
+.Sh オプション
+.Pp
+.Fl R ,
+.Fl r ,
+.Fl t
 のいずれかが指定された場合、
-.I tcpslice
+.Nm
 は、各入力ファイルの最初および最後のパケットの時刻を表示して終了します。
-これらの 3 個のオプションのうち、ひとつだけを指定することができます。
-.TP
-.B \-d
-指定された範囲の開始時刻と終了時刻をダンプして終了します。
+これらの 3 個のオプションのうち、1 つだけを指定することができます。
+.Pp
+以下のオプションが指定できます:
+.Bl -tag -width indent
+.It Fl d
+指定された範囲の開始時刻と終了時刻を表示して終了します。
 このオプションは、指定した範囲が想定している時間と本当に一致しているかどうかを
 確認するのに有効です。
-.B \-R,
-.B \-r,
-.B \-t
-のいずれかが指定された場合、それらに相当する形式で時刻をダンプします。
-指定がない場合は、加工しない形式 (\fB \-R\fP) が使用されます。
-.TP
-.B \-R
-各入力ファイルの最初および最後のパケットの時刻を加工しない形式
-(つまり、\fI sssssssss.uuuuuu\fP の形式) でダンプします。
-.TP
-.B \-r
-.B \-R
-と同じですが、\fI date(1)\fP で使用される物と同様の、読みやすい形式で
-時刻をダンプします。
-.TP
-.B \-t
-.B \-R
+.Fl R ,
+.Fl r ,
+.Fl t
+のいずれかが指定された場合、それらに相当する形式で時刻を表示します。
+指定がない場合は、内部形式 (
+.Fl R )
+となります。
+.It Fl R
+各入力ファイルの最初および最後のパケットの時刻を内部形式
+(つまり、
+.Em sssssssss.uuuuuu
+の形式) で表示します。
+.It Fl r
+.Fl R
+と同じですが、
+.Xr date 1
+と同様の、読みやすい形式で時刻を表示します。
+.It Fl t
+.Fl R
 と同じですが、時刻を
-.I tcpslice
+.Nm
 形式、すなわち、上記に示した
-.I ymdhmsu
-の形でダンプします。
-.TP
-.B \-w
-結果を \fIstdout\fP ではなく、\fIfile\fR に出力します。
-.SH 関連項目
-tcpdump(1)
-.SH 作者
-Vern Paxson (vern@ee.lbl.gov), of
-Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
-.SH バグ
+.Em ymdhmsu
+の形で表示します。
+.It Fl w Ar file
+出力を
+.Pa stdout
+ではなく、
+.Ar file
+とします。
+.El
+.Sh 関連項目
+.Xr tcpdump 1
+.Sh 作者
+.An Vern Paxson Aq vern@ee.lbl.gov ,
+of Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
+.Sh バグ
 数字や `+' で始まるファイル名を入力ファイルとして指定すると、
-開始/終了時刻と区別できません。このようなファイル名は、たとえば、
-`04Jul76.trace' というファイル名ならば `./04Jul76.trace' のように、
-先頭に `./' をつけて指定して下さい。
-.LP
-.I tcpslice
+開始/終了時刻と間違うことがあります。このようなファイル名は、
+先頭に `./' をつけて指定します。たとえば、
+`04Jul76.trace' というファイル名ならば `./04Jul76.trace' とします。
+.Pp
+.Nm
 は、入力ファイルをくまなく探すためにランダムアクセスを使用するため、
-\fIstdin\fP から入力を読み込むことはできません。
-.LP
-.I tcpslice
-は、出力を (\fIisatty(3)\fP で示される) 端末へ出力しようとしません。
-これはバグではなく仕様で、ユーザの端末にバイナリデータをまき散らすことを
-防ぎます。つまり、\fIstdout\fP をリダイレクトするか、\fB\-w\fP により
-出力ファイルを指定する必要があります。
-.LP
-.I tcpslice
-は、1 年以上にわたる \fItcpdump\fP のファイルや、
+.Pa stdin
+から入力することはできません。
+.Pp
+.Nm
+は、出力先が端末 (
+.Xr isatty 3
+で示される) である場合、出力しません。
+これはバグではなく、ユーザの端末にバイナリデータをまき散らすことを
+防ぐための仕様です。つまり、
+.Pa stdout
+をリダイレクトするか、
+.Fl w
+により出力ファイルを指定しなければなりません。
+.Pp
+.Nm
+は、1 年以上にわたる
+.Xr tcpdump 1
+のファイルや、
 もともとのパケットの長さが 65,535 バイトを超えるようなパケットの一部を
-含むようなファイル、3 パケットより少ないパケットしかないファイル
+含むようなファイル、3 パケット未満のパケットしか含まれないファイル
 に対しては正しく働かないでしょう。
 これらのファイルを処理しようとすると、
 `couldn't find final packet in file' というエラーメッセージが出力されます。
 これらの問題は、大きなトレースファイルを扱う場合に、
-.I tcpslice
-が処理速度を大きく改善するために使用している補間機能に起因します。
+.Nm
+が処理速度を大きく改善するために使用している機構に起因します。
 一方、
-.I tcpslice
+.Nm
 は、如何なるサイズのトレースファイルでも中央のスライスを効率的に取り出す
-ことができ、分断されたトレースファイル (ファイルの中の最後のパケットが
-一部しか存在しない様なファイル、\fItcpdump\fP が強制的に終了させられた
-場合にできる場合がある) に対しても正しく動作します。
+ことができ、不完全なトレースファイル (例えば、ファイル中の最後のパケットが
+途中で切れているファイル、
+.Xr tcpdump 1
+が強制的に終了させられた
+場合によくできる) に対しても正しく動作します。