Loading...
1What: /sys/devices/system/cpu/
2Date: pre-git history
3Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
4Description:
5 A collection of both global and individual CPU attributes
6
7 Individual CPU attributes are contained in subdirectories
8 named by the kernel's logical CPU number, e.g.:
9
10 /sys/devices/system/cpu/cpuX/
11
12What: /sys/devices/system/cpu/kernel_max
13 /sys/devices/system/cpu/offline
14 /sys/devices/system/cpu/online
15 /sys/devices/system/cpu/possible
16 /sys/devices/system/cpu/present
17Date: December 2008
18Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
19Description: CPU topology files that describe kernel limits related to
20 hotplug. Briefly:
21
22 kernel_max: the maximum cpu index allowed by the kernel
23 configuration.
24
25 offline: cpus that are not online because they have been
26 HOTPLUGGED off or exceed the limit of cpus allowed by the
27 kernel configuration (kernel_max above).
28
29 online: cpus that are online and being scheduled.
30
31 possible: cpus that have been allocated resources and can be
32 brought online if they are present.
33
34 present: cpus that have been identified as being present in
35 the system.
36
37 See Documentation/admin-guide/cputopology.rst for more information.
38
39
40What: /sys/devices/system/cpu/probe
41 /sys/devices/system/cpu/release
42Date: November 2009
43Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
44Description: Dynamic addition and removal of CPU's. This is not hotplug
45 removal, this is meant complete removal/addition of the CPU
46 from the system.
47
48 probe: writes to this file will dynamically add a CPU to the
49 system. Information written to the file to add CPU's is
50 architecture specific.
51
52 release: writes to this file dynamically remove a CPU from
53 the system. Information written to the file to remove CPU's
54 is architecture specific.
55
56What: /sys/devices/system/cpu/cpuX/node
57Date: October 2009
58Contact: Linux memory management mailing list <linux-mm@kvack.org>
59Description: Discover NUMA node a CPU belongs to
60
61 When CONFIG_NUMA is enabled, a symbolic link that points
62 to the corresponding NUMA node directory.
63
64 For example, the following symlink is created for cpu42
65 in NUMA node 2:
66
67 /sys/devices/system/cpu/cpu42/node2 -> ../../node/node2
68
69
70What: /sys/devices/system/cpu/cpuX/topology/core_siblings
71 /sys/devices/system/cpu/cpuX/topology/core_siblings_list
72 /sys/devices/system/cpu/cpuX/topology/physical_package_id
73 /sys/devices/system/cpu/cpuX/topology/thread_siblings
74 /sys/devices/system/cpu/cpuX/topology/thread_siblings_list
75 /sys/devices/system/cpu/cpuX/topology/ppin
76Date: December 2008
77Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
78Description: CPU topology files that describe a logical CPU's relationship
79 to other cores and threads in the same physical package.
80
81 One cpuX directory is created per logical CPU in the system,
82 e.g. /sys/devices/system/cpu/cpu42/.
83
84 Briefly, the files above are:
85
86 core_siblings: internal kernel map of cpuX's hardware threads
87 within the same physical_package_id.
88
89 core_siblings_list: human-readable list of the logical CPU
90 numbers within the same physical_package_id as cpuX.
91
92 physical_package_id: physical package id of cpuX. Typically
93 corresponds to a physical socket number, but the actual value
94 is architecture and platform dependent.
95
96 thread_siblings: internal kernel map of cpuX's hardware
97 threads within the same core as cpuX
98
99 thread_siblings_list: human-readable list of cpuX's hardware
100 threads within the same core as cpuX
101
102 ppin: human-readable Protected Processor Identification
103 Number of the socket the cpu# belongs to. There should be
104 one per physical_package_id. File is readable only to
105 admin.
106
107 See Documentation/admin-guide/cputopology.rst for more information.
108
109
110What: /sys/devices/system/cpu/cpuidle/available_governors
111 /sys/devices/system/cpu/cpuidle/current_driver
112 /sys/devices/system/cpu/cpuidle/current_governor
113 /sys/devices/system/cpu/cpuidle/current_governer_ro
114Date: September 2007
115Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
116Description: Discover cpuidle policy and mechanism
117
118 Various CPUs today support multiple idle levels that are
119 differentiated by varying exit latencies and power
120 consumption during idle.
121
122 Idle policy (governor) is differentiated from idle mechanism
123 (driver).
124
125 available_governors: (RO) displays a space separated list of
126 available governors.
127
128 current_driver: (RO) displays current idle mechanism.
129
130 current_governor: (RW) displays current idle policy. Users can
131 switch the governor at runtime by writing to this file.
132
133 current_governor_ro: (RO) displays current idle policy.
134
135 See Documentation/admin-guide/pm/cpuidle.rst and
136 Documentation/driver-api/pm/cpuidle.rst for more information.
137
138
139What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/name
140 /sys/devices/system/cpu/cpuX/cpuidle/stateN/latency
141 /sys/devices/system/cpu/cpuX/cpuidle/stateN/power
142 /sys/devices/system/cpu/cpuX/cpuidle/stateN/time
143 /sys/devices/system/cpu/cpuX/cpuidle/stateN/usage
144 /sys/devices/system/cpu/cpuX/cpuidle/stateN/above
145 /sys/devices/system/cpu/cpuX/cpuidle/stateN/below
146Date: September 2007
147KernelVersion: v2.6.24
148Contact: Linux power management list <linux-pm@vger.kernel.org>
149Description:
150 The directory /sys/devices/system/cpu/cpuX/cpuidle contains per
151 logical CPU specific cpuidle information for each online cpu X.
152 The processor idle states which are available for use have the
153 following attributes:
154
155 ======== ==== =================================================
156 name: (RO) Name of the idle state (string).
157
158 latency: (RO) The latency to exit out of this idle state (in
159 microseconds).
160
161 power: (RO) The power consumed while in this idle state (in
162 milliwatts).
163
164 time: (RO) The total time spent in this idle state
165 (in microseconds).
166
167 usage: (RO) Number of times this state was entered (a count).
168
169 above: (RO) Number of times this state was entered, but the
170 observed CPU idle duration was too short for it
171 (a count).
172
173 below: (RO) Number of times this state was entered, but the
174 observed CPU idle duration was too long for it
175 (a count).
176 ======== ==== =================================================
177
178What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/desc
179Date: February 2008
180KernelVersion: v2.6.25
181Contact: Linux power management list <linux-pm@vger.kernel.org>
182Description:
183 (RO) A small description about the idle state (string).
184
185
186What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/disable
187Date: March 2012
188KernelVersion: v3.10
189Contact: Linux power management list <linux-pm@vger.kernel.org>
190Description:
191 (RW) Option to disable this idle state (bool). The behavior and
192 the effect of the disable variable depends on the implementation
193 of a particular governor. In the ladder governor, for example,
194 it is not coherent, i.e. if one is disabling a light state, then
195 all deeper states are disabled as well, but the disable variable
196 does not reflect it. Likewise, if one enables a deep state but a
197 lighter state still is disabled, then this has no effect.
198
199What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/default_status
200Date: December 2019
201KernelVersion: v5.6
202Contact: Linux power management list <linux-pm@vger.kernel.org>
203Description:
204 (RO) The default status of this state, "enabled" or "disabled".
205
206What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/residency
207Date: March 2014
208KernelVersion: v3.15
209Contact: Linux power management list <linux-pm@vger.kernel.org>
210Description:
211 (RO) Display the target residency i.e. the minimum amount of
212 time (in microseconds) this cpu should spend in this idle state
213 to make the transition worth the effort.
214
215What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/
216Date: March 2018
217KernelVersion: v4.17
218Contact: Linux power management list <linux-pm@vger.kernel.org>
219Description:
220 Idle state usage statistics related to suspend-to-idle.
221
222 This attribute group is only present for states that can be
223 used in suspend-to-idle with suspended timekeeping.
224
225What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/time
226Date: March 2018
227KernelVersion: v4.17
228Contact: Linux power management list <linux-pm@vger.kernel.org>
229Description:
230 Total time spent by the CPU in suspend-to-idle (with scheduler
231 tick suspended) after requesting this state.
232
233What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/usage
234Date: March 2018
235KernelVersion: v4.17
236Contact: Linux power management list <linux-pm@vger.kernel.org>
237Description:
238 Total number of times this state has been requested by the CPU
239 while entering suspend-to-idle.
240
241What: /sys/devices/system/cpu/cpuX/cpufreq/*
242Date: pre-git history
243Contact: linux-pm@vger.kernel.org
244Description: Discover and change clock speed of CPUs
245
246 Clock scaling allows you to change the clock speed of the
247 CPUs on the fly. This is a nice method to save battery
248 power, because the lower the clock speed, the less power
249 the CPU consumes.
250
251 There are many knobs to tweak in this directory.
252
253 See files in Documentation/cpu-freq/ for more information.
254
255
256What: /sys/devices/system/cpu/cpuX/cpufreq/freqdomain_cpus
257Date: June 2013
258Contact: linux-pm@vger.kernel.org
259Description: Discover CPUs in the same CPU frequency coordination domain
260
261 freqdomain_cpus is the list of CPUs (online+offline) that share
262 the same clock/freq domain (possibly at the hardware level).
263 That information may be hidden from the cpufreq core and the
264 value of related_cpus may be different from freqdomain_cpus. This
265 attribute is useful for user space DVFS controllers to get better
266 power/performance results for platforms using acpi-cpufreq.
267
268 This file is only present if the acpi-cpufreq or the cppc-cpufreq
269 drivers are in use.
270
271
272What: /sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}
273Date: August 2008
274KernelVersion: 2.6.27
275Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
276Description: Disable L3 cache indices
277
278 These files exist in every CPU's cache/index3 directory. Each
279 cache_disable_{0,1} file corresponds to one disable slot which
280 can be used to disable a cache index. Reading from these files
281 on a processor with this functionality will return the currently
282 disabled index for that node. There is one L3 structure per
283 node, or per internal node on MCM machines. Writing a valid
284 index to one of these files will cause the specified cache
285 index to be disabled.
286
287 All AMD processors with L3 caches provide this functionality.
288 For details, see BKDGs at
289 https://www.amd.com/en/support/tech-docs?keyword=bios+kernel
290
291
292What: /sys/devices/system/cpu/cpufreq/boost
293Date: August 2012
294Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
295Description: Processor frequency boosting control
296
297 This switch controls the boost setting for the whole system.
298 Boosting allows the CPU and the firmware to run at a frequency
299 beyond its nominal limit.
300
301 More details can be found in
302 Documentation/admin-guide/pm/cpufreq.rst
303
304
305What: /sys/devices/system/cpu/cpuX/crash_notes
306 /sys/devices/system/cpu/cpuX/crash_notes_size
307Date: April 2013
308Contact: kexec@lists.infradead.org
309Description: address and size of the percpu note.
310
311 crash_notes: the physical address of the memory that holds the
312 note of cpuX.
313
314 crash_notes_size: size of the note of cpuX.
315
316
317What: /sys/devices/system/cpu/intel_pstate/max_perf_pct
318 /sys/devices/system/cpu/intel_pstate/min_perf_pct
319 /sys/devices/system/cpu/intel_pstate/no_turbo
320Date: February 2013
321Contact: linux-pm@vger.kernel.org
322Description: Parameters for the Intel P-state driver
323
324 Logic for selecting the current P-state in Intel
325 Sandybridge+ processors. The three knobs control
326 limits for the P-state that will be requested by the
327 driver.
328
329 max_perf_pct: limits the maximum P state that will be requested by
330 the driver stated as a percentage of the available performance.
331
332 min_perf_pct: limits the minimum P state that will be requested by
333 the driver stated as a percentage of the available performance.
334
335 no_turbo: limits the driver to selecting P states below the turbo
336 frequency range.
337
338 More details can be found in
339 Documentation/admin-guide/pm/intel_pstate.rst
340
341What: /sys/devices/system/cpu/cpu*/cache/index*/<set_of_attributes_mentioned_below>
342Date: July 2014(documented, existed before August 2008)
343Contact: Sudeep Holla <sudeep.holla@arm.com>
344 Linux kernel mailing list <linux-kernel@vger.kernel.org>
345Description: Parameters for the CPU cache attributes
346
347 allocation_policy:
348 - WriteAllocate:
349 allocate a memory location to a cache line
350 on a cache miss because of a write
351 - ReadAllocate:
352 allocate a memory location to a cache line
353 on a cache miss because of a read
354 - ReadWriteAllocate:
355 both writeallocate and readallocate
356
357 coherency_line_size:
358 the minimum amount of data in bytes that gets
359 transferred from memory to cache
360
361 level:
362 the cache hierarchy in the multi-level cache configuration
363
364 number_of_sets:
365 total number of sets in the cache, a set is a
366 collection of cache lines with the same cache index
367
368 physical_line_partition:
369 number of physical cache line per cache tag
370
371 shared_cpu_list:
372 the list of logical cpus sharing the cache
373
374 shared_cpu_map:
375 logical cpu mask containing the list of cpus sharing
376 the cache
377
378 size:
379 the total cache size in kB
380
381 type:
382 - Instruction: cache that only holds instructions
383 - Data: cache that only caches data
384 - Unified: cache that holds both data and instructions
385
386 ways_of_associativity:
387 degree of freedom in placing a particular block
388 of memory in the cache
389
390 write_policy:
391 - WriteThrough:
392 data is written to both the cache line
393 and to the block in the lower-level memory
394 - WriteBack:
395 data is written only to the cache line and
396 the modified cache line is written to main
397 memory only when it is replaced
398
399
400What: /sys/devices/system/cpu/cpu*/cache/index*/id
401Date: September 2016
402Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
403Description: Cache id
404
405 The id provides a unique number for a specific instance of
406 a cache of a particular type. E.g. there may be a level
407 3 unified cache on each socket in a server and we may
408 assign them ids 0, 1, 2, ...
409
410 Note that id value can be non-contiguous. E.g. level 1
411 caches typically exist per core, but there may not be a
412 power of two cores on a socket, so these caches may be
413 numbered 0, 1, 2, 3, 4, 5, 8, 9, 10, ...
414
415What: /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats
416 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat
417 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat
418 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle
419 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap
420 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp
421 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault
422 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent
423 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset
424Date: March 2016
425Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
426 Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
427Description: POWERNV CPUFreq driver's frequency throttle stats directory and
428 attributes
429
430 'cpuX/cpufreq/throttle_stats' directory contains the CPU frequency
431 throttle stat attributes for the chip. The throttle stats of a cpu
432 is common across all the cpus belonging to a chip. Below are the
433 throttle attributes exported in the 'throttle_stats' directory:
434
435 - turbo_stat : This file gives the total number of times the max
436 frequency is throttled to lower frequency in turbo (at and above
437 nominal frequency) range of frequencies.
438
439 - sub_turbo_stat : This file gives the total number of times the
440 max frequency is throttled to lower frequency in sub-turbo(below
441 nominal frequency) range of frequencies.
442
443 - unthrottle : This file gives the total number of times the max
444 frequency is unthrottled after being throttled.
445
446 - powercap : This file gives the total number of times the max
447 frequency is throttled due to 'Power Capping'.
448
449 - overtemp : This file gives the total number of times the max
450 frequency is throttled due to 'CPU Over Temperature'.
451
452 - supply_fault : This file gives the total number of times the
453 max frequency is throttled due to 'Power Supply Failure'.
454
455 - overcurrent : This file gives the total number of times the
456 max frequency is throttled due to 'Overcurrent'.
457
458 - occ_reset : This file gives the total number of times the max
459 frequency is throttled due to 'OCC Reset'.
460
461 The sysfs attributes representing different throttle reasons like
462 powercap, overtemp, supply_fault, overcurrent and occ_reset map to
463 the reasons provided by OCC firmware for throttling the frequency.
464
465What: /sys/devices/system/cpu/cpufreq/policyX/throttle_stats
466 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat
467 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat
468 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle
469 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap
470 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp
471 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault
472 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent
473 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset
474Date: March 2016
475Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
476 Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
477Description: POWERNV CPUFreq driver's frequency throttle stats directory and
478 attributes
479
480 'policyX/throttle_stats' directory and all the attributes are same as
481 the /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats directory and
482 attributes which give the frequency throttle information of the chip.
483
484What: /sys/devices/system/cpu/cpuX/regs/
485 /sys/devices/system/cpu/cpuX/regs/identification/
486 /sys/devices/system/cpu/cpuX/regs/identification/midr_el1
487 /sys/devices/system/cpu/cpuX/regs/identification/revidr_el1
488 /sys/devices/system/cpu/cpuX/regs/identification/smidr_el1
489Date: June 2016
490Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
491Description: AArch64 CPU registers
492
493 'identification' directory exposes the CPU ID registers for
494 identifying model and revision of the CPU and SMCU.
495
496What: /sys/devices/system/cpu/aarch32_el0
497Date: May 2021
498Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
499Description: Identifies the subset of CPUs in the system that can execute
500 AArch32 (32-bit ARM) applications. If present, the same format as
501 /sys/devices/system/cpu/{offline,online,possible,present} is used.
502 If absent, then all or none of the CPUs can execute AArch32
503 applications and execve() will behave accordingly.
504
505What: /sys/devices/system/cpu/cpuX/cpu_capacity
506Date: December 2016
507Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
508Description: information about CPUs heterogeneity.
509
510 cpu_capacity: capacity of cpuX.
511
512What: /sys/devices/system/cpu/vulnerabilities
513 /sys/devices/system/cpu/vulnerabilities/gather_data_sampling
514 /sys/devices/system/cpu/vulnerabilities/itlb_multihit
515 /sys/devices/system/cpu/vulnerabilities/l1tf
516 /sys/devices/system/cpu/vulnerabilities/mds
517 /sys/devices/system/cpu/vulnerabilities/meltdown
518 /sys/devices/system/cpu/vulnerabilities/mmio_stale_data
519 /sys/devices/system/cpu/vulnerabilities/reg_file_data_sampling
520 /sys/devices/system/cpu/vulnerabilities/retbleed
521 /sys/devices/system/cpu/vulnerabilities/spec_store_bypass
522 /sys/devices/system/cpu/vulnerabilities/spectre_v1
523 /sys/devices/system/cpu/vulnerabilities/spectre_v2
524 /sys/devices/system/cpu/vulnerabilities/srbds
525 /sys/devices/system/cpu/vulnerabilities/tsx_async_abort
526Date: January 2018
527Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
528Description: Information about CPU vulnerabilities
529
530 The files are named after the code names of CPU
531 vulnerabilities. The output of those files reflects the
532 state of the CPUs in the system. Possible output values:
533
534 ================ ==============================================
535 "Not affected" CPU is not affected by the vulnerability
536 "Vulnerable" CPU is affected and no mitigation in effect
537 "Mitigation: $M" CPU is affected and mitigation $M is in effect
538 ================ ==============================================
539
540 See also: Documentation/admin-guide/hw-vuln/index.rst
541
542What: /sys/devices/system/cpu/smt
543 /sys/devices/system/cpu/smt/active
544 /sys/devices/system/cpu/smt/control
545Date: June 2018
546Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
547Description: Control Symmetric Multi Threading (SMT)
548
549 active: Tells whether SMT is active (enabled and siblings online)
550
551 control: Read/write interface to control SMT. Possible
552 values:
553
554 ================ =========================================
555 "on" SMT is enabled
556 "off" SMT is disabled
557 "<N>" SMT is enabled with N threads per core.
558 "forceoff" SMT is force disabled. Cannot be changed.
559 "notsupported" SMT is not supported by the CPU
560 "notimplemented" SMT runtime toggling is not
561 implemented for the architecture
562 ================ =========================================
563
564 If control status is "forceoff" or "notsupported" writes
565 are rejected. Note that enabling SMT on PowerPC skips
566 offline cores.
567
568What: /sys/devices/system/cpu/cpuX/power/energy_perf_bias
569Date: March 2019
570Contact: linux-pm@vger.kernel.org
571Description: Intel Energy and Performance Bias Hint (EPB)
572
573 EPB for the given CPU in a sliding scale 0 - 15, where a value
574 of 0 corresponds to a hint preference for highest performance
575 and a value of 15 corresponds to the maximum energy savings.
576
577 In order to change the EPB value for the CPU, write either
578 a number in the 0 - 15 sliding scale above, or one of the
579 strings: "performance", "balance-performance", "normal",
580 "balance-power", "power" (that represent values reflected by
581 their meaning), to this attribute.
582
583 This attribute is present for all online CPUs supporting the
584 Intel EPB feature.
585
586What: /sys/devices/system/cpu/umwait_control
587 /sys/devices/system/cpu/umwait_control/enable_c02
588 /sys/devices/system/cpu/umwait_control/max_time
589Date: May 2019
590Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
591Description: Umwait control
592
593 enable_c02: Read/write interface to control umwait C0.2 state
594 Read returns C0.2 state status:
595 0: C0.2 is disabled
596 1: C0.2 is enabled
597
598 Write 'y' or '1' or 'on' to enable C0.2 state.
599 Write 'n' or '0' or 'off' to disable C0.2 state.
600
601 The interface is case insensitive.
602
603 max_time: Read/write interface to control umwait maximum time
604 in TSC-quanta that the CPU can reside in either C0.1
605 or C0.2 state. The time is an unsigned 32-bit number.
606 Note that a value of zero means there is no limit.
607 Low order two bits must be zero.
608
609What: /sys/devices/system/cpu/sev
610 /sys/devices/system/cpu/sev/vmpl
611Date: May 2024
612Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
613Description: Secure Encrypted Virtualization (SEV) information
614
615 This directory is only present when running as an SEV-SNP guest.
616
617 vmpl: Reports the Virtual Machine Privilege Level (VMPL) at which
618 the SEV-SNP guest is running.
619
620
621What: /sys/devices/system/cpu/svm
622Date: August 2019
623Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
624 Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
625Description: Secure Virtual Machine
626
627 If 1, it means the system is using the Protected Execution
628 Facility in POWER9 and newer processors. i.e., it is a Secure
629 Virtual Machine.
630
631What: /sys/devices/system/cpu/cpuX/purr
632Date: Apr 2005
633Contact: Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
634Description: PURR ticks for this CPU since the system boot.
635
636 The Processor Utilization Resources Register (PURR) is
637 a 64-bit counter which provides an estimate of the
638 resources used by the CPU thread. The contents of this
639 register increases monotonically. This sysfs interface
640 exposes the number of PURR ticks for cpuX.
641
642What: /sys/devices/system/cpu/cpuX/spurr
643Date: Dec 2006
644Contact: Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
645Description: SPURR ticks for this CPU since the system boot.
646
647 The Scaled Processor Utilization Resources Register
648 (SPURR) is a 64-bit counter that provides a frequency
649 invariant estimate of the resources used by the CPU
650 thread. The contents of this register increases
651 monotonically. This sysfs interface exposes the number
652 of SPURR ticks for cpuX.
653
654What: /sys/devices/system/cpu/cpuX/idle_purr
655Date: Apr 2020
656Contact: Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
657Description: PURR ticks for cpuX when it was idle.
658
659 This sysfs interface exposes the number of PURR ticks
660 for cpuX when it was idle.
661
662What: /sys/devices/system/cpu/cpuX/idle_spurr
663Date: Apr 2020
664Contact: Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
665Description: SPURR ticks for cpuX when it was idle.
666
667 This sysfs interface exposes the number of SPURR ticks
668 for cpuX when it was idle.
669
670What: /sys/devices/system/cpu/cpuX/mte_tcf_preferred
671Date: July 2021
672Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
673Description: Preferred MTE tag checking mode
674
675 When a user program specifies more than one MTE tag checking
676 mode, this sysfs node is used to specify which mode should
677 be preferred when scheduling a task on that CPU. Possible
678 values:
679
680 ================ ==============================================
681 "sync" Prefer synchronous mode
682 "asymm" Prefer asymmetric mode
683 "async" Prefer asynchronous mode
684 ================ ==============================================
685
686 See also: Documentation/arch/arm64/memory-tagging-extension.rst
687
688What: /sys/devices/system/cpu/nohz_full
689Date: Apr 2015
690Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
691Description:
692 (RO) the list of CPUs that are in nohz_full mode.
693 These CPUs are set by boot parameter "nohz_full=".
694
695What: /sys/devices/system/cpu/isolated
696Date: Apr 2015
697Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
698Description:
699 (RO) the list of CPUs that are isolated and don't
700 participate in load balancing. These CPUs are set by
701 boot parameter "isolcpus=".
702
703What: /sys/devices/system/cpu/crash_hotplug
704Date: Aug 2023
705Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
706Description:
707 (RO) indicates whether or not the kernel updates relevant kexec
708 segments on memory hot un/plug and/or on/offline events, avoiding the
709 need to reload kdump kernel.
710
711What: /sys/devices/system/cpu/enabled
712Date: Nov 2022
713Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
714Description:
715 (RO) the list of CPUs that can be brought online.
1What: /sys/devices/system/cpu/
2Date: pre-git history
3Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
4Description:
5 A collection of both global and individual CPU attributes
6
7 Individual CPU attributes are contained in subdirectories
8 named by the kernel's logical CPU number, e.g.:
9
10 /sys/devices/system/cpu/cpuX/
11
12What: /sys/devices/system/cpu/kernel_max
13 /sys/devices/system/cpu/offline
14 /sys/devices/system/cpu/online
15 /sys/devices/system/cpu/possible
16 /sys/devices/system/cpu/present
17Date: December 2008
18Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
19Description: CPU topology files that describe kernel limits related to
20 hotplug. Briefly:
21
22 kernel_max: the maximum cpu index allowed by the kernel
23 configuration.
24
25 offline: cpus that are not online because they have been
26 HOTPLUGGED off or exceed the limit of cpus allowed by the
27 kernel configuration (kernel_max above).
28
29 online: cpus that are online and being scheduled.
30
31 possible: cpus that have been allocated resources and can be
32 brought online if they are present.
33
34 present: cpus that have been identified as being present in
35 the system.
36
37 See Documentation/admin-guide/cputopology.rst for more information.
38
39
40What: /sys/devices/system/cpu/probe
41 /sys/devices/system/cpu/release
42Date: November 2009
43Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
44Description: Dynamic addition and removal of CPU's. This is not hotplug
45 removal, this is meant complete removal/addition of the CPU
46 from the system.
47
48 probe: writes to this file will dynamically add a CPU to the
49 system. Information written to the file to add CPU's is
50 architecture specific.
51
52 release: writes to this file dynamically remove a CPU from
53 the system. Information written to the file to remove CPU's
54 is architecture specific.
55
56What: /sys/devices/system/cpu/cpuX/node
57Date: October 2009
58Contact: Linux memory management mailing list <linux-mm@kvack.org>
59Description: Discover NUMA node a CPU belongs to
60
61 When CONFIG_NUMA is enabled, a symbolic link that points
62 to the corresponding NUMA node directory.
63
64 For example, the following symlink is created for cpu42
65 in NUMA node 2:
66
67 /sys/devices/system/cpu/cpu42/node2 -> ../../node/node2
68
69
70What: /sys/devices/system/cpu/cpuX/topology/core_siblings
71 /sys/devices/system/cpu/cpuX/topology/core_siblings_list
72 /sys/devices/system/cpu/cpuX/topology/physical_package_id
73 /sys/devices/system/cpu/cpuX/topology/thread_siblings
74 /sys/devices/system/cpu/cpuX/topology/thread_siblings_list
75 /sys/devices/system/cpu/cpuX/topology/ppin
76Date: December 2008
77Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
78Description: CPU topology files that describe a logical CPU's relationship
79 to other cores and threads in the same physical package.
80
81 One cpuX directory is created per logical CPU in the system,
82 e.g. /sys/devices/system/cpu/cpu42/.
83
84 Briefly, the files above are:
85
86 core_siblings: internal kernel map of cpuX's hardware threads
87 within the same physical_package_id.
88
89 core_siblings_list: human-readable list of the logical CPU
90 numbers within the same physical_package_id as cpuX.
91
92 physical_package_id: physical package id of cpuX. Typically
93 corresponds to a physical socket number, but the actual value
94 is architecture and platform dependent.
95
96 thread_siblings: internal kernel map of cpuX's hardware
97 threads within the same core as cpuX
98
99 thread_siblings_list: human-readable list of cpuX's hardware
100 threads within the same core as cpuX
101
102 ppin: human-readable Protected Processor Identification
103 Number of the socket the cpu# belongs to. There should be
104 one per physical_package_id. File is readable only to
105 admin.
106
107 See Documentation/admin-guide/cputopology.rst for more information.
108
109
110What: /sys/devices/system/cpu/cpuidle/available_governors
111 /sys/devices/system/cpu/cpuidle/current_driver
112 /sys/devices/system/cpu/cpuidle/current_governor
113 /sys/devices/system/cpu/cpuidle/current_governer_ro
114Date: September 2007
115Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
116Description: Discover cpuidle policy and mechanism
117
118 Various CPUs today support multiple idle levels that are
119 differentiated by varying exit latencies and power
120 consumption during idle.
121
122 Idle policy (governor) is differentiated from idle mechanism
123 (driver).
124
125 available_governors: (RO) displays a space separated list of
126 available governors.
127
128 current_driver: (RO) displays current idle mechanism.
129
130 current_governor: (RW) displays current idle policy. Users can
131 switch the governor at runtime by writing to this file.
132
133 current_governor_ro: (RO) displays current idle policy.
134
135 See Documentation/admin-guide/pm/cpuidle.rst and
136 Documentation/driver-api/pm/cpuidle.rst for more information.
137
138
139What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/name
140 /sys/devices/system/cpu/cpuX/cpuidle/stateN/latency
141 /sys/devices/system/cpu/cpuX/cpuidle/stateN/power
142 /sys/devices/system/cpu/cpuX/cpuidle/stateN/time
143 /sys/devices/system/cpu/cpuX/cpuidle/stateN/usage
144 /sys/devices/system/cpu/cpuX/cpuidle/stateN/above
145 /sys/devices/system/cpu/cpuX/cpuidle/stateN/below
146Date: September 2007
147KernelVersion: v2.6.24
148Contact: Linux power management list <linux-pm@vger.kernel.org>
149Description:
150 The directory /sys/devices/system/cpu/cpuX/cpuidle contains per
151 logical CPU specific cpuidle information for each online cpu X.
152 The processor idle states which are available for use have the
153 following attributes:
154
155 ======== ==== =================================================
156 name: (RO) Name of the idle state (string).
157
158 latency: (RO) The latency to exit out of this idle state (in
159 microseconds).
160
161 power: (RO) The power consumed while in this idle state (in
162 milliwatts).
163
164 time: (RO) The total time spent in this idle state
165 (in microseconds).
166
167 usage: (RO) Number of times this state was entered (a count).
168
169 above: (RO) Number of times this state was entered, but the
170 observed CPU idle duration was too short for it
171 (a count).
172
173 below: (RO) Number of times this state was entered, but the
174 observed CPU idle duration was too long for it
175 (a count).
176 ======== ==== =================================================
177
178What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/desc
179Date: February 2008
180KernelVersion: v2.6.25
181Contact: Linux power management list <linux-pm@vger.kernel.org>
182Description:
183 (RO) A small description about the idle state (string).
184
185
186What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/disable
187Date: March 2012
188KernelVersion: v3.10
189Contact: Linux power management list <linux-pm@vger.kernel.org>
190Description:
191 (RW) Option to disable this idle state (bool). The behavior and
192 the effect of the disable variable depends on the implementation
193 of a particular governor. In the ladder governor, for example,
194 it is not coherent, i.e. if one is disabling a light state, then
195 all deeper states are disabled as well, but the disable variable
196 does not reflect it. Likewise, if one enables a deep state but a
197 lighter state still is disabled, then this has no effect.
198
199What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/default_status
200Date: December 2019
201KernelVersion: v5.6
202Contact: Linux power management list <linux-pm@vger.kernel.org>
203Description:
204 (RO) The default status of this state, "enabled" or "disabled".
205
206What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/residency
207Date: March 2014
208KernelVersion: v3.15
209Contact: Linux power management list <linux-pm@vger.kernel.org>
210Description:
211 (RO) Display the target residency i.e. the minimum amount of
212 time (in microseconds) this cpu should spend in this idle state
213 to make the transition worth the effort.
214
215What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/
216Date: March 2018
217KernelVersion: v4.17
218Contact: Linux power management list <linux-pm@vger.kernel.org>
219Description:
220 Idle state usage statistics related to suspend-to-idle.
221
222 This attribute group is only present for states that can be
223 used in suspend-to-idle with suspended timekeeping.
224
225What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/time
226Date: March 2018
227KernelVersion: v4.17
228Contact: Linux power management list <linux-pm@vger.kernel.org>
229Description:
230 Total time spent by the CPU in suspend-to-idle (with scheduler
231 tick suspended) after requesting this state.
232
233What: /sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/usage
234Date: March 2018
235KernelVersion: v4.17
236Contact: Linux power management list <linux-pm@vger.kernel.org>
237Description:
238 Total number of times this state has been requested by the CPU
239 while entering suspend-to-idle.
240
241What: /sys/devices/system/cpu/cpuX/cpufreq/*
242Date: pre-git history
243Contact: linux-pm@vger.kernel.org
244Description: Discover and change clock speed of CPUs
245
246 Clock scaling allows you to change the clock speed of the
247 CPUs on the fly. This is a nice method to save battery
248 power, because the lower the clock speed, the less power
249 the CPU consumes.
250
251 There are many knobs to tweak in this directory.
252
253 See files in Documentation/cpu-freq/ for more information.
254
255
256What: /sys/devices/system/cpu/cpuX/cpufreq/freqdomain_cpus
257Date: June 2013
258Contact: linux-pm@vger.kernel.org
259Description: Discover CPUs in the same CPU frequency coordination domain
260
261 freqdomain_cpus is the list of CPUs (online+offline) that share
262 the same clock/freq domain (possibly at the hardware level).
263 That information may be hidden from the cpufreq core and the
264 value of related_cpus may be different from freqdomain_cpus. This
265 attribute is useful for user space DVFS controllers to get better
266 power/performance results for platforms using acpi-cpufreq.
267
268 This file is only present if the acpi-cpufreq or the cppc-cpufreq
269 drivers are in use.
270
271
272What: /sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}
273Date: August 2008
274KernelVersion: 2.6.27
275Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
276Description: Disable L3 cache indices
277
278 These files exist in every CPU's cache/index3 directory. Each
279 cache_disable_{0,1} file corresponds to one disable slot which
280 can be used to disable a cache index. Reading from these files
281 on a processor with this functionality will return the currently
282 disabled index for that node. There is one L3 structure per
283 node, or per internal node on MCM machines. Writing a valid
284 index to one of these files will cause the specified cache
285 index to be disabled.
286
287 All AMD processors with L3 caches provide this functionality.
288 For details, see BKDGs at
289 https://www.amd.com/en/support/tech-docs?keyword=bios+kernel
290
291
292What: /sys/devices/system/cpu/cpufreq/boost
293Date: August 2012
294Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
295Description: Processor frequency boosting control
296
297 This switch controls the boost setting for the whole system.
298 Boosting allows the CPU and the firmware to run at a frequency
299 beyond its nominal limit.
300
301 More details can be found in
302 Documentation/admin-guide/pm/cpufreq.rst
303
304
305What: /sys/devices/system/cpu/cpuX/crash_notes
306 /sys/devices/system/cpu/cpuX/crash_notes_size
307Date: April 2013
308Contact: kexec@lists.infradead.org
309Description: address and size of the percpu note.
310
311 crash_notes: the physical address of the memory that holds the
312 note of cpuX.
313
314 crash_notes_size: size of the note of cpuX.
315
316
317What: /sys/devices/system/cpu/intel_pstate/max_perf_pct
318 /sys/devices/system/cpu/intel_pstate/min_perf_pct
319 /sys/devices/system/cpu/intel_pstate/no_turbo
320Date: February 2013
321Contact: linux-pm@vger.kernel.org
322Description: Parameters for the Intel P-state driver
323
324 Logic for selecting the current P-state in Intel
325 Sandybridge+ processors. The three knobs control
326 limits for the P-state that will be requested by the
327 driver.
328
329 max_perf_pct: limits the maximum P state that will be requested by
330 the driver stated as a percentage of the available performance.
331
332 min_perf_pct: limits the minimum P state that will be requested by
333 the driver stated as a percentage of the available performance.
334
335 no_turbo: limits the driver to selecting P states below the turbo
336 frequency range.
337
338 More details can be found in
339 Documentation/admin-guide/pm/intel_pstate.rst
340
341What: /sys/devices/system/cpu/cpu*/cache/index*/<set_of_attributes_mentioned_below>
342Date: July 2014(documented, existed before August 2008)
343Contact: Sudeep Holla <sudeep.holla@arm.com>
344 Linux kernel mailing list <linux-kernel@vger.kernel.org>
345Description: Parameters for the CPU cache attributes
346
347 allocation_policy:
348 - WriteAllocate:
349 allocate a memory location to a cache line
350 on a cache miss because of a write
351 - ReadAllocate:
352 allocate a memory location to a cache line
353 on a cache miss because of a read
354 - ReadWriteAllocate:
355 both writeallocate and readallocate
356
357 coherency_line_size:
358 the minimum amount of data in bytes that gets
359 transferred from memory to cache
360
361 level:
362 the cache hierarchy in the multi-level cache configuration
363
364 number_of_sets:
365 total number of sets in the cache, a set is a
366 collection of cache lines with the same cache index
367
368 physical_line_partition:
369 number of physical cache line per cache tag
370
371 shared_cpu_list:
372 the list of logical cpus sharing the cache
373
374 shared_cpu_map:
375 logical cpu mask containing the list of cpus sharing
376 the cache
377
378 size:
379 the total cache size in kB
380
381 type:
382 - Instruction: cache that only holds instructions
383 - Data: cache that only caches data
384 - Unified: cache that holds both data and instructions
385
386 ways_of_associativity:
387 degree of freedom in placing a particular block
388 of memory in the cache
389
390 write_policy:
391 - WriteThrough:
392 data is written to both the cache line
393 and to the block in the lower-level memory
394 - WriteBack:
395 data is written only to the cache line and
396 the modified cache line is written to main
397 memory only when it is replaced
398
399
400What: /sys/devices/system/cpu/cpu*/cache/index*/id
401Date: September 2016
402Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
403Description: Cache id
404
405 The id provides a unique number for a specific instance of
406 a cache of a particular type. E.g. there may be a level
407 3 unified cache on each socket in a server and we may
408 assign them ids 0, 1, 2, ...
409
410 Note that id value can be non-contiguous. E.g. level 1
411 caches typically exist per core, but there may not be a
412 power of two cores on a socket, so these caches may be
413 numbered 0, 1, 2, 3, 4, 5, 8, 9, 10, ...
414
415What: /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats
416 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat
417 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat
418 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle
419 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap
420 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp
421 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault
422 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent
423 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset
424Date: March 2016
425Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
426 Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
427Description: POWERNV CPUFreq driver's frequency throttle stats directory and
428 attributes
429
430 'cpuX/cpufreq/throttle_stats' directory contains the CPU frequency
431 throttle stat attributes for the chip. The throttle stats of a cpu
432 is common across all the cpus belonging to a chip. Below are the
433 throttle attributes exported in the 'throttle_stats' directory:
434
435 - turbo_stat : This file gives the total number of times the max
436 frequency is throttled to lower frequency in turbo (at and above
437 nominal frequency) range of frequencies.
438
439 - sub_turbo_stat : This file gives the total number of times the
440 max frequency is throttled to lower frequency in sub-turbo(below
441 nominal frequency) range of frequencies.
442
443 - unthrottle : This file gives the total number of times the max
444 frequency is unthrottled after being throttled.
445
446 - powercap : This file gives the total number of times the max
447 frequency is throttled due to 'Power Capping'.
448
449 - overtemp : This file gives the total number of times the max
450 frequency is throttled due to 'CPU Over Temperature'.
451
452 - supply_fault : This file gives the total number of times the
453 max frequency is throttled due to 'Power Supply Failure'.
454
455 - overcurrent : This file gives the total number of times the
456 max frequency is throttled due to 'Overcurrent'.
457
458 - occ_reset : This file gives the total number of times the max
459 frequency is throttled due to 'OCC Reset'.
460
461 The sysfs attributes representing different throttle reasons like
462 powercap, overtemp, supply_fault, overcurrent and occ_reset map to
463 the reasons provided by OCC firmware for throttling the frequency.
464
465What: /sys/devices/system/cpu/cpufreq/policyX/throttle_stats
466 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat
467 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat
468 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle
469 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap
470 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp
471 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault
472 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent
473 /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset
474Date: March 2016
475Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
476 Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
477Description: POWERNV CPUFreq driver's frequency throttle stats directory and
478 attributes
479
480 'policyX/throttle_stats' directory and all the attributes are same as
481 the /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats directory and
482 attributes which give the frequency throttle information of the chip.
483
484What: /sys/devices/system/cpu/cpuX/regs/
485 /sys/devices/system/cpu/cpuX/regs/identification/
486 /sys/devices/system/cpu/cpuX/regs/identification/midr_el1
487 /sys/devices/system/cpu/cpuX/regs/identification/revidr_el1
488 /sys/devices/system/cpu/cpuX/regs/identification/smidr_el1
489Date: June 2016
490Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
491Description: AArch64 CPU registers
492
493 'identification' directory exposes the CPU ID registers for
494 identifying model and revision of the CPU and SMCU.
495
496What: /sys/devices/system/cpu/aarch32_el0
497Date: May 2021
498Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
499Description: Identifies the subset of CPUs in the system that can execute
500 AArch32 (32-bit ARM) applications. If present, the same format as
501 /sys/devices/system/cpu/{offline,online,possible,present} is used.
502 If absent, then all or none of the CPUs can execute AArch32
503 applications and execve() will behave accordingly.
504
505What: /sys/devices/system/cpu/cpuX/cpu_capacity
506Date: December 2016
507Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
508Description: information about CPUs heterogeneity.
509
510 cpu_capacity: capacity of cpuX.
511
512What: /sys/devices/system/cpu/vulnerabilities
513 /sys/devices/system/cpu/vulnerabilities/gather_data_sampling
514 /sys/devices/system/cpu/vulnerabilities/itlb_multihit
515 /sys/devices/system/cpu/vulnerabilities/l1tf
516 /sys/devices/system/cpu/vulnerabilities/mds
517 /sys/devices/system/cpu/vulnerabilities/meltdown
518 /sys/devices/system/cpu/vulnerabilities/mmio_stale_data
519 /sys/devices/system/cpu/vulnerabilities/retbleed
520 /sys/devices/system/cpu/vulnerabilities/spec_store_bypass
521 /sys/devices/system/cpu/vulnerabilities/spectre_v1
522 /sys/devices/system/cpu/vulnerabilities/spectre_v2
523 /sys/devices/system/cpu/vulnerabilities/srbds
524 /sys/devices/system/cpu/vulnerabilities/tsx_async_abort
525Date: January 2018
526Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
527Description: Information about CPU vulnerabilities
528
529 The files are named after the code names of CPU
530 vulnerabilities. The output of those files reflects the
531 state of the CPUs in the system. Possible output values:
532
533 ================ ==============================================
534 "Not affected" CPU is not affected by the vulnerability
535 "Vulnerable" CPU is affected and no mitigation in effect
536 "Mitigation: $M" CPU is affected and mitigation $M is in effect
537 ================ ==============================================
538
539 See also: Documentation/admin-guide/hw-vuln/index.rst
540
541What: /sys/devices/system/cpu/smt
542 /sys/devices/system/cpu/smt/active
543 /sys/devices/system/cpu/smt/control
544Date: June 2018
545Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
546Description: Control Symmetric Multi Threading (SMT)
547
548 active: Tells whether SMT is active (enabled and siblings online)
549
550 control: Read/write interface to control SMT. Possible
551 values:
552
553 ================ =========================================
554 "on" SMT is enabled
555 "off" SMT is disabled
556 "<N>" SMT is enabled with N threads per core.
557 "forceoff" SMT is force disabled. Cannot be changed.
558 "notsupported" SMT is not supported by the CPU
559 "notimplemented" SMT runtime toggling is not
560 implemented for the architecture
561 ================ =========================================
562
563 If control status is "forceoff" or "notsupported" writes
564 are rejected.
565
566What: /sys/devices/system/cpu/cpuX/power/energy_perf_bias
567Date: March 2019
568Contact: linux-pm@vger.kernel.org
569Description: Intel Energy and Performance Bias Hint (EPB)
570
571 EPB for the given CPU in a sliding scale 0 - 15, where a value
572 of 0 corresponds to a hint preference for highest performance
573 and a value of 15 corresponds to the maximum energy savings.
574
575 In order to change the EPB value for the CPU, write either
576 a number in the 0 - 15 sliding scale above, or one of the
577 strings: "performance", "balance-performance", "normal",
578 "balance-power", "power" (that represent values reflected by
579 their meaning), to this attribute.
580
581 This attribute is present for all online CPUs supporting the
582 Intel EPB feature.
583
584What: /sys/devices/system/cpu/umwait_control
585 /sys/devices/system/cpu/umwait_control/enable_c02
586 /sys/devices/system/cpu/umwait_control/max_time
587Date: May 2019
588Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
589Description: Umwait control
590
591 enable_c02: Read/write interface to control umwait C0.2 state
592 Read returns C0.2 state status:
593 0: C0.2 is disabled
594 1: C0.2 is enabled
595
596 Write 'y' or '1' or 'on' to enable C0.2 state.
597 Write 'n' or '0' or 'off' to disable C0.2 state.
598
599 The interface is case insensitive.
600
601 max_time: Read/write interface to control umwait maximum time
602 in TSC-quanta that the CPU can reside in either C0.1
603 or C0.2 state. The time is an unsigned 32-bit number.
604 Note that a value of zero means there is no limit.
605 Low order two bits must be zero.
606
607What: /sys/devices/system/cpu/svm
608Date: August 2019
609Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
610 Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
611Description: Secure Virtual Machine
612
613 If 1, it means the system is using the Protected Execution
614 Facility in POWER9 and newer processors. i.e., it is a Secure
615 Virtual Machine.
616
617What: /sys/devices/system/cpu/cpuX/purr
618Date: Apr 2005
619Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
620Description: PURR ticks for this CPU since the system boot.
621
622 The Processor Utilization Resources Register (PURR) is
623 a 64-bit counter which provides an estimate of the
624 resources used by the CPU thread. The contents of this
625 register increases monotonically. This sysfs interface
626 exposes the number of PURR ticks for cpuX.
627
628What: /sys/devices/system/cpu/cpuX/spurr
629Date: Dec 2006
630Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
631Description: SPURR ticks for this CPU since the system boot.
632
633 The Scaled Processor Utilization Resources Register
634 (SPURR) is a 64-bit counter that provides a frequency
635 invariant estimate of the resources used by the CPU
636 thread. The contents of this register increases
637 monotonically. This sysfs interface exposes the number
638 of SPURR ticks for cpuX.
639
640What: /sys/devices/system/cpu/cpuX/idle_purr
641Date: Apr 2020
642Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
643Description: PURR ticks for cpuX when it was idle.
644
645 This sysfs interface exposes the number of PURR ticks
646 for cpuX when it was idle.
647
648What: /sys/devices/system/cpu/cpuX/idle_spurr
649Date: Apr 2020
650Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
651Description: SPURR ticks for cpuX when it was idle.
652
653 This sysfs interface exposes the number of SPURR ticks
654 for cpuX when it was idle.
655
656What: /sys/devices/system/cpu/cpuX/mte_tcf_preferred
657Date: July 2021
658Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
659Description: Preferred MTE tag checking mode
660
661 When a user program specifies more than one MTE tag checking
662 mode, this sysfs node is used to specify which mode should
663 be preferred when scheduling a task on that CPU. Possible
664 values:
665
666 ================ ==============================================
667 "sync" Prefer synchronous mode
668 "asymm" Prefer asymmetric mode
669 "async" Prefer asynchronous mode
670 ================ ==============================================
671
672 See also: Documentation/arch/arm64/memory-tagging-extension.rst
673
674What: /sys/devices/system/cpu/nohz_full
675Date: Apr 2015
676Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
677Description:
678 (RO) the list of CPUs that are in nohz_full mode.
679 These CPUs are set by boot parameter "nohz_full=".
680
681What: /sys/devices/system/cpu/isolated
682Date: Apr 2015
683Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
684Description:
685 (RO) the list of CPUs that are isolated and don't
686 participate in load balancing. These CPUs are set by
687 boot parameter "isolcpus=".
688
689What: /sys/devices/system/cpu/crash_hotplug
690Date: Aug 2023
691Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
692Description:
693 (RO) indicates whether or not the kernel directly supports
694 modifying the crash elfcorehdr for CPU hot un/plug and/or
695 on/offline changes.