clockevents_program_event(9)

✨ clockevents_program_event ✨

okay so bestie, welcome to the Kernel API Manual 💖 you're literally about to read the page for clockevents_program_event(9) and honestly? it's giving "small function, big responsibility." let's get into it 🎀

---

🌸 NAME 🌸

clockevents_program_event — reprogram the clock event device, no cap ⏰

---

🦋 SYNOPSIS 🦋

int clockevents_program_event (struct clock_event_device *dev , ktime_t
expires , bool force );

like… look at her. three args, one int return, main character energy fr fr 💅

---

💜 ARGUMENTS 💜

• dev — the device you're programming 🛠️ this is the clock event device in question, she's the one getting the glow-up
• expires — the absolute expiry time, and it's on the monotonic clock ⏱️ absolute, not relative, don't get it twisted
• force — if expires can't actually be set, this bad boy tells the function to program the minimum delay instead 🙈 like, "we can't do your time, so here's the earliest we can do"

---

🌈 DESCRIPTION 🌈

so here's the vibe check: the function returns 0 on success ✨ and returns -ETIME when the event is in the past 💀 yeah… if your expiry time already happened, that's a no from her. -ETIME, periodt.

---

👑 SEE ALSO 👑

if you're obsessed (and you should be 🫶), go peek at the kernel file ./kernel/time/clockevents.c and also these iconic siblings:

• clockevent_delta2ns(9)
• clockevents_switch_state(9)
• clockevents_shutdown(9)
• clockevents_tick_resume(9)
• clockevents_increase_min_delta(9)
• clockevents_program_min_delta(9)
• clockevents_program_min_delta(9) — yes bestie she's listed twice, that's not me being messy, that's literally how it is 😭💀
• clockevents_register_device(9)
• clockevents_config_and_register(9)
• clockevents_update_freq(9)
• clockevents_exchange_device(9)
• clockevents_suspend(9)
• clockevents_resume(9)
• tick_offline_cpu(9)

---

okay that's the whole page, you ate that 🍓

lowkey a cute little sign-off: this one lives in ./kernel/time and it's dated October 2026 — and the page itself is clockevents_program_event(9), iykyk 💖✨🎀