summaryrefslogtreecommitdiff
path: root/usr/src/cmd/zic/README.illumos
blob: 27799b3bff8312c984d592861fbb248caf2de5f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
#
# This file and its contents are supplied under the terms of the
# Common Development and Distribution License ("CDDL"), version 1.0.
# You may only use this file in accordance with the terms of version
# 1.0 of the CDDL.
#
# A full copy of the text of the CDDL should have accompanied this
# source.  A copy of the CDDL is also available via the Internet at
# http://www.illumos.org/license/CDDL.
#

#
# Copyright (c) 2014 Joyent, Inc.  All rights reserved.
#

How to update the TZ database information.

Welcome! You've probably heard that some aspect of time has changed and
you're wondering what to do. The first thing to do is to grab the latest
version of the time database which can currently be found at:

http://www.iana.org/time-zones

You'll need the data tarball. Most data files are used in the gate
direcetly; however, a few have slightly different names. The following
commands assume that you're inside of the directory you extracted the
time zone files.

$ cp africa antarctica asia australasia backward etcetera europe \
northamerica pacificnew southamerica systemv $CODEMGR_WS/usr/src/cmd/zic

Next you need to copy the country tab and the zone tab files. These have
different names in our source tree.

$ cp iso3166.tab $CODEMGR_WS/usr/src/cmd/zic/country.tab
$ cp zone.tab $CODEMGR_WS/usr/src/cmd/zic/zone.tab.txt

Now, you need to manaully fix up the zone_sun.tab. zone_sun.tab has
additional different zone names that the original does not. As things
are changed and removed, or coordinates updated, the same should be done
in zone_sun.tab. The simplest way known to deal with it today is
something like the following:

$ cd $CODEMGR_WS/usr/src/cmd/zic
$ vimdiff zone.tab.txt zone_sun.tab

And as you see things that show up as egregiously different, do a 'git
diff zone.tab.txt' and see what changed and fix zone_sun.tab
appropriately. Usually this means deleting removed entries and adding
new ones.

Once that's all set, you should be good to go.