Merged revisions 82285 via svnmerge from
[asterisk/asterisk.git] / main / stdtime / tzfile.h
1 #ifndef TZFILE_H
2
3 #define TZFILE_H
4
5 /*
6 ** This file is in the public domain, so clarified as of
7 ** 1996-06-05 by Arthur David Olson.
8 */
9
10 /*
11 ** This header is for use ONLY with the time conversion code.
12 ** There is no guarantee that it will remain unchanged,
13 ** or that it will remain at all.
14 ** Do NOT copy it to any system include directory.
15 ** Thank you!
16 */
17
18 /*
19 ** ID
20 */
21
22 #ifndef lint
23 #ifndef NOID
24 static char     __attribute__((unused)) tzfilehid[] = "@(#)tzfile.h     8.1";
25 #endif /* !defined NOID */
26 #endif /* !defined lint */
27
28 /*
29 ** Information about time zone files.
30 */
31
32 #ifndef TZDIR
33 #ifdef SOLARIS
34 #define TZDIR   "/usr/share/lib/zoneinfo"
35 #else
36 #ifdef FREEBSD
37 #define TZDIR   "/usr/local/etc/zoneinfo" /* Time zone object file directory */
38 #else
39 #define TZDIR   "/usr/share/zoneinfo"
40 #endif /* defined FREEBSD */
41 #endif /* defined SOLARIS */
42 #endif /* !defined TZDIR */
43
44 #ifndef TZDEFAULT
45 #define TZDEFAULT       "localtime"
46 #endif /* !defined TZDEFAULT */
47
48 #ifndef TZDEFRULES
49 #define TZDEFRULES      "posixrules"
50 #endif /* !defined TZDEFRULES */
51
52 /*
53 ** Each file begins with. . .
54 */
55
56 #define TZ_MAGIC        "TZif"
57
58 struct tzhead {
59         char    tzh_magic[4];           /* TZ_MAGIC */
60         char    tzh_version[1];         /* '\0' or '2' as of 2005 */
61         char    tzh_reserved[15];       /* reserved--must be zero */
62         char    tzh_ttisgmtcnt[4];      /* coded number of trans. time flags */
63         char    tzh_ttisstdcnt[4];      /* coded number of trans. time flags */
64         char    tzh_leapcnt[4];         /* coded number of leap seconds */
65         char    tzh_timecnt[4];         /* coded number of transition times */
66         char    tzh_typecnt[4];         /* coded number of local time types */
67         char    tzh_charcnt[4];         /* coded number of abbr. chars */
68 };
69
70 /*
71 ** . . .followed by. . .
72 **
73 **      tzh_timecnt (char [4])s         coded transition times a la time(2)
74 **      tzh_timecnt (unsigned char)s    types of local time starting at above
75 **      tzh_typecnt repetitions of
76 **              one (char [4])          coded UTC offset in seconds
77 **              one (unsigned char)     used to set tm_isdst
78 **              one (unsigned char)     that's an abbreviation list index
79 **      tzh_charcnt (char)s             '\0'-terminated zone abbreviations
80 **      tzh_leapcnt repetitions of
81 **              one (char [4])          coded leap second transition times
82 **              one (char [4])          total correction after above
83 **      tzh_ttisstdcnt (char)s          indexed by type; if TRUE, transition
84 **                                      time is standard time, if FALSE,
85 **                                      transition time is wall clock time
86 **                                      if absent, transition times are
87 **                                      assumed to be wall clock time
88 **      tzh_ttisgmtcnt (char)s          indexed by type; if TRUE, transition
89 **                                      time is UTC, if FALSE,
90 **                                      transition time is local time
91 **                                      if absent, transition times are
92 **                                      assumed to be local time
93 */
94
95 /*
96 ** If tzh_version is '2' or greater, the above is followed by a second instance
97 ** of tzhead and a second instance of the data in which each coded transition
98 ** time uses 8 rather than 4 chars,
99 ** then a POSIX-TZ-environment-variable-style string for use in handling
100 ** instants after the last transition time stored in the file
101 ** (with nothing between the newlines if there is no POSIX representation for
102 ** such instants).
103 */
104
105 /*
106 ** In the current implementation, "tzset()" refuses to deal with files that
107 ** exceed any of the limits below.
108 */
109
110 #ifndef TZ_MAX_TIMES
111 #define TZ_MAX_TIMES    1200
112 #endif /* !defined TZ_MAX_TIMES */
113
114 #ifndef TZ_MAX_TYPES
115 #ifndef NOSOLAR
116 #define TZ_MAX_TYPES    256 /* Limited by what (unsigned char)'s can hold */
117 #endif /* !defined NOSOLAR */
118 #ifdef NOSOLAR
119 /*
120 ** Must be at least 14 for Europe/Riga as of Jan 12 1995,
121 ** as noted by Earl Chew.
122 */
123 #define TZ_MAX_TYPES    20      /* Maximum number of local time types */
124 #endif /* !defined NOSOLAR */
125 #endif /* !defined TZ_MAX_TYPES */
126
127 #ifndef TZ_MAX_CHARS
128 #define TZ_MAX_CHARS    50      /* Maximum number of abbreviation characters */
129                                 /* (limited by what unsigned chars can hold) */
130 #endif /* !defined TZ_MAX_CHARS */
131
132 #ifndef TZ_MAX_LEAPS
133 #define TZ_MAX_LEAPS    50      /* Maximum number of leap second corrections */
134 #endif /* !defined TZ_MAX_LEAPS */
135
136 #define SECSPERMIN      60
137 #define MINSPERHOUR     60
138 #define HOURSPERDAY     24
139 #define DAYSPERWEEK     7
140 #define DAYSPERNYEAR    365
141 #define DAYSPERLYEAR    366
142 #define SECSPERHOUR     (SECSPERMIN * MINSPERHOUR)
143 #define SECSPERDAY      ((long) SECSPERHOUR * HOURSPERDAY)
144 #define MONSPERYEAR     12
145
146 #define TM_SUNDAY       0
147 #define TM_MONDAY       1
148 #define TM_TUESDAY      2
149 #define TM_WEDNESDAY    3
150 #define TM_THURSDAY     4
151 #define TM_FRIDAY       5
152 #define TM_SATURDAY     6
153
154 #define TM_JANUARY      0
155 #define TM_FEBRUARY     1
156 #define TM_MARCH        2
157 #define TM_APRIL        3
158 #define TM_MAY          4
159 #define TM_JUNE         5
160 #define TM_JULY         6
161 #define TM_AUGUST       7
162 #define TM_SEPTEMBER    8
163 #define TM_OCTOBER      9
164 #define TM_NOVEMBER     10
165 #define TM_DECEMBER     11
166
167 #define TM_YEAR_BASE    1900
168
169 #define EPOCH_YEAR      1970
170 #define EPOCH_WDAY      TM_THURSDAY
171
172 #define isleap(y) (((y) % 4) == 0 && (((y) % 100) != 0 || ((y) % 400) == 0))
173
174 /*
175 ** Since everything in isleap is modulo 400 (or a factor of 400), we know that
176 **      isleap(y) == isleap(y % 400)
177 ** and so
178 **      isleap(a + b) == isleap((a + b) % 400)
179 ** or
180 **      isleap(a + b) == isleap(a % 400 + b % 400)
181 ** This is true even if % means modulo rather than Fortran remainder
182 ** (which is allowed by C89 but not C99).
183 ** We use this to avoid addition overflow problems.
184 */
185
186 #define isleap_sum(a, b)        isleap((a) % 400 + (b) % 400)
187
188 #endif /* !defined TZFILE_H */