22 #include <linux/timer.h>
32  * HRTIMER_MODE_PINNED		- Timer is bound to CPU (is only considered
33  *				  when starting the timer)
34  * HRTIMER_MODE_SOFT		- Timer callback function will be executed in
36  * HRTIMER_MODE_HARD		- Timer callback function will be executed in
63  * Values to track state of the timer
70  * The callback state is not part of the timer->state because clearing it would
71  * mean touching the timer after the callback, this makes it impossible to free
72  * the timer from the callback function.
76  *	timer->base->cpu_base->running == timer
79  * status. It happens for example when a posix timer expired and the callback
80  * queued a signal. Between dropping the lock which protects the posix timer
82  * signal and rearm the timer.
91  * @timer:	embedded timer structure
94  * task is set to NULL, when the timer expires.
97 	struct hrtimer timer;  member
108  * struct hrtimer_clock_base - the timer base for a specific clock
111  *			timer to a base on another cpu.
161  * @timer_waiters:	A hrtimer_cancel() invocation waits for the timer
166  * @next_timer:		Pointer to the first expiring timer
168  * @softirq_next_timer: Pointer to the first expiring softirq based timer
202 static inline void hrtimer_set_expires(struct hrtimer *timer, ktime_t time)  in hrtimer_set_expires()  argument
204 	timer->node.expires = time;  in hrtimer_set_expires()
205 	timer->_softexpires = time;  in hrtimer_set_expires()
208 static inline void hrtimer_set_expires_range(struct hrtimer *timer, ktime_t time, ktime_t delta)  in hrtimer_set_expires_range()  argument
210 	timer->_softexpires = time;  in hrtimer_set_expires_range()
211 	timer->node.expires = ktime_add_safe(time, delta);  in hrtimer_set_expires_range()
214 static inline void hrtimer_set_expires_range_ns(struct hrtimer *timer, ktime_t time, u64 delta)  in hrtimer_set_expires_range_ns()  argument
216 	timer->_softexpires = time;  in hrtimer_set_expires_range_ns()
217 	timer->node.expires = ktime_add_safe(time, ns_to_ktime(delta));  in hrtimer_set_expires_range_ns()
220 static inline void hrtimer_set_expires_tv64(struct hrtimer *timer, s64 tv64)  in hrtimer_set_expires_tv64()  argument
222 	timer->node.expires = tv64;  in hrtimer_set_expires_tv64()
223 	timer->_softexpires = tv64;  in hrtimer_set_expires_tv64()
226 static inline void hrtimer_add_expires(struct hrtimer *timer, ktime_t time)  in hrtimer_add_expires()  argument
228 	timer->node.expires = ktime_add_safe(timer->node.expires, time);  in hrtimer_add_expires()
229 	timer->_softexpires = ktime_add_safe(timer->_softexpires, time);  in hrtimer_add_expires()
232 static inline void hrtimer_add_expires_ns(struct hrtimer *timer, u64 ns)  in hrtimer_add_expires_ns()  argument
234 	timer->node.expires = ktime_add_ns(timer->node.expires, ns);  in hrtimer_add_expires_ns()
235 	timer->_softexpires = ktime_add_ns(timer->_softexpires, ns);  in hrtimer_add_expires_ns()
238 static inline ktime_t hrtimer_get_expires(const struct hrtimer *timer)  in hrtimer_get_expires()  argument
240 	return timer->node.expires;  in hrtimer_get_expires()
243 static inline ktime_t hrtimer_get_softexpires(const struct hrtimer *timer)  in hrtimer_get_softexpires()  argument
245 	return timer->_softexpires;  in hrtimer_get_softexpires()
248 static inline s64 hrtimer_get_expires_tv64(const struct hrtimer *timer)  in hrtimer_get_expires_tv64()  argument
250 	return timer->node.expires;  in hrtimer_get_expires_tv64()
252 static inline s64 hrtimer_get_softexpires_tv64(const struct hrtimer *timer)  in hrtimer_get_softexpires_tv64()  argument
254 	return timer->_softexpires;  in hrtimer_get_softexpires_tv64()
257 static inline s64 hrtimer_get_expires_ns(const struct hrtimer *timer)  in hrtimer_get_expires_ns()  argument
259 	return ktime_to_ns(timer->node.expires);  in hrtimer_get_expires_ns()
262 static inline ktime_t hrtimer_expires_remaining(const struct hrtimer *timer)  in hrtimer_expires_remaining()  argument
264 	return ktime_sub(timer->node.expires, timer->base->get_time());  in hrtimer_expires_remaining()
267 static inline ktime_t hrtimer_cb_get_time(struct hrtimer *timer)  in hrtimer_cb_get_time()  argument
269 	return timer->base->get_time();  in hrtimer_cb_get_time()
272 static inline int hrtimer_is_hres_active(struct hrtimer *timer)  in hrtimer_is_hres_active()  argument
275 		timer->base->cpu_base->hres_active : 0;  in hrtimer_is_hres_active()
292 __hrtimer_expires_remaining_adjusted(const struct hrtimer *timer, ktime_t now)  in __hrtimer_expires_remaining_adjusted()  argument
294 	ktime_t rem = ktime_sub(timer->node.expires, now);  in __hrtimer_expires_remaining_adjusted()
300 	if (IS_ENABLED(CONFIG_TIME_LOW_RES) && timer->is_rel)  in __hrtimer_expires_remaining_adjusted()
306 hrtimer_expires_remaining_adjusted(const struct hrtimer *timer)  in hrtimer_expires_remaining_adjusted()  argument
308 	return __hrtimer_expires_remaining_adjusted(timer,  in hrtimer_expires_remaining_adjusted()
309 						    timer->base->get_time());  in hrtimer_expires_remaining_adjusted()
323 void hrtimer_cancel_wait_running(const struct hrtimer *timer);
325 static inline void hrtimer_cancel_wait_running(struct hrtimer *timer)  in hrtimer_cancel_wait_running()  argument
331 /* Exported timer functions: */
334 extern void hrtimer_init(struct hrtimer *timer, clockid_t which_clock,
340 extern void hrtimer_init_on_stack(struct hrtimer *timer, clockid_t which_clock,
346 extern void destroy_hrtimer_on_stack(struct hrtimer *timer);
348 static inline void hrtimer_init_on_stack(struct hrtimer *timer,  in hrtimer_init_on_stack()  argument
352 	hrtimer_init(timer, which_clock, mode);  in hrtimer_init_on_stack()
362 static inline void destroy_hrtimer_on_stack(struct hrtimer *timer) { }  in destroy_hrtimer_on_stack()  argument
365 /* Basic timer operations: */
366 extern void hrtimer_start_range_ns(struct hrtimer *timer, ktime_t tim,
371  * @timer:	the timer to be added
373  * @mode:	timer mode: absolute (HRTIMER_MODE_ABS) or
377 static inline void hrtimer_start(struct hrtimer *timer, ktime_t tim,  in hrtimer_start()  argument
380 	hrtimer_start_range_ns(timer, tim, 0, mode);  in hrtimer_start()
383 extern int hrtimer_cancel(struct hrtimer *timer);
384 extern int hrtimer_try_to_cancel(struct hrtimer *timer);
386 static inline void hrtimer_start_expires(struct hrtimer *timer,  in hrtimer_start_expires()  argument
391 	soft = hrtimer_get_softexpires(timer);  in hrtimer_start_expires()
392 	hard = hrtimer_get_expires(timer);  in hrtimer_start_expires()
394 	hrtimer_start_range_ns(timer, soft, delta, mode);  in hrtimer_start_expires()
400 static inline void hrtimer_restart(struct hrtimer *timer)  in hrtimer_restart()  argument
402 	hrtimer_start_expires(timer, HRTIMER_MODE_ABS);  in hrtimer_restart()
406 extern ktime_t __hrtimer_get_remaining(const struct hrtimer *timer, bool adjust);
409  * hrtimer_get_remaining - get remaining time for the timer
410  * @timer:	the timer to read
412 static inline ktime_t hrtimer_get_remaining(const struct hrtimer *timer)  in hrtimer_get_remaining()  argument
414 	return __hrtimer_get_remaining(timer, false);  in hrtimer_get_remaining()
420 extern bool hrtimer_active(const struct hrtimer *timer);
423  * hrtimer_is_queued - check, whether the timer is on one of the queues
424  * @timer:	Timer to check
426  * Returns: True if the timer is queued, false otherwise
430 static inline bool hrtimer_is_queued(struct hrtimer *timer)  in hrtimer_is_queued()  argument
432 	/* The READ_ONCE pairs with the update functions of timer->state */  in hrtimer_is_queued()
433 	return !!(READ_ONCE(timer->state) & HRTIMER_STATE_ENQUEUED);  in hrtimer_is_queued()
437  * Helper function to check, whether the timer is running the callback
440 static inline int hrtimer_callback_running(struct hrtimer *timer)  in hrtimer_callback_running()  argument
442 	return timer->base->running == timer;  in hrtimer_callback_running()
447 hrtimer_forward(struct hrtimer *timer, ktime_t now, ktime_t interval);
450  * hrtimer_forward_now - forward the timer expiry so it expires after now
451  * @timer:	hrtimer to forward
454  * Forward the timer expiry so it will expire after the current time
457  * Can be safely called from the callback function of @timer. If
458  * called from other contexts @timer must neither be enqueued nor
462  * Note: This only updates the timer expiry value and does not requeue
463  * the timer.
465 static inline u64 hrtimer_forward_now(struct hrtimer *timer,  in hrtimer_forward_now()  argument
468 	return hrtimer_forward(timer, timer->base->get_time(), interval);  in hrtimer_forward_now()