]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
8b094cd0 TG |
2 | #ifndef _LINUX_TIMEKEEPING_H |
3 | #define _LINUX_TIMEKEEPING_H | |
4 | ||
b536fd58 | 5 | #include <linux/errno.h> |
86d34732 | 6 | |
8b094cd0 TG |
7 | /* Included from linux/ktime.h */ |
8 | ||
9 | void timekeeping_init(void); | |
10 | extern int timekeeping_suspended; | |
11 | ||
93b5a9a7 IM |
12 | /* Architecture timer tick functions: */ |
13 | extern void update_process_times(int user); | |
14 | extern void xtime_update(unsigned long ticks); | |
15 | ||
8b094cd0 TG |
16 | /* |
17 | * Get and set timeofday | |
18 | */ | |
21f7eca5 | 19 | extern int do_settimeofday64(const struct timespec64 *ts); |
86d34732 BW |
20 | extern int do_sys_settimeofday64(const struct timespec64 *tv, |
21 | const struct timezone *tz); | |
8758a240 | 22 | |
0e3fd810 AB |
23 | /* |
24 | * ktime_get() family: read the current time in a multitude of ways, | |
25 | * | |
26 | * The default time reference is CLOCK_MONOTONIC, starting at | |
27 | * boot time but not counting the time spent in suspend. | |
28 | * For other references, use the functions with "real", "clocktai", | |
29 | * "boottime" and "raw" suffixes. | |
30 | * | |
31 | * To get the time in a different format, use the ones wit | |
32 | * "ns", "ts64" and "seconds" suffix. | |
33 | * | |
34 | * See Documentation/core-api/timekeeping.rst for more details. | |
35 | */ | |
36 | ||
37 | ||
8b094cd0 | 38 | /* |
6546911e | 39 | * timespec64 based interfaces |
8b094cd0 | 40 | */ |
fb7fcc96 | 41 | extern void ktime_get_raw_ts64(struct timespec64 *ts); |
d6d29896 | 42 | extern void ktime_get_ts64(struct timespec64 *ts); |
edca71fe | 43 | extern void ktime_get_real_ts64(struct timespec64 *tv); |
fb7fcc96 AB |
44 | extern void ktime_get_coarse_ts64(struct timespec64 *ts); |
45 | extern void ktime_get_coarse_real_ts64(struct timespec64 *ts); | |
46 | ||
47 | void getboottime64(struct timespec64 *ts); | |
48 | ||
49 | /* | |
50 | * time64_t base interfaces | |
51 | */ | |
9e3680b1 | 52 | extern time64_t ktime_get_seconds(void); |
6909e29f | 53 | extern time64_t __ktime_get_real_seconds(void); |
dbe7aa62 | 54 | extern time64_t ktime_get_real_seconds(void); |
d6d29896 | 55 | |
8b094cd0 TG |
56 | /* |
57 | * ktime_t based interfaces | |
58 | */ | |
a3ed0e43 | 59 | |
0077dc60 TG |
60 | enum tk_offsets { |
61 | TK_OFFS_REAL, | |
a3ed0e43 | 62 | TK_OFFS_BOOT, |
0077dc60 TG |
63 | TK_OFFS_TAI, |
64 | TK_OFFS_MAX, | |
65 | }; | |
66 | ||
8b094cd0 | 67 | extern ktime_t ktime_get(void); |
0077dc60 | 68 | extern ktime_t ktime_get_with_offset(enum tk_offsets offs); |
b9ff604c | 69 | extern ktime_t ktime_get_coarse_with_offset(enum tk_offsets offs); |
9a6b5197 | 70 | extern ktime_t ktime_mono_to_any(ktime_t tmono, enum tk_offsets offs); |
f519b1a2 | 71 | extern ktime_t ktime_get_raw(void); |
6374f912 | 72 | extern u32 ktime_get_resolution_ns(void); |
8b094cd0 | 73 | |
f5264d5d TG |
74 | /** |
75 | * ktime_get_real - get the real (wall-) time in ktime_t format | |
76 | */ | |
77 | static inline ktime_t ktime_get_real(void) | |
78 | { | |
79 | return ktime_get_with_offset(TK_OFFS_REAL); | |
80 | } | |
81 | ||
b9ff604c AB |
82 | static inline ktime_t ktime_get_coarse_real(void) |
83 | { | |
84 | return ktime_get_coarse_with_offset(TK_OFFS_REAL); | |
85 | } | |
86 | ||
a3ed0e43 TG |
87 | /** |
88 | * ktime_get_boottime - Returns monotonic time since boot in ktime_t format | |
89 | * | |
90 | * This is similar to CLOCK_MONTONIC/ktime_get, but also includes the | |
91 | * time spent in suspend. | |
92 | */ | |
93 | static inline ktime_t ktime_get_boottime(void) | |
94 | { | |
95 | return ktime_get_with_offset(TK_OFFS_BOOT); | |
96 | } | |
97 | ||
b9ff604c AB |
98 | static inline ktime_t ktime_get_coarse_boottime(void) |
99 | { | |
100 | return ktime_get_coarse_with_offset(TK_OFFS_BOOT); | |
101 | } | |
102 | ||
afab07c0 TG |
103 | /** |
104 | * ktime_get_clocktai - Returns the TAI time of day in ktime_t format | |
105 | */ | |
106 | static inline ktime_t ktime_get_clocktai(void) | |
107 | { | |
108 | return ktime_get_with_offset(TK_OFFS_TAI); | |
109 | } | |
110 | ||
b9ff604c AB |
111 | static inline ktime_t ktime_get_coarse_clocktai(void) |
112 | { | |
113 | return ktime_get_coarse_with_offset(TK_OFFS_TAI); | |
114 | } | |
115 | ||
4c54294d JD |
116 | static inline ktime_t ktime_get_coarse(void) |
117 | { | |
118 | struct timespec64 ts; | |
119 | ||
120 | ktime_get_coarse_ts64(&ts); | |
121 | return timespec64_to_ktime(ts); | |
122 | } | |
123 | ||
124 | static inline u64 ktime_get_coarse_ns(void) | |
125 | { | |
126 | return ktime_to_ns(ktime_get_coarse()); | |
127 | } | |
128 | ||
129 | static inline u64 ktime_get_coarse_real_ns(void) | |
130 | { | |
131 | return ktime_to_ns(ktime_get_coarse_real()); | |
132 | } | |
133 | ||
d48e0cd8 | 134 | static inline u64 ktime_get_coarse_boottime_ns(void) |
4c54294d JD |
135 | { |
136 | return ktime_to_ns(ktime_get_coarse_boottime()); | |
137 | } | |
138 | ||
139 | static inline u64 ktime_get_coarse_clocktai_ns(void) | |
140 | { | |
141 | return ktime_to_ns(ktime_get_coarse_clocktai()); | |
142 | } | |
143 | ||
9a6b5197 TG |
144 | /** |
145 | * ktime_mono_to_real - Convert monotonic time to clock realtime | |
146 | */ | |
147 | static inline ktime_t ktime_mono_to_real(ktime_t mono) | |
148 | { | |
149 | return ktime_mono_to_any(mono, TK_OFFS_REAL); | |
150 | } | |
151 | ||
897994e3 TG |
152 | static inline u64 ktime_get_ns(void) |
153 | { | |
154 | return ktime_to_ns(ktime_get()); | |
155 | } | |
156 | ||
157 | static inline u64 ktime_get_real_ns(void) | |
158 | { | |
159 | return ktime_to_ns(ktime_get_real()); | |
160 | } | |
161 | ||
9285ec4c | 162 | static inline u64 ktime_get_boottime_ns(void) |
a3ed0e43 TG |
163 | { |
164 | return ktime_to_ns(ktime_get_boottime()); | |
165 | } | |
166 | ||
9285ec4c | 167 | static inline u64 ktime_get_clocktai_ns(void) |
fe5fba05 PZ |
168 | { |
169 | return ktime_to_ns(ktime_get_clocktai()); | |
170 | } | |
171 | ||
f519b1a2 TG |
172 | static inline u64 ktime_get_raw_ns(void) |
173 | { | |
174 | return ktime_to_ns(ktime_get_raw()); | |
175 | } | |
176 | ||
4396e058 | 177 | extern u64 ktime_get_mono_fast_ns(void); |
f09cb9a1 | 178 | extern u64 ktime_get_raw_fast_ns(void); |
a3ed0e43 | 179 | extern u64 ktime_get_boot_fast_ns(void); |
4c3711d7 | 180 | extern u64 ktime_get_real_fast_ns(void); |
4396e058 | 181 | |
d6c7270e | 182 | /* |
06aa3769 AB |
183 | * timespec64/time64_t interfaces utilizing the ktime based ones |
184 | * for API completeness, these could be implemented more efficiently | |
185 | * if needed. | |
d6c7270e | 186 | */ |
fb7fcc96 | 187 | static inline void ktime_get_boottime_ts64(struct timespec64 *ts) |
a3ed0e43 TG |
188 | { |
189 | *ts = ktime_to_timespec64(ktime_get_boottime()); | |
190 | } | |
191 | ||
06aa3769 AB |
192 | static inline void ktime_get_coarse_boottime_ts64(struct timespec64 *ts) |
193 | { | |
194 | *ts = ktime_to_timespec64(ktime_get_coarse_boottime()); | |
195 | } | |
196 | ||
197 | static inline time64_t ktime_get_boottime_seconds(void) | |
198 | { | |
199 | return ktime_divns(ktime_get_coarse_boottime(), NSEC_PER_SEC); | |
200 | } | |
201 | ||
fb7fcc96 | 202 | static inline void ktime_get_clocktai_ts64(struct timespec64 *ts) |
3c9c12f4 DD |
203 | { |
204 | *ts = ktime_to_timespec64(ktime_get_clocktai()); | |
205 | } | |
206 | ||
06aa3769 AB |
207 | static inline void ktime_get_coarse_clocktai_ts64(struct timespec64 *ts) |
208 | { | |
209 | *ts = ktime_to_timespec64(ktime_get_coarse_clocktai()); | |
210 | } | |
211 | ||
212 | static inline time64_t ktime_get_clocktai_seconds(void) | |
213 | { | |
214 | return ktime_divns(ktime_get_coarse_clocktai(), NSEC_PER_SEC); | |
215 | } | |
216 | ||
8b094cd0 TG |
217 | /* |
218 | * RTC specific | |
219 | */ | |
0fa88cb4 XP |
220 | extern bool timekeeping_rtc_skipsuspend(void); |
221 | extern bool timekeeping_rtc_skipresume(void); | |
222 | ||
985e6950 | 223 | extern void timekeeping_inject_sleeptime64(const struct timespec64 *delta); |
04d90890 | 224 | |
9da0f49c CH |
225 | /* |
226 | * struct system_time_snapshot - simultaneous raw/real time capture with | |
227 | * counter value | |
228 | * @cycles: Clocksource counter value to produce the system times | |
229 | * @real: Realtime system time | |
230 | * @raw: Monotonic raw system time | |
2c756feb CH |
231 | * @clock_was_set_seq: The sequence number of clock was set events |
232 | * @cs_was_changed_seq: The sequence number of clocksource change events | |
9da0f49c CH |
233 | */ |
234 | struct system_time_snapshot { | |
a5a1d1c2 | 235 | u64 cycles; |
9da0f49c CH |
236 | ktime_t real; |
237 | ktime_t raw; | |
2c756feb CH |
238 | unsigned int clock_was_set_seq; |
239 | u8 cs_was_changed_seq; | |
9da0f49c CH |
240 | }; |
241 | ||
8006c245 CH |
242 | /* |
243 | * struct system_device_crosststamp - system/device cross-timestamp | |
244 | * (syncronized capture) | |
245 | * @device: Device time | |
246 | * @sys_realtime: Realtime simultaneous with device time | |
247 | * @sys_monoraw: Monotonic raw simultaneous with device time | |
248 | */ | |
249 | struct system_device_crosststamp { | |
250 | ktime_t device; | |
251 | ktime_t sys_realtime; | |
252 | ktime_t sys_monoraw; | |
253 | }; | |
254 | ||
255 | /* | |
256 | * struct system_counterval_t - system counter value with the pointer to the | |
257 | * corresponding clocksource | |
258 | * @cycles: System counter value | |
259 | * @cs: Clocksource corresponding to system counter value. Used by | |
260 | * timekeeping code to verify comparibility of two cycle values | |
261 | */ | |
262 | struct system_counterval_t { | |
a5a1d1c2 | 263 | u64 cycles; |
8006c245 CH |
264 | struct clocksource *cs; |
265 | }; | |
266 | ||
267 | /* | |
268 | * Get cross timestamp between system clock and device clock | |
269 | */ | |
270 | extern int get_device_system_crosststamp( | |
271 | int (*get_time_fn)(ktime_t *device_time, | |
272 | struct system_counterval_t *system_counterval, | |
273 | void *ctx), | |
274 | void *ctx, | |
2c756feb | 275 | struct system_time_snapshot *history, |
8006c245 CH |
276 | struct system_device_crosststamp *xtstamp); |
277 | ||
9da0f49c CH |
278 | /* |
279 | * Simultaneously snapshot realtime and monotonic raw clocks | |
280 | */ | |
281 | extern void ktime_get_snapshot(struct system_time_snapshot *systime_snapshot); | |
282 | ||
8b094cd0 TG |
283 | /* |
284 | * Persistent clock related interfaces | |
285 | */ | |
8b094cd0 TG |
286 | extern int persistent_clock_is_local; |
287 | ||
2ee96632 | 288 | extern void read_persistent_clock64(struct timespec64 *ts); |
c43c5e9f CB |
289 | void read_persistent_wall_and_boot_offset(struct timespec64 *wall_clock, |
290 | struct timespec64 *boot_offset); | |
3c00a1fe | 291 | extern int update_persistent_clock64(struct timespec64 now); |
8b094cd0 | 292 | |
8b094cd0 | 293 | #endif |