Name Date Size #Lines LOC

..10-Dec-2021-

MakefileH A D10-Dec-20211.5 KiB7848

READMEH A D14-Feb-20212.8 KiB6858

README.illumosH A D10-Dec-20213.7 KiB9270

africaH A D10-Dec-202164.6 KiB1,5641,419

antarcticaH A D10-Dec-202112.5 KiB336302

asiaH A D10-Dec-2021173.9 KiB3,9603,659

australasiaH A D10-Dec-202197.7 KiB2,2942,039

backwardH A D10-Dec-20214.8 KiB137133

continent.tabH A D14-Feb-2021257 1514

country.tabH A D14-Feb-20214.4 KiB275274

do_pofile.shH A D14-Feb-20211 KiB6945

etceteraH A D14-Feb-20212.6 KiB7968

europeH A D10-Dec-2021178.5 KiB4,2083,881

factoryH A D14-Feb-2021367 118

northamericaH A D10-Dec-2021160.5 KiB3,6953,434

southamericaH A D10-Dec-202186.1 KiB1,9571,856

systemvH A D14-Feb-20211.6 KiB4035

update_manifestH A D10-Dec-20212.3 KiB9967

zone.tab.txtH A D10-Dec-202119 KiB455454

zone_sun.tabH A D10-Dec-202121.1 KiB479478

zonelintH A D14-Feb-20211.5 KiB7342

README

1Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
2
3The /usr/share/lib/zoneinfo/src directory contains zoneinfo timezone source
4files.  These source files have been compiled using zic(1M) to create
5the zoneinfo data files in /usr/share/lib/zoneinfo.  The zic command can be
6used with the zoneinfo source files to create additional data files.
7
8The zoneinfo files track the Olson public source provided at
9ftp://elsie.nci.nih.gov/pub/, therefore zoneinfo files may be added and
10removed as the Solaris source is updated.  The current Solaris release of
11the zoneinfo files is based on tzdata2010k.tar.gz.
12
13The /usr/share/lib/zoneinfo/GMT[+-]* timezones listed below have been
14removed from the release.  Replace usage of the
15/usr/share/lib/zoneinfo/GMT[+-]* files with the equivalent quoted timezone
16(see environ(5)).  Note the signs of the offsets of the equivalent quoted
17timezone are reversed from the signs of the /usr/share/lib/zoneinfo/GMT[+-]*
18files.
19
20For example, replace TZ=:GMT+1, with TZ="<GMT-1>-1".  (The colon (:) is
21significant.  Without the colon, for example TZ=GMT+1, an unquoted timezone
22is used;  unquoted timezones are not affected by the removal of the zoneinfo
23timezone files listed below.)
24
25The following files have been removed from the release:
26
27/usr/share/lib/zoneinfo/GMT-12
28/usr/share/lib/zoneinfo/GMT-11
29/usr/share/lib/zoneinfo/GMT-10
30/usr/share/lib/zoneinfo/GMT-9
31/usr/share/lib/zoneinfo/GMT-8
32/usr/share/lib/zoneinfo/GMT-7
33/usr/share/lib/zoneinfo/GMT-6
34/usr/share/lib/zoneinfo/GMT-5
35/usr/share/lib/zoneinfo/GMT-4
36/usr/share/lib/zoneinfo/GMT-3
37/usr/share/lib/zoneinfo/GMT-2
38/usr/share/lib/zoneinfo/GMT-1
39/usr/share/lib/zoneinfo/GMT+1
40/usr/share/lib/zoneinfo/GMT+2
41/usr/share/lib/zoneinfo/GMT+3
42/usr/share/lib/zoneinfo/GMT+4
43/usr/share/lib/zoneinfo/GMT+5
44/usr/share/lib/zoneinfo/GMT+6
45/usr/share/lib/zoneinfo/GMT+7
46/usr/share/lib/zoneinfo/GMT+8
47/usr/share/lib/zoneinfo/GMT+9
48/usr/share/lib/zoneinfo/GMT+10
49/usr/share/lib/zoneinfo/GMT+11
50/usr/share/lib/zoneinfo/GMT+12
51/usr/share/lib/zoneinfo/GMT+13
52
53As zoneinfo timezones are updated, the savings/daylight transition rules
54and timezone name abbreviations may change.  This can affect how
55the times are calculated in the local timezone.  Therefore the interpretation
56of a time_t value can vary amongst Solaris releases that use different
57versions of the zoneinfo timezones.
58
59The zoneinfo timezone data files do not transition past
60Tue Jan 19 03:14:07 2038 GMT.  Therefore for 64-bit applications using
61zoneinfo timezones, calculations beyond this date may not use the correct
62offset from standard time, and could return incorrect values.  This affects
6364-bit versions of interfaces such as ascftime(3C), cftime(3C), ctime(3C),
64getdate(3C), ftime(3C), mktime(3C), and localtime(3C).
65
66For more information see zic(1M), zdump(1M), environ(5), TIMEZONE(4),
67ctime(3C), and mktime(3C) man pages.
68

README.illumos

1#
2# This file and its contents are supplied under the terms of the
3# Common Development and Distribution License ("CDDL"), version 1.0.
4# You may only use this file in accordance with the terms of version
5# 1.0 of the CDDL.
6#
7# A full copy of the text of the CDDL should have accompanied this
8# source.  A copy of the CDDL is also available via the Internet at
9# http://www.illumos.org/license/CDDL.
10#
11
12#
13# Copyright (c) 2014 Joyent, Inc.  All rights reserved.
14# Copyright 2021 OmniOS Community Edition (OmniOSce) Association.
15#
16
17How to update the TZ database information.
18
19Welcome! You've probably heard that some aspect of time has changed and
20you're wondering what to do. The first thing to do is to grab the latest
21version of the time database which can currently be found at:
22
23http://www.iana.org/time-zones
24
25You'll need the data tarball. Most data files are used in the gate
26directly; however, a few have slightly different names. The following
27commands assume that you're inside of the directory you extracted the
28time zone files.
29
30$ cp africa antarctica asia australasia backward etcetera europe \
31  northamerica southamerica $CODEMGR_WS/usr/src/data/zoneinfo
32
33Next you need to copy the country tab and the zone tab files. These have
34different names in our source tree.
35
36$ cp iso3166.tab $CODEMGR_WS/usr/src/data/zoneinfo/country.tab
37$ cp zone.tab $CODEMGR_WS/usr/src/data/zoneinfo/zone.tab.txt
38
39Now, you need to manually fix up the zone_sun.tab. zone_sun.tab has
40additional different zone names that the original does not. As things
41are changed and removed, or coordinates updated, the same should be done
42in zone_sun.tab. The simplest way known to deal with it today is
43something like the following:
44
45$ cd $CODEMGR_WS/usr/src/data/zoneinfo
46$ vimdiff zone.tab.txt zone_sun.tab
47
48And as you see things that show up as egregiously different, do a 'git
49diff zone.tab.txt' and see what changed and fix zone_sun.tab
50appropriately. Usually this means deleting removed entries and adding
51new ones.
52
53********** IMPORTANT **********
54*** zone_sun.tab must remain sorted.
55*** The upstream zone.tab.txt is not always completely in alphabetical order.
56
57To check the final zone_sun.tab file, the `zonelint` script in the current
58directory can be used within a bldenv environment. First run `dmake install`
59to stage the zone files to proto, then run `./zonelint`. If it produces no
60output then you're okay.
61
62After that's done, you'll need to go through the more agonizing process of
63packaging. To do this, you'll want to look through the differences in "Link"
64lines in all files under $CODEMGR_WS/usr/src/data/zoneinfo/
65These "Link" lines describe hardlinks that need to exist in packaging.
66Specifically, if you have a line in the form of:
67
68LINK	Arda/Beleriand	Arda/Gondolin
69
70That instructs that Gondolin should be hardlinked to Beleriand. In IPS parlance
71that'd be:
72
73hardlink path=usr/share/lib/zoneinfo/Arda/Gondolin target=Beleriand
74
75The 'update' make target can help with this by automatically re-generating all
76of the hardlinks in the package manifest based on the Link lines found in the
77data files. Run 'make update' and then check the manifest file at
78$CODEMGR_WS/usr/src/pkg/manifests/system-data-zoneinfo.p5m to ensure it has
79done the right thing.
80
81Other differences in files describe the addition and removal of various
82file entries. The update_manifest script will take care of files which have
83changed to links but others may need manual adjustment. If you're not friends
84with protocmp yet, this should help you out.
85
86Once both of those are done, you'll need to update the version of the package
87itself in the manifest. IANA releases these as <year><letter>, eg. 2013i.
88Instead, you need to encode that letter to its spot in the alphabet. So 2013i
89would become 2013.9.
90
91Once packaging is all done, then you should be all set.
92