X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman8%2Fzic.8;h=699b40ad05b620cd1363fbba704ae7350fc2329e;hb=refs%2Ftags%2FLDP-3.39-final;hp=438d580aae99fe29b83f031d72f1561181da2cb8;hpb=ce024239a1d8e74a7a44f7c24cee4375cb13b3ef;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man8/zic.8 b/release/man8/zic.8 index 438d580a..699b40ad 100644 --- a/release/man8/zic.8 +++ b/release/man8/zic.8 @@ -1,118 +1,64 @@ .\" This page is in the public domain .\" -.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved. -.\" Translated Sat Aug 14 1999 -.\" by NAKANO Takeo -.\" Updated Wed Apr 4 2001 -.\" by Yuichi SATO +.\"******************************************************************* .\" -.\"WORD: time value 時刻値 -.\"WORD: rule line ルール行 -.\"WORD: zone line ゾーン行 -.\"WORD: link line リンク行 -.\"WORD: continuation line 継続行 -.\"WORD: wall clock (time) 壁時計 (時刻) -.\"WORD: standard (time) 標準 (時刻) +.\" This file was generated with po4a. Translate the source file. .\" -.TH ZIC 8 2010-02-25 "" "Linux System Administration" +.\"******************************************************************* +.TH ZIC 8 2010\-02\-25 "" "Linux System Administration" .SH 名前 zic \- タイムゾーンコンパイラ .SH 書式 -.B zic -[ -.B \-v -] [ -.B \-d -.I directory -] [ -.B \-l -.I localtime -] [ -.B \-p -.I posixrules -] [ -.B \-L -.I leapsecondfilename -] [ -.B \-s -] [ -.B \-y -.I command -] [ -.I filename -\&... ] +\fBzic\fP [ \fB\-v\fP ] [ \fB\-d\fP \fIdirectory\fP ] [ \fB\-l\fP \fIlocaltime\fP ] [ \fB\-p\fP +\fIposixrules\fP ] [ \fB\-L\fP \fIleapsecondfilename\fP ] [ \fB\-s\fP ] [ \fB\-y\fP \fIcommand\fP +] [ \fIfilename\fP \&... ] .SH 説明 -.if t .ds lq `` -.if t .ds rq '' -.if n .ds lq \&"\" -.if n .ds rq \&"\" -.de q +.if t .ds lq `` +.if t .ds rq '' +.if n .ds lq \&"\" +.if n .ds rq \&"\" +.de q \\$3\*(lq\\$1\*(rq\\$2 .. -.I zic -はコマンドラインで指定されたファイル (複数指定可) からテキストを読み、 -時刻変換情報ファイルを生成する。ファイル名も読み込みテキストで指定しておく。 -.I filename -が -.B \- -の場合は、標準入力から読み込む。 +\fIzic\fP はコマンドラインで指定されたファイル (複数指定可) からテキストを読み、 +時刻変換情報ファイルを生成する。ファイル名も読み込みテキストで指定しておく。 \fIfilename\fP が \fB\-\fP の場合は、標準入力から読み込む。 .PP 以下のオプションを指定できる: -.TP -.BI "\-d " directory -時刻変換情報ファイルを生成するディレクトリを、標準のディレクトリ -(以下を参照) ではなく指定したディレクトリにする。 -.TP -.BI "\-l " timezone -指定したタイムゾーンをローカルタイムに用いる。 -.I zic -は入力に以下の書式のリンク行が含まれているかのように振る舞う。 +.TP +\fB\-d \fP\fIdirectory\fP +時刻変換情報ファイルを生成するディレクトリを、標準のディレクトリ (以下を参照) ではなく指定したディレクトリにする。 +.TP +\fB\-l \fP\fItimezone\fP +指定したタイムゾーンをローカルタイムに用いる。 \fIzic\fP は入力に以下の書式のリンク行が含まれているかのように振る舞う。 .sp .ti +.5i Link \fItimezone\fP localtime -.TP -.BI "\-p " timezone -POSIX 形式のタイムゾーン環境変数を扱うとき、 -指定したタイムゾーンのルールを用いる。 -.I zic +.TP +\fB\-p \fP\fItimezone\fP +POSIX 形式のタイムゾーン環境変数を扱うとき、 指定したタイムゾーンのルールを用いる。 \fIzic\fP は入力に以下の書式のリンク行が含まれているかのように振る舞う。 .sp .ti +.5i Link \fItimezone\fP posixrules -.TP -.BI "\-L " leapsecondfilename -閏秒情報を与えられた名前のファイルから読み込む。 -このオプションが指定されなかった場合には、 -出力ファイルには閏秒の情報は含まれない。 -.TP -.B \-v -データファイルに現れる年が -.BR time (2) -で表記できる範囲を越えている場合に文句を言う。 -.TP -.B \-s -出力ファイルに格納される時刻の値を、 signed で評価しても unsigned で -評価しても同じ値になるような範囲に制限する。 +.TP +\fB\-L \fP\fIleapsecondfilename\fP +閏秒情報を与えられた名前のファイルから読み込む。 このオプションが指定されなかった場合には、 出力ファイルには閏秒の情報は含まれない。 +.TP +\fB\-v\fP +データファイルに現れる年が \fBtime\fP(2) で表記できる範囲を越えている場合に文句を言う。 +.TP +\fB\-s\fP +出力ファイルに格納される時刻の値を、 signed で評価しても unsigned で 評価しても同じ値になるような範囲に制限する。 このオプションを使うと SVVS 互換なファイルを生成することができる。 -.TP -.BI "\-y " command -年の型のチェック (以下参照) に -.B yearistype -ではなく指定した -.I command -を用いる。 +.TP +\fB\-y \fP\fIcommand\fP +年の型のチェック (以下参照) に \fByearistype\fP ではなく指定した \fIcommand\fP を用いる。 .PP -入力行はフィールドからなる。 -フィールド間は、連続した任意の個数の空白文字によって区切られる。 -行頭・行末の空白文字は無視される。 -クォートされていないシャープ文字 (#) が入力行に現れた場合は、 -そこから行末まではコメントとして扱われる。 -空白文字やシャープ文字をダブルクォート (") で囲めば、 -フィールドの一部として用いることができる。 -(コメント除去処理を行った後のものを含めて) 空行は無視される。 -空行以外の行は、 3 種類あるタイプの行のいずれかであるとみなされる。 -3 つのタイプとは、ルール行 (rule line)、ゾーン行 (zone line)、 -リンク行 (link line) である。 +入力行はフィールドからなる。 フィールド間は、連続した任意の個数の空白文字によって区切られる。 行頭・行末の空白文字は無視される。 +クォートされていないシャープ文字 (#) が入力行に現れた場合は、 そこから行末まではコメントとして扱われる。 空白文字やシャープ文字をダブルクォート +(") で囲めば、 フィールドの一部として用いることができる。 (コメント除去処理を行った後のものを含めて) 空行は無視される。 空行以外の行は、 3 +種類あるタイプの行のいずれかであるとみなされる。 3 つのタイプとは、ルール行 (rule line)、ゾーン行 (zone line)、 リンク行 +(link line) である。 .PP ルール行の書式は以下のようなものである。 .nf @@ -128,59 +74,32 @@ Rule US 1967 1973 \- Apr lastSun 2:00 1:00 D .sp .fi ルール行を構成するフィールドは以下の通り: -.TP "\w'LETTER/S'u" -.B NAME +.TP "\w'LETTER/S'u" +\fBNAME\fP このルールが所属するルールセットの名前を与える (任意)。 -.TP -.B FROM -このルールが適用される最初の年を与える。 -任意の整数を年として与えることができる。グレゴリオ暦が仮定される。 -.I minimum -(あるいはその短縮) は整数表記できる最小の年を意味する。 -.I maximum -(あるいはその短縮) は整数表記できる最大の年を意味する。 -ルールでは時刻値 (time value) では表記できない時刻も記述できる。 -表記できない時刻は無視される。つまりルールは -異なった時刻値の型を持つホスト間でポータブルである。 -.TP -.B TO -このルールが適用される最後の年を与える。 -.I minimum -と -.I maximum -(上述) に加え、 -.I only -(またはその短縮) を用いることができ、この場合は -.B FROM -フィールドに指定した値と同じ値が用いられる。 -.TP -.B TYPE -ルールの適用される年のタイプを与える。 -.B TYPE -が -.B \- -であれば、このルールは -.B FROM -から -.B TO -に挟まれた (両端含む) 全ての年に適用される。 -.B TYPE -がそれ以外の場合には、 -.I zic -は以下のコマンドを実行して年のタイプをチェックする。 +.TP +\fBFROM\fP +このルールが適用される最初の年を与える。 任意の整数を年として与えることができる。グレゴリオ暦が仮定される。 \fIminimum\fP (あるいはその短縮) +は整数表記できる最小の年を意味する。 \fImaximum\fP (あるいはその短縮) は整数表記できる最大の年を意味する。 ルールでは時刻値 (time +value) では表記できない時刻も記述できる。 表記できない時刻は無視される。つまりルールは 異なった時刻値の型を持つホスト間でポータブルである。 +.TP +\fBTO\fP +このルールが適用される最後の年を与える。 \fIminimum\fP と \fImaximum\fP (上述) に加え、 \fIonly\fP (またはその短縮) +を用いることができ、この場合は \fBFROM\fP フィールドに指定した値と同じ値が用いられる。 +.TP +\fBTYPE\fP +ルールの適用される年のタイプを与える。 \fBTYPE\fP が \fB\-\fP であれば、このルールは \fBFROM\fP から \fBTO\fP に挟まれた (両端含む) +全ての年に適用される。 \fBTYPE\fP がそれ以外の場合には、 \fIzic\fP は以下のコマンドを実行して年のタイプをチェックする。 .ti +.5i \fByearistype\fP \fIyear\fP \fItype\fP .br -返り値が 0 の場合は、その年は与えられたタイプに含まれ、 -返り値が 1 の場合は含まれないことになる。 -.TP -.B IN -ルールが効力を持つ月の名前を指定する。 -月名は短縮できる。 -.TP -.B ON -ルールが効力を持つ日の名前を指定する。 -以下のような書式を認識する: +返り値が 0 の場合は、その年は与えられたタイプに含まれ、 返り値が 1 の場合は含まれないことになる。 +.TP +\fBIN\fP +ルールが効力を持つ月の名前を指定する。 月名は短縮できる。 +.TP +\fBON\fP +ルールが効力を持つ日の名前を指定する。 以下のような書式を認識する: .nf .in +.5i .sp @@ -193,13 +112,10 @@ Sun<=25 第 25 日以前の最後の日曜日 .fi .in -.5i .sp -曜日の名前は短縮できる。全部綴っても良い。 -.B ON -フィールドの内部にはスペースを入れてはいけないことに注意。 -.TP -.B AT -ルールが効力を持つ一日のうちの時刻を与える。 -以下のような書式を認識する: +曜日の名前は短縮できる。全部綴っても良い。 \fBON\fP フィールドの内部にはスペースを入れてはいけないことに注意。 +.TP +\fBAT\fP +ルールが効力を持つ一日のうちの時刻を与える。 以下のような書式を認識する: .nf .in +.5i .sp @@ -212,37 +128,19 @@ Sun<=25 第 25 日以前の最後の日曜日 .fi .in -.5i .sp -ここで 0 時はその日のはじまりであり、 -24 時はその日の終わりである。 -これらの書式のあとには、以下の文字のいずれかを指定することができる。 -.I w -与えられた時刻がローカルな +ここで 0 時はその日のはじまりであり、 24 時はその日の終わりである。 これらの書式のあとには、以下の文字のいずれかを指定することができる。 +\fIw\fP 与えられた時刻がローカルな .q "壁時計 (wall clock)" -時刻である; -.I s -与えられた時刻がローカルな +時刻である; \fIs\fP 与えられた時刻がローカルな .q "標準 (standard)" -時刻である; -.I u -(または -.I g -または -.IR z ) -与えられた時刻が標準時 (universal time) である。 -これらの表意文字がいずれも指定されなかった場合は、 -壁時計時刻が仮定される。 -.TP -.B SAVE -ルールが効力を持っているとき、ローカルな標準時刻に追加すべき -時間の量を与える。このフィールドの書式は -.B AT -フィールドのものと同じである (ただしもちろん -.I w -と -.I s -の後置文字は用いられない)。 -.TP -.B LETTER/S +時刻である; \fIu\fP (または \fIg\fP または \fIz\fP) 与えられた時刻が標準時 (universal +time) である。 これらの表意文字がいずれも指定されなかった場合は、 壁時計時刻が仮定される。 +.TP +\fBSAVE\fP +ルールが効力を持っているとき、ローカルな標準時刻に追加すべき 時間の量を与える。このフィールドの書式は \fBAT\fP フィールドのものと同じである +(ただしもちろん \fIw\fP と \fIs\fP の後置文字は用いられない)。 +.TP +\fBLETTER/S\fP このルールが効力を持っている場合に用いられるタイムゾーン短縮型の .q "可変部 (variable part) を与える (例えば @@ -253,10 +151,7 @@ Sun<=25 第 25 日以前の最後の日曜日 .q S や .q D -など)。 -このフィールドが -.B \- -であった場合には、 +など)。 このフィールドが \fB\-\fP であった場合には、 可変部は存在しない。 .PP ゾーン行の書式は以下のようなものである。 @@ -273,65 +168,42 @@ Zone Australia/Adelaide 9:30 Aus CST 1971 Oct 31 2:00 .sp .fi ゾーン行を構成するフィールドは以下の通り: -.TP "\w'UTCOFF'u" -.B NAME -タイムゾーンの名前。この名前がこのゾーンの時刻変換情報ファイルを -生成するときに用いられる。 -.TP -.B UTCOFF -このゾーンの標準時刻を得るために、 UTC に加える時間。 -このフィールドの書式は、ルール行の -.B AT -および -.B SAVE -フィールドのものと同じである。時間を UTC から引く必要がある場合は -マイナス記号を前置する。 -.TP -.B RULES/SAVE -タイムゾーンに適用されるルールの名前か、あるいは -ローカル標準時刻に加えるべき時間の量を指定する。 -このフィールドが -.B \- +.TP "\w'UTCOFF'u" +\fBNAME\fP +タイムゾーンの名前。この名前がこのゾーンの時刻変換情報ファイルを 生成するときに用いられる。 +.TP +\fBUTCOFF\fP +このゾーンの標準時刻を得るために、 UTC に加える時間。 このフィールドの書式は、ルール行の \fBAT\fP および \fBSAVE\fP +フィールドのものと同じである。時間を UTC から引く必要がある場合は マイナス記号を前置する。 +.TP +\fBRULES/SAVE\fP +タイムゾーンに適用されるルールの名前か、あるいは ローカル標準時刻に加えるべき時間の量を指定する。 このフィールドが \fB\-\fP ならば、常に標準時刻がこのゾーンに対して用いられる。 -.TP -.B FORMAT -このタイムゾーンに対するタイムゾーン短縮名の書式。 -2 文字の文字列 -.B %s -を用いて、どこが +.TP +\fBFORMAT\fP +このタイムゾーンに対するタイムゾーン短縮名の書式。 2 文字の文字列 \fB%s\fP を用いて、どこが .q 可変部 -になるかを指定できる。あるいはスラッシュ文字 (/) を用いて -標準の短縮名とサマータイム短縮名を区切ることができる。 -.TP -.B UNTIL -UTC に対するオフセットか、その場所におけるルールが変更される時刻。 -年・月・日・時刻で指定する。 -これが指定された場合には、タイムゾーンの情報は与えられている -UTC オフセットから生成され、ルールは指定時刻になると変更される。 -月・日・時刻は、ルールの IN, ON, AT カラムと同じ書式で指定する。 -この後に続くカラムは省略できる。 -省略されたカラムに対しては、 +になるかを指定できる。あるいはスラッシュ文字 (/) を用いて 標準の短縮名とサマータイム短縮名を区切ることができる。 +.TP +\fBUNTIL\fP +UTC に対するオフセットか、その場所におけるルールが変更される時刻。 年・月・日・時刻で指定する。 +これが指定された場合には、タイムゾーンの情報は与えられている UTC オフセットから生成され、ルールは指定時刻になると変更される。 +月・日・時刻は、ルールの IN, ON, AT カラムと同じ書式で指定する。 この後に続くカラムは省略できる。 省略されたカラムに対しては、 可能性のあるもののうち最も早い値がデフォルトで用いられる。 .IP この行には必ず .q 継続 (continuation) -行が続く。 -継続行はゾーン行と同じ書式を持つが、 +行が続く。 継続行はゾーン行と同じ書式を持つが、 .q Zone -と名前は省略される。なぜなら継続行は直前の行の -.B UNTIL -フィールドで指定された時刻以降の情報を与えるものだからである。 -継続行にもゾーン行と同じように -.B UNTIL -フィールドを指定することができ、この場合はその次の行が -さらなる継続行になることとなる。 +と名前は省略される。なぜなら継続行は直前の行の \fBUNTIL\fP フィールドで指定された時刻以降の情報を与えるものだからである。 +継続行にもゾーン行と同じように \fBUNTIL\fP フィールドを指定することができ、この場合はその次の行が さらなる継続行になることとなる。 .PP リンク行の書式は以下のようなものである。 .sp .nf .ti +.5i .ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u -Link LINK-FROM LINK-TO +Link LINK\-FROM LINK\-TO .sp 例: .sp @@ -339,13 +211,9 @@ Link LINK-FROM LINK-TO Link Europe/Istanbul Asia/Istanbul .sp .fi +\fBLINK\-FROM\fP フィールドはゾーン行の \fBNAME\fP フィールドが記述される。 \fBLINK\-TO\fP フィールドはそのゾーンの別名である。 .PP -.B LINK-FROM -フィールドはゾーン行の -.B NAME -フィールドが記述される。 -.B LINK-TO -フィールドはそのゾーンの別名である。 +Except for continuation lines, lines may appear in any order in the input. .PP ファイル中で閏秒を記述する行は以下のような書式を持つ。 .nf @@ -360,17 +228,6 @@ Leap YEAR MONTH DAY HH:MM:SS CORR R/S Leap 1974 Dec 31 23:59:60 + S .sp .fi -.BR YEAR , -.BR MONTH , -.BR DAY , -.B HH:MM:SS -は閏秒の生じた瞬間を示す。 -.B CORR -フィールドには、秒が挿入された場合 -.q + -を、秒がスキップされた場合 -.q - -を指定する。 .\" There's no need to document the following, since it's impossible for more .\" than one leap second to be inserted or deleted at a time. .\" The C Standard is in error in suggesting the possibility. @@ -382,24 +239,23 @@ Leap 1974 Dec 31 23:59:60 + S .\" or .\" .q -- .\" if two seconds were skipped. -.B R/S -フィールドには、他のフィールドが記述している閏秒の時刻が -UTC ならば +\fBYEAR\fP, \fBMONTH\fP, \fBDAY\fP, \fBHH:MM:SS\fP は閏秒の生じた瞬間を示す。 \fBCORR\fP +フィールドには、秒が挿入された場合 +.q + +を、秒がスキップされた場合 +.q \- +を指定する。 \fBR/S\fP +フィールドには、他のフィールドが記述している閏秒の時刻が UTC ならば .q Stationary -(あるいはその短縮形) を、ローカルな壁時計時刻なら +(あるいはその短縮形) +を、ローカルな壁時計時刻なら .q Rolling (あるいはその短縮形) を指定する。 .SH ファイル /usr/local/etc/zoneinfo 生成されたファイル用の標準ディレクトリ .SH 注意 -二つ以上のローカルタイムを持っている地域では、 -ローカルな標準時を -最も早い方の時刻変換ルールの -.B AT -フィールドに用いる必要があるだろう。さもないと -コンパイルされたファイルに記録された最も早い変換時刻が -正しいことが保証されない。 +二つ以上のローカルタイムを持っている地域では、 ローカルな標準時を 最も早い方の時刻変換ルールの \fBAT\fP +フィールドに用いる必要があるだろう。さもないと コンパイルされたファイルに記録された最も早い変換時刻が 正しいことが保証されない。 .SH 関連項目 -.BR tzfile (5), -.BR zdump (8) +\fBtzfile\fP(5), \fBzdump\fP(8) .\" @(#)zic.8 7.19