]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
9a98c7a1 LP |
2 | #pragma once |
3 | ||
4 | /*** | |
5 | This file is part of systemd. | |
6 | ||
7 | Copyright 2010 Lennart Poettering | |
9a98c7a1 LP |
8 | ***/ |
9 | ||
cb0dac05 | 10 | #include <inttypes.h> |
11c3a366 TA |
11 | #include <stdbool.h> |
12 | #include <stddef.h> | |
13 | #include <stdint.h> | |
7c67c79c HV |
14 | #include <stdio.h> |
15 | #include <time.h> | |
9a98c7a1 LP |
16 | |
17 | typedef uint64_t usec_t; | |
18 | typedef uint64_t nsec_t; | |
19 | ||
70887c5f ZJS |
20 | #define PRI_NSEC PRIu64 |
21 | #define PRI_USEC PRIu64 | |
22 | #define NSEC_FMT "%" PRI_NSEC | |
23 | #define USEC_FMT "%" PRI_USEC | |
ccd06097 | 24 | |
9a98c7a1 LP |
25 | #include "macro.h" |
26 | ||
27 | typedef struct dual_timestamp { | |
28 | usec_t realtime; | |
29 | usec_t monotonic; | |
30 | } dual_timestamp; | |
31 | ||
fe624c4c LP |
32 | typedef struct triple_timestamp { |
33 | usec_t realtime; | |
34 | usec_t monotonic; | |
35 | usec_t boottime; | |
36 | } triple_timestamp; | |
37 | ||
3a43da28 KS |
38 | #define USEC_INFINITY ((usec_t) -1) |
39 | #define NSEC_INFINITY ((nsec_t) -1) | |
40 | ||
41 | #define MSEC_PER_SEC 1000ULL | |
609e002e LP |
42 | #define USEC_PER_SEC ((usec_t) 1000000ULL) |
43 | #define USEC_PER_MSEC ((usec_t) 1000ULL) | |
3a43da28 KS |
44 | #define NSEC_PER_SEC ((nsec_t) 1000000000ULL) |
45 | #define NSEC_PER_MSEC ((nsec_t) 1000000ULL) | |
46 | #define NSEC_PER_USEC ((nsec_t) 1000ULL) | |
609e002e LP |
47 | |
48 | #define USEC_PER_MINUTE ((usec_t) (60ULL*USEC_PER_SEC)) | |
3a43da28 | 49 | #define NSEC_PER_MINUTE ((nsec_t) (60ULL*NSEC_PER_SEC)) |
609e002e | 50 | #define USEC_PER_HOUR ((usec_t) (60ULL*USEC_PER_MINUTE)) |
3a43da28 | 51 | #define NSEC_PER_HOUR ((nsec_t) (60ULL*NSEC_PER_MINUTE)) |
609e002e | 52 | #define USEC_PER_DAY ((usec_t) (24ULL*USEC_PER_HOUR)) |
3a43da28 | 53 | #define NSEC_PER_DAY ((nsec_t) (24ULL*NSEC_PER_HOUR)) |
609e002e | 54 | #define USEC_PER_WEEK ((usec_t) (7ULL*USEC_PER_DAY)) |
3a43da28 | 55 | #define NSEC_PER_WEEK ((nsec_t) (7ULL*NSEC_PER_DAY)) |
609e002e | 56 | #define USEC_PER_MONTH ((usec_t) (2629800ULL*USEC_PER_SEC)) |
3a43da28 | 57 | #define NSEC_PER_MONTH ((nsec_t) (2629800ULL*NSEC_PER_SEC)) |
609e002e | 58 | #define USEC_PER_YEAR ((usec_t) (31557600ULL*USEC_PER_SEC)) |
3a43da28 | 59 | #define NSEC_PER_YEAR ((nsec_t) (31557600ULL*NSEC_PER_SEC)) |
9a98c7a1 | 60 | |
21b3a0fc LP |
61 | /* We assume a maximum timezone length of 6. TZNAME_MAX is not defined on Linux, but glibc internally initializes this |
62 | * to 6. Let's rely on that. */ | |
63 | #define FORMAT_TIMESTAMP_MAX (3+1+10+1+8+1+6+1+6+1) | |
c3f84106 | 64 | #define FORMAT_TIMESTAMP_WIDTH 28 /* when outputting, assume this width */ |
9185c8e6 | 65 | #define FORMAT_TIMESTAMP_RELATIVE_MAX 256 |
9a98c7a1 LP |
66 | #define FORMAT_TIMESPAN_MAX 64 |
67 | ||
2d60169d | 68 | #define TIME_T_MAX (time_t)((UINTMAX_C(1) << ((sizeof(time_t) << 3) - 1)) - 1) |
e4746b57 | 69 | |
fe624c4c LP |
70 | #define DUAL_TIMESTAMP_NULL ((struct dual_timestamp) {}) |
71 | #define TRIPLE_TIMESTAMP_NULL ((struct triple_timestamp) {}) | |
842129f5 | 72 | |
9a98c7a1 | 73 | usec_t now(clockid_t clock); |
45d7a8bb | 74 | nsec_t now_nsec(clockid_t clock); |
9a98c7a1 LP |
75 | |
76 | dual_timestamp* dual_timestamp_get(dual_timestamp *ts); | |
77 | dual_timestamp* dual_timestamp_from_realtime(dual_timestamp *ts, usec_t u); | |
cae0c5e0 | 78 | dual_timestamp* dual_timestamp_from_monotonic(dual_timestamp *ts, usec_t u); |
fbe55073 | 79 | dual_timestamp* dual_timestamp_from_boottime_or_monotonic(dual_timestamp *ts, usec_t u); |
9a98c7a1 | 80 | |
fe624c4c LP |
81 | triple_timestamp* triple_timestamp_get(triple_timestamp *ts); |
82 | triple_timestamp* triple_timestamp_from_realtime(triple_timestamp *ts, usec_t u); | |
83 | ||
84 | #define DUAL_TIMESTAMP_HAS_CLOCK(clock) \ | |
85 | IN_SET(clock, CLOCK_REALTIME, CLOCK_REALTIME_ALARM, CLOCK_MONOTONIC) | |
86 | ||
87 | #define TRIPLE_TIMESTAMP_HAS_CLOCK(clock) \ | |
88 | IN_SET(clock, CLOCK_REALTIME, CLOCK_REALTIME_ALARM, CLOCK_MONOTONIC, CLOCK_BOOTTIME, CLOCK_BOOTTIME_ALARM) | |
89 | ||
34cf6c43 | 90 | static inline bool dual_timestamp_is_set(const dual_timestamp *ts) { |
3a43da28 KS |
91 | return ((ts->realtime > 0 && ts->realtime != USEC_INFINITY) || |
92 | (ts->monotonic > 0 && ts->monotonic != USEC_INFINITY)); | |
966204e0 | 93 | } |
9a98c7a1 | 94 | |
34cf6c43 | 95 | static inline bool triple_timestamp_is_set(const triple_timestamp *ts) { |
fe624c4c LP |
96 | return ((ts->realtime > 0 && ts->realtime != USEC_INFINITY) || |
97 | (ts->monotonic > 0 && ts->monotonic != USEC_INFINITY) || | |
98 | (ts->boottime > 0 && ts->boottime != USEC_INFINITY)); | |
99 | } | |
100 | ||
101 | usec_t triple_timestamp_by_clock(triple_timestamp *ts, clockid_t clock); | |
102 | ||
44a6b1b6 | 103 | usec_t timespec_load(const struct timespec *ts) _pure_; |
3a730176 | 104 | nsec_t timespec_load_nsec(const struct timespec *ts) _pure_; |
9a98c7a1 LP |
105 | struct timespec *timespec_store(struct timespec *ts, usec_t u); |
106 | ||
44a6b1b6 | 107 | usec_t timeval_load(const struct timeval *tv) _pure_; |
9a98c7a1 LP |
108 | struct timeval *timeval_store(struct timeval *tv, usec_t u); |
109 | ||
110 | char *format_timestamp(char *buf, size_t l, usec_t t); | |
5ab99e07 LP |
111 | char *format_timestamp_utc(char *buf, size_t l, usec_t t); |
112 | char *format_timestamp_us(char *buf, size_t l, usec_t t); | |
113 | char *format_timestamp_us_utc(char *buf, size_t l, usec_t t); | |
bbb8486e | 114 | char *format_timestamp_relative(char *buf, size_t l, usec_t t); |
2fa4092c | 115 | char *format_timespan(char *buf, size_t l, usec_t t, usec_t accuracy); |
9a98c7a1 LP |
116 | |
117 | void dual_timestamp_serialize(FILE *f, const char *name, dual_timestamp *t); | |
e911de99 | 118 | int dual_timestamp_deserialize(const char *value, dual_timestamp *t); |
b895a735 | 119 | int timestamp_deserialize(const char *value, usec_t *timestamp); |
9a98c7a1 LP |
120 | |
121 | int parse_timestamp(const char *t, usec_t *usec); | |
122 | ||
7f602784 | 123 | int parse_sec(const char *t, usec_t *usec); |
0004f698 | 124 | int parse_sec_fix_0(const char *t, usec_t *usec); |
519cffec | 125 | int parse_time(const char *t, usec_t *usec, usec_t default_unit); |
9a98c7a1 | 126 | int parse_nsec(const char *t, nsec_t *nsec); |
03cc26dd LP |
127 | |
128 | bool ntp_synced(void); | |
75683450 LP |
129 | |
130 | int get_timezones(char ***l); | |
089fb865 | 131 | bool timezone_is_valid(const char *name, int log_level); |
77ff2de9 | 132 | |
3411372e | 133 | bool clock_boottime_supported(void); |
fe624c4c | 134 | bool clock_supported(clockid_t clock); |
77ff2de9 | 135 | clockid_t clock_boottime_or_monotonic(void); |
babc21fd | 136 | |
1007ec60 LP |
137 | usec_t usec_shift_clock(usec_t, clockid_t from, clockid_t to); |
138 | ||
5c904ba5 | 139 | int get_timezone(char **timezone); |
7c67c79c HV |
140 | |
141 | time_t mktime_or_timegm(struct tm *tm, bool utc); | |
142 | struct tm *localtime_or_gmtime_r(const time_t *t, struct tm *tm, bool utc); | |
87b8ce69 SS |
143 | |
144 | unsigned long usec_to_jiffies(usec_t usec); | |
53f555b6 | 145 | |
9a9a4f10 LP |
146 | bool in_utc_timezone(void); |
147 | ||
53f555b6 LP |
148 | static inline usec_t usec_add(usec_t a, usec_t b) { |
149 | usec_t c; | |
150 | ||
151 | /* Adds two time values, and makes sure USEC_INFINITY as input results as USEC_INFINITY in output, and doesn't | |
152 | * overflow. */ | |
153 | ||
154 | c = a + b; | |
155 | if (c < a || c < b) /* overflow check */ | |
156 | return USEC_INFINITY; | |
157 | ||
158 | return c; | |
159 | } | |
5d634ca8 | 160 | |
54d8ef14 | 161 | static inline usec_t usec_sub_unsigned(usec_t timestamp, usec_t delta) { |
5d634ca8 | 162 | |
04a1d84c LP |
163 | if (timestamp == USEC_INFINITY) /* Make sure infinity doesn't degrade */ |
164 | return USEC_INFINITY; | |
54d8ef14 | 165 | if (timestamp < delta) |
04a1d84c LP |
166 | return 0; |
167 | ||
168 | return timestamp - delta; | |
5d634ca8 | 169 | } |
1bb4b028 | 170 | |
54d8ef14 LP |
171 | static inline usec_t usec_sub_signed(usec_t timestamp, int64_t delta) { |
172 | if (delta < 0) | |
173 | return usec_add(timestamp, (usec_t) (-delta)); | |
174 | else | |
175 | return usec_sub_unsigned(timestamp, (usec_t) delta); | |
176 | } | |
177 | ||
1bb4b028 LP |
178 | #if SIZEOF_TIME_T == 8 |
179 | /* The last second we can format is 31. Dec 9999, 1s before midnight, because otherwise we'd enter 5 digit year | |
180 | * territory. However, since we want to stay away from this in all timezones we take one day off. */ | |
181 | #define USEC_TIMESTAMP_FORMATTABLE_MAX ((usec_t) 253402214399000000) | |
182 | #elif SIZEOF_TIME_T == 4 | |
183 | /* With a 32bit time_t we can't go beyond 2038... */ | |
184 | #define USEC_TIMESTAMP_FORMATTABLE_MAX ((usec_t) 2147483647000000) | |
185 | #else | |
186 | #error "Yuck, time_t is neither 4 not 8 bytes wide?" | |
187 | #endif |