HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

src/basic/time-util.c

63,018 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: 44c53067411741027580f465c9873e673db03028

Lines 1001–1968 of 1,968

                        goto from_tm;
        }
 
        tm = copy;
        k = strptime(t, "%H:%M", &tm);
        if (k && *k == 0) {
                tm.tm_sec = 0;
                goto from_tm;
        }
 
        return -EINVAL;
 
parse_usec:
        k++;
        r = parse_fractional_part_u(&k, 6, &fractional);
        if (r < 0)
                return -EINVAL;
        if (*k != '\0')
                return -EINVAL;
 
from_tm:
        assert(plus == 0);
        assert(minus == 0);
 
        if (weekday >= 0 && tm.tm_wday != weekday)
                return -EINVAL;
 
        if (gmtoff < 0) {
                plus = -gmtoff * USEC_PER_SEC;
 
                /* If gmtoff is negative, the string may be too old to be parsed as UTC.
                 * E.g. 1969-12-31 23:00:00 -06 == 1970-01-01 05:00:00 UTC
                 * We assumed that gmtoff is in the range of -24:00…+24:00, hence the only date we need to
                 * handle here is 1969-12-31. So, let's shift the date with one day, then subtract the shift
                 * later. */
                if (tm.tm_year == 69 && tm.tm_mon == 11 && tm.tm_mday == 31) {
                        /* Thu 1970-01-01-00:00:00 */
                        tm.tm_year = 70;
                        tm.tm_mon = 0;
                        tm.tm_mday = 1;
                        tm.tm_wday = 4;
                        tm.tm_yday = 0;
                        minus = USEC_PER_DAY;
                }
        } else
                minus = gmtoff * USEC_PER_SEC;
 
        r = mktime_or_timegm_usec(&tm, utc, &usec);
        if (r < 0)
                return r;
 
        usec = usec_add(usec, fractional);
 
finish:
        usec = usec_add(usec, plus);
 
        if (usec < minus)
                return -EINVAL;
 
        usec = usec_sub_unsigned(usec, minus);
 
        if (usec > USEC_TIMESTAMP_FORMATTABLE_MAX)
                return -EINVAL;
 
        if (ret)
                *ret = usec;
        return 0;
}
 
int parse_timestamp(const char *t, usec_t *ret) {
        long gmtoff;
        int r;
 
        assert(t);
 
        size_t t_len = strlen(t);
        if (t_len > 2 && t[t_len - 1] == 'Z') {
                /* Try to parse as RFC3339-style welded UTC: "1985-04-12T23:20:50.52Z" */
                r = parse_timestamp_impl(t, t_len - 1, /* utc= */ true, /* isdst= */ -1, /* gmtoff= */ 0, ret);
                if (r >= 0)
                        return r;
        }
 
        /* RFC3339-style welded offset: "1990-12-31T15:59:60-08:00" */
        if (t_len > 7 && IN_SET(t[t_len - 6], '+', '-') && t[t_len - 7] != ' ' && parse_gmtoff(&t[t_len - 6], &gmtoff) >= 0)
                return parse_timestamp_impl(t, t_len - 6, /* utc= */ true, /* isdst= */ -1, gmtoff, ret);
 
        const char *tz = strrchr(t, ' ');
        if (!tz)
                return parse_timestamp_impl(t, /* max_len= */ SIZE_MAX, /* utc= */ false, /* isdst= */ -1, /* gmtoff= */ 0, ret);
 
        size_t max_len = tz - t;
        tz++;
 
        /* Shortcut, parse the string as UTC. */
        if (streq(tz, "UTC"))
                return parse_timestamp_impl(t, max_len, /* utc= */ true, /* isdst= */ -1, /* gmtoff= */ 0, ret);
 
        /* If the timezone is compatible with RFC-822/ISO 8601 (e.g. +06, or -03:00) then parse the string as
         * UTC and shift the result. Note, this must be earlier than the timezone check with tzname[], as
         * tzname[] may be in the same format. */
        if (parse_gmtoff(tz, &gmtoff) >= 0)
                return parse_timestamp_impl(t, max_len, /* utc= */ true, /* isdst= */ -1, gmtoff, ret);
 
        /* Check if the last word matches tzname[] of the local timezone. Note, this must be done earlier
         * than the check by timezone_is_valid() below, as some short timezone specifications have their own
         * timezone files (e.g. WET has its own timezone file, but JST does not), but using such files does
         * not follow the timezone change in the current area. */
        tzset();
        for (int j = 0; j <= 1; j++) {
                if (!streq_ptr(tz, get_tzname(j)))
                        continue;
 
                /* The specified timezone matches tzname[] of the local timezone. */
                return parse_timestamp_impl(t, max_len, /* utc= */ false, /* isdst= */ j, /* gmtoff= */ 0, ret);
        }
 
        /* If the last word is a valid timezone file (e.g. Asia/Tokyo), then save the current timezone, apply
         * the specified timezone, and parse the remaining string as a local time. */
        if (timezone_is_valid(tz, LOG_DEBUG)) {
                SAVE_TIMEZONE;
 
                if (setenv("TZ", tz, /* overwrite= */ true) < 0)
                        return negative_errno();
 
                return parse_timestamp_impl(t, max_len, /* utc= */ false, /* isdst= */ -1, /* gmtoff= */ 0, ret);
        }
 
        /* Otherwise, assume that the last word is a part of the time and try to parse the whole string as a
         * local time. */
        return parse_timestamp_impl(t, SIZE_MAX, /* utc= */ false, /* isdst= */ -1, /* gmtoff= */ 0, ret);
}
 
