Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

topology: Create package_cpus sysfs attribute

The existing sysfs cpu/topology/core_siblings (and core_siblings_list)
attributes are documented, implemented, and used by programs to represent
set of logical CPUs sharing the same package.

This makes sense if the next topology level above a core is always a
package. But on systems where there is a die topology level between a core
and a package, the name and its definition become inconsistent.

So without changing its function, add a name for this map that describes
what it actually is -- package CPUs -- the set of CPUs that share the same
package.

This new name will be immune to changes in topology, since it describes
threads at the current level, not siblings at a contained level.

Suggested-by: Brice Goglin <Brice.Goglin@inria.fr>
Signed-off-by: Len Brown <len.brown@intel.com>
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Reviewed-by: Ingo Molnar <mingo@kernel.org>
Acked-by: Peter Zijlstra (Intel) <peterz@infradead.org>
Link: https://lkml.kernel.org/r/d9d3228b82fb5665e6f93a0ccd033fe022558521.1557769318.git.len.brown@intel.com

authored by

Len Brown and committed by
Thomas Gleixner
b73ed8dc cfcd82e6

+12 -6
+6 -6
Documentation/cputopology.txt
··· 46 46 human-readable list of cpuX's hardware threads within the same 47 47 core as cpuX. 48 48 49 - core_siblings: 49 + package_cpus: 50 50 51 - internal kernel map of cpuX's hardware threads within the same 52 - physical_package_id. 51 + internal kernel map of the CPUs sharing the same physical_package_id. 52 + (deprecated name: "core_siblings") 53 53 54 - core_siblings_list: 54 + package_cpus_list: 55 55 56 - human-readable list of cpuX's hardware threads within the same 57 - physical_package_id. 56 + human-readable list of CPUs sharing the same physical_package_id. 57 + (deprecated name: "core_siblings_list") 58 58 59 59 book_siblings: 60 60
+6
drivers/base/topology.c
··· 57 57 static DEVICE_ATTR_RO(core_siblings); 58 58 static DEVICE_ATTR_RO(core_siblings_list); 59 59 60 + define_siblings_show_func(package_cpus, core_cpumask); 61 + static DEVICE_ATTR_RO(package_cpus); 62 + static DEVICE_ATTR_RO(package_cpus_list); 63 + 60 64 #ifdef CONFIG_SCHED_BOOK 61 65 define_id_show_func(book_id); 62 66 static DEVICE_ATTR_RO(book_id); ··· 85 81 &dev_attr_thread_siblings_list.attr, 86 82 &dev_attr_core_siblings.attr, 87 83 &dev_attr_core_siblings_list.attr, 84 + &dev_attr_package_cpus.attr, 85 + &dev_attr_package_cpus_list.attr, 88 86 #ifdef CONFIG_SCHED_BOOK 89 87 &dev_attr_book_id.attr, 90 88 &dev_attr_book_siblings.attr,