tick_program_event(9)

📦 version 7.3.1, in nixpkgs unstable

✨ tick_program_event ✨

okay so like, this is a page from the Kernel API Manual, and honestly? it's giving "tiny function, huge responsibilities" 💅 we're talking about tick_program_event — the little guy that pokes the CPU local timer device and tells it exactly when to fire next. main character energy fr fr 🔥

🌸 NAME 🌸

tick_program_event — program the CPU local timer device for the next event ⏰✨

like. that's the whole vibe. it schedules the next tick. no cap.

🎀 SYNOPSIS 🎀

int tick_program_event (ktime_t expires , int force );

yes bestie that's the whole signature, she's short and she knows it 💖

🦋 ARGUMENTS 🦋

  • expires — the time at which the next timer event should occur 🕐 like, the actual moment the timer's supposed to go off. that's the whole point.
  • force — flag to force reprograming even if the event time hasn't changed 😤 so normally if expires is the same as before, the code would be like "already done, bestie, nothing to do" — but set this bad boy and it reprograms anyway. stubborn queen behavior. (yes, the original spells it "reprograming" — we respect the spelling, periodt 💀)

💜 RETURN 💜

  • 0 on success 🎉 slay, it worked
  • negative error code on failure 😭 something went wrong, check the number
no in-between, no "maybe" — it's either a clean 0 or a negative code, iykyk 🙈

🌈 SEE ALSO 🌈

the kernel file ./kernel/time/tick-oneshot.c says hi 👋 and also go read these:

all the oneshot girlies, one big happy timer family 🫶✨

okay that's the whole page, you ate that 💅 this little icon lives in ./kernel/time, it's from October 2026, and it's filed under tick_program_event(9) in the Kernel API Manual — mwah, go program a timer, bestie 🎀💖🐛

📦 where this page comes from