static const char* extract_multiplier(const char *p, usec_t *ret) {
        static const struct {
                const char *suffix;
                usec_t usec;
        } table[] = {
                { "seconds", USEC_PER_SEC    },
                { "second",  USEC_PER_SEC    },
                { "sec",     USEC_PER_SEC    },
                { "s",       USEC_PER_SEC    },
                { "minutes", USEC_PER_MINUTE },
                { "minute",  USEC_PER_MINUTE },
                { "min",     USEC_PER_MINUTE },
                { "months",  USEC_PER_MONTH  },
                { "month",   USEC_PER_MONTH  },
                { "M",       USEC_PER_MONTH  },
                { "msec",    USEC_PER_MSEC   },
                { "ms",      USEC_PER_MSEC   },
                { "m",       USEC_PER_MINUTE },
                { "hours",   USEC_PER_HOUR   },
                { "hour",    USEC_PER_HOUR   },
                { "hr",      USEC_PER_HOUR   },
                { "h",       USEC_PER_HOUR   },
                { "days",    USEC_PER_DAY    },
                { "day",     USEC_PER_DAY    },
                { "d",       USEC_PER_DAY    },
                { "weeks",   USEC_PER_WEEK   },
                { "week",    USEC_PER_WEEK   },
                { "w",       USEC_PER_WEEK   },
                { "years",   USEC_PER_YEAR   },
                { "year",    USEC_PER_YEAR   },
                { "y",       USEC_PER_YEAR   },
                { "usec",    1ULL            },
                { "us",      1ULL            },
                { "μs",      1ULL            }, /* U+03bc (aka GREEK SMALL LETTER MU) */
                { "µs",      1ULL            }, /* U+b5 (aka MICRO SIGN) */
        };
 
        assert(p);
        assert(ret);
 
        FOREACH_ELEMENT(i, table) {
                const char *e = startswith(p, i->suffix);
                if (e) {
                        *ret = i->usec;
                        return e;
                }
        }
 
        return p;
}
 
