alarm_start_timer(9)
π alarm_start_timer(9) β from the Kernel API Manual, bestie
okay so like, real talk: this page lives in the Kernel API Manual, and it's genuinely one of the most "short but slay" pages ever. It's literally just one function that sets an alarm to fire, and honestly? Iconic. Let's get into it β¨
π NAME
alarm_start_timer β sets an alarm to fire. that's it, that's the whole vibe π«Ά
πΈ SYNOPSIS
bool alarm_start_timer (struct alarm *alarm , ktime_t expires , bool
relative );
look at her. one function, three args, returns a bool. she's giving minimalism, she's giving "I only need what I need" π
π¦ ARGUMENTS
alarmβ pointer to the alarm you wanna set. like, the actual alarm object, not a copy, not a vibe, the pointer itself πexpiresβ the expiry time. this is aktime_t, so it's kernel-time coded. respect her units bestie.relativeβtrueifexpiresis relative. so like, "an hour from now" vs "at exactly 3:47pm" β this flag is the difference between those two whole situations π
π₯ RETURN
Trueβ the alarm was queued. mission accomplished, she's in the queue, we love to see it πFalseβ it already expired. yeah, it's a little anticlimactic, but at least you know π
β SEE ALSO
this list is LONG and honestly it's a whole friend group. every single one of them, no cap:
Kernel file ./kernel/time/alarmtimer.c struct alarm_base(9), alarmtimer_get_rtcdev(9), alarmtimer_enqueue(9), alarmtimer_dequeue(9), alarmtimer_fired(9), alarmtimer_suspend(9), alarm_init(9), alarm_try_to_cancel(9), alarm_cancel(9), clock2alarm(9), alarm_handle_timer(9), alarm_timer_rearm(9), alarm_timer_forward(9), alarm_timer_remaining(9), alarm_timer_try_to_cancel(9), alarm_timer_wait_running(9), alarm_timer_arm(9), alarm_clock_getres(9), alarm_clock_get_timespec(9), alarm_clock_get_ktime(9), alarm_timer_create(9), alarmtimer_nsleep_wakeup(9), alarmtimer_do_nsleep(9), alarm_timer_nsleep_restart(9), alarm_timer_nsleep(9), alarmtimer_init(9)
like I said. a whole friend group. go say hi to them π
quick reminder bestie: False doesn't mean "bad thing happened", it means the alarm already expired. don't panic, just read the return value π§
and that's the page!! mwah π this lil gem comes from ./kernel/time and it's dated October 2026, and the title/footer both rep alarm_start_timer(9) β so now you know exactly where she's from and when she was last touched up. periodt ππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms