rtc_timer_enqueue(9)

💅 rtc_timer_enqueue(9)

okay so bestie, welcome to the Kernel API Manual — specifically the page for rtc_timer_enqueue(9), aka the little function that shoves your timer into the queue. let's get into it ✨

---

🌸 NAME 🌸

rtc_timer_enqueue — adds a rtc_timer to the rtc_device timerqueue 🎀

---

✨ SYNOPSIS ✨

int rtc_timer_enqueue (struct rtc_device *rtc , struct rtc_timer *timer
);

like, it returns an int, takes a struct rtc_device *rtc, and a struct rtc_timer *timer. that's the whole vibe fr fr 🫶

---

🦋 ARGUMENTS 🦋

• rtc — the rtc device, obviously. main character of this call 💅
• timer — the timer being added. this is the one we're enqueueing, no cap.

---

💖 DESCRIPTION 💖

So what it does: it enqueues a timer onto the rtc device's timerqueue, and sets the next alarm event appropriately. like, it handles the whole scheduling situation for you, iconic behavior honestly 👑

It also sets the enabled bit on the added timer. so once it's in, it's in — enabled and ready to go ⭐

⚠️ big one bestie: you must hold ops_lock for proper serialization of the timerqueue. no ops_lock, no proper serialization. this is not a drill 💀

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/rtc/interface.c, plus all these besties:

• rtc_read_next_alarm(9)
• rtc_handle_legacy_irq(9)
• rtc_aie_update_irq(9)
• rtc_uie_update_irq(9)
• rtc_pie_update_irq(9)
• rtc_update_irq(9)
• rtc_irq_set_state(9)
• rtc_irq_set_freq(9)
• rtc_timer_remove(9)
• rtc_timer_do_work(9)
• rtc_read_offset(9)
• rtc_set_offset(9)

---

and that's the page!! 🍓 this little gem lives in ./drivers/rtc, dated October 2026, straight from the Kernel API Manual. go forth and enqueue responsibly, mwah 💜🧚