int parse_time(const char *t, usec_t *ret, usec_t default_unit) {
        const char *p, *s;
 
        assert(t);
        assert(default_unit > 0);
 
        p = skip_leading_chars(t, /* bad= */ NULL);
        s = startswith(p, "infinity");
        if (s) {
                if (!in_charset(s, WHITESPACE))
                        return -EINVAL;
 
                if (ret)
                        *ret = USEC_INFINITY;
                return 0;
        }
 
        usec_t usec = 0;
 
        for (bool something = false;;) {
                usec_t multiplier = default_unit, k;
                long long l;
                char *e;
 
                p = skip_leading_chars(p, /* bad= */ NULL);
                if (*p == 0) {
                        if (!something)
                                return -EINVAL;
 
                        break;
                }
 
                if (*p == '-') /* Don't allow "-0" */
                        return -ERANGE;
 
                errno = 0;
                l = strtoll(p, &e, 10);
                if (errno > 0)
                        return -errno;
                if (l < 0)
                        return -ERANGE;
 
                if (*e == '.') {
                        p = e + 1;
                        p += strspn(p, DIGITS);
                } else if (e == p)
                        return -EINVAL;
                else
                        p = e;
 
                s = extract_multiplier(p + strspn(p, WHITESPACE), &multiplier);
                if (s == p && *s != '\0')
                        /* Don't allow '12.34.56', but accept '12.34 .56' or '12.34s.56' */
                        return -EINVAL;
 
                p = s;
 
                if ((usec_t) l >= USEC_INFINITY / multiplier)
                        return -ERANGE;
 
                k = (usec_t) l * multiplier;
                if (k >= USEC_INFINITY - usec)
                        return -ERANGE;
 
                usec += k;
 
                something = true;
 
                if (*e == '.') {
                        usec_t m = multiplier / 10;
                        const char *b;
 
                        for (b = e + 1; *b >= '0' && *b <= '9'; b++, m /= 10) {
                                k = (usec_t) (*b - '0') * m;
                                if (k >= USEC_INFINITY - usec)
                                        return -ERANGE;
 
                                usec += k;
                        }
 
                        /* Don't allow "0.-0", "3.+1", "3. 1", "3.sec" or "3.hoge" */
                        if (b == e + 1)
                                return -EINVAL;
                }
        }
 
        if (ret)
                *ret = usec;
        return 0;
}
 
int parse_sec(const char *t, usec_t *ret) {
        return parse_time(t, ret, USEC_PER_SEC);
}
 
int parse_sec_fix_0(const char *t, usec_t *ret) {
        usec_t k;
        int r;
 
        assert(t);
        assert(ret);
 
        r = parse_sec(t, &k);
        if (r < 0)
                return r;
 
        *ret = k == 0 ? USEC_INFINITY : k;
        return r;
}
 
int parse_sec_def_infinity(const char *t, usec_t *ret) {
        assert(t);
        assert(ret);
 
        t += strspn(t, WHITESPACE);
        if (isempty(t)) {
                *ret = USEC_INFINITY;
                return 0;
        }
        return parse_sec(t, ret);
}
 
static const char* extract_nsec_multiplier(const char *p, nsec_t *ret) {
        static const struct {
                const char *suffix;
                nsec_t nsec;
        } table[] = {
                { "seconds", NSEC_PER_SEC    },
                { "second",  NSEC_PER_SEC    },
                { "sec",     NSEC_PER_SEC    },
                { "s",       NSEC_PER_SEC    },
                { "minutes", NSEC_PER_MINUTE },
                { "minute",  NSEC_PER_MINUTE },
                { "min",     NSEC_PER_MINUTE },
                { "months",  NSEC_PER_MONTH  },
                { "month",   NSEC_PER_MONTH  },
                { "M",       NSEC_PER_MONTH  },
                { "msec",    NSEC_PER_MSEC   },
                { "ms",      NSEC_PER_MSEC   },
                { "m",       NSEC_PER_MINUTE },
                { "hours",   NSEC_PER_HOUR   },
                { "hour",    NSEC_PER_HOUR   },
                { "hr",      NSEC_PER_HOUR   },
                { "h",       NSEC_PER_HOUR   },
                { "days",    NSEC_PER_DAY    },
                { "day",     NSEC_PER_DAY    },
                { "d",       NSEC_PER_DAY    },
                { "weeks",   NSEC_PER_WEEK   },
                { "week",    NSEC_PER_WEEK   },
                { "w",       NSEC_PER_WEEK   },
                { "years",   NSEC_PER_YEAR   },
                { "year",    NSEC_PER_YEAR   },
                { "y",       NSEC_PER_YEAR   },
                { "usec",    NSEC_PER_USEC   },
                { "us",      NSEC_PER_USEC   },
                { "μs",      NSEC_PER_USEC   }, /* U+03bc (aka GREEK LETTER MU) */
                { "µs",      NSEC_PER_USEC   }, /* U+b5 (aka MICRO SIGN) */
                { "nsec",    1ULL            },
                { "ns",      1ULL            },
                { "",        1ULL            }, /* default is nsec */
        };
 
        assert(p);
        assert(ret);
 
        FOREACH_ELEMENT(i, table) {
                const char *e = startswith(p, i->suffix);
                if (e) {
                        *ret = i->nsec;
                        return e;
                }
        }
 
        return p;
}
 
int parse_nsec(const char *t, nsec_t *ret) {
        const char *p, *s;
        nsec_t nsec = 0;
        bool something = false;
 
        assert(t);
        assert(ret);
 
        p = t;
 
        p += strspn(p, WHITESPACE);
        s = startswith(p, "infinity");
        if (s) {
                s += strspn(s, WHITESPACE);
                if (*s != 0)
                        return -EINVAL;
 
                *ret = NSEC_INFINITY;
                return 0;
        }
 
        for (;;) {
                nsec_t multiplier = 1, k;
                long long l;
                char *e;
 
                p += strspn(p, WHITESPACE);
 
                if (*p == 0) {
                        if (!something)
                                return -EINVAL;
 
                        break;
                }
 
                if (*p == '-') /* Don't allow "-0" */
                        return -ERANGE;
 
                errno = 0;
                l = strtoll(p, &e, 10);
                if (errno > 0)
                        return -errno;
                if (l < 0)
                        return -ERANGE;
 
                if (*e == '.') {
                        p = e + 1;
                        p += strspn(p, DIGITS);
                } else if (e == p)
                        return -EINVAL;
                else
                        p = e;
 
                s = extract_nsec_multiplier(p + strspn(p, WHITESPACE), &multiplier);
                if (s == p && *s != '\0')
                        /* Don't allow '12.34.56', but accept '12.34 .56' or '12.34s.56' */
                        return -EINVAL;
 
                p = s;
 
                if ((nsec_t) l >= NSEC_INFINITY / multiplier)
                        return -ERANGE;
 
                k = (nsec_t) l * multiplier;
                if (k >= NSEC_INFINITY - nsec)
                        return -ERANGE;
 
                nsec += k;
 
                something = true;
 
                if (*e == '.') {
                        nsec_t m = multiplier / 10;
                        const char *b;
 
                        for (b = e + 1; *b >= '0' && *b <= '9'; b++, m /= 10) {
                                k = (nsec_t) (*b - '0') * m;
                                if (k >= NSEC_INFINITY - nsec)
                                        return -ERANGE;
 
                                nsec += k;
                        }
 
                        /* Don't allow "0.-0", "3.+1", "3. 1", "3.sec" or "3.hoge" */
                        if (b == e + 1)
                                return -EINVAL;
                }
        }
 
        *ret = nsec;
 
        return 0;
}
 
static int get_timezones_from_zone1970_tab(char ***ret) {
        _cleanup_fclose_ FILE *f = NULL;
        _cleanup_strv_free_ char **zones = NULL;
        int r;
 
        assert(ret);
 
        f = fopen("/usr/share/zoneinfo/zone1970.tab", "re");
        if (!f)
                return -errno;
 
        for (;;) {
                _cleanup_free_ char *line = NULL, *cc = NULL, *co = NULL, *tz = NULL;
 
                r = read_line(f, LONG_LINE_MAX, &line);
                if (r < 0)
                        return r;
                if (r == 0)
                        break;
 
                const char *p = line;
 
                /* Line format is:
                 * 'country codes' 'coordinates' 'timezone' 'comments' */
                r = extract_many_words(&p, NULL, 0, &cc, &co, &tz);
                if (r < 0)
                        continue;
 
                /* Lines that start with # are comments. */
                if (*cc == '#')
                        continue;
 
                if (!timezone_is_valid(tz, LOG_DEBUG))
                        /* Don't list unusable timezones. */
                        continue;
 
                r = strv_extend(&zones, tz);
                if (r < 0)
                        return r;
        }
 
        *ret = TAKE_PTR(zones);
        return 0;
}
 
