![[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] / 43BSDTahoe / etc / tzone|
Return to zic.8 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / etc / tzone |
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: .I filename
16: \&... ]
17: .SH DESCRIPTION
18: .I Zic
19: reads text from the file(s) named on the command line
20: and creates the time conversion information files specified in this input.
21: If a
22: .I filename
23: is
24: .BR \- ,
25: the standard input is read.
26: .PP
27: These options are available:
28: .TP
29: .BI "\-d " directory
30: Create time conversion information files in the named directory rather than
31: in the standard directory named below.
32: .TP
33: .BI "\-l " timezone
34: Use the given time zone as local time.
35: .I Zic
36: will act as if the file contained a link line of the form
37: .sp
38: .ti +.5i
39: Link \fItimezone\fP localtime
40: .TP
41: .B \-v
42: Complain if a year that appears in a data file is outside the range
43: of years representable by
44: .IR time (2)
45: values.
46: .sp
47: Input lines are made up of fields.
48: Fields are separated from one another by any number of white space characters.
49: Leading and trailing white space on input lines is ignored.
50: An unquoted sharp character (#) in the input introduces a comment which extends
51: to the end of the line the sharp character appears on.
52: White space characters and sharp characters may be enclosed in double quotes
53: (") if they're to be used as part of a field.
54: Any line that is blank (after comment stripping) is ignored.
55: Non-blank lines are expected to be of one of three types:
56: rule lines, zone lines, and link lines.
57: .PP
58: A rule line has the form
59: .nf
60: .B
61: .ti +.5i
62: .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
63: .sp
64: Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S
65: .sp
66: For example:
67: .ti +.5i
68: .sp
69: Rule USA 1969 1973 \- Apr lastSun 2:00 1:00 D
70: .sp
71: .fi
72: The fields that make up a rule line are:
73: .TP "\w'LETTER/S'u"
74: .B NAME
75: Gives the (arbitrary) name of the set of rules this rule is part of.
76: .TP
77: .B FROM
78: Gives the first year in which the rule applies.
79: The word
80: .B minimum
81: (or an abbreviation) means the minimum year with a representable time value.
82: The word
83: .B maximum
84: (or an abbreviation) means the maximum year with a representable time value.
85: .TP
86: .B TO
87: Gives the final year in which the rule applies.
88: In addition to
89: .B minimum
90: and
91: .B maximum
92: (as above),
93: the word
94: .B only
95: (or an abbreviation)
96: may be used to repeat the value of the
97: .B FROM
98: field.
99: .TP
100: .B TYPE
101: Gives the type of year in which the rule applies.
102: If
103: .B TYPE
104: is
105: .B \-
106: then the rule applies in all years between
107: .B FROM
108: and
109: .B TO
110: inclusive;
111: if
112: .B TYPE
113: is
114: .BR uspres ,
115: the rule applies in U.S. Presidential election years;
116: if
117: .B TYPE
118: is
119: .BR nonpres ,
120: the rule applies in years other than U.S. Presidential election years.
121: If
122: .B TYPE
123: is something else, then
124: .I zic
125: executes the command
126: .ti +.5i
127: \fByearistype\fP \fIyear\fP \fItype\fP
128: .br
129: to check the type of a year:
130: an exit status of zero is taken to mean that the year is of the given type;
131: an exit status of one is taken to mean that the year is not of the given type.
132: .TP
133: .B IN
134: Names the month in which the rule takes effect.
135: Month names may be abbreviated.
136: .TP
137: .B ON
138: Gives the day on which the rule takes effect.
139: Recognized forms include:
140: .nf
141: .in +.5i
142: .sp
143: .ta \w'Sun<=25\0\0'u
144: 5 the fifth of the month
145: lastSun the last Sunday in the month
146: lastMon the last Monday in the month
147: Sun>=8 first Sunday on or after the eighth
148: Sun<=25 last Sunday on or before the 25th
149: .fi
150: .in -.5i
151: .sp
152: Names of days of the week may be abbreviated or spelled out in full.
153: Note that there must be no spaces within the
154: .B ON
155: field.
156: .TP
157: .B AT
158: Gives the time of day at which the rule takes effect.
159: Recognized forms include:
160: .nf
161: .in +.5i
162: .sp
163: .ta \w'1:28:13\0\0'u
164: 2 time in hours
165: 2:00 time in hours and minutes
166: 15:00 24-hour format time (for times after noon)
167: 1:28:14 time in hours, minutes, and seconds
168: .fi
169: .in -.5i
170: .sp
171: Any of these forms may be followed by the letter
172: .B w
173: if the given time is local ``wall clock'' time or
174: .B s
175: if the given time is local ``standard'' time; in the absence of
176: .B w
177: or
178: .BR s ,
179: wall clock time is assumed.
180: .TP
181: .B SAVE
182: Gives the amount of time to be added to local standard time when the rule is in
183: effect.
184: This field has the same format as the
185: .B AT
186: field
187: (although, of course, the
188: .B w
189: and
190: .B s
191: suffixes are not used).
192: .TP
193: .B LETTER/S
194: Gives the ``variable part'' (for example, the ``S'' or ``D'' in ``EST''
195: or ``EDT'') of time zone abbreviations to be used when this rule is in effect.
196: If this field is
197: .BR \- ,
198: the variable part is null.
199: .PP
200: A zone line has the form
201: .sp
202: .nf
203: .ti +.5i
204: .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
205: Zone NAME GMTOFF RULES/SAVE FORMAT [UNTIL]
206: .sp
207: For example:
208: .sp
209: .ti +.5i
210: Zone Australia/South\-west 9:30 Aus CST 1987 Mar 15 2:00
211: .sp
212: .fi
213: The fields that make up a zone line are:
214: .TP "\w'GMTOFF'u"
215: .B NAME
216: The name of the time zone.
217: This is the name used in creating the time conversion information file for the
218: zone.
219: .TP
220: .B GMTOFF
221: The amount of time to add to GMT to get standard time in this zone.
222: This field has the same format as the
223: .B AT
224: and
225: .B SAVE
226: fields of rule lines;
227: begin the field with a minus sign if time must be subtracted from GMT.
228: .TP
229: .B RULES/SAVE
230: The name of the rule(s) that apply in the time zone or,
231: alternately, an amount of time to add to local standard time.
232: If this field is
233: .B \-
234: then standard time always applies in the time zone.
235: .TP
236: .B FORMAT
237: The format for time zone abbreviations in this time zone.
238: The pair of characters
239: .B %s
240: is used to show where the ``variable part'' of the time zone abbreviation goes.
241: .B UNTIL
242: The time at which the GMT offset or the rule(s) change for a location.
243: It is specified as a year, a month, a day, and a time of day.
244: If this is specified,
245: the time zone information is generated from the given GMT offset
246: and rule change until the time specified.
247: .IP
248: The next line must be a
249: ``continuation'' line; this has the same form as a zone line except that the
250: string ``Zone'' and the name are omitted, as the continuation line will
251: place information starting at the time specified as the
252: .B UNTIL
253: field in the previous line in the file used by the previous line.
254: Continuation lines may contain an
255: .B UNTIL
256: field, just as zone lines do, indicating that the next line is a further
257: continuation.
258: .PP
259: A link line has the form
260: .sp
261: .nf
262: .ti +.5i
263: .if t .ta \w'Link\0\0'u +\w'LINK-FROM\0\0'u
264: .if n .ta \w'Link\0\0'u +\w'US/Eastern\0\0'u
265: Link LINK-FROM LINK-TO
266: .sp
267: For example:
268: .sp
269: .ti +.5i
270: Link US/Eastern EST5EDT
271: .sp
272: .fi
273: The
274: .B LINK-FROM
275: field should appear as the
276: .B NAME
277: field in some zone line;
278: the
279: .B LINK-TO
280: field is used as an alternate name for that zone.
281: .PP
282: Except for continuation lines,
283: lines may appear in any order in the input.
284: .SH NOTE
285: For areas with more than two types of local time,
286: you may need to use local standard time in the
287: .B AT
288: field of the earliest transition time's rule to ensure that
289: the earliest transition time recorded in the compiled file is correct.
290: .SH FILES
291: /etc/zoneinfo standard directory used for created files
292: .SH "SEE ALSO"
293: newctime(3), tzfile(5), zdump(8)
294: .. @(#)zic.8 3.1
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.