cpuidle_select(9)

📦 version 7.3.1, in nixpkgs unstable

🦋 cpuidle_select — the kernel API manual, bestie edition 🦋

okay so real talk, this one's from the kernel API manual and it's literally the moment your CPU is like "hmm which nap should I take" and this function is the one that picks 💅

✨ NAME ✨

cpuidle_select — bestie, it literally asks the cpuidle framework to choose an idle state 🛌✨

🌸 SYNOPSIS 🌸

int cpuidle_select (struct cpuidle_driver *drv , struct cpuidle_device
*dev , bool *stop_tick );

no cap, that's the whole signature, exactly as written, don't come for me about the spacing 😭

🎀 ARGUMENTS 🎀

  • drv — the cpuidle driver. your driver. the one calling the shots 🚗
  • dev — the cpuidle device. the device in question, iconic, we love them 🫶
  • stop_tick — the indication on whether or not to stop the tick ⏰ it's giving "yes or no, the tick edition"

💖 DESCRIPTION 💖

so like, this returns the index of the idle state 👑 — the index, periodt. and the return value must not be negative 🙅‍♀️ no negative values allowed, that's the rule, that's the vibe check, that's non-negotiable.

the memory location pointed to by stop_tick is expected to be written the entering the returned state 🫧 — yes that's the sentence, verbatim, she's a little mysterious but she's doing her best 💀

🌈 SEE ALSO 🌈

literally the whole cpuidle friend group, they all show up together, iykyk:

Kernel file ./drivers/cpuidle/cpuidle.c

ok and a lil sign-off fr fr: this whole page lives over in ./drivers/cpuidle, dated October 2026, and it's cpuidle_select(9) bestie — stan her, cite her, don't return negative from her 💜✨
📦 where this page comes from