xref: /linux/Documentation/ABI/testing/sysfs-devices-system-cpu (revision 42b16d3ac371a2fac9b6f08fd75f23f34ba3955a)
12ceb3fb0SAlex ChiangWhat:		/sys/devices/system/cpu/
22ceb3fb0SAlex ChiangDate:		pre-git history
32ceb3fb0SAlex ChiangContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
42ceb3fb0SAlex ChiangDescription:
52ceb3fb0SAlex Chiang		A collection of both global and individual CPU attributes
62ceb3fb0SAlex Chiang
72ceb3fb0SAlex Chiang		Individual CPU attributes are contained in subdirectories
82ceb3fb0SAlex Chiang		named by the kernel's logical CPU number, e.g.:
92ceb3fb0SAlex Chiang
10abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/
112ceb3fb0SAlex Chiang
12d93fc863SAlex ChiangWhat:		/sys/devices/system/cpu/kernel_max
13d93fc863SAlex Chiang		/sys/devices/system/cpu/offline
14d93fc863SAlex Chiang		/sys/devices/system/cpu/online
15d93fc863SAlex Chiang		/sys/devices/system/cpu/possible
16d93fc863SAlex Chiang		/sys/devices/system/cpu/present
17d93fc863SAlex ChiangDate:		December 2008
18d93fc863SAlex ChiangContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
19d93fc863SAlex ChiangDescription:	CPU topology files that describe kernel limits related to
20d93fc863SAlex Chiang		hotplug. Briefly:
21d93fc863SAlex Chiang
22d93fc863SAlex Chiang		kernel_max: the maximum cpu index allowed by the kernel
23d93fc863SAlex Chiang		configuration.
24d93fc863SAlex Chiang
25d93fc863SAlex Chiang		offline: cpus that are not online because they have been
26d93fc863SAlex Chiang		HOTPLUGGED off or exceed the limit of cpus allowed by the
27d93fc863SAlex Chiang		kernel configuration (kernel_max above).
28d93fc863SAlex Chiang
29d93fc863SAlex Chiang		online: cpus that are online and being scheduled.
30d93fc863SAlex Chiang
31d93fc863SAlex Chiang		possible: cpus that have been allocated resources and can be
32d93fc863SAlex Chiang		brought online if they are present.
33d93fc863SAlex Chiang
34d93fc863SAlex Chiang		present: cpus that have been identified as being present in
35d93fc863SAlex Chiang		the system.
36d93fc863SAlex Chiang
374f4cfa6cSMauro Carvalho Chehab		See Documentation/admin-guide/cputopology.rst for more information.
38d93fc863SAlex Chiang
39d93fc863SAlex Chiang
4012633e80SNathan FontenotWhat:		/sys/devices/system/cpu/probe
4112633e80SNathan Fontenot		/sys/devices/system/cpu/release
4212633e80SNathan FontenotDate:		November 2009
4312633e80SNathan FontenotContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4412633e80SNathan FontenotDescription:	Dynamic addition and removal of CPU's.  This is not hotplug
4512633e80SNathan Fontenot		removal, this is meant complete removal/addition of the CPU
4612633e80SNathan Fontenot		from the system.
4712633e80SNathan Fontenot
4812633e80SNathan Fontenot		probe: writes to this file will dynamically add a CPU to the
4912633e80SNathan Fontenot		system.  Information written to the file to add CPU's is
5012633e80SNathan Fontenot		architecture specific.
5112633e80SNathan Fontenot
5212633e80SNathan Fontenot		release: writes to this file dynamically remove a CPU from
5312633e80SNathan Fontenot		the system.  Information written to the file to remove CPU's
5412633e80SNathan Fontenot		is architecture specific.
55657348a0SAlex Chiang
56abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/node
57657348a0SAlex ChiangDate:		October 2009
58657348a0SAlex ChiangContact:	Linux memory management mailing list <linux-mm@kvack.org>
59657348a0SAlex ChiangDescription:	Discover NUMA node a CPU belongs to
60657348a0SAlex Chiang
61657348a0SAlex Chiang		When CONFIG_NUMA is enabled, a symbolic link that points
62657348a0SAlex Chiang		to the corresponding NUMA node directory.
63657348a0SAlex Chiang
64657348a0SAlex Chiang		For example, the following symlink is created for cpu42
65657348a0SAlex Chiang		in NUMA node 2:
66657348a0SAlex Chiang
67657348a0SAlex Chiang		/sys/devices/system/cpu/cpu42/node2 -> ../../node/node2
68657348a0SAlex Chiang
69657348a0SAlex Chiang
701d248d23SMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/topology/core_siblings
71abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/topology/core_siblings_list
72abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/topology/physical_package_id
73abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/topology/thread_siblings
74abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/topology/thread_siblings_list
75ab28e944STony Luck		/sys/devices/system/cpu/cpuX/topology/ppin
76663fb2fcSAlex ChiangDate:		December 2008
77663fb2fcSAlex ChiangContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
78663fb2fcSAlex ChiangDescription:	CPU topology files that describe a logical CPU's relationship
79663fb2fcSAlex Chiang		to other cores and threads in the same physical package.
80663fb2fcSAlex Chiang
81abcb948dSMauro Carvalho Chehab		One cpuX directory is created per logical CPU in the system,
82663fb2fcSAlex Chiang		e.g. /sys/devices/system/cpu/cpu42/.
83663fb2fcSAlex Chiang
84663fb2fcSAlex Chiang		Briefly, the files above are:
85663fb2fcSAlex Chiang
86abcb948dSMauro Carvalho Chehab		core_siblings: internal kernel map of cpuX's hardware threads
87663fb2fcSAlex Chiang		within the same physical_package_id.
88663fb2fcSAlex Chiang
89663fb2fcSAlex Chiang		core_siblings_list: human-readable list of the logical CPU
90abcb948dSMauro Carvalho Chehab		numbers within the same physical_package_id as cpuX.
91663fb2fcSAlex Chiang
92abcb948dSMauro Carvalho Chehab		physical_package_id: physical package id of cpuX. Typically
93663fb2fcSAlex Chiang		corresponds to a physical socket number, but the actual value
94663fb2fcSAlex Chiang		is architecture and platform dependent.
95663fb2fcSAlex Chiang
96abcb948dSMauro Carvalho Chehab		thread_siblings: internal kernel map of cpuX's hardware
97abcb948dSMauro Carvalho Chehab		threads within the same core as cpuX
98663fb2fcSAlex Chiang
99abcb948dSMauro Carvalho Chehab		thread_siblings_list: human-readable list of cpuX's hardware
100abcb948dSMauro Carvalho Chehab		threads within the same core as cpuX
101663fb2fcSAlex Chiang
102ab28e944STony Luck		ppin: human-readable Protected Processor Identification
103ab28e944STony Luck		Number of the socket the cpu# belongs to. There should be
104ab28e944STony Luck		one per physical_package_id. File is readable only to
105ab28e944STony Luck		admin.
106ab28e944STony Luck
1074f4cfa6cSMauro Carvalho Chehab		See Documentation/admin-guide/cputopology.rst for more information.
108663fb2fcSAlex Chiang
109663fb2fcSAlex Chiang
1107395683aSHanjun GuoWhat:		/sys/devices/system/cpu/cpuidle/available_governors
1117395683aSHanjun Guo		/sys/devices/system/cpu/cpuidle/current_driver
112b6d8ef86SAishwarya Pant		/sys/devices/system/cpu/cpuidle/current_governor
1137395683aSHanjun Guo		/sys/devices/system/cpu/cpuidle/current_governer_ro
114c1fb5c47SAlex ChiangDate:		September 2007
115c1fb5c47SAlex ChiangContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
116c1fb5c47SAlex ChiangDescription:	Discover cpuidle policy and mechanism
117c1fb5c47SAlex Chiang
118c1fb5c47SAlex Chiang		Various CPUs today support multiple idle levels that are
119c1fb5c47SAlex Chiang		differentiated by varying exit latencies and power
120c1fb5c47SAlex Chiang		consumption during idle.
121c1fb5c47SAlex Chiang
122c1fb5c47SAlex Chiang		Idle policy (governor) is differentiated from idle mechanism
1237395683aSHanjun Guo		(driver).
124b6d8ef86SAishwarya Pant
125b6d8ef86SAishwarya Pant		available_governors: (RO) displays a space separated list of
1267395683aSHanjun Guo		available governors.
1277395683aSHanjun Guo
1287395683aSHanjun Guo		current_driver: (RO) displays current idle mechanism.
129b6d8ef86SAishwarya Pant
130b6d8ef86SAishwarya Pant		current_governor: (RW) displays current idle policy. Users can
131b6d8ef86SAishwarya Pant		switch the governor at runtime by writing to this file.
132c1fb5c47SAlex Chiang
1337395683aSHanjun Guo		current_governor_ro: (RO) displays current idle policy.
1347395683aSHanjun Guo
135671c3095SMauro Carvalho Chehab		See Documentation/admin-guide/pm/cpuidle.rst and
136671c3095SMauro Carvalho Chehab		Documentation/driver-api/pm/cpuidle.rst for more information.
137c1fb5c47SAlex Chiang
138c1fb5c47SAlex Chiang
13926d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/name
140b6d8ef86SAishwarya Pant		/sys/devices/system/cpu/cpuX/cpuidle/stateN/latency
141b6d8ef86SAishwarya Pant		/sys/devices/system/cpu/cpuX/cpuidle/stateN/power
142b6d8ef86SAishwarya Pant		/sys/devices/system/cpu/cpuX/cpuidle/stateN/time
143b6d8ef86SAishwarya Pant		/sys/devices/system/cpu/cpuX/cpuidle/stateN/usage
14404dab58aSRafael J. Wysocki		/sys/devices/system/cpu/cpuX/cpuidle/stateN/above
14504dab58aSRafael J. Wysocki		/sys/devices/system/cpu/cpuX/cpuidle/stateN/below
146b6d8ef86SAishwarya PantDate:		September 2007
147b6d8ef86SAishwarya PantKernelVersion:	v2.6.24
148b6d8ef86SAishwarya PantContact:	Linux power management list <linux-pm@vger.kernel.org>
149b6d8ef86SAishwarya PantDescription:
150b6d8ef86SAishwarya Pant		The directory /sys/devices/system/cpu/cpuX/cpuidle contains per
151b6d8ef86SAishwarya Pant		logical CPU specific cpuidle information for each online cpu X.
152b6d8ef86SAishwarya Pant		The processor idle states which are available for use have the
153b6d8ef86SAishwarya Pant		following attributes:
154b6d8ef86SAishwarya Pant
15534433332SMauro Carvalho Chehab		======== ==== =================================================
156b6d8ef86SAishwarya Pant		name:	 (RO) Name of the idle state (string).
157b6d8ef86SAishwarya Pant
158b6d8ef86SAishwarya Pant		latency: (RO) The latency to exit out of this idle state (in
159b6d8ef86SAishwarya Pant			      microseconds).
160b6d8ef86SAishwarya Pant
161b6d8ef86SAishwarya Pant		power:   (RO) The power consumed while in this idle state (in
162b6d8ef86SAishwarya Pant			      milliwatts).
163b6d8ef86SAishwarya Pant
16434433332SMauro Carvalho Chehab		time:    (RO) The total time spent in this idle state
16534433332SMauro Carvalho Chehab			      (in microseconds).
166b6d8ef86SAishwarya Pant
167b6d8ef86SAishwarya Pant		usage:	 (RO) Number of times this state was entered (a count).
168b6d8ef86SAishwarya Pant
16904dab58aSRafael J. Wysocki		above:	 (RO) Number of times this state was entered, but the
17034433332SMauro Carvalho Chehab			      observed CPU idle duration was too short for it
17134433332SMauro Carvalho Chehab			      (a count).
17204dab58aSRafael J. Wysocki
17304dab58aSRafael J. Wysocki		below:	 (RO) Number of times this state was entered, but the
17434433332SMauro Carvalho Chehab			      observed CPU idle duration was too long for it
17534433332SMauro Carvalho Chehab			      (a count).
17634433332SMauro Carvalho Chehab		======== ==== =================================================
177b6d8ef86SAishwarya Pant
17826d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/desc
179b6d8ef86SAishwarya PantDate:		February 2008
180b6d8ef86SAishwarya PantKernelVersion:	v2.6.25
181b6d8ef86SAishwarya PantContact:	Linux power management list <linux-pm@vger.kernel.org>
182b6d8ef86SAishwarya PantDescription:
183b6d8ef86SAishwarya Pant		(RO) A small description about the idle state (string).
184b6d8ef86SAishwarya Pant
185b6d8ef86SAishwarya Pant
18626d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/disable
187b6d8ef86SAishwarya PantDate:		March 2012
188b6d8ef86SAishwarya PantKernelVersion:	v3.10
189b6d8ef86SAishwarya PantContact:	Linux power management list <linux-pm@vger.kernel.org>
190b6d8ef86SAishwarya PantDescription:
191b6d8ef86SAishwarya Pant		(RW) Option to disable this idle state (bool). The behavior and
192b6d8ef86SAishwarya Pant		the effect of the disable variable depends on the implementation
193b6d8ef86SAishwarya Pant		of a particular governor. In the ladder governor, for example,
194b6d8ef86SAishwarya Pant		it is not coherent, i.e. if one is disabling a light state, then
195b6d8ef86SAishwarya Pant		all deeper states are disabled as well, but the disable variable
196b6d8ef86SAishwarya Pant		does not reflect it. Likewise, if one enables a deep state but a
197b6d8ef86SAishwarya Pant		lighter state still is disabled, then this has no effect.
198b6d8ef86SAishwarya Pant
19926d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/default_status
20075a80267SRafael J. WysockiDate:		December 2019
20175a80267SRafael J. WysockiKernelVersion:	v5.6
20275a80267SRafael J. WysockiContact:	Linux power management list <linux-pm@vger.kernel.org>
20375a80267SRafael J. WysockiDescription:
20475a80267SRafael J. Wysocki		(RO) The default status of this state, "enabled" or "disabled".
205b6d8ef86SAishwarya Pant
20626d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/residency
207b6d8ef86SAishwarya PantDate:		March 2014
208b6d8ef86SAishwarya PantKernelVersion:	v3.15
209b6d8ef86SAishwarya PantContact:	Linux power management list <linux-pm@vger.kernel.org>
210b6d8ef86SAishwarya PantDescription:
211b6d8ef86SAishwarya Pant		(RO) Display the target residency i.e. the minimum amount of
212b6d8ef86SAishwarya Pant		time (in microseconds) this cpu should spend in this idle state
213b6d8ef86SAishwarya Pant		to make the transition worth the effort.
214b6d8ef86SAishwarya Pant
21526d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/
21664bdff69SRafael J. WysockiDate:		March 2018
21764bdff69SRafael J. WysockiKernelVersion:	v4.17
21864bdff69SRafael J. WysockiContact:	Linux power management list <linux-pm@vger.kernel.org>
21964bdff69SRafael J. WysockiDescription:
22064bdff69SRafael J. Wysocki		Idle state usage statistics related to suspend-to-idle.
22164bdff69SRafael J. Wysocki
22264bdff69SRafael J. Wysocki		This attribute group is only present for states that can be
22364bdff69SRafael J. Wysocki		used in suspend-to-idle with suspended timekeeping.
22464bdff69SRafael J. Wysocki
22526d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/time
22664bdff69SRafael J. WysockiDate:		March 2018
22764bdff69SRafael J. WysockiKernelVersion:	v4.17
22864bdff69SRafael J. WysockiContact:	Linux power management list <linux-pm@vger.kernel.org>
22964bdff69SRafael J. WysockiDescription:
23064bdff69SRafael J. Wysocki		Total time spent by the CPU in suspend-to-idle (with scheduler
23164bdff69SRafael J. Wysocki		tick suspended) after requesting this state.
23264bdff69SRafael J. Wysocki
23326d6ba2fSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/usage
23464bdff69SRafael J. WysockiDate:		March 2018
23564bdff69SRafael J. WysockiKernelVersion:	v4.17
23664bdff69SRafael J. WysockiContact:	Linux power management list <linux-pm@vger.kernel.org>
23764bdff69SRafael J. WysockiDescription:
23864bdff69SRafael J. Wysocki		Total number of times this state has been requested by the CPU
23964bdff69SRafael J. Wysocki		while entering suspend-to-idle.
240b6d8ef86SAishwarya Pant
241abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpufreq/*
2420cda8b91SAlex ChiangDate:		pre-git history
243dec102aaSViresh KumarContact:	linux-pm@vger.kernel.org
2440cda8b91SAlex ChiangDescription:	Discover and change clock speed of CPUs
2450cda8b91SAlex Chiang
2460cda8b91SAlex Chiang		Clock scaling allows you to change the clock speed of the
2470cda8b91SAlex Chiang		CPUs on the fly. This is a nice method to save battery
2480cda8b91SAlex Chiang		power, because the lower the clock speed, the less power
2490cda8b91SAlex Chiang		the CPU consumes.
2500cda8b91SAlex Chiang
2510cda8b91SAlex Chiang		There are many knobs to tweak in this directory.
2520cda8b91SAlex Chiang
2530cda8b91SAlex Chiang		See files in Documentation/cpu-freq/ for more information.
2540cda8b91SAlex Chiang
2550cda8b91SAlex Chiang
256abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpufreq/freqdomain_cpus
257f4fd3797SLan TianyuDate:		June 2013
258dec102aaSViresh KumarContact:	linux-pm@vger.kernel.org
259f4fd3797SLan TianyuDescription:	Discover CPUs in the same CPU frequency coordination domain
260f4fd3797SLan Tianyu
261f4fd3797SLan Tianyu		freqdomain_cpus is the list of CPUs (online+offline) that share
262f4fd3797SLan Tianyu		the same clock/freq domain (possibly at the hardware level).
263f4fd3797SLan Tianyu		That information may be hidden from the cpufreq core and the
264f4fd3797SLan Tianyu		value of related_cpus may be different from freqdomain_cpus. This
265f4fd3797SLan Tianyu		attribute is useful for user space DVFS controllers to get better
266f4fd3797SLan Tianyu		power/performance results for platforms using acpi-cpufreq.
267f4fd3797SLan Tianyu
268cfdc589fSIonela Voinescu		This file is only present if the acpi-cpufreq or the cppc-cpufreq
269cfdc589fSIonela Voinescu		drivers are in use.
270f4fd3797SLan Tianyu
271f4fd3797SLan Tianyu
272eecaaba5SBorislav PetkovWhat:		/sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}
273468727abSAlex ChiangDate:		August 2008
274468727abSAlex ChiangKernelVersion:	2.6.27
275ea8e080bSAravind GopalakrishnanContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
276eecaaba5SBorislav PetkovDescription:	Disable L3 cache indices
277468727abSAlex Chiang
278eecaaba5SBorislav Petkov		These files exist in every CPU's cache/index3 directory. Each
279eecaaba5SBorislav Petkov		cache_disable_{0,1} file corresponds to one disable slot which
280eecaaba5SBorislav Petkov		can be used to disable a cache index. Reading from these files
281eecaaba5SBorislav Petkov		on a processor with this functionality will return the currently
282eecaaba5SBorislav Petkov		disabled index for that node. There is one L3 structure per
283eecaaba5SBorislav Petkov		node, or per internal node on MCM machines. Writing a valid
2843e42d1deSCarlos Bilbao		index to one of these files will cause the specified cache
285eecaaba5SBorislav Petkov		index to be disabled.
286eecaaba5SBorislav Petkov
287eecaaba5SBorislav Petkov		All AMD processors with L3 caches provide this functionality.
288eecaaba5SBorislav Petkov		For details, see BKDGs at
2892fa4928aSAnatoly Pugachev                https://www.amd.com/en/support/tech-docs?keyword=bios+kernel
290615b7300SAndre Przywara
291615b7300SAndre Przywara
292615b7300SAndre PrzywaraWhat:		/sys/devices/system/cpu/cpufreq/boost
293615b7300SAndre PrzywaraDate:		August 2012
294615b7300SAndre PrzywaraContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
295615b7300SAndre PrzywaraDescription:	Processor frequency boosting control
296615b7300SAndre Przywara
297615b7300SAndre Przywara		This switch controls the boost setting for the whole system.
298615b7300SAndre Przywara		Boosting allows the CPU and the firmware to run at a frequency
2998a7f0e8aSRandy Dunlap		beyond its nominal limit.
30034433332SMauro Carvalho Chehab
3013ba9b1b8STom Saeger		More details can be found in
3023ba9b1b8STom Saeger		Documentation/admin-guide/pm/cpufreq.rst
303c4fd675fSZhang Yanfei
304c4fd675fSZhang Yanfei
305abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/crash_notes
306abcb948dSMauro Carvalho Chehab		/sys/devices/system/cpu/cpuX/crash_notes_size
307c4fd675fSZhang YanfeiDate:		April 2013
308c4fd675fSZhang YanfeiContact:	kexec@lists.infradead.org
309c4fd675fSZhang YanfeiDescription:	address and size of the percpu note.
310c4fd675fSZhang Yanfei
311c4fd675fSZhang Yanfei		crash_notes: the physical address of the memory that holds the
312abcb948dSMauro Carvalho Chehab		note of cpuX.
313c4fd675fSZhang Yanfei
314abcb948dSMauro Carvalho Chehab		crash_notes_size: size of the note of cpuX.
315fbe299e0SRamkumar Ramachandra
316fbe299e0SRamkumar Ramachandra
317fbe299e0SRamkumar RamachandraWhat:		/sys/devices/system/cpu/intel_pstate/max_perf_pct
318fbe299e0SRamkumar Ramachandra		/sys/devices/system/cpu/intel_pstate/min_perf_pct
319fbe299e0SRamkumar Ramachandra		/sys/devices/system/cpu/intel_pstate/no_turbo
320fbe299e0SRamkumar RamachandraDate:		February 2013
321fbe299e0SRamkumar RamachandraContact:	linux-pm@vger.kernel.org
322fbe299e0SRamkumar RamachandraDescription:	Parameters for the Intel P-state driver
323fbe299e0SRamkumar Ramachandra
324fbe299e0SRamkumar Ramachandra		Logic for selecting the current P-state in Intel
325fbe299e0SRamkumar Ramachandra		Sandybridge+ processors. The three knobs control
326fbe299e0SRamkumar Ramachandra		limits for the P-state that will be requested by the
327fbe299e0SRamkumar Ramachandra		driver.
328fbe299e0SRamkumar Ramachandra
329fbe299e0SRamkumar Ramachandra		max_perf_pct: limits the maximum P state that will be requested by
330fbe299e0SRamkumar Ramachandra		the driver stated as a percentage of the available performance.
331fbe299e0SRamkumar Ramachandra
332fbe299e0SRamkumar Ramachandra		min_perf_pct: limits the minimum P state that will be requested by
333fbe299e0SRamkumar Ramachandra		the driver stated as a percentage of the available performance.
334fbe299e0SRamkumar Ramachandra
335fbe299e0SRamkumar Ramachandra		no_turbo: limits the driver to selecting P states below the turbo
336fbe299e0SRamkumar Ramachandra		frequency range.
337fbe299e0SRamkumar Ramachandra
3383ba9b1b8STom Saeger		More details can be found in
3393ba9b1b8STom Saeger		Documentation/admin-guide/pm/intel_pstate.rst
340246246cbSSudeep Holla
341246246cbSSudeep HollaWhat:		/sys/devices/system/cpu/cpu*/cache/index*/<set_of_attributes_mentioned_below>
342246246cbSSudeep HollaDate:		July 2014(documented, existed before August 2008)
343246246cbSSudeep HollaContact:	Sudeep Holla <sudeep.holla@arm.com>
344246246cbSSudeep Holla		Linux kernel mailing list <linux-kernel@vger.kernel.org>
345246246cbSSudeep HollaDescription:	Parameters for the CPU cache attributes
346246246cbSSudeep Holla
347246246cbSSudeep Holla		allocation_policy:
34834433332SMauro Carvalho Chehab			- WriteAllocate:
34934433332SMauro Carvalho Chehab					allocate a memory location to a cache line
350246246cbSSudeep Holla					on a cache miss because of a write
35134433332SMauro Carvalho Chehab			- ReadAllocate:
35234433332SMauro Carvalho Chehab					allocate a memory location to a cache line
353246246cbSSudeep Holla					on a cache miss because of a read
35434433332SMauro Carvalho Chehab			- ReadWriteAllocate:
35534433332SMauro Carvalho Chehab					both writeallocate and readallocate
356246246cbSSudeep Holla
35734433332SMauro Carvalho Chehab		coherency_line_size:
35834433332SMauro Carvalho Chehab				     the minimum amount of data in bytes that gets
359246246cbSSudeep Holla				     transferred from memory to cache
360246246cbSSudeep Holla
36134433332SMauro Carvalho Chehab		level:
36234433332SMauro Carvalho Chehab			the cache hierarchy in the multi-level cache configuration
363246246cbSSudeep Holla
36434433332SMauro Carvalho Chehab		number_of_sets:
36534433332SMauro Carvalho Chehab				total number of sets in the cache, a set is a
366246246cbSSudeep Holla				collection of cache lines with the same cache index
367246246cbSSudeep Holla
36834433332SMauro Carvalho Chehab		physical_line_partition:
36934433332SMauro Carvalho Chehab				number of physical cache line per cache tag
370246246cbSSudeep Holla
37134433332SMauro Carvalho Chehab		shared_cpu_list:
37234433332SMauro Carvalho Chehab				the list of logical cpus sharing the cache
373246246cbSSudeep Holla
37434433332SMauro Carvalho Chehab		shared_cpu_map:
37534433332SMauro Carvalho Chehab				logical cpu mask containing the list of cpus sharing
376246246cbSSudeep Holla				the cache
377246246cbSSudeep Holla
37834433332SMauro Carvalho Chehab		size:
37934433332SMauro Carvalho Chehab			the total cache size in kB
380246246cbSSudeep Holla
381246246cbSSudeep Holla		type:
382246246cbSSudeep Holla			- Instruction: cache that only holds instructions
383246246cbSSudeep Holla			- Data: cache that only caches data
384246246cbSSudeep Holla			- Unified: cache that holds both data and instructions
385246246cbSSudeep Holla
38634433332SMauro Carvalho Chehab		ways_of_associativity:
38734433332SMauro Carvalho Chehab			degree of freedom in placing a particular block
388246246cbSSudeep Holla			of memory in the cache
389246246cbSSudeep Holla
390246246cbSSudeep Holla		write_policy:
39134433332SMauro Carvalho Chehab			- WriteThrough:
39234433332SMauro Carvalho Chehab					data is written to both the cache line
393246246cbSSudeep Holla					and to the block in the lower-level memory
39434433332SMauro Carvalho Chehab			- WriteBack:
39534433332SMauro Carvalho Chehab				     data is written only to the cache line and
396246246cbSSudeep Holla				     the modified cache line is written to main
397246246cbSSudeep Holla				     memory only when it is replaced
3981b028984SShilpasri G Bhat
3991d78dc59STony Luck
4001d78dc59STony LuckWhat:		/sys/devices/system/cpu/cpu*/cache/index*/id
4011d78dc59STony LuckDate:		September 2016
4021d78dc59STony LuckContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4031d78dc59STony LuckDescription:	Cache id
4041d78dc59STony Luck
4051d78dc59STony Luck		The id provides a unique number for a specific instance of
4061d78dc59STony Luck		a cache of a particular type. E.g. there may be a level
4071d78dc59STony Luck		3 unified cache on each socket in a server and we may
4081d78dc59STony Luck		assign them ids 0, 1, 2, ...
4091d78dc59STony Luck
4101d78dc59STony Luck		Note that id value can be non-contiguous. E.g. level 1
4111d78dc59STony Luck		caches typically exist per core, but there may not be a
4121d78dc59STony Luck		power of two cores on a socket, so these caches may be
4131d78dc59STony Luck		numbered 0, 1, 2, 3, 4, 5, 8, 9, 10, ...
4141d78dc59STony Luck
4151b028984SShilpasri G BhatWhat:		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats
4161b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat
4171b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat
4181b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle
4191b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap
4201b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp
4211b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault
4221b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent
4231b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset
4241b028984SShilpasri G BhatDate:		March 2016
4251b028984SShilpasri G BhatContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
426fae57306SStephen Rothwell		Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
4271b028984SShilpasri G BhatDescription:	POWERNV CPUFreq driver's frequency throttle stats directory and
4281b028984SShilpasri G Bhat		attributes
4291b028984SShilpasri G Bhat
4301b028984SShilpasri G Bhat		'cpuX/cpufreq/throttle_stats' directory contains the CPU frequency
4311b028984SShilpasri G Bhat		throttle stat attributes for the chip. The throttle stats of a cpu
4321b028984SShilpasri G Bhat		is common across all the cpus belonging to a chip. Below are the
4331b028984SShilpasri G Bhat		throttle attributes exported in the 'throttle_stats' directory:
4341b028984SShilpasri G Bhat
4351b028984SShilpasri G Bhat		- turbo_stat : This file gives the total number of times the max
4361b028984SShilpasri G Bhat		  frequency is throttled to lower frequency in turbo (at and above
4371b028984SShilpasri G Bhat		  nominal frequency) range of frequencies.
4381b028984SShilpasri G Bhat
4391b028984SShilpasri G Bhat		- sub_turbo_stat : This file gives the total number of times the
4401b028984SShilpasri G Bhat		  max frequency is throttled to lower frequency in sub-turbo(below
4411b028984SShilpasri G Bhat		  nominal frequency) range of frequencies.
4421b028984SShilpasri G Bhat
4431b028984SShilpasri G Bhat		- unthrottle : This file gives the total number of times the max
4441b028984SShilpasri G Bhat		  frequency is unthrottled after being throttled.
4451b028984SShilpasri G Bhat
4461b028984SShilpasri G Bhat		- powercap : This file gives the total number of times the max
4471b028984SShilpasri G Bhat		  frequency is throttled due to 'Power Capping'.
4481b028984SShilpasri G Bhat
4491b028984SShilpasri G Bhat		- overtemp : This file gives the total number of times the max
4501b028984SShilpasri G Bhat		  frequency is throttled due to 'CPU Over Temperature'.
4511b028984SShilpasri G Bhat
4521b028984SShilpasri G Bhat		- supply_fault : This file gives the total number of times the
4531b028984SShilpasri G Bhat		  max frequency is throttled due to 'Power Supply Failure'.
4541b028984SShilpasri G Bhat
4551b028984SShilpasri G Bhat		- overcurrent : This file gives the total number of times the
4561b028984SShilpasri G Bhat		  max frequency is throttled due to 'Overcurrent'.
4571b028984SShilpasri G Bhat
4581b028984SShilpasri G Bhat		- occ_reset : This file gives the total number of times the max
4591b028984SShilpasri G Bhat		  frequency is throttled due to 'OCC Reset'.
4601b028984SShilpasri G Bhat
4611b028984SShilpasri G Bhat		The sysfs attributes representing different throttle reasons like
4621b028984SShilpasri G Bhat		powercap, overtemp, supply_fault, overcurrent and occ_reset map to
4631b028984SShilpasri G Bhat		the reasons provided by OCC firmware for throttling the frequency.
4641b028984SShilpasri G Bhat
4651b028984SShilpasri G BhatWhat:		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats
4661b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat
4671b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat
4681b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle
4691b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap
4701b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp
4711b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault
4721b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent
4731b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset
4741b028984SShilpasri G BhatDate:		March 2016
4751b028984SShilpasri G BhatContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
476fae57306SStephen Rothwell		Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
4771b028984SShilpasri G BhatDescription:	POWERNV CPUFreq driver's frequency throttle stats directory and
4781b028984SShilpasri G Bhat		attributes
4791b028984SShilpasri G Bhat
4801b028984SShilpasri G Bhat		'policyX/throttle_stats' directory and all the attributes are same as
4811b028984SShilpasri G Bhat		the /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats directory and
4821b028984SShilpasri G Bhat		attributes which give the frequency throttle information of the chip.
483f8d9f924SSteve Capper
484f8d9f924SSteve CapperWhat:		/sys/devices/system/cpu/cpuX/regs/
485f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/
486f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/midr_el1
487f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/revidr_el1
488d69d5649SMark Brown		/sys/devices/system/cpu/cpuX/regs/identification/smidr_el1
489f8d9f924SSteve CapperDate:		June 2016
490f8d9f924SSteve CapperContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
491f8d9f924SSteve CapperDescription:	AArch64 CPU registers
49234433332SMauro Carvalho Chehab
493f8d9f924SSteve Capper		'identification' directory exposes the CPU ID registers for
494d69d5649SMark Brown		identifying model and revision of the CPU and SMCU.
495a2b60670SJuri Lelli
4967af33504SWill DeaconWhat:		/sys/devices/system/cpu/aarch32_el0
4977af33504SWill DeaconDate:		May 2021
4987af33504SWill DeaconContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
4997af33504SWill DeaconDescription:	Identifies the subset of CPUs in the system that can execute
5007af33504SWill Deacon		AArch32 (32-bit ARM) applications. If present, the same format as
5017af33504SWill Deacon		/sys/devices/system/cpu/{offline,online,possible,present} is used.
5027af33504SWill Deacon		If absent, then all or none of the CPUs can execute AArch32
5037af33504SWill Deacon		applications and execve() will behave accordingly.
5047af33504SWill Deacon
505abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpu_capacity
506a2b60670SJuri LelliDate:		December 2016
507a2b60670SJuri LelliContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
508a2b60670SJuri LelliDescription:	information about CPUs heterogeneity.
509a2b60670SJuri Lelli
510abcb948dSMauro Carvalho Chehab		cpu_capacity: capacity of cpuX.
51187590ce6SThomas Gleixner
51287590ce6SThomas GleixnerWhat:		/sys/devices/system/cpu/vulnerabilities
5138974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/gather_data_sampling
5148974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/itlb_multihit
515d90a7a0eSJiri Kosina		/sys/devices/system/cpu/vulnerabilities/l1tf
5168a4b06d3SThomas Gleixner		/sys/devices/system/cpu/vulnerabilities/mds
5178974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/meltdown
5188d50cdf8SPawan Gupta		/sys/devices/system/cpu/vulnerabilities/mmio_stale_data
5198076fcdeSPawan Gupta		/sys/devices/system/cpu/vulnerabilities/reg_file_data_sampling
52000da0cb3SSalvatore Bonaccorso		/sys/devices/system/cpu/vulnerabilities/retbleed
5218974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spec_store_bypass
5228974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spectre_v1
5238974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spectre_v2
5248974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/srbds
5258974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/tsx_async_abort
5269ecccfaaSDavid WoodhouseDate:		January 2018
52787590ce6SThomas GleixnerContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
52887590ce6SThomas GleixnerDescription:	Information about CPU vulnerabilities
52987590ce6SThomas Gleixner
53087590ce6SThomas Gleixner		The files are named after the code names of CPU
53187590ce6SThomas Gleixner		vulnerabilities. The output of those files reflects the
53287590ce6SThomas Gleixner		state of the CPUs in the system. Possible output values:
53387590ce6SThomas Gleixner
53434433332SMauro Carvalho Chehab		================  ==============================================
53587590ce6SThomas Gleixner		"Not affected"	  CPU is not affected by the vulnerability
53687590ce6SThomas Gleixner		"Vulnerable"	  CPU is affected and no mitigation in effect
5379ecccfaaSDavid Woodhouse		"Mitigation: $M"  CPU is affected and mitigation $M is in effect
53834433332SMauro Carvalho Chehab		================  ==============================================
53905736e4aSThomas Gleixner
5405999bbe7SThomas Gleixner		See also: Documentation/admin-guide/hw-vuln/index.rst
541d90a7a0eSJiri Kosina
54205736e4aSThomas GleixnerWhat:		/sys/devices/system/cpu/smt
54305736e4aSThomas Gleixner		/sys/devices/system/cpu/smt/active
54405736e4aSThomas Gleixner		/sys/devices/system/cpu/smt/control
54505736e4aSThomas GleixnerDate:		June 2018
54605736e4aSThomas GleixnerContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
5473e42d1deSCarlos BilbaoDescription:	Control Symmetric Multi Threading (SMT)
54805736e4aSThomas Gleixner
54905736e4aSThomas Gleixner		active:  Tells whether SMT is active (enabled and siblings online)
55005736e4aSThomas Gleixner
55105736e4aSThomas Gleixner		control: Read/write interface to control SMT. Possible
55205736e4aSThomas Gleixner			 values:
55305736e4aSThomas Gleixner
55434433332SMauro Carvalho Chehab			 ================ =========================================
55505736e4aSThomas Gleixner			 "on"		  SMT is enabled
55605736e4aSThomas Gleixner			 "off"		  SMT is disabled
5577f48405cSMichael Ellerman			 "<N>"		  SMT is enabled with N threads per core.
55805736e4aSThomas Gleixner			 "forceoff"	  SMT is force disabled. Cannot be changed.
55905736e4aSThomas Gleixner			 "notsupported"   SMT is not supported by the CPU
560de7b77e5SJosh Poimboeuf			 "notimplemented" SMT runtime toggling is not
561de7b77e5SJosh Poimboeuf					  implemented for the architecture
56234433332SMauro Carvalho Chehab			 ================ =========================================
56305736e4aSThomas Gleixner
56405736e4aSThomas Gleixner			 If control status is "forceoff" or "notsupported" writes
565*6c17ea1fSNysal Jan K.A			 are rejected. Note that enabling SMT on PowerPC skips
566*6c17ea1fSNysal Jan K.A			 offline cores.
567b9c273baSRafael J. Wysocki
568abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/power/energy_perf_bias
569b9c273baSRafael J. WysockiDate:		March 2019
570b9c273baSRafael J. WysockiContact:	linux-pm@vger.kernel.org
571b9c273baSRafael J. WysockiDescription:	Intel Energy and Performance Bias Hint (EPB)
572b9c273baSRafael J. Wysocki
573b9c273baSRafael J. Wysocki		EPB for the given CPU in a sliding scale 0 - 15, where a value
574b9c273baSRafael J. Wysocki		of 0 corresponds to a hint preference for highest performance
575b9c273baSRafael J. Wysocki		and a value of 15 corresponds to the maximum energy savings.
576b9c273baSRafael J. Wysocki
577b9c273baSRafael J. Wysocki		In order to change the EPB value for the CPU, write either
578b9c273baSRafael J. Wysocki		a number in the 0 - 15 sliding scale above, or one of the
579b9c273baSRafael J. Wysocki		strings: "performance", "balance-performance", "normal",
580b9c273baSRafael J. Wysocki		"balance-power", "power" (that represent values reflected by
581b9c273baSRafael J. Wysocki		their meaning), to this attribute.
582b9c273baSRafael J. Wysocki
583b9c273baSRafael J. Wysocki		This attribute is present for all online CPUs supporting the
584b9c273baSRafael J. Wysocki		Intel EPB feature.
585203dffacSFenghua Yu
586203dffacSFenghua YuWhat:		/sys/devices/system/cpu/umwait_control
587203dffacSFenghua Yu		/sys/devices/system/cpu/umwait_control/enable_c02
588203dffacSFenghua Yu		/sys/devices/system/cpu/umwait_control/max_time
589203dffacSFenghua YuDate:		May 2019
590203dffacSFenghua YuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
591203dffacSFenghua YuDescription:	Umwait control
592203dffacSFenghua Yu
593203dffacSFenghua Yu		enable_c02: Read/write interface to control umwait C0.2 state
594203dffacSFenghua Yu			Read returns C0.2 state status:
595203dffacSFenghua Yu				0: C0.2 is disabled
596203dffacSFenghua Yu				1: C0.2 is enabled
597203dffacSFenghua Yu
598203dffacSFenghua Yu			Write 'y' or '1'  or 'on' to enable C0.2 state.
599203dffacSFenghua Yu			Write 'n' or '0'  or 'off' to disable C0.2 state.
600203dffacSFenghua Yu
601203dffacSFenghua Yu			The interface is case insensitive.
602203dffacSFenghua Yu
603203dffacSFenghua Yu		max_time: Read/write interface to control umwait maximum time
604203dffacSFenghua Yu			  in TSC-quanta that the CPU can reside in either C0.1
605203dffacSFenghua Yu			  or C0.2 state. The time is an unsigned 32-bit number.
606203dffacSFenghua Yu			  Note that a value of zero means there is no limit.
607203dffacSFenghua Yu			  Low order two bits must be zero.
608734560acSRyan Grimm
60961564d34STom LendackyWhat:		/sys/devices/system/cpu/sev
61061564d34STom Lendacky		/sys/devices/system/cpu/sev/vmpl
61161564d34STom LendackyDate:		May 2024
61261564d34STom LendackyContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
61361564d34STom LendackyDescription:	Secure Encrypted Virtualization (SEV) information
61461564d34STom Lendacky
61561564d34STom Lendacky		This directory is only present when running as an SEV-SNP guest.
61661564d34STom Lendacky
61761564d34STom Lendacky		vmpl: Reports the Virtual Machine Privilege Level (VMPL) at which
61861564d34STom Lendacky		      the SEV-SNP guest is running.
61961564d34STom Lendacky
62061564d34STom Lendacky
621734560acSRyan GrimmWhat:		/sys/devices/system/cpu/svm
622734560acSRyan GrimmDate:		August 2019
623734560acSRyan GrimmContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
624fae57306SStephen Rothwell		Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
625734560acSRyan GrimmDescription:	Secure Virtual Machine
626734560acSRyan Grimm
627734560acSRyan Grimm		If 1, it means the system is using the Protected Execution
628734560acSRyan Grimm		Facility in POWER9 and newer processors. i.e., it is a Secure
629734560acSRyan Grimm		Virtual Machine.
630bde752c3SGautham R. Shenoy
631bde752c3SGautham R. ShenoyWhat:		/sys/devices/system/cpu/cpuX/purr
632bde752c3SGautham R. ShenoyDate:		Apr 2005
633fae57306SStephen RothwellContact:	Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
634bde752c3SGautham R. ShenoyDescription:	PURR ticks for this CPU since the system boot.
635bde752c3SGautham R. Shenoy
636bde752c3SGautham R. Shenoy		The Processor Utilization Resources Register (PURR) is
637bde752c3SGautham R. Shenoy		a 64-bit counter which provides an estimate of the
638bde752c3SGautham R. Shenoy		resources used by the CPU thread. The contents of this
639bde752c3SGautham R. Shenoy		register increases monotonically. This sysfs interface
640bde752c3SGautham R. Shenoy		exposes the number of PURR ticks for cpuX.
641bde752c3SGautham R. Shenoy
642bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/spurr
643bde752c3SGautham R. ShenoyDate:		Dec 2006
644fae57306SStephen RothwellContact:	Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
645bde752c3SGautham R. ShenoyDescription:	SPURR ticks for this CPU since the system boot.
646bde752c3SGautham R. Shenoy
647bde752c3SGautham R. Shenoy		The Scaled Processor Utilization Resources Register
648bde752c3SGautham R. Shenoy		(SPURR) is a 64-bit counter that provides a frequency
649bde752c3SGautham R. Shenoy		invariant estimate of the resources used by the CPU
650bde752c3SGautham R. Shenoy		thread. The contents of this register increases
651bde752c3SGautham R. Shenoy		monotonically. This sysfs interface exposes the number
652bde752c3SGautham R. Shenoy		of SPURR ticks for cpuX.
653bde752c3SGautham R. Shenoy
654bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/idle_purr
655bde752c3SGautham R. ShenoyDate:		Apr 2020
656fae57306SStephen RothwellContact:	Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
657bde752c3SGautham R. ShenoyDescription:	PURR ticks for cpuX when it was idle.
658bde752c3SGautham R. Shenoy
659bde752c3SGautham R. Shenoy		This sysfs interface exposes the number of PURR ticks
660bde752c3SGautham R. Shenoy		for cpuX when it was idle.
661bde752c3SGautham R. Shenoy
662bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/idle_spurr
663bde752c3SGautham R. ShenoyDate:		Apr 2020
664fae57306SStephen RothwellContact:	Linux for PowerPC mailing list <linuxppc-dev@lists.ozlabs.org>
665bde752c3SGautham R. ShenoyDescription:	SPURR ticks for cpuX when it was idle.
666bde752c3SGautham R. Shenoy
667bde752c3SGautham R. Shenoy		This sysfs interface exposes the number of SPURR ticks
668bde752c3SGautham R. Shenoy		for cpuX when it was idle.
66980c7c36fSPeter Collingbourne
67080c7c36fSPeter CollingbourneWhat: 		/sys/devices/system/cpu/cpuX/mte_tcf_preferred
67180c7c36fSPeter CollingbourneDate:		July 2021
67280c7c36fSPeter CollingbourneContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
67380c7c36fSPeter CollingbourneDescription:	Preferred MTE tag checking mode
67480c7c36fSPeter Collingbourne
67580c7c36fSPeter Collingbourne		When a user program specifies more than one MTE tag checking
67680c7c36fSPeter Collingbourne		mode, this sysfs node is used to specify which mode should
67780c7c36fSPeter Collingbourne		be preferred when scheduling a task on that CPU. Possible
67880c7c36fSPeter Collingbourne		values:
67980c7c36fSPeter Collingbourne
68080c7c36fSPeter Collingbourne		================  ==============================================
68180c7c36fSPeter Collingbourne		"sync"	  	  Prefer synchronous mode
6829986c765SEvgenii Stepanov		"asymm"	  	  Prefer asymmetric mode
68380c7c36fSPeter Collingbourne		"async"	  	  Prefer asynchronous mode
68480c7c36fSPeter Collingbourne		================  ==============================================
68580c7c36fSPeter Collingbourne
686e4624435SJonathan Corbet		See also: Documentation/arch/arm64/memory-tagging-extension.rst
6873722e7c3SKohei Tarumizu
6883722e7c3SKohei TarumizuWhat:		/sys/devices/system/cpu/nohz_full
6893722e7c3SKohei TarumizuDate:		Apr 2015
6903722e7c3SKohei TarumizuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
6913722e7c3SKohei TarumizuDescription:
6923722e7c3SKohei Tarumizu		(RO) the list of CPUs that are in nohz_full mode.
6933722e7c3SKohei Tarumizu		These CPUs are set by boot parameter "nohz_full=".
69402bf6074SKohei Tarumizu
69502bf6074SKohei TarumizuWhat:		/sys/devices/system/cpu/isolated
69602bf6074SKohei TarumizuDate:		Apr 2015
69702bf6074SKohei TarumizuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
69802bf6074SKohei TarumizuDescription:
69902bf6074SKohei Tarumizu		(RO) the list of CPUs that are isolated and don't
70002bf6074SKohei Tarumizu		participate in load balancing. These CPUs are set by
70102bf6074SKohei Tarumizu		boot parameter "isolcpus=".
70288a6f899SEric DeVolder
70388a6f899SEric DeVolderWhat:		/sys/devices/system/cpu/crash_hotplug
70488a6f899SEric DeVolderDate:		Aug 2023
70588a6f899SEric DeVolderContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
70688a6f899SEric DeVolderDescription:
70788a6f899SEric DeVolder		(RO) indicates whether or not the kernel updates relevant kexec
70888a6f899SEric DeVolder		segments on memory hot un/plug and/or on/offline events, avoiding the
70988a6f899SEric DeVolder		need to reload kdump kernel.
7104e1a7df4SJames Morse
7114e1a7df4SJames MorseWhat:		/sys/devices/system/cpu/enabled
7124e1a7df4SJames MorseDate:		Nov 2022
7134e1a7df4SJames MorseContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
7144e1a7df4SJames MorseDescription:
7154e1a7df4SJames Morse		(RO) the list of CPUs that can be brought online.
716