clockevents_update_freq(9)

💅 clockevents_update_freq(9) — Kernel API Manual 💅

okay so bestie, welcome to the Kernel API Manual page for clockevents_update_freq(9). this is the one about updating frequency and reprogramming a clock event device — main character energy, fr fr. 🎀

---

💖 NAME 💖

clockevents_update_freq — update the frequency and reprogram a clock event device. slay. ✨

✨ SYNOPSIS ✨

int clockevents_update_freq (struct clock_event_device *dev , u32 freq );

🎀 ARGUMENTS 🎀

• dev — the device to modify. that's the one you're touching, bestie. 💅
• freq — the new device frequency. the fresh number, no cap. 🔥

🦋 DESCRIPTION 🦋

okay so what this does: it reconfigures and reprograms a clock event device in oneshot mode. literally its whole thing. ✨

⚠️ caveat, bestie: you must call this on the cpu for which the device delivers per cpu timer events. like, that part is not optional. no cap. 🫶

if you call it for the broadcast device, the core takes care of serialization — iconic, honestly. 👑

it returns 0 on success, and -ETIME when the event is in the past. periodt. 💀

🌸 SEE ALSO 🌸

Kernel file: ./kernel/time/clockevents.c

the SEE ALSO gang, in order (and yes, clockevents_program_min_delta(9) shows up twice — i don't make the rules, i just keep every detail 💅):

• 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)
• clockevents_program_event(9)
• clockevents_register_device(9)
• clockevents_config_and_register(9)
• clockevents_exchange_device(9)
• clockevents_suspend(9)
• clockevents_resume(9)
• tick_offline_cpu(9)

---

mwah 💋 this cutie lives at source/path ./kernel/time, dated October 2026, and it's the clockevents_update_freq(9) page. byeee, go reprogram something responsibly 🫶✨