Documentation: ABI: /sys/devices/system/cpu/ topology files
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / Documentation / ABI / testing / sysfs-devices-system-cpu
blob871acdbeed1a3cfe7129276b0f30e5b28be68bb7
1 What:           /sys/devices/system/cpu/
2 Date:           pre-git history
3 Contact:        Linux kernel mailing list <linux-kernel@vger.kernel.org>
4 Description:
5                 A collection of both global and individual CPU attributes
7                 Individual CPU attributes are contained in subdirectories
8                 named by the kernel's logical CPU number, e.g.:
10                 /sys/devices/system/cpu/cpu#/
13 What:           /sys/devices/system/cpu/kernel_max
14                 /sys/devices/system/cpu/offline
15                 /sys/devices/system/cpu/online
16                 /sys/devices/system/cpu/possible
17                 /sys/devices/system/cpu/present
18 Date:           December 2008
19 Contact:        Linux kernel mailing list <linux-kernel@vger.kernel.org>
20 Description:    CPU topology files that describe kernel limits related to
21                 hotplug. Briefly:
23                 kernel_max: the maximum cpu index allowed by the kernel
24                 configuration.
26                 offline: cpus that are not online because they have been
27                 HOTPLUGGED off or exceed the limit of cpus allowed by the
28                 kernel configuration (kernel_max above).
30                 online: cpus that are online and being scheduled.
32                 possible: cpus that have been allocated resources and can be
33                 brought online if they are present.
35                 present: cpus that have been identified as being present in
36                 the system.
38                 See Documentation/cputopology.txt for more information.
41 What:      /sys/devices/system/cpu/cpu*/cache/index*/cache_disable_X
42 Date:      August 2008
43 KernelVersion:  2.6.27
44 Contact:        mark.langsdorf@amd.com
45 Description:    These files exist in every cpu's cache index directories.
46                 There are currently 2 cache_disable_# files in each
47                 directory.  Reading from these files on a supported
48                 processor will return that cache disable index value
49                 for that processor and node.  Writing to one of these
50                 files will cause the specificed cache index to be disabled.
52                 Currently, only AMD Family 10h Processors support cache index
53                 disable, and only for their L3 caches.  See the BIOS and
54                 Kernel Developer's Guide at
55                 http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/31116-Public-GH-BKDG_3.20_2-4-09.pdf
56                 for formatting information and other details on the
57                 cache index disable.
58 Users:    joachim.deguara@amd.com