OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man8 / zic.8
1 .\" %%%LICENSE_START(PUBLIC_DOMAIN)
2 .\" This page is in the public domain
3 .\" %%%LICENSE_END
4 .\"
5 .\"*******************************************************************
6 .\"
7 .\" This file was generated with po4a. Translate the source file.
8 .\"
9 .\"*******************************************************************
10 .\"
11 .\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
12 .\" Translated Sat Aug 14 1999
13 .\"       by NAKANO Takeo <nakano@apm.seikei.ac.jp>
14 .\" Updated Wed Apr 4 2001
15 .\"       by Yuichi SATO <ysato@h4.dion.ne.jp>
16 .\"
17 .TH ZIC 8 2010\-02\-25 "" "Linux System Administration"
18 .SH 名前
19 zic \- タイムゾーンコンパイラ
20 .SH 書式
21 \fBzic\fP [ \fB\-v\fP ] [ \fB\-d\fP \fIdirectory\fP ] [ \fB\-l\fP \fIlocaltime\fP ] [ \fB\-p\fP
22 \fIposixrules\fP ] [ \fB\-L\fP \fIleapsecondfilename\fP ] [ \fB\-s\fP ] [ \fB\-y\fP \fIcommand\fP
23 ] [ \fIfilename\fP \&... ]
24 .SH 説明
25 .if  t .ds lq ``
26 .if  t .ds rq ''
27 .if  n .ds lq \&"\"
28 .if  n .ds rq \&"\"
29 .de  q
30 \\$3\*(lq\\$1\*(rq\\$2
31 ..
32 \fIzic\fP はコマンドラインで指定されたファイル (複数指定可) からテキストを読み、
33 時刻変換情報ファイルを生成する。ファイル名も読み込みテキストで指定しておく。 \fIfilename\fP が \fB\-\fP の場合は、標準入力から読み込む。
34 .PP
35 以下のオプションを指定できる:
36 .TP 
37 \fB\-d \fP\fIdirectory\fP
38 時刻変換情報ファイルを生成するディレクトリを、標準のディレクトリ (以下を参照) ではなく指定したディレクトリにする。
39 .TP 
40 \fB\-l \fP\fItimezone\fP
41 指定したタイムゾーンをローカルタイムに用いる。 \fIzic\fP は入力に以下の書式のリンク行が含まれているかのように振る舞う。
42 .sp
43 .ti +.5i
44 Link    \fItimezone\fP          localtime
45 .TP 
46 \fB\-p \fP\fItimezone\fP
47 POSIX 形式のタイムゾーン環境変数を扱うとき、 指定したタイムゾーンのルールを用いる。 \fIzic\fP
48 は入力に以下の書式のリンク行が含まれているかのように振る舞う。
49 .sp
50 .ti +.5i
51 Link    \fItimezone\fP          posixrules
52 .TP 
53 \fB\-L \fP\fIleapsecondfilename\fP
54 閏秒情報を与えられた名前のファイルから読み込む。 このオプションが指定されなかった場合には、 出力ファイルには閏秒の情報は含まれない。
55 .TP 
56 \fB\-v\fP
57 データファイルに現れる年が \fBtime\fP(2)  で表記できる範囲を越えている場合に文句を言う。
58 .TP 
59 \fB\-s\fP
60 出力ファイルに格納される時刻の値を、 signed で評価しても unsigned で 評価しても同じ値になるような範囲に制限する。
61 このオプションを使うと SVVS 互換なファイルを生成することができる。
62 .TP 
63 \fB\-y \fP\fIcommand\fP
64 年の型のチェック (以下参照) に \fByearistype\fP ではなく指定した \fIcommand\fP を用いる。
65 .PP
66 入力行はフィールドからなる。 フィールド間は、連続した任意の個数の空白文字によって区切られる。 行頭・行末の空白文字は無視される。
67 クォートされていないシャープ文字 (#) が入力行に現れた場合は、 そこから行末まではコメントとして扱われる。 空白文字やシャープ文字をダブルクォート
68 (") で囲めば、 フィールドの一部として用いることができる。 (コメント除去処理を行った後のものを含めて) 空行は無視される。 空行以外の行は、 3
69 種類あるタイプの行のいずれかであるとみなされる。 3 つのタイプとは、ルール行 (rule line)、ゾーン行 (zone line)、 リンク行
70 (link line) である。
71 .PP
72 ルール行の書式は以下のようなものである。
73 .nf
74 .ti +.5i
75 .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
76 .sp
77 Rule    NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
78 .sp
79 例:
80 .ti +.5i
81 .sp
82 Rule    US      1967    1973    \-      Apr     lastSun 2:00    1:00    D
83 .sp
84 .fi
85 ルール行を構成するフィールドは以下の通り:
86 .TP  "\w'LETTER/S'u"
87 \fBNAME\fP
88 このルールが所属するルールセットの名前を与える (任意)。
89 .TP 
90 \fBFROM\fP
91 このルールが適用される最初の年を与える。 任意の整数を年として与えることができる。グレゴリオ暦が仮定される。 \fIminimum\fP (あるいはその短縮)
92 は整数表記できる最小の年を意味する。 \fImaximum\fP (あるいはその短縮) は整数表記できる最大の年を意味する。 ルールでは時刻値 (time
93 value) では表記できない時刻も記述できる。 表記できない時刻は無視される。つまりルールは 異なった時刻値の型を持つホスト間でポータブルである。
94 .TP 
95 \fBTO\fP
96 このルールが適用される最後の年を与える。 \fIminimum\fP と \fImaximum\fP (上述) に加え、 \fIonly\fP (またはその短縮)
97 を用いることができ、この場合は \fBFROM\fP フィールドに指定した値と同じ値が用いられる。
98 .TP 
99 \fBTYPE\fP
100 ルールの適用される年のタイプを与える。 \fBTYPE\fP が \fB\-\fP であれば、このルールは \fBFROM\fP から \fBTO\fP に挟まれた (両端含む)
101 全ての年に適用される。 \fBTYPE\fP がそれ以外の場合には、 \fIzic\fP は以下のコマンドを実行して年のタイプをチェックする。
102 .ti +.5i
103 \fByearistype\fP \fIyear\fP \fItype\fP
104 .br
105 返り値が 0 の場合は、その年は与えられたタイプに含まれ、 返り値が 1 の場合は含まれないことになる。
106 .TP 
107 \fBIN\fP
108 ルールが効力を持つ月の名前を指定する。 月名は短縮できる。
109 .TP 
110 \fBON\fP
111 ルールが効力を持つ日の名前を指定する。 以下のような書式を認識する:
112 .nf
113 .in +.5i
114 .sp
115 .ta \w'Sun<=25\0\0'u
116 5       その月の第 5 日
117 lastSun その月の最後の日曜日
118 lastMon その月の最後の月曜日
119 Sun>=8  第 8 日以降の最初の日曜日
120 Sun<=25 第 25 日以前の最後の日曜日
121 .fi
122 .in -.5i
123 .sp
124 曜日の名前は短縮できる。全部綴っても良い。 \fBON\fP フィールドの内部にはスペースを入れてはいけないことに注意。
125 .TP 
126 \fBAT\fP
127 ルールが効力を持つ一日のうちの時刻を与える。 以下のような書式を認識する:
128 .nf
129 .in +.5i
130 .sp
131 .ta \w'1:28:13\0\0'u
132 2       時間での表記
133 2:00    時間と分での表記
134 15:00   24 時間形式の時間 (正午以降)
135 1:28:14 時間・分・秒での表記
136 \-      0 と同じ
137 .fi
138 .in -.5i
139 .sp
140 ここで 0 時はその日のはじまりであり、 24 時はその日の終わりである。 これらの書式のあとには、以下の文字のいずれかを指定することができる。
141 \fIw\fP 与えられた時刻がローカルな
142 .q "壁時計 (wall clock)"
143 時刻である; \fIs\fP 与えられた時刻がローカルな
144 .q "標準 (standard)"
145 時刻である; \fIu\fP (または \fIg\fP または \fIz\fP)  与えられた時刻が標準時 (universal
146 time) である。 これらの表意文字がいずれも指定されなかった場合は、 壁時計時刻が仮定される。
147 .TP 
148 \fBSAVE\fP
149 ルールが効力を持っているとき、ローカルな標準時刻に追加すべき 時間の量を与える。このフィールドの書式は \fBAT\fP フィールドのものと同じである
150 (ただしもちろん \fIw\fP と \fIs\fP の後置文字は用いられない)。
151 .TP 
152 \fBLETTER/S\fP
153 このルールが効力を持っている場合に用いられるタイムゾーン短縮型の
154 .q "可変部 (variable part)
155 を与える (例えば
156 .q EST
157
158 .q EDT
159 における
160 .q S
161
162 .q D
163 など)。 このフィールドが \fB\-\fP であった場合には、
164 可変部は存在しない。
165 .PP
166 ゾーン行の書式は以下のようなものである。
167 .sp
168 .nf
169 .ti +.5i
170 .ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'UTCOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
171 Zone    NAME    UTCOFF  RULES/SAVE      FORMAT  [UNTIL]
172 .sp
173 例:
174 .sp
175 .ti +.5i
176 Zone    Australia/Adelaide      9:30    Aus     CST     1971 Oct 31 2:00
177 .sp
178 .fi
179 ゾーン行を構成するフィールドは以下の通り:
180 .TP  "\w'UTCOFF'u"
181 \fBNAME\fP
182 タイムゾーンの名前。この名前がこのゾーンの時刻変換情報ファイルを 生成するときに用いられる。
183 .TP 
184 \fBUTCOFF\fP
185 このゾーンの標準時刻を得るために、 UTC に加える時間。 このフィールドの書式は、ルール行の \fBAT\fP および \fBSAVE\fP
186 フィールドのものと同じである。時間を UTC から引く必要がある場合は マイナス記号を前置する。
187 .TP 
188 \fBRULES/SAVE\fP
189 タイムゾーンに適用されるルールの名前か、あるいは ローカル標準時刻に加えるべき時間の量を指定する。 このフィールドが \fB\-\fP
190 ならば、常に標準時刻がこのゾーンに対して用いられる。
191 .TP 
192 \fBFORMAT\fP
193 このタイムゾーンに対するタイムゾーン短縮名の書式。 2 文字の文字列 \fB%s\fP を用いて、どこが
194 .q 可変部
195 になるかを指定できる。あるいはスラッシュ文字 (/) を用いて 標準の短縮名とサマータイム短縮名を区切ることができる。
196 .TP 
197 \fBUNTIL\fP
198 UTC に対するオフセットか、その場所におけるルールが変更される時刻。 年・月・日・時刻で指定する。
199 これが指定された場合には、タイムゾーンの情報は与えられている UTC オフセットから生成され、ルールは指定時刻になると変更される。
200 月・日・時刻は、ルールの IN, ON, AT カラムと同じ書式で指定する。 この後に続くカラムは省略できる。 省略されたカラムに対しては、
201 可能性のあるもののうち最も早い値がデフォルトで用いられる。
202 .IP
203 この行には必ず
204 .q 継続 (continuation)
205 行が続く。 継続行はゾーン行と同じ書式を持つが、
206 .q Zone
207 と名前は省略される。なぜなら継続行は直前の行の \fBUNTIL\fP フィールドで指定された時刻以降の情報を与えるものだからである。
208 継続行にもゾーン行と同じように \fBUNTIL\fP フィールドを指定することができ、この場合はその次の行が さらなる継続行になることとなる。
209 .PP
210 リンク行の書式は以下のようなものである。
211 .sp
212 .nf
213 .ti +.5i
214 .ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u
215 Link    LINK\-FROM      LINK\-TO
216 .sp
217 例:
218 .sp
219 .ti +.5i
220 Link    Europe/Istanbul Asia/Istanbul
221 .sp
222 .fi
223 \fBLINK\-FROM\fP フィールドはゾーン行の \fBNAME\fP フィールドが記述される。 \fBLINK\-TO\fP フィールドはそのゾーンの別名である。
224 .PP
225 Except for continuation lines, lines may appear in any order in the input.
226 .PP
227 ファイル中で閏秒を記述する行は以下のような書式を持つ。
228 .nf
229 .ti +.5i
230 .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
231 .sp
232 Leap    YEAR    MONTH   DAY     HH:MM:SS        CORR    R/S
233 .sp
234 例:
235 .ti +.5i
236 .sp
237 Leap    1974    Dec     31      23:59:60        +       S
238 .sp
239 .fi
240 .\" There's no need to document the following, since it's impossible for more
241 .\" than one leap second to be inserted or deleted at a time.
242 .\" The C Standard is in error in suggesting the possibility.
243 .\" See Terry J Quinn, The BIPM and the accurate measure of time,
244 .\" Proc IEEE 79, 7 (July 1991), 894-905.
245 .\"     or
246 .\"     .q ++
247 .\"     if two seconds were added
248 .\"     or
249 .\"     .q --
250 .\"     if two seconds were skipped.
251 \fBYEAR\fP, \fBMONTH\fP, \fBDAY\fP, \fBHH:MM:SS\fP は閏秒の生じた瞬間を示す。 \fBCORR\fP
252 フィールドには、秒が挿入された場合
253 .q +
254 を、秒がスキップされた場合
255 .q \-
256 を指定する。 \fBR/S\fP
257 フィールドには、他のフィールドが記述している閏秒の時刻が UTC ならば
258 .q Stationary
259 (あるいはその短縮形)
260 を、ローカルな壁時計時刻なら
261 .q Rolling
262 (あるいはその短縮形) を指定する。
263 .SH ファイル
264 /usr/local/etc/zoneinfo         生成されたファイル用の標準ディレクトリ
265 .SH 注意
266 二つ以上のローカルタイムを持っている地域では、 ローカルな標準時を 最も早い方の時刻変換ルールの \fBAT\fP
267 フィールドに用いる必要があるだろう。さもないと コンパイルされたファイルに記録された最も早い変換時刻が 正しいことが保証されない。
268 .SH 関連項目
269 .\" @(#)zic.8   7.19
270 \fBtzfile\fP(5), \fBzdump\fP(8)
271 .SH この文書について
272 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
273 である。プロジェクトの説明とバグ報告に関する情報は
274 http://www.kernel.org/doc/man\-pages/ に書かれている。