![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to zic.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / share / zoneinfo|
Return to zic.8 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / share / zoneinfo |
1.1 root 1: .TH ZIC 8
2: .SH NAME
3: zic \- time zone compiler
4: .SH SYNOPSIS
5: .B zic
6: [
7: .B \-v
8: ] [
9: .B \-d
10: .I directory
11: ] [
12: .B \-l
13: .I localtime
14: ] [
15: .B \-p
16: .I posixrules
17: ] [
18: .B \-L
19: .I leapsecondfilename
20: ] [
21: .B \-s
22: ] [
23: .I filename
24: \&... ]
25: .SH DESCRIPTION
26: .if t .ds lq ``
27: .if t .ds rq ''
28: .if n .ds lq \&"\"
29: .if n .ds rq \&"\"
30: .de q
31: \\$3\*(lq\\$1\*(rq\\$2
32: ..
33: .I Zic
34: reads text from the file(s) named on the command line
35: and creates the time conversion information files specified in this input.
36: If a
37: .I filename
38: is
39: .BR \- ,
40: the standard input is read.
41: .PP
42: These options are available:
43: .TP
44: .BI "\-d " directory
45: Create time conversion information files in the named directory rather than
46: in the standard directory named below.
47: .TP
48: .BI "\-l " timezone
49: Use the given time zone as local time.
50: .I Zic
51: will act as if the input contained a link line of the form
52: .sp
53: .ti +.5i
54: Link \fItimezone\fP localtime
55: .TP
56: .BI "\-p " timezone
57: Use the given time zone's rules when handling POSIX-format
58: time zone environment variables.
59: .I Zic
60: will act as if the input contained a link line of the form
61: .sp
62: .ti +.5i
63: Link \fItimezone\fP posixrules
64: .TP
65: .BI "\-L " leapsecondfilename
66: Read leap second information from the file with the given name.
67: If this option is not used,
68: no leap second information appears in output files.
69: .TP
70: .B \-v
71: Complain if a year that appears in a data file is outside the range
72: of years representable by
73: .IR time (2)
74: values.
75: .TP
76: .B \-s
77: Limit time values stored in output files to values that are the same
78: whether they're taken to be signed or unsigned.
79: You can use this option to generate SVVS-compatible files.
80: .sp
81: Input lines are made up of fields.
82: Fields are separated from one another by any number of white space characters.
83: Leading and trailing white space on input lines is ignored.
84: An unquoted sharp character (#) in the input introduces a comment which extends
85: to the end of the line the sharp character appears on.
86: White space characters and sharp characters may be enclosed in double quotes
87: (") if they're to be used as part of a field.
88: Any line that is blank (after comment stripping) is ignored.
89: Non-blank lines are expected to be of one of three types:
90: rule lines, zone lines, and link lines.
91: .PP
92: A rule line has the form
93: .nf
94: .B
95: .ti +.5i
96: .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
97: .sp
98: Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S
99: .sp
100: For example:
101: .ti +.5i
102: .sp
103: Rule USA 1969 1973 \- Apr lastSun 2:00 1:00 D
104: .sp
105: .fi
106: The fields that make up a rule line are:
107: .TP "\w'LETTER/S'u"
108: .B NAME
109: Gives the (arbitrary) name of the set of rules this rule is part of.
110: .TP
111: .B FROM
112: Gives the first year in which the rule applies.
113: The word
114: .B minimum
115: (or an abbreviation) means the minimum year with a representable time value.
116: The word
117: .B maximum
118: (or an abbreviation) means the maximum year with a representable time value.
119: .TP
120: .B TO
121: Gives the final year in which the rule applies.
122: In addition to
123: .B minimum
124: and
125: .B maximum
126: (as above),
127: the word
128: .B only
129: (or an abbreviation)
130: may be used to repeat the value of the
131: .B FROM
132: field.
133: .TP
134: .B TYPE
135: Gives the type of year in which the rule applies.
136: If
137: .B TYPE
138: is
139: .B \-
140: then the rule applies in all years between
141: .B FROM
142: and
143: .B TO
144: inclusive;
145: if
146: .B TYPE
147: is
148: .BR uspres ,
149: the rule applies in U.S. Presidential election years;
150: if
151: .B TYPE
152: is
153: .BR nonpres ,
154: the rule applies in years other than U.S. Presidential election years.
155: If
156: .B TYPE
157: is something else, then
158: .I zic
159: executes the command
160: .ti +.5i
161: \fByearistype\fP \fIyear\fP \fItype\fP
162: .br
163: to check the type of a year:
164: an exit status of zero is taken to mean that the year is of the given type;
165: an exit status of one is taken to mean that the year is not of the given type.
166: .TP
167: .B IN
168: Names the month in which the rule takes effect.
169: Month names may be abbreviated.
170: .TP
171: .B ON
172: Gives the day on which the rule takes effect.
173: Recognized forms include:
174: .nf
175: .in +.5i
176: .sp
177: .ta \w'Sun<=25\0\0'u
178: 5 the fifth of the month
179: lastSun the last Sunday in the month
180: lastMon the last Monday in the month
181: Sun>=8 first Sunday on or after the eighth
182: Sun<=25 last Sunday on or before the 25th
183: .fi
184: .in -.5i
185: .sp
186: Names of days of the week may be abbreviated or spelled out in full.
187: Note that there must be no spaces within the
188: .B ON
189: field.
190: .TP
191: .B AT
192: Gives the time of day at which the rule takes effect.
193: Recognized forms include:
194: .nf
195: .in +.5i
196: .sp
197: .ta \w'1:28:13\0\0'u
198: 2 time in hours
199: 2:00 time in hours and minutes
200: 15:00 24-hour format time (for times after noon)
201: 1:28:14 time in hours, minutes, and seconds
202: .fi
203: .in -.5i
204: .sp
205: Any of these forms may be followed by the letter
206: .B w
207: if the given time is local
208: .q "wall clock"
209: time or
210: .B s
211: if the given time is local
212: .q standard
213: time; in the absence of
214: .B w
215: or
216: .BR s ,
217: wall clock time is assumed.
218: .TP
219: .B SAVE
220: Gives the amount of time to be added to local standard time when the rule is in
221: effect.
222: This field has the same format as the
223: .B AT
224: field
225: (although, of course, the
226: .B w
227: and
228: .B s
229: suffixes are not used).
230: .TP
231: .B LETTER/S
232: Gives the
233: .q "variable part"
234: (for example, the
235: .q S
236: or
237: .q D
238: in
239: .q EST
240: or
241: .q EDT )
242: of time zone abbreviations to be used when this rule is in effect.
243: If this field is
244: .BR \- ,
245: the variable part is null.
246: .PP
247: A zone line has the form
248: .sp
249: .nf
250: .ti +.5i
251: .ta \w'Zone\0\0'u +\w'Australia/South\-west\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
252: Zone NAME GMTOFF RULES/SAVE FORMAT [UNTIL]
253: .sp
254: For example:
255: .sp
256: .ti +.5i
257: Zone Australia/South\-west 9:30 Aus CST 1987 Mar 15 2:00
258: .sp
259: .fi
260: The fields that make up a zone line are:
261: .TP "\w'GMTOFF'u"
262: .B NAME
263: The name of the time zone.
264: This is the name used in creating the time conversion information file for the
265: zone.
266: .TP
267: .B GMTOFF
268: The amount of time to add to GMT to get standard time in this zone.
269: This field has the same format as the
270: .B AT
271: and
272: .B SAVE
273: fields of rule lines;
274: begin the field with a minus sign if time must be subtracted from GMT.
275: .TP
276: .B RULES/SAVE
277: The name of the rule(s) that apply in the time zone or,
278: alternately, an amount of time to add to local standard time.
279: If this field is
280: .B \-
281: then standard time always applies in the time zone.
282: .TP
283: .B FORMAT
284: The format for time zone abbreviations in this time zone.
285: The pair of characters
286: .B %s
287: is used to show where the
288: .q "variable part"
289: of the time zone abbreviation goes.
290: .TP
291: .B UNTIL
292: The time at which the GMT offset or the rule(s) change for a location.
293: It is specified as a year, a month, a day, and a time of day.
294: If this is specified,
295: the time zone information is generated from the given GMT offset
296: and rule change until the time specified.
297: .IP
298: The next line must be a
299: .q continuation
300: line; this has the same form as a zone line except that the
301: string
302: .q Zone
303: and the name are omitted, as the continuation line will
304: place information starting at the time specified as the
305: .B UNTIL
306: field in the previous line in the file used by the previous line.
307: Continuation lines may contain an
308: .B UNTIL
309: field, just as zone lines do, indicating that the next line is a further
310: continuation.
311: .PP
312: A link line has the form
313: .sp
314: .nf
315: .ti +.5i
316: .if t .ta \w'Link\0\0'u +\w'LINK-FROM\0\0'u
317: .if n .ta \w'Link\0\0'u +\w'US/Eastern\0\0'u
318: Link LINK-FROM LINK-TO
319: .sp
320: For example:
321: .sp
322: .ti +.5i
323: Link US/Eastern EST5EDT
324: .sp
325: .fi
326: The
327: .B LINK-FROM
328: field should appear as the
329: .B NAME
330: field in some zone line;
331: the
332: .B LINK-TO
333: field is used as an alternate name for that zone.
334: .PP
335: Except for continuation lines,
336: lines may appear in any order in the input.
337: .PP
338: Lines in the file that describes leap seconds have the following form:
339: .nf
340: .B
341: .ti +.5i
342: .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
343: Leap YEAR MONTH DAY HH:MM:SS CORR R/S
344: .sp
345: For example:
346: .ti +.5i
347: .sp
348: Leap 1974 Dec 31 23:59:60 + S
349: .sp
350: .fi
351: The
352: .BR YEAR ,
353: .BR MONTH ,
354: .BR DAY ,
355: and
356: .B HH:MM:SS
357: fields tell when the leap second happened.
358: The
359: .B CORR
360: field
361: should be
362: .q +
363: if a second was added
364: or
365: .q -
366: if a second was skipped.
367: The
368: .B R/S
369: field
370: should be (an abbreviation of)
371: .q Stationary
372: if the leap second time given by the other fields should be interpreted as GMT
373: or
374: (an abbreviation of)
375: .q Rolling
376: if the leap second time given by the other fields should be interpreted as
377: local wall clock time.
378: .SH NOTE
379: For areas with more than two types of local time,
380: you may need to use local standard time in the
381: .B AT
382: field of the earliest transition time's rule to ensure that
383: the earliest transition time recorded in the compiled file is correct.
384: .SH FILE
385: /etc/zoneinfo standard directory used for created files
386: .SH "SEE ALSO"
387: newctime(3), tzfile(5), zdump(8)
388: .. @(#)zic.8 4.4
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.