xref: /linux/Documentation/ABI/stable/sysfs-devices-system-cpu (revision f81c2b81508c4f479f2cf1ac0dbb138927dc6188)
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/die_id
2805a463ecSTian TaoDescription:    the CPU die ID of cpuX. Typically it is the hardware platform's
2905a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
3005a463ecSTian Tao                architecture and platform dependent.
3105a463ecSTian TaoValues:         integer
3205a463ecSTian Tao
3305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/core_id
3405a463ecSTian TaoDescription:    the CPU core 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
39*c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_id
40*c5e22fefSJonathan CameronDescription:    the cluster ID of cpuX.  Typically it is the hardware platform's
41*c5e22fefSJonathan Cameron                identifier (rather than the kernel's). The actual value is
42*c5e22fefSJonathan Cameron                architecture and platform dependent.
43*c5e22fefSJonathan CameronValues:         integer
44*c5e22fefSJonathan Cameron
4505a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_id
4605a463ecSTian TaoDescription:    the book ID of cpuX. Typically it is the hardware platform's
4705a463ecSTian Tao                identifier (rather than the kernel's). The actual value is
4805a463ecSTian Tao                architecture and platform dependent. it's only used on s390.
4905a463ecSTian TaoValues:         integer
5005a463ecSTian Tao
5105a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_id
5205a463ecSTian TaoDescription:    the drawer 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/core_cpus
5805a463ecSTian TaoDescription:    internal kernel map of CPUs within the same core.
5905a463ecSTian Tao                (deprecated name: "thread_siblings")
6005a463ecSTian TaoValues:         hexadecimal bitmask.
6105a463ecSTian Tao
6205a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/core_cpus_list
6305a463ecSTian TaoDescription:    human-readable list of CPUs within the same core.
6405a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
6505a463ecSTian Tao                (deprecated name: "thread_siblings_list").
6605a463ecSTian TaoValues:         decimal list.
6705a463ecSTian Tao
6805a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/package_cpus
6905a463ecSTian TaoDescription:    internal kernel map of the CPUs sharing the same physical_package_id.
7005a463ecSTian Tao                (deprecated name: "core_siblings").
7105a463ecSTian TaoValues:         hexadecimal bitmask.
7205a463ecSTian Tao
7305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/package_cpus_list
7405a463ecSTian TaoDescription:    human-readable list of CPUs sharing the same physical_package_id.
7505a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
7605a463ecSTian Tao                (deprecated name: "core_siblings_list")
7705a463ecSTian TaoValues:         decimal list.
7805a463ecSTian Tao
7905a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/die_cpus
8005a463ecSTian TaoDescription:    internal kernel map of CPUs within the same die.
8105a463ecSTian TaoValues:         hexadecimal bitmask.
8205a463ecSTian Tao
8305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/die_cpus_list
8405a463ecSTian TaoDescription:    human-readable list of CPUs within the same die.
8505a463ecSTian Tao                The format is like 0-3, 8-11, 14,17.
8605a463ecSTian TaoValues:         decimal list.
8705a463ecSTian Tao
88*c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_cpus
89*c5e22fefSJonathan CameronDescription:    internal kernel map of CPUs within the same cluster.
90*c5e22fefSJonathan CameronValues:         hexadecimal bitmask.
91*c5e22fefSJonathan Cameron
92*c5e22fefSJonathan CameronWhat:           /sys/devices/system/cpu/cpuX/topology/cluster_cpus_list
93*c5e22fefSJonathan CameronDescription:    human-readable list of CPUs within the same cluster.
94*c5e22fefSJonathan Cameron                The format is like 0-3, 8-11, 14,17.
95*c5e22fefSJonathan CameronValues:         decimal list.
96*c5e22fefSJonathan Cameron
9705a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_siblings
9805a463ecSTian TaoDescription:    internal kernel map of cpuX's hardware threads within the same
9905a463ecSTian Tao                book_id. it's only used on s390.
10005a463ecSTian TaoValues:         hexadecimal bitmask.
10105a463ecSTian Tao
10205a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/book_siblings_list
10305a463ecSTian TaoDescription:    human-readable list of cpuX's hardware threads within the same
10405a463ecSTian Tao                book_id.
10505a463ecSTian Tao                The format is like 0-3, 8-11, 14,17. it's only used on s390.
10605a463ecSTian TaoValues:         decimal list.
10705a463ecSTian Tao
10805a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_siblings
10905a463ecSTian TaoDescription:    internal kernel map of cpuX's hardware threads within the same
11005a463ecSTian Tao                drawer_id. it's only used on s390.
11105a463ecSTian TaoValues:         hexadecimal bitmask.
11205a463ecSTian Tao
11305a463ecSTian TaoWhat:           /sys/devices/system/cpu/cpuX/topology/drawer_siblings_list
11405a463ecSTian TaoDescription:    human-readable list of cpuX's hardware threads within the same
11505a463ecSTian Tao                drawer_id.
11605a463ecSTian Tao                The format is like 0-3, 8-11, 14,17. it's only used on s390.
11705a463ecSTian TaoValues:         decimal list.
118