static int get_timezones_from_tzdata_zi(char ***ret) {
        _cleanup_fclose_ FILE *f = NULL;
        _cleanup_strv_free_ char **zones = NULL;
        int r;
 
        assert(ret);
 
        f = fopen("/usr/share/zoneinfo/tzdata.zi", "re");
        if (!f)
                return -errno;
 
        for (;;) {
                _cleanup_free_ char *line = NULL, *type = NULL, *f1 = NULL, *f2 = NULL;
 
                r = read_line(f, LONG_LINE_MAX, &line);
                if (r < 0)
                        return r;
                if (r == 0)
                        break;
 
                const char *p = line;
 
                /* The only lines we care about are Zone and Link lines.
                 * Zone line format is:
                 * 'Zone' 'timezone' ...
                 * Link line format is:
                 * 'Link' 'target' 'alias'
                 * See 'man zic' for more detail. */
                r = extract_many_words(&p, NULL, 0, &type, &f1, &f2);
                if (r < 0)
                        continue;
 
                char *tz;
                if (IN_SET(*type, 'Z', 'z'))
                        /* Zone lines have timezone in field 1. */
                        tz = f1;
                else if (IN_SET(*type, 'L', 'l'))
                        /* Link lines have timezone in field 2. */
                        tz = f2;
                else
                        /* Not a line we care about. */
                        continue;
 
                if (!timezone_is_valid(tz, LOG_DEBUG))
                        /* Don't list unusable timezones. */
                        continue;
 
                r = strv_extend(&zones, tz);
                if (r < 0)
                        return r;
        }
 
        *ret = TAKE_PTR(zones);
        return 0;
}
 
int get_timezones(char ***ret) {
        _cleanup_strv_free_ char **zones = NULL;
        int r;
 
        assert(ret);
 
        r = get_timezones_from_tzdata_zi(&zones);
        if (r == -ENOENT) {
                log_debug_errno(r, "Could not get timezone data from tzdata.zi, using zone1970.tab: %m");
                r = get_timezones_from_zone1970_tab(&zones);
                if (r == -ENOENT)
                        log_debug_errno(r, "Could not get timezone data from zone1970.tab, using UTC: %m");
        }
        if (r < 0 && r != -ENOENT)
                return r;
 
        /* Always include UTC */
        r = strv_extend(&zones, "UTC");
        if (r < 0)
                return r;
 
        strv_sort_uniq(zones);
 
        *ret = TAKE_PTR(zones);
        return 0;
}
 
int verify_timezone(const char *name, int log_level) {
        bool slash = false;
        const char *p, *t;
        _cleanup_close_ int fd = -EBADF;
        char buf[4];
        int r;
 
        if (isempty(name))
                return -EINVAL;
 
        /* Always accept "UTC" as valid timezone, since it's the fallback, even if user has no timezones installed. */
        if (streq(name, "UTC"))
                return 0;
 
        if (name[0] == '/')
                return -EINVAL;
 
        for (p = name; *p; p++) {
                if (!ascii_isdigit(*p) &&
                    !ascii_isalpha(*p) &&
                    !IN_SET(*p, '-', '_', '+', '/'))
                        return -EINVAL;
 
                if (*p == '/') {
 
                        if (slash)
                                return -EINVAL;
 
                        slash = true;
                } else
                        slash = false;
        }
 
        if (slash)
                return -EINVAL;
 
        if (p - name >= PATH_MAX)
                return -ENAMETOOLONG;
 
        t = strjoina("/usr/share/zoneinfo/", name);
 
        fd = open(t, O_RDONLY|O_CLOEXEC);
        if (fd < 0)
                return log_full_errno(log_level, errno, "Failed to open timezone file '%s': %m", t);
 
        r = fd_verify_regular(fd);
        if (r < 0)
                return log_full_errno(log_level, r, "Timezone file '%s' is not a regular file: %m", t);
 
        r = loop_read_exact(fd, buf, 4, false);
        if (r < 0)
                return log_full_errno(log_level, r, "Failed to read from timezone file '%s': %m", t);
 
        /* Magic from tzfile(5) */
        if (memcmp(buf, "TZif", 4) != 0)
                return log_full_errno(log_level, SYNTHETIC_ERRNO(EBADMSG),
                                      "Timezone file '%s' has wrong magic bytes", t);
 
        return 0;
}
 
