cpuidle_coupled_poke(9)

💖 NAME 💖

cpuidle_coupled_poke — wake up a cpu that may be waiting, bestie 💅

(this one lives in the Kernel API Manual, ok? that's the whole vibe ✨)

---

🦋 SYNOPSIS 🦋

void cpuidle_coupled_poke (int cpu );

---

🎀 ARGUMENTS 🎀

• cpu — the target cpu, like the one you're trying to wake up 🫶

---

✨ DESCRIPTION ✨

Okay so here's the tea: this function ensures that the target cpu exits its waiting idle state (if it happens to be in it rn), and that it will see updates to waiting_count before it re-enters its waiting idle state. No cap, that's literally the whole job 💖

And if cpuidle_coupled_poked_mask is already set for the target cpu? Then that cpu either has or will soon have a pending IPI that'll wake it out of idle, or it's currently processing that IPI and is not in idle at all. So like… it's already handled, no need to spiral 😌

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/cpuidle/coupled.c, plus the whole friend group:

• 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_others(9)
• cpuidle_coupled_set_waiting(9)
• cpuidle_coupled_set_not_waiting(9)
• cpuidle_coupled_set_done(9)
• cpuidle_coupled_clear_pokes(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)

---

okay that's the page!! sourced straight from ./drivers/cpuidle, dated October 2026, and no I did not make that date up, it's right there in the footer 🎀 go poke some cpus bestie, ily, mwah 💋✨