xref: /onnv-gate/usr/src/cmd/zic/README (revision 13047:3a5370c021db)
112063SNobutomo.Nakano@Sun.COMCopyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
20Sstevel@tonic-gate
30Sstevel@tonic-gateThe /usr/share/lib/zoneinfo/src directory contains zoneinfo timezone source
40Sstevel@tonic-gatefiles.  These source files have been compiled using zic(1M) to create
50Sstevel@tonic-gatethe zoneinfo data files in /usr/share/lib/zoneinfo.  The zic command can be
60Sstevel@tonic-gateused with the zoneinfo source files to create additional data files.
70Sstevel@tonic-gate
80Sstevel@tonic-gateThe zoneinfo files track the Olson public source provided at
90Sstevel@tonic-gateftp://elsie.nci.nih.gov/pub/, therefore zoneinfo files may be added and
100Sstevel@tonic-gateremoved as the Solaris source is updated.  The current Solaris release of
11*13047SNobutomo.Nakano@Sun.COMthe zoneinfo files is based on tzdata2010k.tar.gz.
120Sstevel@tonic-gate
130Sstevel@tonic-gateThe /usr/share/lib/zoneinfo/GMT[+-]* timezones listed below have been
140Sstevel@tonic-gateremoved from the release.  Replace usage of the
150Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT[+-]* files with the equivalent quoted timezone
160Sstevel@tonic-gate(see environ(5)).  Note the signs of the offsets of the equivalent quoted
170Sstevel@tonic-gatetimezone are reversed from the signs of the /usr/share/lib/zoneinfo/GMT[+-]*
180Sstevel@tonic-gatefiles.
190Sstevel@tonic-gate
200Sstevel@tonic-gateFor example, replace TZ=:GMT+1, with TZ="<GMT-1>-1".  (The colon (:) is
210Sstevel@tonic-gatesignificant.  Without the colon, for example TZ=GMT+1, an unquoted timezone
220Sstevel@tonic-gateis used;  unquoted timezones are not affected by the removal of the zoneinfo
230Sstevel@tonic-gatetimezone files listed below.)
240Sstevel@tonic-gate
250Sstevel@tonic-gateThe following files have been removed from the release:
260Sstevel@tonic-gate
270Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-12
280Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-11
290Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-10
300Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-9
310Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-8
320Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-7
330Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-6
340Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-5
350Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-4
360Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-3
370Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-2
380Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT-1
390Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+1
400Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+2
410Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+3
420Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+4
430Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+5
440Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+6
450Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+7
460Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+8
470Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+9
480Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+10
490Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+11
500Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+12
510Sstevel@tonic-gate/usr/share/lib/zoneinfo/GMT+13
520Sstevel@tonic-gate
530Sstevel@tonic-gateAs zoneinfo timezones are updated, the savings/daylight transition rules
540Sstevel@tonic-gateand timezone name abbreviations may change.  This can affect how
550Sstevel@tonic-gatethe times are calculated in the local timezone.  Therefore the interpretation
560Sstevel@tonic-gateof a time_t value can vary amongst Solaris releases that use different
570Sstevel@tonic-gateversions of the zoneinfo timezones.
580Sstevel@tonic-gate
590Sstevel@tonic-gateThe zoneinfo timezone data files do not transition past
600Sstevel@tonic-gateTue Jan 19 03:14:07 2038 GMT.  Therefore for 64-bit applications using
610Sstevel@tonic-gatezoneinfo timezones, calculations beyond this date may not use the correct
620Sstevel@tonic-gateoffset from standard time, and could return incorrect values.  This affects
630Sstevel@tonic-gate64-bit versions of interfaces such as ascftime(3C), cftime(3C), ctime(3C),
640Sstevel@tonic-gategetdate(3C), ftime(3C), mktime(3C), and localtime(3C).
650Sstevel@tonic-gate
660Sstevel@tonic-gateFor more information see zic(1M), zdump(1M), environ(5), TIMEZONE(4),
670Sstevel@tonic-gatectime(3C), and mktime(3C) man pages.
68