void reset_timezonep(char **p) {
        assert(p);
 
        (void) set_unset_env("TZ", *p, /* overwrite= */ true);
        tzset();
        *p = mfree(*p);
}
 
char* save_timezone(void) {
        const char *e = getenv("TZ");
        if (!e)
                return NULL;
 
        char *s = strdup(e);
        if (!s)
                log_debug("Failed to save $TZ=%s, unsetting the environment variable.", e);
 
        return s;
}
 
bool clock_supported(clockid_t clock) {
        struct timespec ts;
 
        switch (clock) {
 
        case CLOCK_MONOTONIC:
        case CLOCK_REALTIME:
        case CLOCK_BOOTTIME:
                /* These three are always available in our baseline, and work in timerfd, as of kernel 3.15 */
                return true;
 
        default:
                /* For everything else, check properly */
                return clock_gettime(clock, &ts) >= 0;
        }
}
 
int get_timezone(char **ret) {
        _cleanup_free_ char *t = NULL;
        int r;
 
        assert(ret);
 
        r = readlink_malloc(etc_localtime(), &t);
        if (r == -ENOENT)
                /* If the symlink does not exist, assume "UTC", like glibc does */
                return strdup_to(ret, "UTC");
        if (r < 0)
                return r; /* Return EINVAL if not a symlink */
 
        const char *e = PATH_STARTSWITH_SET(t, "/usr/share/zoneinfo/", "../usr/share/zoneinfo/");
        if (!e)
                return -EINVAL;
        if (!timezone_is_valid(e, LOG_DEBUG))
                return -EINVAL;
 
        return strdup_to(ret, e);
}
 
int get_timezone_prefer_env(char **ret) {
        assert(ret);
 
        const char *e = getenv("TZ");
        if (e && e[0] == ':' && timezone_is_valid(e + 1, LOG_DEBUG))
                return strdup_to(ret, e + 1);
 
        return get_timezone(ret);
}
 
const char* etc_localtime(void) {
        static const char *cached = NULL;
 
        if (!cached)
                cached = secure_getenv("SYSTEMD_ETC_LOCALTIME") ?: "/etc/localtime";
 
        return cached;
}
 
int mktime_or_timegm_usec(
                struct tm *tm, /* input + normalized output */
                bool utc,
                usec_t *ret) {
 
        time_t t;
 
        assert(tm);
 
        if (tm->tm_year < 69) /* early check for negative (i.e. before 1970) time_t (Note that in some timezones the epoch is in the year 1969!) */
                return -ERANGE;
        if ((usec_t) tm->tm_year > CONST_MIN(USEC_INFINITY / USEC_PER_YEAR, (usec_t) TIME_T_MAX / (365U * 24U * 60U * 60U)) - 1900) /* early check for possible overrun of usec_t or time_t */
                return -ERANGE;
 
        /* timegm()/mktime() is a bit weird to use, since it returns -1 in two cases: on error as well as a
         * valid time indicating one second before the UNIX epoch. Let's treat both cases the same here, and
         * return -ERANGE for anything negative, since usec_t is unsigned, and we can thus not express
         * negative times anyway. */
 
        t = utc ? timegm(tm) : mktime(tm);
        if (t < 0) /* Refuse negative times and errors */
                return -ERANGE;
        if ((usec_t) t >= USEC_INFINITY / USEC_PER_SEC) /* Never return USEC_INFINITY by accident (or overflow) */
                return -ERANGE;
 
        if (ret)
                *ret = (usec_t) t * USEC_PER_SEC;
        return 0;
}
 
