diff options
Diffstat (limited to 'ja/man/man8/zic.8')
-rw-r--r-- | ja/man/man8/zic.8 | 396 |
1 files changed, 396 insertions, 0 deletions
diff --git a/ja/man/man8/zic.8 b/ja/man/man8/zic.8 new file mode 100644 index 0000000000..3e104a929e --- /dev/null +++ b/ja/man/man8/zic.8 @@ -0,0 +1,396 @@ +.TH ZIC 8 +.\" jpman %Id: zic.8,v 1.2 1997/06/16 08:24:17 yugawa Stab % +.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 +\&... ] +.SH 解説 +.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 +が +.BR \- +だった場合、標準入力から読み込みます。 +.PP +以下のオプションがあります。 +.TP +.BI "\-d " directory +下記に示した標準ディレクトリではなく、指定されたディレクトリに時刻変換情報 +ファイルを作成します。 +.TP +.BI "\-l " timezone +指定されたタイムゾーンをローカルの時刻に使用します。 +.I zic +は、以下のリンク行が入力ファイルにあった場合と同様に働きます。 +.sp +.ti +.5i +Link \fItimezone\fP localtime +.TP +.BI "\-p " timezone +POSIX 形式のタイムゾーンの環境変数を扱う場合に、指定されたタイムゾーンの +ルールを使用します。 +.I zic +は、以下のリンク行が入力ファイルにあった場合と同様に働きます。 +.sp +.ti +.5i +Link \fItimezone\fP posixrules +.TP +.BI "\-L " leapsecondfilename +指定された名前のファイルからうるう秒の情報を読み込みます。 +このオプションが指定されなかった場合、 +出力ファイルにはうるう秒の情報は記録されません。 +.TP +.B \-v +データファイル中の年が +.IR time (2) +で表示できる年の範囲を超えていた場合、警告します。 +.TP +.B \-s +出力ファイルに記録される時刻の値を、それが符号付きと扱われるか符号なしと +扱われるかに関係なく同じ値になるように制限します。 +SVVS と互換のファイルを生成する場合に、このオプションを使用できます。 +.TP +.BI "\-y " command +年のタイプをチェックする際に、 +.B yearistype +の代わりに指定された +.I command +を用います(下記参照)。 +.PP +入力の各行はフィールドから構成されます。 +各フィールドは任意の数の空白文字により分離されます。先行する空白や、 +行末の空白は無視されます。クォートされていない井桁文字 (#) から +その行の末尾まではコメントとして扱われます。 +空白文字や井桁文字をフィールドの一部として使用する場合は、二重クォート +(") で囲みます。 +(コメントを取り除いた後の)空白行は無視されます。 +空白ではない行は、ルール行、ゾーン行、リンク行の 3 種類のいずれか +であるとみなされます。 +.PP +ルール行は、 +.nf +.ti +.5i +.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u +.sp +Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S +.sp +と言う形式です。例えば、 +.ti +.5i +.sp +Rule US 1967 1973 \- Apr lastSun 2:00 1:00 D +.sp +.fi +となります。ルール行を構成するフィールドは以下の通りです。 +.TP "\w'LETTER/S'u" +.B NAME +このルールが属するルールの(任意の)名前を指定します。 +.TP +.B FROM +ルールが適用される最初の年を指定します。 +如何なる整数の年も指定できます。グレゴリオ歴を仮定しています。 +単語 +.B minimum +(あるいはその短縮形)は、整数で表せる最小の年を示します。 +単語 +.B maximum +(あるいはその短縮形)は、整数で表せる最大の年を示します。 +ルールは、時刻の値として表す事ができない時刻を定義します。 +表す事ができない時刻は無視されます。これにより、時刻の値のタイプが +異なるホスト間でルールを共用する事ができます。 +.TP +.B TO +ルールが適用される最後の年を指定します。 +.B minimum +や +.B maximum +(上記と同様)に加え、 +単語 +.B only +(あるいはその短縮形) +は、 +.B FROM +フィールドの値を使用する場合に指定できます。 +.TP +.B TYPE +ルールが適用される年のタイプを指定します。 +.B TYPE +が +.B \- +だった場合、ルールは、 +.B FROM +から +.B TO +までのその年を含む全ての年に適用されます。 +.B TYPE +がそれ以外だった場合、 +.I zic +は、コマンド +.ti +.5i +\fByearistype\fP \fIyear\fP \fItype\fP +.br +を実行して、年のタイプをチェックします。 +終了ステータスが 0 だった場合は、その年が指定されたタイプであり、 +終了ステータスが 1 だった場合は、その年が指定されたタイプではないと +判断します。 +.TP +.B IN +ルールが適用される月の名前を指定します。 +月名は短縮形でも構いません。 +.TP +.B ON +ルールが適用される日を指定します。 +指定できる形式は以下の通りです。 +.nf +.in +.5i +.sp +.ta \w'Sun<=25\0\0'u +5 その月の 5 日 +lastSun その月の最後の日曜日 +lastMon その月の最後の月曜日 +Sun>=8 8 日以降の最初の日曜日 +Sun<=25 25 日以前の最後の日曜日 +.fi +.in -.5i +.sp +曜日は短縮形でも、フルスペルでも構いません。 +.B ON +フィールドにスペースが含まれない事に注意して下さい。 +.TP +.B AT +ルールが適用される時刻を指定します。 +指定できる形式は以下の通りです。 +.nf +.in +.5i +.sp +.ta \w'1:28:13\0\0'u +2 時 +2:00 時と分 +15:00 (正午以降の時刻の) 24 時間形式の時刻 +1:28:14 時、分、秒 +.fi +.in -.5i +.sp +これらの形式の最後に +.B w +をつけると、指定した時刻がローカルの +.q "ウォールクロック" +(夏時間の適用される地域で、ローカルの標準時に、 +夏時間の期間であればその修正を加えた時刻) +.\" 上記の()内の記述は、wall clock では、特に日本人には +.\" 理解しづらいので追加した。 +.\" 2.2.2-RELEASE 対象 +.\" By yugawa@orleans.rim.or.jp (Jun 16 1997) +であり、 +.B s +をつけると、指定した時刻がローカルの +.q 標準時 +であり、 +.B u +(あるいは +.B g +ないし +.BR z ) +をつけると、指定した時刻が世界標準時であることを示します。 +これらの文字を指定していない場合は、ウォールクロックが適用されます。 +.TP +.B SAVE +ルールが有効な場合にローカルの標準時に加えられる量を指定します。 +このフィールドの形式は +.B AT +フィールドと同じです +(この場合は、末尾に +.B w +と +.B s +を指定する事はできません)。 +.TP +.B LETTER/S +ルールが有効な場合にタイムゾーンの短縮形に用いられる +.q "変化部分" +(例えば、 +.q EST +や +.q EDT +の +.q S +や +.q D ) +を指定します。 +このフィールドが +.B \- +だった場合、変化部分はヌル (NULL) になります。 +.PP +ゾーン行は、 +.sp +.nf +.ti +.5i +.ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u +Zone NAME GMTOFF RULES/SAVE FORMAT [UNTIL] +.sp +と言う形式です。例えば、 +.sp +.ti +.5i +Zone Australia/Adelaide 9:30 Aus CST 1971 Oct 31 2:00 +.sp +.fi +となります。ゾーン行を構成するフィールドは以下の通りです。 +.TP "\w'GMTOFF'u" +.B NAME +タイムゾーンの名称です。 +そのゾーンに対する時刻変換情報ファイルを作成する時の名前になります。 +.TP +.B GMTOFF +そのゾーンの標準時を得る時に GMT に加算される量です。 +このフィールドの形式は、ルール行の +.B AT +および +.B SAVE +フィールドと同じです。 +GMT から時刻を引く場合は、フィールドの最初にマイナスをつけます。 +.TP +.B RULES/SAVE +そのタイムゾーンに適用されるルールの名前、あるいは、ローカルの標準時に +加算される量を指定します。 +このフィールドが +.B \- +だった場合、そのタイムゾーンには常に標準時が適用されます。 +.TP +.B FORMAT +そのタイムゾーンで使用されるタイムゾーンの短縮形の形式を指定します。 +文字列 +.B %s +は、タイムゾーンの短縮形で用いられる +.q "変化部分" +を示します。 +一方、 +スラッシュ (/) +で標準時の短縮形と夏時間の短縮形を指定する事もできます。 +.TP +.B UNTIL +その場所で GMT との差あるいはルールが変化する時刻を指定します。 +年、月、日、時刻を用いて指定できます。 +このフィールドが指定された場合、その時刻になるまでは与えられた GMT との差 +およびルールからタイムゾーンの情報が生成されます。 +.IP +この次の行は +.q 継続 +行でなくてはなりません。この行は最初の +.q Zone +と NAME フィールドがない点を除いてはゾーン行と同一の形式で、その前の行の +.B UNTIL +フィールドで指定した時刻以降の情報を指定します。 +この継続行にも +.B UNTIL +フィールドを指定する事ができ、その場合は、次の行に +その時刻以降の情報を指定します。 +.PP +リンク行は、 +.sp +.nf +.ti +.5i +.ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u +Link LINK-FROM LINK-TO +.sp +と言う形式です。例えば、 +.sp +.ti +.5i +Link Europe/Istanbul Asia/Istanbul +.sp +.fi +となります。 +.B LINK-FROM +フィールドは、存在するゾーン行の +.B NAME +フィールドのいずれかと一致していなければなりません。 +.B LINK-TO +フィールドはそのゾーンに対する別名として使用されます。 +.PP +継続行以外は、入力中での行の順番に制限はありません。 +.PP +うるう秒の定義ファイルの各行は以下のような形式になります。 +.nf +.ti +.5i +.ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u +.sp +Leap YEAR MONTH DAY HH:MM:SS CORR R/S +.sp +例えば、 +.ti +.5i +.sp +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. +.\" See Terry J Quinn, The BIPM and the accurate measure of time, +.\" Proc IEEE 79, 7 (July 1991), 894-905. +.\" or +.\" .q ++ +.\" if two seconds were added +.\" or +.\" .q -- +.\" if two seconds were skipped. +.B R/S +フィールドは +他のフィールドで与えられるうるう秒の時刻が GMT である場合は、 +.q Stationary +(またはその短縮形)で、 +他のフィールドで与えられるうるう秒の時刻がローカルのウォールクロックである +場合は、 +.q Rolling +(またはその短縮形)となります。 +.SH 注釈 +ローカル時刻が複数のタイプとなる地域では、 +作成されたファイルの最初の変化時刻を正しく設定するためには、 +最初の変化時刻のルールの +.B AT +フィールドでローカルの標準時を使用する必要があります。 +.SH 関連ファイル +/usr/share/zoneinfo 作成されたファイルが置かれる標準ディレクトリ +.SH 関連項目 +ctime(3), tzfile(5), zdump(8) +.\" @(#)zic.8 7.12 |