usr/src/cmd/zic/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 #
  15
  16 How to update the TZ database information.
  17
  18 Welcome! You've probably heard that some aspect of time has changed and
  19 you're wondering what to do. The first thing to do is to grab the latest
  20 version of the time database which can currently be found at:
  21
  22 http://www.iana.org/time-zones
  23
  24 You'll need the data tarball. Most data files are used in the gate
  25 directly; however, a few have slightly different names. The following
  26 commands assume that you're inside of the directory you extracted the
  27 time zone files.
  28
  29 $ cp africa antarctica asia australasia backward etcetera europe \
  30 northamerica pacificnew southamerica systemv $CODEMGR_WS/usr/src/cmd/zic
  31
  32 Next you need to copy the country tab and the zone tab files. These have
  33 different names in our source tree.
  34
  35 $ cp iso3166.tab $CODEMGR_WS/usr/src/cmd/zic/country.tab
  36 $ cp zone.tab $CODEMGR_WS/usr/src/cmd/zic/zone.tab.txt
  37
  38 Now, you need to manaully fix up the zone_sun.tab. zone_sun.tab has
  39 additional different zone names that the original does not. As things
  40 are changed and removed, or coordinates updated, the same should be done
  41 in zone_sun.tab. The simplest way known to deal with it today is
  42 something like the following:
  43
  44 $ cd $CODEMGR_WS/usr/src/cmd/zic
  45 $ vimdiff zone.tab.txt zone_sun.tab
  46
  47 And as you see things that show up as egregiously different, do a 'git
  48 diff zone.tab.txt' and see what changed and fix zone_sun.tab
  49 appropriately. Usually this means deleting removed entries and adding
  50 new ones.
  51
  52 After that's done, you'll need to go through the more agonizing process of
  53 packaging. To do this, you'll want to look through the differences that have
  54 occurred in zone.tab.txt and backward. The contents of backward describe
  55 hardlinks that need to exist in packaging. Specifically, if you have a line in
  56 the form of:
  57
  58 LINK    Beleriand       Gondolin
  59
  60 That instructs that Gondolin should be hardlinked to Beleriand. In ips parlance
  61 that'd be:
  62
  63 hardlink path=usr/share/lib/zoneinfo/Beleriand target=./Gondolin
  64
  65 The differences in zone.tab.txt describe the additions and removals of various
  66 file entries. If you're not friends with protocmp yet, this should help you out.
  67 Once both of those are done, you'll need to update the version of the package
  68 itself in the manifest. IANA releases these as <year><letter>, eg. 2013i.
  69 Instead, you need to encode that letter to its spot in the alphabet. So 2013i
  70 would become 2013.9.
  71
  72 Once packaging is all done, then you should be all set.