80 lines · plain
1.TH "CPUPOWER-IDLE-SET" "1" "0.1" "" "cpupower Manual"2.SH "NAME"3.LP4cpupower\-idle\-set \- Utility to set cpu idle state specific kernel options5.SH "SYNTAX"6.LP7cpupower [ \-c cpulist ] idle\-set [\fIoptions\fP]8.SH "DESCRIPTION"9.LP10The cpupower idle\-set subcommand allows to set cpu idle, also called cpu11sleep state, specific options offered by the kernel. One example is disabling12sleep states. This can be handy for power vs performance tuning.13.SH "OPTIONS"14.LP15.TP16\fB\-d\fR \fB\-\-disable\fR <STATE_NO>17Disable a specific processor sleep state.18.TP19\fB\-e\fR \fB\-\-enable\fR <STATE_NO>20Enable a specific processor sleep state.21.TP22\fB\-D\fR \fB\-\-disable-by-latency\fR <LATENCY>23Disable all idle states with a equal or higher latency than <LATENCY>.24 25Enable all idle states with a latency lower than <LATENCY>.26.TP27\fB\-E\fR \fB\-\-enable-all\fR28Enable all idle states if not enabled already.29 30.SH "REMARKS"31.LP32Cpuidle Governors Policy on Disabling Sleep States33 34.RS 435Depending on the used cpuidle governor, implementing the kernel policy36how to choose sleep states, subsequent sleep states on this core, might get37disabled as well.38 39There are two cpuidle governors ladder and menu. While the ladder40governor is always available, if CONFIG_CPU_IDLE is selected, the41menu governor additionally requires CONFIG_NO_HZ.42 43The behavior and the effect of the disable variable depends on the44implementation of a particular governor. In the ladder governor, for45example, it is not coherent, i.e. if one is disabling a light state,46then all deeper states are disabled as well. Likewise, if one enables a47deep state but a lighter state still is disabled, then this has no effect.48.RE49.LP50Disabling the Lightest Sleep State may not have any Affect51 52.RS 453If criteria are not met to enter deeper sleep states and the lightest sleep54state is chosen when idle, the kernel may still enter this sleep state,55irrespective of whether it is disabled or not. This is also reflected in56the usage count of the disabled sleep state when using the cpupower idle-info57command.58.RE59.LP60Selecting specific CPU Cores61 62.RS 463By default processor sleep states of all CPU cores are set. Please refer64to the cpupower(1) manpage in the \-\-cpu option section how to disable65C-states of specific cores.66.RE67.SH "FILES"68.nf69\fI/sys/devices/system/cpu/cpu*/cpuidle/state*\fP70\fI/sys/devices/system/cpu/cpuidle/*\fP71.fi72.SH "AUTHORS"73.nf74Thomas Renninger <trenn@suse.de>75.fi76.SH "SEE ALSO"77.LP78cpupower(1), cpupower\-monitor(1), cpupower\-info(1), cpupower\-set(1),79cpupower\-idle\-info(1)80