int localtime_or_gmtime_usec(
                usec_t t,
                bool utc,
                struct tm *ret) {
 
        t /= USEC_PER_SEC; /* Round down */
        if (t > (usec_t) TIME_T_MAX)
                return -ERANGE;
        time_t sec = (time_t) t;
 
        struct tm buf = {};
        if (!(utc ? gmtime_r(&sec, &buf) : localtime_r(&sec, &buf)))
                return -EINVAL;
 
        if (ret)
                *ret = buf;
 
        return 0;
}
 
uint64_t sysconf_clock_ticks_cached(void) {
        static thread_local uint64_t hz = 0;
 
        if (hz != 0)
                return hz;
 
        long t = sysconf(_SC_CLK_TCK);
        assert(t > 0);
        hz = (uint64_t) t;
 
        return hz;
}
 
uint32_t usec_to_jiffies(usec_t u) {
        uint64_t hz = sysconf_clock_ticks_cached();
        return DIV_ROUND_UP(u, USEC_PER_SEC / hz);
}
 
usec_t jiffies_to_usec(uint32_t j) {
        uint64_t hz = sysconf_clock_ticks_cached();
        return DIV_ROUND_UP(j * USEC_PER_SEC, hz);
}
 
usec_t usec_shift_clock(usec_t x, clockid_t from, clockid_t to) {
        usec_t a, b;
 
        if (x == USEC_INFINITY)
                return USEC_INFINITY;
        if (map_clock_id(from) == map_clock_id(to))
                return x;
 
        a = now(from);
        b = now(to);
 
        if (x > a)
                /* x lies in the future */
                return usec_add(b, usec_sub_unsigned(x, a));
        else
                /* x lies in the past */
                return usec_sub_unsigned(b, usec_sub_unsigned(a, x));
}
 
bool in_utc_timezone(void) {
        tzset();
 
        return timezone == 0 && daylight == 0;
}
 
int usleep_safe(usec_t usec) {
        int r;
 
        /* usleep() takes useconds_t that is (typically?) uint32_t. Also, usleep() may only support the
         * range [0, 1000000]. See usleep(3). Let's override usleep() with clock_nanosleep().
         *
         * ⚠️ Note we are not using plain nanosleep() here, since that operates on CLOCK_REALTIME, not
         *    CLOCK_MONOTONIC! */
 
        if (usec == 0)
                return 0;
 
        if (usec == USEC_INFINITY)
                return RET_NERRNO(pause());
 
        struct timespec t;
        timespec_store(&t, usec);
 
        for (;;) {
                struct timespec remaining;
 
                /* `clock_nanosleep()` does not use `errno`, but returns positive error codes. */
                r = -clock_nanosleep(CLOCK_MONOTONIC, /* flags= */ 0, &t, &remaining);
                if (r == -EINTR) {
                        /* Interrupted. Continue sleeping for the remaining time. */
                        t = remaining;
                        continue;
                }
 
                return r;
        }
}
 
int time_change_fd(void) {
 
        /* We only care for the cancellation event, hence we set the timeout to the latest possible value. */
        static const struct itimerspec its = {
                .it_value.tv_sec = TIME_T_MAX,
        };
 
        _cleanup_close_ int fd = -EBADF;
 
        /* Uses TFD_TIMER_CANCEL_ON_SET to get notifications whenever CLOCK_REALTIME makes a jump relative to
         * CLOCK_MONOTONIC. */
 
        fd = timerfd_create(CLOCK_REALTIME, TFD_NONBLOCK|TFD_CLOEXEC);
        if (fd < 0)
                return -errno;
 
        if (timerfd_settime(fd, TFD_TIMER_ABSTIME|TFD_TIMER_CANCEL_ON_SET, &its, NULL) >= 0)
                return TAKE_FD(fd);
 
        /* So apparently there are systems where time_t is 64-bit, but the kernel actually doesn't support
         * 64-bit time_t. In that case configuring a timer to TIME_T_MAX will fail with EOPNOTSUPP or a
         * similar error. If that's the case let's try with INT32_MAX instead, maybe that works. It's a bit
         * of a black magic thing though, but what can we do?
         *
         * We don't want this code on x86-64, hence let's conditionalize this for systems with 64-bit time_t
         * but where "long" is shorter than 64-bit, i.e. 32-bit archs.
         *
         * See: https://github.com/systemd/systemd/issues/14362 */
 
#if SIZEOF_TIME_T == 8 && ULONG_MAX < UINT64_MAX
        if (ERRNO_IS_NOT_SUPPORTED(errno) || errno == EOVERFLOW) {
                static const struct itimerspec its32 = {
                        .it_value.tv_sec = INT32_MAX,
                };
 
                if (timerfd_settime(fd, TFD_TIMER_ABSTIME|TFD_TIMER_CANCEL_ON_SET, &its32, NULL) >= 0)
                        return TAKE_FD(fd);
        }
#endif
 
        return -errno;
}
 
static const char* const timestamp_style_table[_TIMESTAMP_STYLE_MAX] = {
        [TIMESTAMP_PRETTY] = "pretty",
        [TIMESTAMP_US]     = "us",
        [TIMESTAMP_UTC]    = "utc",
        [TIMESTAMP_US_UTC] = "us+utc",
        [TIMESTAMP_UNIX]   = "unix",
};
 
/* Use the macro for enum → string to allow for aliases */
DEFINE_STRING_TABLE_LOOKUP_TO_STRING(timestamp_style, TimestampStyle);
 
/* For the string → enum mapping we use the generic implementation, but also support two aliases */
TimestampStyle timestamp_style_from_string(const char *s) {
        TimestampStyle t;
 
        t = (TimestampStyle) string_table_lookup_from_string(timestamp_style_table, ELEMENTSOF(timestamp_style_table), s);
        if (t >= 0)
                return t;
        if (STRPTR_IN_SET(s, "µs", "μs")) /* accept both µ symbols in unicode, i.e. micro symbol + Greek small letter mu. */
                return TIMESTAMP_US;
        if (STRPTR_IN_SET(s, "µs+utc", "μs+utc"))
                return TIMESTAMP_US_UTC;
        return t;
}
 
int parse_calendar_date_full(const char *s, bool allow_pre_epoch, usec_t *ret_usec, struct tm *ret_tm) {
        struct tm parsed_tm = {}, copy_tm;
        const char *k;
        int r;
 
        assert(s);
 
        k = strptime(s, "%Y-%m-%d", &parsed_tm);
        if (!k || *k)
                return -EINVAL;
 
        copy_tm = parsed_tm;
 
        usec_t usec = USEC_INFINITY;
 
        if (allow_pre_epoch) {
                /* For birth dates we use timegm() directly since we need to accept pre-epoch dates.
                 * timegm() returns (time_t) -1 both on error and for one second before the epoch.
                 * Initialize wday to -1 beforehand: if it remains -1 after the call, it's a genuine
                 * error; if timegm() changed it, the date was successfully normalized. */
                copy_tm.tm_wday = -1;
                if (timegm(&copy_tm) == (time_t) -1 && copy_tm.tm_wday == -1)
                        return -EINVAL;
        } else {
                r = mktime_or_timegm_usec(&copy_tm, /* utc= */ true, &usec);
                if (r < 0)
                        return r;
        }
 
        /* Refuse non-normalized dates, e.g. Feb 30 */
        if (copy_tm.tm_mday != parsed_tm.tm_mday ||
            copy_tm.tm_mon  != parsed_tm.tm_mon  ||
            copy_tm.tm_year != parsed_tm.tm_year)
                return -EINVAL;
 
        if (ret_usec)
                *ret_usec = usec;
        if (ret_tm) {
                /* Reset to unset, then fill in only the date fields we parsed and validated */
                *ret_tm = BIRTH_DATE_UNSET;
                ret_tm->tm_mday = parsed_tm.tm_mday;
                ret_tm->tm_mon = parsed_tm.tm_mon;
                ret_tm->tm_year = parsed_tm.tm_year;
        }
 
        return 0;
}