mod_timer_pending(9)

💅 mod_timer_pending(9) 💅

okay bestie, welcome to the Kernel API Manual — this one's mod_timer_pending(9) and it's literally the timer-nerd's bestie. buckle up 🎀

---

✨ NAME ✨

mod_timer_pending — tweak a pending timer's timeout, no cap ⏰

---

🌸 SYNOPSIS 🌸

int mod_timer_pending (struct timer_list *timer , unsigned long expires );

---

🦋 ARGUMENTS 🦋

• timer — the pending timer you're about to mess with, iykyk 🫶
• expires — the new absolute timeout, measured in jiffies ⏱️

---

💖 DESCRIPTION 💖

so like, mod_timer_pending is the exact same energy as mod_timer for pending timers — but it will not activate timers that are currently inactive. it's giving "respect the vibe of a sleeping timer" 😴✨

and here's the little detail that matters: if timer->function == NULL, then the start operation is silently discarded. no error, no drama, just... gone 🙈

---

🔥 RETURN 🔥

• 0 — the timer was inactive and not modified, or it was in a shutdown state and the whole operation was discarded 💀
• 1 — the timer was active and got requeued to expire at expires — slay, it worked 👑

---

🌈 SEE ALSO 🌈

go peek at the kernel file ./kernel/time/timer.c and the struct timer_base(9), plus this whole iconic friend group of timer functions:

• __round_jiffies_relative(9)
• round_jiffies(9)
• round_jiffies_relative(9)
• __round_jiffies_up_relative(9)
• round_jiffies_up(9)
• round_jiffies_up_relative(9)
• timer_init_key(9)
• mod_timer(9)
• timer_reduce(9)
• add_timer(9)
• add_timer_local(9)
• add_timer_global(9)
• add_timer_on(9)
• __timer_delete(9)
• timer_delete(9)
• timer_shutdown(9)
• __try_to_del_timer_sync(9)
• timer_delete_sync_try(9)
• __timer_delete_sync(9)
• timer_delete_sync(9)
• timer_shutdown_sync(9)
• fetch_next_timer_interrupt_remote(9)
• timer_unlock_remote_bases(9)
• timer_lock_remote_bases(9)
• timer_base_is_idle(9)
• timer_expire_remote(9)
• get_next_timer_interrupt(9)
• timer_base_try_to_set_idle(9)
• timer_clear_idle(9)
• __run_timers(9)

---

💡 reminder bestie: this only works its magic on pending timers. if your timer's inactive, this function is gonna hit it with the silent treatment fr fr.

---

and that's the whole page, periodt 💅✨ sourced straight from ./kernel/time, dated October 2026 — mwah, go forth and time your timers correctly 🧚💜