cpuidle_coupled_clear_pokes(9)

💖 cpuidle_coupled_clear_pokes(9) 💖

okay so bestie, we're in the Kernel API Manual today and this one is a tiny little function with a big job. buckle up 🎀

---

✨ NAME ✨

cpuidle_coupled_clear_pokes — spin until the poke interrupt is processed

---

🌸 SYNOPSIS 🌸

int cpuidle_coupled_clear_pokes (int cpu );

---

🦋 ARGUMENTS 🦋

• cpu — this cpu. like, this one. the one you're on. hiii 👋

---

💅 DESCRIPTION 💅

so what it does is: it turns interrupts on, then spins until any outstanding poke interrupts have been processed and the poke bit has been cleared. that's the whole vibe. spin spin spin until the poke bit says bye 💀

but here's the thing — other interrupts may also get processed while interrupts are enabled, so need_resched must be tested after this function returns, to make sure the interrupt didn't schedule work that should take the cpu out of idle. like, don't just wander off after this call, check need_resched first, i'm literally begging 🫶

ngl this is the important bit: returns 0 if no poke was pending, 1 if a poke was cleared. two outcomes, no in-between, periodt.

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/cpuidle/coupled.c
• Coupled cpuidle states(9)
• struct cpuidle_coupled(9)
• cpuidle_coupled_parallel_barrier(9)
• cpuidle_state_is_coupled(9)
• cpuidle_coupled_state_verify(9)
• cpuidle_coupled_set_ready(9)
• cpuidle_coupled_set_not_ready(9)
• cpuidle_coupled_no_cpus_ready(9)
• cpuidle_coupled_cpus_ready(9)
• cpuidle_coupled_cpus_waiting(9)
• cpuidle_coupled_no_cpus_waiting(9)
• cpuidle_coupled_get_state(9)
• cpuidle_coupled_poke(9)
• cpuidle_coupled_poke_others(9)
• cpuidle_coupled_set_waiting(9)
• cpuidle_coupled_set_not_waiting(9)
• cpuidle_coupled_set_done(9)
• cpuidle_enter_state_coupled(9)
• cpuidle_coupled_register_device(9)
• cpuidle_coupled_unregister_device(9)
• cpuidle_coupled_prevent_idle(9)
• cpuidle_coupled_allow_idle(9)

---

that's the whole page bestie, go read the coupled ones next, they're iconic 👑

sign-off szn: this lil cutie lives in ./drivers/cpuidle, dated October 2026, and it's cpuidle_coupled_clear_pokes(9) all the way down. mwah 💋