[PATCH v7 03/21] timer: Add comment to get_next_timer_interrupt() description

From: Anna-Maria Behnsen
Date: Wed May 24 2023 - 03:07:14 EST

get_next_timer_interrupt() does more than simply getting the next timer
interrupt. The timer bases are forwarded and also marked as idle whenever

To get not confused, add a comment to function description.

Signed-off-by: Anna-Maria Behnsen <anna-maria@xxxxxxxxxxxxx>
Reviewed-by: Frederic Weisbecker <frederic@xxxxxxxxxx>
v6: s/handling/marking

v5: New patch, which adds only a comment to get_next_timer_interrupt()
instead of changing the function name
kernel/time/timer.c | 4 ++++
1 file changed, 4 insertions(+)

diff --git a/kernel/time/timer.c b/kernel/time/timer.c
index 6e251e3cf659..0699fd14d00a 100644
--- a/kernel/time/timer.c
+++ b/kernel/time/timer.c
@@ -1912,6 +1912,10 @@ static u64 cmp_next_hrtimer_event(u64 basem, u64 expires)
* @basej: base time jiffies
* @basem: base time clock monotonic
+ * If required, base->clk is forwarded and base is also marked as
+ * idle. Idle marking of timer bases is allowed only to be done by CPU
+ * itself.
+ *
* Returns the tick aligned clock monotonic time of the next pending
* timer or KTIME_MAX if no timer is pending.