Text of docs.kernel.org › admin-guide › pm › intel-speed-select.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Intel(R) Speed Select Technology User Guide — The Linux Kernel documentation

The Linux Kernel 7.4.0-rc3 Quick search Contents Working with the development community Development process Submitting patches Code of conduct Maintainer handbook All development-process docs Internal API manuals Core API Driver APIs Subsystems Locking Development tools and processes Licensing rules Writing documentation Development tools Testing guide Hacking guide Tracing Fault injection Livepatching Rust User-oriented documentation Administration General guides to kernel administration Booting the kernel Tracking down and identifying problems Core-kernel subsystems Control Group v2 Control Groups version 1 CPU Isolation CPU load Memory Management Kernel module signing facility Namespaces Numa policy hit/miss statistics Power Management Syscall User Dispatch Kernel Support for miscellaneous Binary Formats (binfmt_misc) Java(tm) Binary Kernel Support for Linux v1.03 Mono(tm) Binary Kernel Support for Linux Block-layer and filesystem administration Device-specific guides Workload analysis Everything else Build system Reporting issues Userspace tools Userspace API Firmware-related documentation Firmware Firmware and Devicetree Architecture-specific documentation CPU architectures Other documentation Unsorted documentation Translations Translations This Page Show Source Intel(R) Speed Select Technology User Guide ¶ The Intel(R) Speed Select Technology (Intel(R) SST) provides a powerful new collection of features that give more granular control over CPU performance.

With Intel(R) SST, one server can be configured for power and performance for a variety of diverse workload requirements. Refer to the links below for an overview of the technology: https://www.intel.com/content/www/us/en/architecture-and-technology/speed-select-technology-article.html https://builders.intel.com/docs/networkbuilders/intel-speed-select-technology-base-frequency-enhancing-performance.pdf These capabilities are further enhanced in some of the newer generations of server platforms where these features can be enumerated and controlled dynamically without pre-configuring via BIOS setup options.

This dynamic configuration is done via mailbox commands to the hardware. One way to enumerate and configure these features is by using the Intel Speed Select utility. This document explains how to use the Intel Speed Select tool to enumerate and control Intel(R) SST features. This document gives example commands and explains how these commands change the power and performance profile of the system under test. Using this tool as an example, customers can replicate the messaging implemented in the tool in their production software. intel-speed-select configuration tool ¶ Most Linux distribution packages may include the “intel-speed-select” tool.

If not, it can be built by downloading the Linux kernel tree from kernel.org. Once downloaded, the tool can be built without building the full kernel. From the kernel tree, run the following commands: # cd tools/power/x86/intel-speed-select/ # make # make install Getting Help ¶ To get help with the tool, execute the command below: # intel-speed-select --help The top-level help describes arguments and features. Notice that there is a multi-level help structure in the tool.

For example, to get help for the feature “perf-profile”: # intel-speed-select perf-profile --help To get help on a command, another level of help is provided. For example for the command info “info”: # intel-speed-select perf-profile info --help Summary of platform capability ¶ To check the current platform and driver capabilities, execute: #intel-speed-select --info For example on a test system: # intel-speed-select --info Intel(R) Speed Select Technology Executing on CPU model: X Platform: API version : 1 Platform: Driver version : 1 Platform: mbox supported : 1 Platform: mmio supported : 1 Intel(R) SST-PP (feature perf-profile) is supported TDP level change control is unlocked, max level: 4 Intel(R) SST-TF (feature turbo-freq) is supported Intel(R) SST-BF (feature base-freq) is not supported Intel(R) SST-CP (feature core-power) is supported Intel(R) Speed Select Technology - Performance Profile (Intel(R) SST-PP) ¶ This feature allows configuration of a server dynamically based on workload performance requirements.

This helps users during deployment as they do not have to choose a specific server configuration statically. This Intel(R) Speed Select Technology - Performance Profile (Intel(R) SST-PP) feature introduces a mechanism that allows multiple optimized performance profiles per system. Each profile defines a set of CPUs that need to be online and rest offline to sustain a guaranteed base frequency. Once the user issues a command to use a specific performance profile and meet CPU online/offline requirement, the user can expect a change in the base frequency dynamically.

This feature is called “perf-profile” when using the Intel Speed Select tool. Number or performance levels ¶ There can be multiple performance profiles on a system. To get the number of profiles, execute the command below: # intel-speed-select perf-profile get-config-levels Intel(R) Speed Select Technology Executing on CPU model: X package-0 die-0 cpu-0 get-config-levels:4 package-1 die-0 cpu-14 get-config-levels:4 On this system under test, there are 4 performance profiles in addition to the base performance profile (which is performance level 0).

Lock/Unlock status ¶ Even if there are multiple performance profiles, it is possible that they are locked. If they are locked, users cannot issue a command to change the performance state. It is possible that there is a BIOS setup to unlock or check with your system vendor. To check if the system is locked, execute the following command: # intel-speed-select perf-profile get-lock-status Intel(R) Speed Select Technology Executing on CPU model: X package-0 die-0 cpu-0 get-lock-status:0 package-1 die-0 cpu-14 get-lock-status:0 In this case, lock status is 0, which means that the system is unlocked.

Properties of a performance level ¶ To get properties of a specific performance level (For example for the level 0, below), execute the command below: # intel-speed-select perf-profile info -l 0 Intel(R) Speed Select Technology Executing on CPU model: X package-0 die-0 cpu-0 perf-profile-level-0 cpu-count:28 enable-cpu-mask:000003ff,f0003fff enable-cpu-list:0,1,2,3,4,5,6,7,8,9,10,11,12,13,28,29,30,31,32,33,34,35,36,37,38,39,40,41 thermal-design-power-ratio:26 base-frequency(MHz):2600 speed-select-turbo-freq:disabled speed-select-base-freq:disabled ... ...

Here -l option is used to specify a performance level. If the option -l is omitted, then this command will print information about all the performance levels. The above command is printing properties of the performance level 0. For this performance profile, the list of CPUs displayed by the “enable-cpu-mask/enable-cpu-list” at the max can be “online.” When that condition is met, then base frequency of 2600 MHz can be maintained.

To understand more, execute “intel-speed-select perf-profile info” for performance level 4: # intel-speed-select perf-profile info -l 4 Intel(R) Speed Select Technology Executing on CPU model: X package-0 die-0 cpu-0 perf-profile-level-4 cpu-count:28 enable-cpu-mask:000000fa,f0000faf enable-cpu-list:0,1,2,3,5,7,8,9,10,11,28,29,30,31,33,35,36,37,38,39 thermal-design-power-ratio:28 base-frequency(MHz):2800 speed-select-turbo-freq:disabled speed-select-base-freq:unsupported ... ...

There are fewer CPUs in the “enable-cpu-mask/enable-cpu-list”. Consequently, if the user only keeps these CPUs online and the rest “offline,” then the base frequency is increased to 2.8 GHz compared to 2.6 GHz at performance level 0. Get current performance level ¶ To get the current performance level, execute: # intel-speed-select perf-profile get-config-current-level Intel(R) Speed Select Technology Executing on CPU model: X package-0 die-0 cpu-0 get-config-current_level:0 Firs

The rest of this page is on the live site.