cpuidle_use_deepest_state(9)
π€ cpuidle_use_deepest_state β the governor override glow-up
okay so bestie, welcome to section 9 of the Kernel API Manual π β this is cpuidle_use_deepest_state, and it's literally the "let my CPU nap HARD" switch. no cap.
β¨ SYNOPSIS β¨
void cpuidle_use_deepest_state (u64 latency_limit_ns );
that's it. one function, one argument, zero drama. π
πΈ ARGUMENTS πΈ
latency_limit_nsβ the idle state exit latency limit, in nanoseconds β±οΈ. and if you pass0? that means no override, bestie β the governors get to keep doing their thing. π«Ά
π DESCRIPTION π
here's the tea β:
if latency_limit_ns is nonzero, this sets the current CPU to use the deepest idle state whose exit latency is within latency_limit_ns β and yeah, that overrides the governors going forward π₯ (main character energy, honestly).
if latency_limit_ns is zero, it does not override the governors. nope. governors stay in charge. π
fr fr, it's just a set/unset of governor override mode β nothing sneaky happening in the background π
π¦ SEE ALSO π¦
the kernel file lives at ./drivers/cpuidle/cpuidle.c β go snoop if you're nosy (respectfully) π
and these absolute icons in the cpuidle family iykyk:
cpuidle_play_dead(9)cpuidle_find_deepest_state(9)cpuidle_enter_s2idle(9)cpuidle_enter_state(9)cpuidle_select(9)cpuidle_enter(9)cpuidle_reflect(9)cpuidle_poll_time(9)cpuidle_install_idle_handler(9)cpuidle_uninstall_idle_handler(9)cpuidle_pause_and_lock(9)cpuidle_resume_and_unlock(9)cpuidle_enable_device(9)cpuidle_disable_device(9)__cpuidle_register_device(9)cpuidle_register_device(9)cpuidle_unregister_device(9)cpuidle_unregister(9)cpuidle_register(9)cpuidle_init(9)
the whole squad, assembled. periodt. π
that's the whole page, bestie β go let your CPU have the deepest, most luxurious nap it's allowed to take π§π
β sig β¨ source: ./drivers/cpuidle, dated October 2026, kernel api manual vibes only, no notes π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms