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