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		attributes:
35834433332SMauro Carvalho Chehab			    LEGACY used only on IA64 and is same as write_policy
359246246cbSSudeep Holla
36034433332SMauro Carvalho Chehab		coherency_line_size:
36134433332SMauro Carvalho Chehab				     the minimum amount of data in bytes that gets
362246246cbSSudeep Holla				     transferred from memory to cache
363246246cbSSudeep Holla
36434433332SMauro Carvalho Chehab		level:
36534433332SMauro Carvalho Chehab			the cache hierarchy in the multi-level cache configuration
366246246cbSSudeep Holla
36734433332SMauro Carvalho Chehab		number_of_sets:
36834433332SMauro Carvalho Chehab				total number of sets in the cache, a set is a
369246246cbSSudeep Holla				collection of cache lines with the same cache index
370246246cbSSudeep Holla
37134433332SMauro Carvalho Chehab		physical_line_partition:
37234433332SMauro Carvalho Chehab				number of physical cache line per cache tag
373246246cbSSudeep Holla
37434433332SMauro Carvalho Chehab		shared_cpu_list:
37534433332SMauro Carvalho Chehab				the list of logical cpus sharing the cache
376246246cbSSudeep Holla
37734433332SMauro Carvalho Chehab		shared_cpu_map:
37834433332SMauro Carvalho Chehab				logical cpu mask containing the list of cpus sharing
379246246cbSSudeep Holla				the cache
380246246cbSSudeep Holla
38134433332SMauro Carvalho Chehab		size:
38234433332SMauro Carvalho Chehab			the total cache size in kB
383246246cbSSudeep Holla
384246246cbSSudeep Holla		type:
385246246cbSSudeep Holla			- Instruction: cache that only holds instructions
386246246cbSSudeep Holla			- Data: cache that only caches data
387246246cbSSudeep Holla			- Unified: cache that holds both data and instructions
388246246cbSSudeep Holla
38934433332SMauro Carvalho Chehab		ways_of_associativity:
39034433332SMauro Carvalho Chehab			degree of freedom in placing a particular block
391246246cbSSudeep Holla			of memory in the cache
392246246cbSSudeep Holla
393246246cbSSudeep Holla		write_policy:
39434433332SMauro Carvalho Chehab			- WriteThrough:
39534433332SMauro Carvalho Chehab					data is written to both the cache line
396246246cbSSudeep Holla					and to the block in the lower-level memory
39734433332SMauro Carvalho Chehab			- WriteBack:
39834433332SMauro Carvalho Chehab				     data is written only to the cache line and
399246246cbSSudeep Holla				     the modified cache line is written to main
400246246cbSSudeep Holla				     memory only when it is replaced
4011b028984SShilpasri G Bhat
4021d78dc59STony Luck
4031d78dc59STony LuckWhat:		/sys/devices/system/cpu/cpu*/cache/index*/id
4041d78dc59STony LuckDate:		September 2016
4051d78dc59STony LuckContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4061d78dc59STony LuckDescription:	Cache id
4071d78dc59STony Luck
4081d78dc59STony Luck		The id provides a unique number for a specific instance of
4091d78dc59STony Luck		a cache of a particular type. E.g. there may be a level
4101d78dc59STony Luck		3 unified cache on each socket in a server and we may
4111d78dc59STony Luck		assign them ids 0, 1, 2, ...
4121d78dc59STony Luck
4131d78dc59STony Luck		Note that id value can be non-contiguous. E.g. level 1
4141d78dc59STony Luck		caches typically exist per core, but there may not be a
4151d78dc59STony Luck		power of two cores on a socket, so these caches may be
4161d78dc59STony Luck		numbered 0, 1, 2, 3, 4, 5, 8, 9, 10, ...
4171d78dc59STony Luck
4181b028984SShilpasri G BhatWhat:		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats
4191b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat
4201b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat
4211b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle
4221b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap
4231b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp
4241b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault
4251b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent
4261b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset
4271b028984SShilpasri G BhatDate:		March 2016
4281b028984SShilpasri G BhatContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4291b028984SShilpasri G Bhat		Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
4301b028984SShilpasri G BhatDescription:	POWERNV CPUFreq driver's frequency throttle stats directory and
4311b028984SShilpasri G Bhat		attributes
4321b028984SShilpasri G Bhat
4331b028984SShilpasri G Bhat		'cpuX/cpufreq/throttle_stats' directory contains the CPU frequency
4341b028984SShilpasri G Bhat		throttle stat attributes for the chip. The throttle stats of a cpu
4351b028984SShilpasri G Bhat		is common across all the cpus belonging to a chip. Below are the
4361b028984SShilpasri G Bhat		throttle attributes exported in the 'throttle_stats' directory:
4371b028984SShilpasri G Bhat
4381b028984SShilpasri G Bhat		- turbo_stat : This file gives the total number of times the max
4391b028984SShilpasri G Bhat		  frequency is throttled to lower frequency in turbo (at and above
4401b028984SShilpasri G Bhat		  nominal frequency) range of frequencies.
4411b028984SShilpasri G Bhat
4421b028984SShilpasri G Bhat		- sub_turbo_stat : This file gives the total number of times the
4431b028984SShilpasri G Bhat		  max frequency is throttled to lower frequency in sub-turbo(below
4441b028984SShilpasri G Bhat		  nominal frequency) range of frequencies.
4451b028984SShilpasri G Bhat
4461b028984SShilpasri G Bhat		- unthrottle : This file gives the total number of times the max
4471b028984SShilpasri G Bhat		  frequency is unthrottled after being throttled.
4481b028984SShilpasri G Bhat
4491b028984SShilpasri G Bhat		- powercap : This file gives the total number of times the max
4501b028984SShilpasri G Bhat		  frequency is throttled due to 'Power Capping'.
4511b028984SShilpasri G Bhat
4521b028984SShilpasri G Bhat		- overtemp : This file gives the total number of times the max
4531b028984SShilpasri G Bhat		  frequency is throttled due to 'CPU Over Temperature'.
4541b028984SShilpasri G Bhat
4551b028984SShilpasri G Bhat		- supply_fault : This file gives the total number of times the
4561b028984SShilpasri G Bhat		  max frequency is throttled due to 'Power Supply Failure'.
4571b028984SShilpasri G Bhat
4581b028984SShilpasri G Bhat		- overcurrent : This file gives the total number of times the
4591b028984SShilpasri G Bhat		  max frequency is throttled due to 'Overcurrent'.
4601b028984SShilpasri G Bhat
4611b028984SShilpasri G Bhat		- occ_reset : This file gives the total number of times the max
4621b028984SShilpasri G Bhat		  frequency is throttled due to 'OCC Reset'.
4631b028984SShilpasri G Bhat
4641b028984SShilpasri G Bhat		The sysfs attributes representing different throttle reasons like
4651b028984SShilpasri G Bhat		powercap, overtemp, supply_fault, overcurrent and occ_reset map to
4661b028984SShilpasri G Bhat		the reasons provided by OCC firmware for throttling the frequency.
4671b028984SShilpasri G Bhat
4681b028984SShilpasri G BhatWhat:		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats
4691b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat
4701b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat
4711b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle
4721b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap
4731b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp
4741b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault
4751b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent
4761b028984SShilpasri G Bhat		/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset
4771b028984SShilpasri G BhatDate:		March 2016
4781b028984SShilpasri G BhatContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4791b028984SShilpasri G Bhat		Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
4801b028984SShilpasri G BhatDescription:	POWERNV CPUFreq driver's frequency throttle stats directory and
4811b028984SShilpasri G Bhat		attributes
4821b028984SShilpasri G Bhat
4831b028984SShilpasri G Bhat		'policyX/throttle_stats' directory and all the attributes are same as
4841b028984SShilpasri G Bhat		the /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats directory and
4851b028984SShilpasri G Bhat		attributes which give the frequency throttle information of the chip.
486f8d9f924SSteve Capper
487f8d9f924SSteve CapperWhat:		/sys/devices/system/cpu/cpuX/regs/
488f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/
489f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/midr_el1
490f8d9f924SSteve Capper		/sys/devices/system/cpu/cpuX/regs/identification/revidr_el1
491d69d5649SMark Brown		/sys/devices/system/cpu/cpuX/regs/identification/smidr_el1
492f8d9f924SSteve CapperDate:		June 2016
493f8d9f924SSteve CapperContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
494f8d9f924SSteve CapperDescription:	AArch64 CPU registers
49534433332SMauro Carvalho Chehab
496f8d9f924SSteve Capper		'identification' directory exposes the CPU ID registers for
497d69d5649SMark Brown		identifying model and revision of the CPU and SMCU.
498a2b60670SJuri Lelli
4997af33504SWill DeaconWhat:		/sys/devices/system/cpu/aarch32_el0
5007af33504SWill DeaconDate:		May 2021
5017af33504SWill DeaconContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
5027af33504SWill DeaconDescription:	Identifies the subset of CPUs in the system that can execute
5037af33504SWill Deacon		AArch32 (32-bit ARM) applications. If present, the same format as
5047af33504SWill Deacon		/sys/devices/system/cpu/{offline,online,possible,present} is used.
5057af33504SWill Deacon		If absent, then all or none of the CPUs can execute AArch32
5067af33504SWill Deacon		applications and execve() will behave accordingly.
5077af33504SWill Deacon
508abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/cpu_capacity
509a2b60670SJuri LelliDate:		December 2016
510a2b60670SJuri LelliContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
511a2b60670SJuri LelliDescription:	information about CPUs heterogeneity.
512a2b60670SJuri Lelli
513abcb948dSMauro Carvalho Chehab		cpu_capacity: capacity of cpuX.
51487590ce6SThomas Gleixner
51587590ce6SThomas GleixnerWhat:		/sys/devices/system/cpu/vulnerabilities
5168974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/gather_data_sampling
5178974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/itlb_multihit
518d90a7a0eSJiri Kosina		/sys/devices/system/cpu/vulnerabilities/l1tf
5198a4b06d3SThomas Gleixner		/sys/devices/system/cpu/vulnerabilities/mds
5208974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/meltdown
5218d50cdf8SPawan Gupta		/sys/devices/system/cpu/vulnerabilities/mmio_stale_data
522*77018fb9SPawan Gupta		/sys/devices/system/cpu/vulnerabilities/reg_file_data_sampling
52300da0cb3SSalvatore Bonaccorso		/sys/devices/system/cpu/vulnerabilities/retbleed
5248974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spec_store_bypass
5258974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spectre_v1
5268974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/spectre_v2
5278974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/srbds
5288974eb58SDaniel Sneddon		/sys/devices/system/cpu/vulnerabilities/tsx_async_abort
5299ecccfaaSDavid WoodhouseDate:		January 2018
53087590ce6SThomas GleixnerContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
53187590ce6SThomas GleixnerDescription:	Information about CPU vulnerabilities
53287590ce6SThomas Gleixner
53387590ce6SThomas Gleixner		The files are named after the code names of CPU
53487590ce6SThomas Gleixner		vulnerabilities. The output of those files reflects the
53587590ce6SThomas Gleixner		state of the CPUs in the system. Possible output values:
53687590ce6SThomas Gleixner
53734433332SMauro Carvalho Chehab		================  ==============================================
53887590ce6SThomas Gleixner		"Not affected"	  CPU is not affected by the vulnerability
53987590ce6SThomas Gleixner		"Vulnerable"	  CPU is affected and no mitigation in effect
5409ecccfaaSDavid Woodhouse		"Mitigation: $M"  CPU is affected and mitigation $M is in effect
54134433332SMauro Carvalho Chehab		================  ==============================================
54205736e4aSThomas Gleixner
5435999bbe7SThomas Gleixner		See also: Documentation/admin-guide/hw-vuln/index.rst
544d90a7a0eSJiri Kosina
54505736e4aSThomas GleixnerWhat:		/sys/devices/system/cpu/smt
54605736e4aSThomas Gleixner		/sys/devices/system/cpu/smt/active
54705736e4aSThomas Gleixner		/sys/devices/system/cpu/smt/control
54805736e4aSThomas GleixnerDate:		June 2018
54905736e4aSThomas GleixnerContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
5503e42d1deSCarlos BilbaoDescription:	Control Symmetric Multi Threading (SMT)
55105736e4aSThomas Gleixner
55205736e4aSThomas Gleixner		active:  Tells whether SMT is active (enabled and siblings online)
55305736e4aSThomas Gleixner
55405736e4aSThomas Gleixner		control: Read/write interface to control SMT. Possible
55505736e4aSThomas Gleixner			 values:
55605736e4aSThomas Gleixner
55734433332SMauro Carvalho Chehab			 ================ =========================================
55805736e4aSThomas Gleixner			 "on"		  SMT is enabled
55905736e4aSThomas Gleixner			 "off"		  SMT is disabled
5607f48405cSMichael Ellerman			 "<N>"		  SMT is enabled with N threads per core.
56105736e4aSThomas Gleixner			 "forceoff"	  SMT is force disabled. Cannot be changed.
56205736e4aSThomas Gleixner			 "notsupported"   SMT is not supported by the CPU
563de7b77e5SJosh Poimboeuf			 "notimplemented" SMT runtime toggling is not
564de7b77e5SJosh Poimboeuf					  implemented for the architecture
56534433332SMauro Carvalho Chehab			 ================ =========================================
56605736e4aSThomas Gleixner
56705736e4aSThomas Gleixner			 If control status is "forceoff" or "notsupported" writes
56805736e4aSThomas Gleixner			 are rejected.
569b9c273baSRafael J. Wysocki
570abcb948dSMauro Carvalho ChehabWhat:		/sys/devices/system/cpu/cpuX/power/energy_perf_bias
571b9c273baSRafael J. WysockiDate:		March 2019
572b9c273baSRafael J. WysockiContact:	linux-pm@vger.kernel.org
573b9c273baSRafael J. WysockiDescription:	Intel Energy and Performance Bias Hint (EPB)
574b9c273baSRafael J. Wysocki
575b9c273baSRafael J. Wysocki		EPB for the given CPU in a sliding scale 0 - 15, where a value
576b9c273baSRafael J. Wysocki		of 0 corresponds to a hint preference for highest performance
577b9c273baSRafael J. Wysocki		and a value of 15 corresponds to the maximum energy savings.
578b9c273baSRafael J. Wysocki
579b9c273baSRafael J. Wysocki		In order to change the EPB value for the CPU, write either
580b9c273baSRafael J. Wysocki		a number in the 0 - 15 sliding scale above, or one of the
581b9c273baSRafael J. Wysocki		strings: "performance", "balance-performance", "normal",
582b9c273baSRafael J. Wysocki		"balance-power", "power" (that represent values reflected by
583b9c273baSRafael J. Wysocki		their meaning), to this attribute.
584b9c273baSRafael J. Wysocki
585b9c273baSRafael J. Wysocki		This attribute is present for all online CPUs supporting the
586b9c273baSRafael J. Wysocki		Intel EPB feature.
587203dffacSFenghua Yu
588203dffacSFenghua YuWhat:		/sys/devices/system/cpu/umwait_control
589203dffacSFenghua Yu		/sys/devices/system/cpu/umwait_control/enable_c02
590203dffacSFenghua Yu		/sys/devices/system/cpu/umwait_control/max_time
591203dffacSFenghua YuDate:		May 2019
592203dffacSFenghua YuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
593203dffacSFenghua YuDescription:	Umwait control
594203dffacSFenghua Yu
595203dffacSFenghua Yu		enable_c02: Read/write interface to control umwait C0.2 state
596203dffacSFenghua Yu			Read returns C0.2 state status:
597203dffacSFenghua Yu				0: C0.2 is disabled
598203dffacSFenghua Yu				1: C0.2 is enabled
599203dffacSFenghua Yu
600203dffacSFenghua Yu			Write 'y' or '1'  or 'on' to enable C0.2 state.
601203dffacSFenghua Yu			Write 'n' or '0'  or 'off' to disable C0.2 state.
602203dffacSFenghua Yu
603203dffacSFenghua Yu			The interface is case insensitive.
604203dffacSFenghua Yu
605203dffacSFenghua Yu		max_time: Read/write interface to control umwait maximum time
606203dffacSFenghua Yu			  in TSC-quanta that the CPU can reside in either C0.1
607203dffacSFenghua Yu			  or C0.2 state. The time is an unsigned 32-bit number.
608203dffacSFenghua Yu			  Note that a value of zero means there is no limit.
609203dffacSFenghua Yu			  Low order two bits must be zero.
610734560acSRyan Grimm
611734560acSRyan GrimmWhat:		/sys/devices/system/cpu/svm
612734560acSRyan GrimmDate:		August 2019
613734560acSRyan GrimmContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
614734560acSRyan Grimm		Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
615734560acSRyan GrimmDescription:	Secure Virtual Machine
616734560acSRyan Grimm
617734560acSRyan Grimm		If 1, it means the system is using the Protected Execution
618734560acSRyan Grimm		Facility in POWER9 and newer processors. i.e., it is a Secure
619734560acSRyan Grimm		Virtual Machine.
620bde752c3SGautham R. Shenoy
621bde752c3SGautham R. ShenoyWhat:		/sys/devices/system/cpu/cpuX/purr
622bde752c3SGautham R. ShenoyDate:		Apr 2005
623bde752c3SGautham R. ShenoyContact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
624bde752c3SGautham R. ShenoyDescription:	PURR ticks for this CPU since the system boot.
625bde752c3SGautham R. Shenoy
626bde752c3SGautham R. Shenoy		The Processor Utilization Resources Register (PURR) is
627bde752c3SGautham R. Shenoy		a 64-bit counter which provides an estimate of the
628bde752c3SGautham R. Shenoy		resources used by the CPU thread. The contents of this
629bde752c3SGautham R. Shenoy		register increases monotonically. This sysfs interface
630bde752c3SGautham R. Shenoy		exposes the number of PURR ticks for cpuX.
631bde752c3SGautham R. Shenoy
632bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/spurr
633bde752c3SGautham R. ShenoyDate:		Dec 2006
634bde752c3SGautham R. ShenoyContact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
635bde752c3SGautham R. ShenoyDescription:	SPURR ticks for this CPU since the system boot.
636bde752c3SGautham R. Shenoy
637bde752c3SGautham R. Shenoy		The Scaled Processor Utilization Resources Register
638bde752c3SGautham R. Shenoy		(SPURR) is a 64-bit counter that provides a frequency
639bde752c3SGautham R. Shenoy		invariant estimate of the resources used by the CPU
640bde752c3SGautham R. Shenoy		thread. The contents of this register increases
641bde752c3SGautham R. Shenoy		monotonically. This sysfs interface exposes the number
642bde752c3SGautham R. Shenoy		of SPURR ticks for cpuX.
643bde752c3SGautham R. Shenoy
644bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/idle_purr
645bde752c3SGautham R. ShenoyDate:		Apr 2020
646bde752c3SGautham R. ShenoyContact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
647bde752c3SGautham R. ShenoyDescription:	PURR ticks for cpuX when it was idle.
648bde752c3SGautham R. Shenoy
649bde752c3SGautham R. Shenoy		This sysfs interface exposes the number of PURR ticks
650bde752c3SGautham R. Shenoy		for cpuX when it was idle.
651bde752c3SGautham R. Shenoy
652bde752c3SGautham R. ShenoyWhat: 		/sys/devices/system/cpu/cpuX/idle_spurr
653bde752c3SGautham R. ShenoyDate:		Apr 2020
654bde752c3SGautham R. ShenoyContact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
655bde752c3SGautham R. ShenoyDescription:	SPURR ticks for cpuX when it was idle.
656bde752c3SGautham R. Shenoy
657bde752c3SGautham R. Shenoy		This sysfs interface exposes the number of SPURR ticks
658bde752c3SGautham R. Shenoy		for cpuX when it was idle.
65980c7c36fSPeter Collingbourne
66080c7c36fSPeter CollingbourneWhat: 		/sys/devices/system/cpu/cpuX/mte_tcf_preferred
66180c7c36fSPeter CollingbourneDate:		July 2021
66280c7c36fSPeter CollingbourneContact:	Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
66380c7c36fSPeter CollingbourneDescription:	Preferred MTE tag checking mode
66480c7c36fSPeter Collingbourne
66580c7c36fSPeter Collingbourne		When a user program specifies more than one MTE tag checking
66680c7c36fSPeter Collingbourne		mode, this sysfs node is used to specify which mode should
66780c7c36fSPeter Collingbourne		be preferred when scheduling a task on that CPU. Possible
66880c7c36fSPeter Collingbourne		values:
66980c7c36fSPeter Collingbourne
67080c7c36fSPeter Collingbourne		================  ==============================================
67180c7c36fSPeter Collingbourne		"sync"	  	  Prefer synchronous mode
6729986c765SEvgenii Stepanov		"asymm"	  	  Prefer asymmetric mode
67380c7c36fSPeter Collingbourne		"async"	  	  Prefer asynchronous mode
67480c7c36fSPeter Collingbourne		================  ==============================================
67580c7c36fSPeter Collingbourne
676e4624435SJonathan Corbet		See also: Documentation/arch/arm64/memory-tagging-extension.rst
6773722e7c3SKohei Tarumizu
6783722e7c3SKohei TarumizuWhat:		/sys/devices/system/cpu/nohz_full
6793722e7c3SKohei TarumizuDate:		Apr 2015
6803722e7c3SKohei TarumizuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
6813722e7c3SKohei TarumizuDescription:
6823722e7c3SKohei Tarumizu		(RO) the list of CPUs that are in nohz_full mode.
6833722e7c3SKohei Tarumizu		These CPUs are set by boot parameter "nohz_full=".
68402bf6074SKohei Tarumizu
68502bf6074SKohei TarumizuWhat:		/sys/devices/system/cpu/isolated
68602bf6074SKohei TarumizuDate:		Apr 2015
68702bf6074SKohei TarumizuContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
68802bf6074SKohei TarumizuDescription:
68902bf6074SKohei Tarumizu		(RO) the list of CPUs that are isolated and don't
69002bf6074SKohei Tarumizu		participate in load balancing. These CPUs are set by
69102bf6074SKohei Tarumizu		boot parameter "isolcpus=".
69288a6f899SEric DeVolder
69388a6f899SEric DeVolderWhat:		/sys/devices/system/cpu/crash_hotplug
69488a6f899SEric DeVolderDate:		Aug 2023
69588a6f899SEric DeVolderContact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
69688a6f899SEric DeVolderDescription:
69788a6f899SEric DeVolder		(RO) indicates whether or not the kernel directly supports
69888a6f899SEric DeVolder		modifying the crash elfcorehdr for CPU hot un/plug and/or
69988a6f899SEric DeVolder		on/offline changes.
700