Home | History | Annotate | Line # | Download | only in time
private.h revision 1.65
      1 /* Private header for tzdb code.  */
      2 
      3 /*	$NetBSD: private.h,v 1.65 2023/01/15 18:12:37 christos Exp $	*/
      4 
      5 #ifndef PRIVATE_H
      6 #define PRIVATE_H
      7 
      8 /* NetBSD defaults */
      9 #define TM_GMTOFF	tm_gmtoff
     10 #define TM_ZONE		tm_zone
     11 #define STD_INSPIRED	1
     12 #define HAVE_LONG_DOUBLE 1
     13 
     14 /* For when we build zic as a host tool. */
     15 #if HAVE_NBTOOL_CONFIG_H
     16 #include "nbtool_config.h"
     17 #endif
     18 
     19 /*
     20 ** This file is in the public domain, so clarified as of
     21 ** 1996-06-05 by Arthur David Olson.
     22 */
     23 
     24 /*
     25 ** This header is for use ONLY with the time conversion code.
     26 ** There is no guarantee that it will remain unchanged,
     27 ** or that it will remain at all.
     28 ** Do NOT copy it to any system include directory.
     29 ** Thank you!
     30 */
     31 
     32 #ifndef __STDC_VERSION__
     33 # define __STDC_VERSION__ 0
     34 #endif
     35 
     36 /* Define true, false and bool if they don't work out of the box.  */
     37 #if __STDC_VERSION__ < 199901
     38 # define true 1
     39 # define false 0
     40 # define bool int
     41 #elif __STDC_VERSION__ < 202311
     42 # include <stdbool.h>
     43 #endif
     44 
     45 /*
     46 ** zdump has been made independent of the rest of the time
     47 ** conversion package to increase confidence in the verification it provides.
     48 ** You can use zdump to help in verifying other implementations.
     49 ** To do this, compile with -DUSE_LTZ=0 and link without the tz library.
     50 */
     51 #ifndef USE_LTZ
     52 # define USE_LTZ 1
     53 #endif
     54 
     55 /* This string was in the Factory zone through version 2016f.  */
     56 #define GRANDPARENTED	"Local time zone must be set--see zic manual page"
     57 
     58 /*
     59 ** Defaults for preprocessor symbols.
     60 ** You can override these in your C compiler options, e.g. '-DHAVE_GETTEXT=1'.
     61 */
     62 
     63 #ifndef HAVE_DECL_ASCTIME_R
     64 # define HAVE_DECL_ASCTIME_R 1
     65 #endif
     66 
     67 #if !defined HAVE_GENERIC && defined __has_extension
     68 # if __has_extension(c_generic_selections)
     69 #  define HAVE_GENERIC 1
     70 # else
     71 #  define HAVE_GENERIC 0
     72 # endif
     73 #endif
     74 /* _Generic is buggy in pre-4.9 GCC.  */
     75 #if !defined HAVE_GENERIC && defined __GNUC__ && !defined __STRICT_ANSI__
     76 # define HAVE_GENERIC (4 < __GNUC__ + (9 <= __GNUC_MINOR__))
     77 #endif
     78 #ifndef HAVE_GENERIC
     79 # define HAVE_GENERIC (201112 <= __STDC_VERSION__)
     80 #endif
     81 
     82 #if !defined HAVE_GETTEXT && defined __has_include
     83 # if __has_include(<libintl.h>)
     84 #  define HAVE_GETTEXT true
     85 # endif
     86 #endif
     87 #ifndef HAVE_GETTEXT
     88 # define HAVE_GETTEXT false
     89 #endif
     90 
     91 #ifndef HAVE_INCOMPATIBLE_CTIME_R
     92 # define HAVE_INCOMPATIBLE_CTIME_R 0
     93 #endif
     94 
     95 #ifndef HAVE_LINK
     96 # define HAVE_LINK 1
     97 #endif /* !defined HAVE_LINK */
     98 
     99 #ifndef HAVE_MALLOC_ERRNO
    100 # define HAVE_MALLOC_ERRNO 1
    101 #endif
    102 
    103 #ifndef HAVE_POSIX_DECLS
    104 # define HAVE_POSIX_DECLS 1
    105 #endif
    106 
    107 #ifndef HAVE_SETENV
    108 # define HAVE_SETENV 1
    109 #endif
    110 
    111 #ifndef HAVE_STRDUP
    112 # define HAVE_STRDUP 1
    113 #endif
    114 
    115 #ifndef HAVE_STRTOLL
    116 # define HAVE_STRTOLL 1
    117 #endif
    118 
    119 #ifndef HAVE_SYMLINK
    120 # define HAVE_SYMLINK 1
    121 #endif /* !defined HAVE_SYMLINK */
    122 
    123 #if !defined HAVE_SYS_STAT_H && defined __has_include
    124 # if !__has_include(<sys/stat.h>)
    125 #  define HAVE_SYS_STAT_H false
    126 # endif
    127 #endif
    128 #ifndef HAVE_SYS_STAT_H
    129 # define HAVE_SYS_STAT_H true
    130 #endif
    131 
    132 #if !defined HAVE_UNISTD_H && defined __has_include
    133 # if !__has_include(<unistd.h>)
    134 #  define HAVE_UNISTD_H false
    135 # endif
    136 #endif
    137 #ifndef HAVE_UNISTD_H
    138 # define HAVE_UNISTD_H true
    139 #endif
    140 
    141 #ifndef NETBSD_INSPIRED
    142 # define NETBSD_INSPIRED 1
    143 #endif
    144 
    145 #if HAVE_INCOMPATIBLE_CTIME_R
    146 # define asctime_r _incompatible_asctime_r
    147 # define ctime_r _incompatible_ctime_r
    148 #endif /* HAVE_INCOMPATIBLE_CTIME_R */
    149 
    150 /* Enable tm_gmtoff, tm_zone, and environ on GNUish systems.  */
    151 #define _GNU_SOURCE 1
    152 /* Fix asctime_r on Solaris 11.  */
    153 #define _POSIX_PTHREAD_SEMANTICS 1
    154 /* Enable strtoimax on pre-C99 Solaris 11.  */
    155 #define __EXTENSIONS__ 1
    156 
    157 /* On GNUish systems where time_t might be 32 or 64 bits, use 64.
    158    On these platforms _FILE_OFFSET_BITS must also be 64; otherwise
    159    setting _TIME_BITS to 64 does not work.  The code does not
    160    otherwise rely on _FILE_OFFSET_BITS being 64, since it does not
    161    use off_t or functions like 'stat' that depend on off_t.  */
    162 #ifndef _FILE_OFFSET_BITS
    163 # define _FILE_OFFSET_BITS 64
    164 #endif
    165 #if !defined _TIME_BITS && _FILE_OFFSET_BITS == 64
    166 # define _TIME_BITS 64
    167 #endif
    168 
    169 /*
    170 ** Nested includes
    171 */
    172 
    173 #ifndef __NetBSD__
    174 /* Avoid clashes with NetBSD by renaming NetBSD's declarations.
    175    If defining the 'timezone' variable, avoid a clash with FreeBSD's
    176    'timezone' function by renaming its declaration.  */
    177 #define localtime_rz sys_localtime_rz
    178 #define mktime_z sys_mktime_z
    179 #define posix2time_z sys_posix2time_z
    180 #define time2posix_z sys_time2posix_z
    181 #if defined USG_COMPAT && USG_COMPAT == 2
    182 # define timezone sys_timezone
    183 #endif
    184 #define timezone_t sys_timezone_t
    185 #define tzalloc sys_tzalloc
    186 #define tzfree sys_tzfree
    187 #include <time.h>
    188 #undef localtime_rz
    189 #undef mktime_z
    190 #undef posix2time_z
    191 #undef time2posix_z
    192 #if defined USG_COMPAT && USG_COMPAT == 2
    193 # undef timezone
    194 #endif
    195 #undef timezone_t
    196 #undef tzalloc
    197 #undef tzfree
    198 #else
    199 #include "time.h"
    200 #endif
    201 
    202 #include <stddef.h>
    203 #include <string.h>
    204 #include <limits.h>	/* for CHAR_BIT et al. */
    205 #include <stdlib.h>
    206 
    207 #include <errno.h>
    208 
    209 #ifndef EINVAL
    210 # define EINVAL ERANGE
    211 #endif
    212 
    213 #ifndef ELOOP
    214 # define ELOOP EINVAL
    215 #endif
    216 #ifndef ENAMETOOLONG
    217 # define ENAMETOOLONG EINVAL
    218 #endif
    219 #ifndef ENOMEM
    220 # define ENOMEM EINVAL
    221 #endif
    222 #ifndef ENOTSUP
    223 # define ENOTSUP EINVAL
    224 #endif
    225 #ifndef EOVERFLOW
    226 # define EOVERFLOW EINVAL
    227 #endif
    228 
    229 #if HAVE_GETTEXT
    230 # include <libintl.h>
    231 #endif /* HAVE_GETTEXT */
    232 
    233 #if HAVE_UNISTD_H
    234 # include <unistd.h> /* for R_OK, and other POSIX goodness */
    235 #endif /* HAVE_UNISTD_H */
    236 
    237 #ifndef HAVE_STRFTIME_L
    238 # if _POSIX_VERSION < 200809
    239 #  define HAVE_STRFTIME_L 0
    240 # else
    241 #  define HAVE_STRFTIME_L 1
    242 # endif
    243 #endif
    244 
    245 #ifndef USG_COMPAT
    246 # ifndef _XOPEN_VERSION
    247 #  define USG_COMPAT 0
    248 # else
    249 #  define USG_COMPAT 1
    250 # endif
    251 #endif
    252 
    253 #ifndef HAVE_TZNAME
    254 # if _POSIX_VERSION < 198808 && !USG_COMPAT
    255 #  define HAVE_TZNAME 0
    256 # else
    257 #  define HAVE_TZNAME 1
    258 # endif
    259 #endif
    260 
    261 #ifndef ALTZONE
    262 # if defined __sun || defined _M_XENIX
    263 #  define ALTZONE 1
    264 # else
    265 #  define ALTZONE 0
    266 # endif
    267 #endif
    268 
    269 #ifndef R_OK
    270 # define R_OK 4
    271 #endif /* !defined R_OK */
    272 
    273 /*
    274 ** Define HAVE_STDINT_H's default value here, rather than at the
    275 ** start, since __GLIBC__ and INTMAX_MAX's values depend on
    276 ** previously-included files.  glibc 2.1 and Solaris 10 and later have
    277 ** stdint.h, even with pre-C99 compilers.
    278 */
    279 #if !defined HAVE_STDINT_H && defined __has_include
    280 # define HAVE_STDINT_H true /* C23 __has_include implies C99 stdint.h.  */
    281 #endif
    282 #ifndef HAVE_STDINT_H
    283 # define HAVE_STDINT_H \
    284    (199901 <= __STDC_VERSION__ \
    285     || 2 < __GLIBC__ + (1 <= __GLIBC_MINOR__) \
    286     || __CYGWIN__ || INTMAX_MAX)
    287 #endif /* !defined HAVE_STDINT_H */
    288 
    289 #if HAVE_STDINT_H
    290 # include <stdint.h>
    291 #endif /* !HAVE_STDINT_H */
    292 
    293 #ifndef HAVE_INTTYPES_H
    294 # define HAVE_INTTYPES_H HAVE_STDINT_H
    295 #endif
    296 #if HAVE_INTTYPES_H
    297 # include <inttypes.h>
    298 #endif
    299 
    300 /* Pre-C99 GCC compilers define __LONG_LONG_MAX__ instead of LLONG_MAX.  */
    301 #if defined __LONG_LONG_MAX__ && !defined __STRICT_ANSI__
    302 # ifndef LLONG_MAX
    303 #  define LLONG_MAX __LONG_LONG_MAX__
    304 # endif
    305 # ifndef LLONG_MIN
    306 #  define LLONG_MIN (-1 - LLONG_MAX)
    307 # endif
    308 # ifndef ULLONG_MAX
    309 #  define ULLONG_MAX (LLONG_MAX * 2ull + 1)
    310 # endif
    311 #endif
    312 
    313 #ifndef INT_FAST64_MAX
    314 # if 1 <= LONG_MAX >> 31 >> 31
    315 typedef long int_fast64_t;
    316 #  define INT_FAST64_MIN LONG_MIN
    317 #  define INT_FAST64_MAX LONG_MAX
    318 # else
    319 /* If this fails, compile with -DHAVE_STDINT_H or with a better compiler.  */
    320 typedef long long int_fast64_t;
    321 #  define INT_FAST64_MIN LLONG_MIN
    322 #  define INT_FAST64_MAX LLONG_MAX
    323 # endif
    324 #endif
    325 
    326 #ifndef PRIdFAST64
    327 # if INT_FAST64_MAX == LONG_MAX
    328 #  define PRIdFAST64 "ld"
    329 # else
    330 #  define PRIdFAST64 "lld"
    331 # endif
    332 #endif
    333 
    334 #ifndef SCNdFAST64
    335 # define SCNdFAST64 PRIdFAST64
    336 #endif
    337 
    338 #ifndef INT_FAST32_MAX
    339 # if INT_MAX >> 31 == 0
    340 typedef long int_fast32_t;
    341 #  define INT_FAST32_MAX LONG_MAX
    342 #  define INT_FAST32_MIN LONG_MIN
    343 # else
    344 typedef int int_fast32_t;
    345 #  define INT_FAST32_MAX INT_MAX
    346 #  define INT_FAST32_MIN INT_MIN
    347 # endif
    348 #endif
    349 
    350 #ifndef INTMAX_MAX
    351 # ifdef LLONG_MAX
    352 typedef long long intmax_t;
    353 #  if HAVE_STRTOLL
    354 #   define strtoimax strtoll
    355 #  endif
    356 #  define INTMAX_MAX LLONG_MAX
    357 #  define INTMAX_MIN LLONG_MIN
    358 # else
    359 typedef long intmax_t;
    360 #  define INTMAX_MAX LONG_MAX
    361 #  define INTMAX_MIN LONG_MIN
    362 # endif
    363 # ifndef strtoimax
    364 #  define strtoimax strtol
    365 # endif
    366 #endif
    367 
    368 #ifndef PRIdMAX
    369 # if INTMAX_MAX == LLONG_MAX
    370 #  define PRIdMAX "lld"
    371 # else
    372 #  define PRIdMAX "ld"
    373 # endif
    374 #endif
    375 
    376 #ifndef PTRDIFF_MAX
    377 # define PTRDIFF_MAX MAXVAL(ptrdiff_t, TYPE_BIT(ptrdiff_t))
    378 #endif
    379 
    380 #ifndef UINT_FAST32_MAX
    381 typedef unsigned long uint_fast32_t;
    382 #endif
    383 
    384 #ifndef UINT_FAST64_MAX
    385 # if 3 <= ULONG_MAX >> 31 >> 31
    386 typedef unsigned long uint_fast64_t;
    387 #  define UINT_FAST64_MAX ULONG_MAX
    388 # else
    389 /* If this fails, compile with -DHAVE_STDINT_H or with a better compiler.  */
    390 typedef unsigned long long uint_fast64_t;
    391 #  define UINT_FAST64_MAX ULLONG_MAX
    392 # endif
    393 #endif
    394 
    395 #ifndef UINTMAX_MAX
    396 # ifdef ULLONG_MAX
    397 typedef unsigned long long uintmax_t;
    398 # else
    399 typedef unsigned long uintmax_t;
    400 # endif
    401 #endif
    402 
    403 #ifndef PRIuMAX
    404 # ifdef ULLONG_MAX
    405 #  define PRIuMAX "llu"
    406 # else
    407 #  define PRIuMAX "lu"
    408 # endif
    409 #endif
    410 
    411 #ifndef SIZE_MAX
    412 # define SIZE_MAX ((size_t) -1)
    413 #endif
    414 
    415 /* Support ckd_add, ckd_sub, ckd_mul on C23 or recent-enough GCC-like
    416    hosts, unless compiled with -DHAVE_STDCKDINT_H=0 or with pre-C23 EDG.  */
    417 #if !defined HAVE_STDCKDINT_H && defined __has_include
    418 # if __has_include(<stdckdint.h>)
    419 #  define HAVE_STDCKDINT_H true
    420 # endif
    421 #endif
    422 #ifdef HAVE_STDCKDINT_H
    423 # if HAVE_STDCKDINT_H
    424 #  include <stdckdint.h>
    425 # endif
    426 #elif defined __EDG__
    427 /* Do nothing, to work around EDG bug <https://bugs.gnu.org/53256>.  */
    428 #elif defined __has_builtin
    429 # if __has_builtin(__builtin_add_overflow)
    430 #  define ckd_add(r, a, b) __builtin_add_overflow(a, b, r)
    431 # endif
    432 # if __has_builtin(__builtin_sub_overflow)
    433 #  define ckd_sub(r, a, b) __builtin_sub_overflow(a, b, r)
    434 # endif
    435 # if __has_builtin(__builtin_mul_overflow)
    436 #  define ckd_mul(r, a, b) __builtin_mul_overflow(a, b, r)
    437 # endif
    438 #elif 7 <= __GNUC__
    439 # define ckd_add(r, a, b) __builtin_add_overflow(a, b, r)
    440 # define ckd_sub(r, a, b) __builtin_sub_overflow(a, b, r)
    441 # define ckd_mul(r, a, b) __builtin_mul_overflow(a, b, r)
    442 #endif
    443 
    444 #if 3 <= __GNUC__
    445 # define ATTRIBUTE_MALLOC __attribute__((__malloc__))
    446 # define ATTRIBUTE_FORMAT(spec) __attribute__((__format__ spec))
    447 #else
    448 # define ATTRIBUTE_MALLOC /* empty */
    449 # define ATTRIBUTE_FORMAT(spec) /* empty */
    450 #endif
    451 
    452 #if (defined __has_c_attribute \
    453      && (202311 <= __STDC_VERSION__ || !defined __STRICT_ANSI__))
    454 # define HAVE_HAS_C_ATTRIBUTE true
    455 #else
    456 # define HAVE_HAS_C_ATTRIBUTE false
    457 #endif
    458 
    459 #if HAVE_HAS_C_ATTRIBUTE
    460 # if __has_c_attribute(fallthrough)
    461 #  define ATTRIBUTE_FALLTHROUGH [[fallthrough]]
    462 # endif
    463 #endif
    464 #ifndef ATTRIBUTE_FALLTHROUGH
    465 # if 7 <= __GNUC__
    466 #  define ATTRIBUTE_FALLTHROUGH __attribute__((fallthrough))
    467 # else
    468 #  define ATTRIBUTE_FALLTHROUGH ((void) 0)
    469 # endif
    470 #endif
    471 
    472 #if HAVE_HAS_C_ATTRIBUTE
    473 # if __has_c_attribute(maybe_unused)
    474 #  define ATTRIBUTE_MAYBE_UNUSED [[maybe_unused]]
    475 # endif
    476 #endif
    477 #ifndef ATTRIBUTE_MAYBE_UNUSED
    478 # if 2 < __GNUC__ + (7 <= __GNUC_MINOR__)
    479 #  define ATTRIBUTE_MAYBE_UNUSED __attribute__((unused))
    480 # else
    481 #  define ATTRIBUTE_MAYBE_UNUSED /* empty */
    482 # endif
    483 #endif
    484 
    485 #if HAVE_HAS_C_ATTRIBUTE
    486 # if __has_c_attribute(noreturn)
    487 #  define ATTRIBUTE_NORETURN [[noreturn]]
    488 # endif
    489 #endif
    490 #ifndef ATTRIBUTE_NORETURN
    491 # if 201112 <= __STDC_VERSION__
    492 #  define ATTRIBUTE_NORETURN _Noreturn
    493 # elif 2 < __GNUC__ + (8 <= __GNUC_MINOR__)
    494 #  define ATTRIBUTE_NORETURN __attribute__((noreturn))
    495 # else
    496 #  define ATTRIBUTE_NORETURN /* empty */
    497 # endif
    498 #endif
    499 
    500 #if HAVE_HAS_C_ATTRIBUTE
    501 # if __has_c_attribute(reproducible)
    502 #  define ATTRIBUTE_REPRODUCIBLE [[reproducible]]
    503 # endif
    504 #endif
    505 #ifndef ATTRIBUTE_REPRODUCIBLE
    506 # if 3 <= __GNUC__
    507 #  define ATTRIBUTE_REPRODUCIBLE __attribute__((pure))
    508 # else
    509 #  define ATTRIBUTE_REPRODUCIBLE /* empty */
    510 # endif
    511 #endif
    512 
    513 #if HAVE_HAS_C_ATTRIBUTE
    514 # if __has_c_attribute(unsequenced)
    515 #  define ATTRIBUTE_UNSEQUENCED [[unsequenced]]
    516 # endif
    517 #endif
    518 #ifndef ATTRIBUTE_UNSEQUENCED
    519 # if 3 <= __GNUC__
    520 #  define ATTRIBUTE_UNSEQUENCED __attribute__((const))
    521 # else
    522 #  define ATTRIBUTE_UNSEQUENCED /* empty */
    523 # endif
    524 #endif
    525 
    526 #if __STDC_VERSION__ < 199901 && !defined restrict
    527 # define restrict /* empty */
    528 #endif
    529 
    530 /*
    531 ** Workarounds for compilers/systems.
    532 */
    533 
    534 #ifndef EPOCH_LOCAL
    535 # define EPOCH_LOCAL 0
    536 #endif
    537 #ifndef EPOCH_OFFSET
    538 # define EPOCH_OFFSET 0
    539 #endif
    540 #ifndef RESERVE_STD_EXT_IDS
    541 # define RESERVE_STD_EXT_IDS 0
    542 #endif
    543 
    544 /* If standard C identifiers with external linkage (e.g., localtime)
    545    are reserved and are not already being renamed anyway, rename them
    546    as if compiling with '-Dtime_tz=time_t'.  */
    547 #if !defined time_tz && RESERVE_STD_EXT_IDS && USE_LTZ
    548 # define time_tz time_t
    549 #endif
    550 
    551 /*
    552 ** Compile with -Dtime_tz=T to build the tz package with a private
    553 ** time_t type equivalent to T rather than the system-supplied time_t.
    554 ** This debugging feature can test unusual design decisions
    555 ** (e.g., time_t wider than 'long', or unsigned time_t) even on
    556 ** typical platforms.
    557 */
    558 #if defined time_tz || EPOCH_LOCAL || EPOCH_OFFSET != 0
    559 # define TZ_TIME_T 1
    560 #else
    561 # define TZ_TIME_T 0
    562 #endif
    563 
    564 #if defined LOCALTIME_IMPLEMENTATION && TZ_TIME_T
    565 static time_t sys_time(time_t *x) { return time(x); }
    566 #endif
    567 
    568 #if TZ_TIME_T
    569 
    570 typedef time_tz tz_time_t;
    571 
    572 # undef  asctime
    573 # define asctime tz_asctime
    574 # undef  asctime_r
    575 # define asctime_r tz_asctime_r
    576 # undef  ctime
    577 # define ctime tz_ctime
    578 # undef  ctime_r
    579 # define ctime_r tz_ctime_r
    580 # undef  difftime
    581 # define difftime tz_difftime
    582 # undef  gmtime
    583 # define gmtime tz_gmtime
    584 # undef  gmtime_r
    585 # define gmtime_r tz_gmtime_r
    586 # undef  localtime
    587 # define localtime tz_localtime
    588 # undef  localtime_r
    589 # define localtime_r tz_localtime_r
    590 # undef  localtime_rz
    591 # define localtime_rz tz_localtime_rz
    592 # undef  mktime
    593 # define mktime tz_mktime
    594 # undef  mktime_z
    595 # define mktime_z tz_mktime_z
    596 # undef  offtime
    597 # define offtime tz_offtime
    598 # undef  posix2time
    599 # define posix2time tz_posix2time
    600 # undef  posix2time_z
    601 # define posix2time_z tz_posix2time_z
    602 # undef  strftime
    603 # define strftime tz_strftime
    604 # undef  time
    605 # define time tz_time
    606 # undef  time2posix
    607 # define time2posix tz_time2posix
    608 # undef  time2posix_z
    609 # define time2posix_z tz_time2posix_z
    610 # undef  time_t
    611 # define time_t tz_time_t
    612 # undef  timegm
    613 # define timegm tz_timegm
    614 # undef  timelocal
    615 # define timelocal tz_timelocal
    616 # undef  timeoff
    617 # define timeoff tz_timeoff
    618 # undef  tzalloc
    619 # define tzalloc tz_tzalloc
    620 # undef  tzfree
    621 # define tzfree tz_tzfree
    622 # undef  tzset
    623 # define tzset tz_tzset
    624 # undef  tzsetwall
    625 # define tzsetwall tz_tzsetwall
    626 # if HAVE_STRFTIME_L
    627 #  undef  strftime_l
    628 #  define strftime_l tz_strftime_l
    629 # endif
    630 # if HAVE_TZNAME
    631 #  undef  tzname
    632 #  define tzname tz_tzname
    633 # endif
    634 # if USG_COMPAT
    635 #  undef  daylight
    636 #  define daylight tz_daylight
    637 #  undef  timezone
    638 #  define timezone tz_timezone
    639 # endif
    640 # if ALTZONE
    641 #  undef  altzone
    642 #  define altzone tz_altzone
    643 # endif
    644 
    645 char *asctime(struct tm const *);
    646 char *asctime_r(struct tm const *restrict, char *restrict);
    647 char *ctime(time_t const *);
    648 char *ctime_r(time_t const *, char *);
    649 ATTRIBUTE_UNSEQUENCED double difftime(time_t, time_t);
    650 size_t strftime(char *restrict, size_t, char const *restrict,
    651 		struct tm const *restrict);
    652 # if HAVE_STRFTIME_L
    653 size_t strftime_l(char *restrict, size_t, char const *restrict,
    654 		  struct tm const *restrict, locale_t);
    655 # endif
    656 struct tm *gmtime(time_t const *);
    657 struct tm *gmtime_r(time_t const *restrict, struct tm *restrict);
    658 struct tm *localtime(time_t const *);
    659 struct tm *localtime_r(time_t const *restrict, struct tm *restrict);
    660 time_t mktime(struct tm *);
    661 time_t time(time_t *);
    662 time_t timegm(struct tm *);
    663 void tzset(void);
    664 #endif
    665 
    666 #ifndef HAVE_DECL_TIMEGM
    667 # if (202311 <= __STDC_VERSION__ \
    668       || defined __GLIBC__ || defined __tm_zone /* musl */ \
    669       || defined __FreeBSD__ || defined __NetBSD__ || defined __OpenBSD__ \
    670       || (defined __APPLE__ && defined __MACH__))
    671 #  define HAVE_DECL_TIMEGM true
    672 # else
    673 #  define HAVE_DECL_TIMEGM false
    674 # endif
    675 #endif
    676 #if !HAVE_DECL_TIMEGM && !defined timegm
    677 time_t timegm(struct tm *);
    678 #endif
    679 
    680 #if !HAVE_DECL_ASCTIME_R && !defined asctime_r
    681 extern char *asctime_r(struct tm const *restrict, char *restrict);
    682 #endif
    683 
    684 #ifndef HAVE_DECL_ENVIRON
    685 # if defined environ || defined __USE_GNU
    686 #  define HAVE_DECL_ENVIRON 1
    687 # else
    688 #  define HAVE_DECL_ENVIRON 0
    689 # endif
    690 #endif
    691 
    692 #if !HAVE_DECL_ENVIRON
    693 extern char **environ;
    694 #endif
    695 
    696 #if 2 <= HAVE_TZNAME + (TZ_TIME_T || !HAVE_POSIX_DECLS)
    697 extern char *tzname[];
    698 #endif
    699 #if 2 <= USG_COMPAT + (TZ_TIME_T || !HAVE_POSIX_DECLS)
    700 extern long timezone;
    701 extern int daylight;
    702 #endif
    703 #if 2 <= ALTZONE + (TZ_TIME_T || !HAVE_POSIX_DECLS)
    704 extern long altzone;
    705 #endif
    706 
    707 /*
    708 ** The STD_INSPIRED functions are similar, but most also need
    709 ** declarations if time_tz is defined.
    710 */
    711 
    712 #ifdef STD_INSPIRED
    713 # if TZ_TIME_T || !defined tzsetwall
    714 void tzsetwall(void);
    715 # endif
    716 # if TZ_TIME_T || !defined offtime
    717 struct tm *offtime(time_t const *, long);
    718 # endif
    719 # if TZ_TIME_T || !defined timelocal
    720 time_t timelocal(struct tm *);
    721 # endif
    722 # if TZ_TIME_T || !defined timeoff
    723 time_t timeoff(struct tm *, long);
    724 # endif
    725 # if TZ_TIME_T || !defined time2posix
    726 time_t time2posix(time_t);
    727 # endif
    728 # if TZ_TIME_T || !defined posix2time
    729 time_t posix2time(time_t);
    730 # endif
    731 #endif
    732 
    733 /* Infer TM_ZONE on systems where this information is known, but suppress
    734    guessing if NO_TM_ZONE is defined.  Similarly for TM_GMTOFF.  */
    735 #if (defined __GLIBC__ \
    736      || defined __tm_zone /* musl */ \
    737      || defined __FreeBSD__ || defined __NetBSD__ || defined __OpenBSD__ \
    738      || (defined __APPLE__ && defined __MACH__))
    739 # if !defined TM_GMTOFF && !defined NO_TM_GMTOFF
    740 #  define TM_GMTOFF tm_gmtoff
    741 # endif
    742 # if !defined TM_ZONE && !defined NO_TM_ZONE
    743 #  define TM_ZONE tm_zone
    744 # endif
    745 #endif
    746 
    747 /*
    748 ** Define functions that are ABI compatible with NetBSD but have
    749 ** better prototypes.  NetBSD 6.1.4 defines a pointer type timezone_t
    750 ** and labors under the misconception that 'const timezone_t' is a
    751 ** pointer to a constant.  This use of 'const' is ineffective, so it
    752 ** is not done here.  What we call 'struct state' NetBSD calls
    753 ** 'struct __state', but this is a private name so it doesn't matter.
    754 */
    755 #ifndef __NetBSD__
    756 #if NETBSD_INSPIRED
    757 typedef struct state *timezone_t;
    758 struct tm *localtime_rz(timezone_t restrict, time_t const *restrict,
    759 			struct tm *restrict);
    760 time_t mktime_z(timezone_t restrict, struct tm *restrict);
    761 timezone_t tzalloc(char const *);
    762 void tzfree(timezone_t);
    763 # ifdef STD_INSPIRED
    764 #  if TZ_TIME_T || !defined posix2time_z
    765 ATTRIBUTE_REPRODUCIBLE time_t posix2time_z(timezone_t __restrict, time_t);
    766 #  endif
    767 #  if TZ_TIME_T || !defined time2posix_z
    768 ATTRIBUTE_REPRODUCIBLE time_t time2posix_z(timezone_t __restrict, time_t);
    769 #  endif
    770 # endif
    771 #endif
    772 #endif
    773 
    774 /*
    775 ** Finally, some convenience items.
    776 */
    777 
    778 #define TYPE_BIT(type)	(sizeof(type) * CHAR_BIT)
    779 #define TYPE_SIGNED(type) (/*CONSTCOND*/((type) -1) < 0)
    780 #define TWOS_COMPLEMENT(t) (/*CONSTCOND*/(t) ~ (t) 0 < 0)
    781 
    782 /* Minimum and maximum of two values.  Use lower case to avoid
    783    naming clashes with standard include files.  */
    784 #define max(a, b) ((a) > (b) ? (a) : (b))
    785 #define min(a, b) ((a) < (b) ? (a) : (b))
    786 
    787 /* Max and min values of the integer type T, of which only the bottom
    788    B bits are used, and where the highest-order used bit is considered
    789    to be a sign bit if T is signed.  */
    790 #define MAXVAL(t, b) /*LINTED*/					\
    791   ((t) (((t) 1 << ((b) - 1 - TYPE_SIGNED(t)))			\
    792 	- 1 + ((t) 1 << ((b) - 1 - TYPE_SIGNED(t)))))
    793 #define MINVAL(t, b)						\
    794   ((t) (TYPE_SIGNED(t) ? - TWOS_COMPLEMENT(t) - MAXVAL(t, b) : 0))
    795 
    796 /* The extreme time values, assuming no padding.  */
    797 #define TIME_T_MIN_NO_PADDING MINVAL(time_t, TYPE_BIT(time_t))
    798 #define TIME_T_MAX_NO_PADDING MAXVAL(time_t, TYPE_BIT(time_t))
    799 
    800 /* The extreme time values.  These are macros, not constants, so that
    801    any portability problems occur only when compiling .c files that use
    802    the macros, which is safer for applications that need only zdump and zic.
    803    This implementation assumes no padding if time_t is signed and
    804    either the compiler lacks support for _Generic or time_t is not one
    805    of the standard signed integer types.  */
    806 #if HAVE_GENERIC
    807 # define TIME_T_MIN \
    808     _Generic((time_t) 0, \
    809 	     signed char: SCHAR_MIN, short: SHRT_MIN, \
    810 	     int: INT_MIN, long: LONG_MIN, long long: LLONG_MIN, \
    811 	     default: TIME_T_MIN_NO_PADDING)
    812 # define TIME_T_MAX \
    813     (TYPE_SIGNED(time_t) \
    814      ? _Generic((time_t) 0, \
    815 		signed char: SCHAR_MAX, short: SHRT_MAX, \
    816 		int: INT_MAX, long: LONG_MAX, long long: LLONG_MAX, \
    817 		default: TIME_T_MAX_NO_PADDING)			    \
    818      : (time_t) -1)
    819 #else
    820 # define TIME_T_MIN TIME_T_MIN_NO_PADDING
    821 # define TIME_T_MAX TIME_T_MAX_NO_PADDING
    822 #endif
    823 
    824 /*
    825 ** 302 / 1000 is log10(2.0) rounded up.
    826 ** Subtract one for the sign bit if the type is signed;
    827 ** add one for integer division truncation;
    828 ** add one more for a minus sign if the type is signed.
    829 */
    830 #define INT_STRLEN_MAXIMUM(type) \
    831 	((TYPE_BIT(type) - TYPE_SIGNED(type)) * 302 / 1000 + \
    832 	1 + TYPE_SIGNED(type))
    833 
    834 /*
    835 ** INITIALIZE(x)
    836 */
    837 
    838 #if defined(__GNUC__) || defined(__lint__)
    839 # define INITIALIZE(x)	((x) = 0)
    840 #else
    841 # define INITIALIZE(x)
    842 #endif
    843 
    844 /* Whether memory access must strictly follow the C standard.
    845    If 0, it's OK to read uninitialized storage so long as the value is
    846    not relied upon.  Defining it to 0 lets mktime access parts of
    847    struct tm that might be uninitialized, as a heuristic when the
    848    standard doesn't say what to return and when tm_gmtoff can help
    849    mktime likely infer a better value.  */
    850 #ifndef UNINIT_TRAP
    851 # define UNINIT_TRAP 0
    852 #endif
    853 
    854 #ifdef DEBUG
    855 # undef unreachable
    856 # define unreachable() abort()
    857 #elif !defined unreachable
    858 # ifdef __has_builtin
    859 #  if __has_builtin(__builtin_unreachable)
    860 #   define unreachable() __builtin_unreachable()
    861 #  endif
    862 # elif 4 < __GNUC__ + (5 <= __GNUC_MINOR__)
    863 #  define unreachable() __builtin_unreachable()
    864 # endif
    865 # ifndef unreachable
    866 #  define unreachable() ((void) 0)
    867 # endif
    868 #endif
    869 
    870 /*
    871 ** For the benefit of GNU folk...
    872 ** '_(MSGID)' uses the current locale's message library string for MSGID.
    873 ** The default is to use gettext if available, and use MSGID otherwise.
    874 */
    875 
    876 #if HAVE_GETTEXT
    877 #define _(msgid) gettext(msgid)
    878 #else /* !HAVE_GETTEXT */
    879 #define _(msgid) msgid
    880 #endif /* !HAVE_GETTEXT */
    881 
    882 #if !defined TZ_DOMAIN && defined HAVE_GETTEXT
    883 # define TZ_DOMAIN "tz"
    884 #endif
    885 
    886 #if HAVE_INCOMPATIBLE_CTIME_R
    887 #undef asctime_r
    888 #undef ctime_r
    889 char *asctime_r(struct tm const *, char *);
    890 char *ctime_r(time_t const *, char *);
    891 #endif /* HAVE_INCOMPATIBLE_CTIME_R */
    892 
    893 /* Handy macros that are independent of tzfile implementation.  */
    894 
    895 #ifndef SECSPERMIN
    896 enum {
    897   SECSPERMIN = 60,
    898   MINSPERHOUR = 60,
    899   SECSPERHOUR = SECSPERMIN * MINSPERHOUR,
    900   HOURSPERDAY = 24,
    901   DAYSPERWEEK = 7,
    902   DAYSPERNYEAR = 365,
    903   DAYSPERLYEAR = DAYSPERNYEAR + 1,
    904   MONSPERYEAR = 12,
    905   YEARSPERREPEAT = 400	/* years before a Gregorian repeat */
    906 };
    907 #endif
    908 
    909 #define SECSPERDAY	((int_fast32_t) SECSPERHOUR * HOURSPERDAY)
    910 
    911 #define DAYSPERREPEAT		((int_fast32_t) 400 * 365 + 100 - 4 + 1)
    912 #define SECSPERREPEAT		((int_fast64_t) DAYSPERREPEAT * SECSPERDAY)
    913 #define AVGSECSPERYEAR		(SECSPERREPEAT / YEARSPERREPEAT)
    914 
    915 #ifndef TM_SUNDAY
    916 enum {
    917   TM_SUNDAY,
    918   TM_MONDAY,
    919   TM_TUESDAY,
    920   TM_WEDNESDAY,
    921   TM_THURSDAY,
    922   TM_FRIDAY,
    923   TM_SATURDAY
    924 };
    925 #endif
    926 
    927 #ifndef TM_JANUARY
    928 enum {
    929   TM_JANUARY,
    930   TM_FEBRUARY,
    931   TM_MARCH,
    932   TM_APRIL,
    933   TM_MAY,
    934   TM_JUNE,
    935   TM_JULY,
    936   TM_AUGUST,
    937   TM_SEPTEMBER,
    938   TM_OCTOBER,
    939   TM_NOVEMBER,
    940   TM_DECEMBER
    941 };
    942 #endif
    943 
    944 #ifndef TM_YEAR_BASE
    945 enum {
    946   TM_YEAR_BASE = 1900,
    947   TM_WDAY_BASE = TM_MONDAY,
    948   EPOCH_YEAR = 1970,
    949   EPOCH_WDAY = TM_THURSDAY
    950 };
    951 #endif
    952 
    953 #define isleap(y) (((y) % 4) == 0 && (((y) % 100) != 0 || ((y) % 400) == 0))
    954 
    955 /*
    956 ** Since everything in isleap is modulo 400 (or a factor of 400), we know that
    957 **	isleap(y) == isleap(y % 400)
    958 ** and so
    959 **	isleap(a + b) == isleap((a + b) % 400)
    960 ** or
    961 **	isleap(a + b) == isleap(a % 400 + b % 400)
    962 ** This is true even if % means modulo rather than Fortran remainder
    963 ** (which is allowed by C89 but not by C99 or later).
    964 ** We use this to avoid addition overflow problems.
    965 */
    966 
    967 #define isleap_sum(a, b)	isleap((a) % 400 + (b) % 400)
    968 
    969 #ifdef _LIBC
    970 #include "reentrant.h"
    971 extern struct __state *__lclptr;
    972 #if defined(__LIBC12_SOURCE__)
    973 #define tzset_unlocked __tzset_unlocked
    974 #else
    975 #define tzset_unlocked __tzset_unlocked50
    976 #endif
    977 
    978 void tzset_unlocked(void);
    979 #ifdef _REENTRANT
    980 extern rwlock_t __lcl_lock;
    981 #endif
    982 #endif
    983 
    984 #endif /* !defined PRIVATE_H */
    985