1CPUPOWER-SET(1) cpupower Manual CPUPOWER-SET(1)
2
6 cpupower-set - Set processor power related kernel or hardware configu‐
7 rations
8
10 cpupower set [ -b VAL ] [ -s VAL ] [ -m VAL ]
11
15 cpupower set sets kernel configurations or directly accesses hardware
16 registers affecting processor power saving policies.
17 Some options are platform wide, some affect single cores. By default
19 values are applied on all cores. How to modify single core configura‐
20 tions is described in the cpupower(1) manpage in the --cpu option sec‐
21 tion. Whether an option affects the whole system or can be applied to
22 individual cores is described in the Options sections.
23 Use cpupower info to read out current settings and whether they are
25 supported on the system at all.
26
29 --perf-bias, -b
30 Sets a register on supported Intel processore which allows software
31 to convey its policy for the relative importance of performance
32 versus energy savings to the processor.
33 The range of valid numbers is 0-15, where 0 is maximum performance
35 and 15 is maximum energy efficiency.
36 The processor uses this information in model-specific ways when it
38 must select trade-offs between performance and energy efficiency.
39 This policy hint does not supersede Processor Performance states
41 (P-states) or CPU Idle power states (C-states), but allows software
42 to have influence where it would otherwise be unable to express a
43 preference.
44 For example, this setting may tell the hardware how aggressively or
46 conservatively to control frequency in the "turbo range" above the
47 explicitly OS-controlled P-state frequency range. It may also tell
48 the hardware how aggressively it should enter the OS requested C-
49 states.
50 This option can be applied to individual cores only via the --cpu
52 option, cpupower(1).
53 Setting the performance bias value on one CPU can modify the set‐
55 ting on related CPUs as well (for example all CPUs on one socket),
56 because of hardware restrictions. Use cpupower -c all info -b to
57 verify.
58 This options needs the msr kernel driver (CONFIG_X86_MSR) loaded.
60 --sched-mc, -m [ VAL ]
62 --sched-smt, -s [ VAL ]
63 --sched-mc utilizes cores in one processor package/socket first
64 before processes are scheduled to other processor packages/sockets.
65 --sched-smt utilizes thread siblings of one processor core first
67 before processes are scheduled to other cores.
68 The impact on power consumption and performance (positiv or nega‐
70 tiv) heavily depends on processor support for deep sleep states,
71 frequency scaling and frequency boost modes and their dependencies
72 between other thread siblings and processor cores.
73 Taken over from kernel documentation:
75 Adjust the kernel's multi-core scheduler support.
77 Possible values are:
79 0 - No power saving load balance (default value)
80 1 - Fill one thread/core/package first for long running threads
82 2 - Also bias task wakeups to semi-idle cpu package for power
84 savings
85 sched_mc_power_savings is dependent upon SCHED_MC, which is itself
87 architecture dependent.
88 sched_smt_power_savings is dependent upon SCHED_SMT, which is
90 itself architecture dependent.
91 The two files are independent of each other. It is possible that
93 one file may be present without the other.
94
97 cpupower-info(1), cpupower-monitor(1), powertop(1)
98
100 --perf-bias parts written by Len Brown <len.brown@intel.com>
101 Thomas Renninger <trenn@suse.de>
102 22/02/2011 CPUPOWER-SET(1)