dwww Home | Manual pages | Find package

CPUPOWER-IDLE-SET(1)            cpupower Manual            CPUPOWER-IDLE-SET(1)

NAME
       cpupower-idle-set  -  Utility  to set cpu idle state specific kernel op-
       tions

SYNTAX
       cpupower [ -c cpulist ] idle-set [options]

DESCRIPTION
       The cpupower idle-set subcommand allows to set cpu idle, also called cpu
       sleep state, specific options offered by the kernel. One example is dis-
       abling sleep states. This can be handy for power vs performance tuning.

OPTIONS
       -d --disable <STATE_NO>
              Disable a specific processor sleep state.

       -e --enable <STATE_NO>
              Enable a specific processor sleep state.

       -D --disable-by-latency <LATENCY>
              Disable all idle states with a equal or higher latency than  <LA-
              TENCY>.

              Enable all idle states with a latency lower than <LATENCY>.

       -E --enable-all
              Enable all idle states if not enabled already.

REMARKS
       Cpuidle Governors Policy on Disabling Sleep States

           Depending  on  the  used   cpuidle governor, implementing the kernel
           policy how to choose sleep states, subsequent sleep states  on  this
           core, might get disabled as well.

           There  are  two  cpuidle governors ladder and menu. While the ladder
           governor is always available, if CONFIG_CPU_IDLE  is  selected,  the
           menu governor additionally requires CONFIG_NO_HZ.

           The  behavior  and the effect of the disable variable depends on the
           implementation of a particular governor. In the ladder governor, for
           example, it is not coherent, i.e. if one is disabling a light state,
           then all deeper states are disabled as well. Likewise,  if  one  en-
           ables  a deep state but a lighter state still is disabled, then this
           has no effect.

       Disabling the Lightest Sleep State may not have any Affect

           If criteria are not met to enter deeper sleep states and the  light-
           est sleep state is chosen when idle, the kernel may still enter this
           sleep  state, irrespective of whether it is disabled or not. This is
           also reflected in the usage count of the disabled sleep  state  when
           using the cpupower idle-info command.

       Selecting specific CPU Cores

           By  default  processor sleep states of all CPU cores are set. Please
           refer to the cpupower(1) manpage in the --cpu option section how  to
           disable C-states of specific cores.

FILES
       /sys/devices/system/cpu/cpu*/cpuidle/state*
       /sys/devices/system/cpu/cpuidle/*

AUTHORS
       Thomas Renninger <trenn@suse.de>

SEE ALSO
       cpupower(1),   cpupower-monitor(1),  cpupower-info(1),  cpupower-set(1),
       cpupower-idle-info(1)

                                      0.1                  CPUPOWER-IDLE-SET(1)

Generated by dwww version 1.16 on Thu Nov 19 15:40:41 CET 2026.