xref: /openbmc/linux/Documentation/ABI/stable/sysfs-devices-system-cpu (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
126c88f93SSam bobroffWhat: 		/sys/devices/system/cpu/dscr_default
226c88f93SSam bobroffDate:		13-May-2014
326c88f93SSam bobroffKernelVersion:	v3.15.0
426c88f93SSam bobroffContact:
526c88f93SSam bobroffDescription:	Writes are equivalent to writing to
626c88f93SSam bobroff		/sys/devices/system/cpu/cpuN/dscr on all CPUs.
726c88f93SSam bobroff		Reads return the last written value or 0.
826c88f93SSam bobroff		This value is not a global default: it is a way to set
926c88f93SSam bobroff		all per-CPU defaults at the same time.
1026c88f93SSam bobroffValues:		64 bit unsigned integer (bit field)
1126c88f93SSam bobroff
1226c88f93SSam bobroffWhat: 		/sys/devices/system/cpu/cpu[0-9]+/dscr
1326c88f93SSam bobroffDate:		13-May-2014
1426c88f93SSam bobroffKernelVersion:	v3.15.0
1526c88f93SSam bobroffContact:
1626c88f93SSam bobroffDescription:	Default value for the Data Stream Control Register (DSCR) on
1726c88f93SSam bobroff		a CPU.
1826c88f93SSam bobroff		This default value is used when the kernel is executing and
1926c88f93SSam bobroff		for any process that has not set the DSCR itself.
2026c88f93SSam bobroff		If a process ever sets the DSCR (via direct access to the
2126c88f93SSam bobroff		SPR) that value will be persisted for that process and used
2226c88f93SSam bobroff		on any CPU where it executes (overriding the value described
2326c88f93SSam bobroff		here).
2426c88f93SSam bobroff		If set by a process it will be inherited by child processes.
2526c88f93SSam bobroffValues:		64 bit unsigned integer (bit field)
2605a463ecSTian Tao
2705a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/physical_package_id
2805a463ecSTian TaoDescription:    physical package id of cpuX. Typically corresponds to a physical
2905a463ecSTian Tao                socket number, but the actual value is architecture and platform
3005a463ecSTian Tao                dependent.
3105a463ecSTian TaoValues:         integer
3205a463ecSTian Tao
3305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/die_id
3405a463ecSTian TaoDescription:    the CPU die ID of cpuX. Typically it is the hardware platform's
3505a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
3605a463ecSTian Tao                architecture and platform dependent.
3705a463ecSTian TaoValues:         integer
3805a463ecSTian Tao
3905a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/core_id
4005a463ecSTian TaoDescription:    the CPU core ID of cpuX. Typically it is the hardware platform's
4105a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
4205a463ecSTian Tao                architecture and platform dependent.
4305a463ecSTian TaoValues:         integer
4405a463ecSTian Tao
45c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_id
46c5e22fefSJonathan CameronDescription:    the cluster ID of cpuX.  Typically it is the hardware platform's
47c5e22fefSJonathan Cameron                identifier (rather than the kernel's). The actual value is
48c5e22fefSJonathan Cameron                architecture and platform dependent.
49c5e22fefSJonathan CameronValues:         integer
50c5e22fefSJonathan Cameron
5105a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_id
5205a463ecSTian TaoDescription:    the book ID of cpuX. Typically it is the hardware platform's
5305a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
5405a463ecSTian Tao                architecture and platform dependent. it's only used on s390.
5505a463ecSTian TaoValues:         integer
5605a463ecSTian Tao
5705a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_id
5805a463ecSTian TaoDescription:    the drawer ID of cpuX. Typically it is the hardware platform's
5905a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
6005a463ecSTian Tao                architecture and platform dependent. it's only used on s390.
6105a463ecSTian TaoValues:         integer
6205a463ecSTian Tao
6305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/core_cpus
6405a463ecSTian TaoDescription:    internal kernel map of CPUs within the same core.
6505a463ecSTian Tao                (deprecated name: "thread_siblings")
6605a463ecSTian TaoValues:         hexadecimal bitmask.
6705a463ecSTian Tao
6805a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/core_cpus_list
6905a463ecSTian TaoDescription:    human-readable list of CPUs within the same core.
7005a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
7105a463ecSTian Tao                (deprecated name: "thread_siblings_list").
7205a463ecSTian TaoValues:         decimal list.
7305a463ecSTian Tao
7405a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/package_cpus
7505a463ecSTian TaoDescription:    internal kernel map of the CPUs sharing the same physical_package_id.
7605a463ecSTian Tao                (deprecated name: "core_siblings").
7705a463ecSTian TaoValues:         hexadecimal bitmask.
7805a463ecSTian Tao
7905a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/package_cpus_list
8005a463ecSTian TaoDescription:    human-readable list of CPUs sharing the same physical_package_id.
8105a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
8205a463ecSTian Tao                (deprecated name: "core_siblings_list")
8305a463ecSTian TaoValues:         decimal list.
8405a463ecSTian Tao
8505a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/die_cpus
8605a463ecSTian TaoDescription:    internal kernel map of CPUs within the same die.
8705a463ecSTian TaoValues:         hexadecimal bitmask.
8805a463ecSTian Tao
89*ab28e944STony LuckWhat:           /sys/devices/system/cpu/cpuX/topology/ppin
90*ab28e944STony LuckDescription:    per-socket protected processor inventory number
91*ab28e944STony LuckValues:         hexadecimal.
92*ab28e944STony Luck
9305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/die_cpus_list
9405a463ecSTian TaoDescription:    human-readable list of CPUs within the same die.
9505a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
9605a463ecSTian TaoValues:         decimal list.
9705a463ecSTian Tao
98c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_cpus
99c5e22fefSJonathan CameronDescription:    internal kernel map of CPUs within the same cluster.
100c5e22fefSJonathan CameronValues:         hexadecimal bitmask.
101c5e22fefSJonathan Cameron
102c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_cpus_list
103c5e22fefSJonathan CameronDescription:    human-readable list of CPUs within the same cluster.
104c5e22fefSJonathan Cameron                The format is like 0-3, 8-11, 14,17.
105c5e22fefSJonathan CameronValues:         decimal list.
106c5e22fefSJonathan Cameron
10705a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_siblings
10805a463ecSTian TaoDescription:    internal kernel map of cpuX's hardware threads within the same
10905a463ecSTian Tao                book_id. it's only used on s390.
11005a463ecSTian TaoValues:         hexadecimal bitmask.
11105a463ecSTian Tao
11205a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_siblings_list
11305a463ecSTian TaoDescription:    human-readable list of cpuX's hardware threads within the same
11405a463ecSTian Tao                book_id.
11505a463ecSTian Tao                The format is like 0-3, 8-11, 14,17. it's only used on s390.
11605a463ecSTian TaoValues:         decimal list.
11705a463ecSTian Tao
11805a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_siblings
11905a463ecSTian TaoDescription:    internal kernel map of cpuX's hardware threads within the same
12005a463ecSTian Tao                drawer_id. it's only used on s390.
12105a463ecSTian TaoValues:         hexadecimal bitmask.
12205a463ecSTian Tao
12305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_siblings_list
12405a463ecSTian TaoDescription:    human-readable list of cpuX's hardware threads within the same
12505a463ecSTian Tao                drawer_id.
12605a463ecSTian Tao                The format is like 0-3, 8-11, 14,17. it's only used on s390.
12705a463ecSTian TaoValues:         decimal list.
128