英文

如何通过 sysfs 导出 CPU 拓扑信息

CPU 拓扑信息通过 sysfs 导出。这些项（属性）类似于某些架构的 /proc/cpuinfo 输出。它们位于 /sys/devices/system/cpu/cpuX/topology/ 中。请参考 ABI 文件：Documentation/ABI/stable/sysfs-devices-system-cpu。

架构无关的 drivers/base/topology.c 导出这些属性。但是，只有当架构提供了如下所述的相关宏时，才会创建与 die、cluster、book 和 drawer 层次结构相关的 sysfs 文件。

为了使架构支持此功能，它必须在 include/asm-XXX/topology.h 中定义其中一些宏

#define topology_physical_package_id(cpu)
#define topology_die_id(cpu)
#define topology_cluster_id(cpu)
#define topology_core_id(cpu)
#define topology_book_id(cpu)
#define topology_drawer_id(cpu)
#define topology_sibling_cpumask(cpu)
#define topology_core_cpumask(cpu)
#define topology_cluster_cpumask(cpu)
#define topology_die_cpumask(cpu)
#define topology_book_cpumask(cpu)
#define topology_drawer_cpumask(cpu)

**_id 宏 的类型是 int。**_cpumask 宏 的类型是 (const) struct cpumask *。后者与相应的 **_siblings sysfs 属性对应（topology_sibling_cpumask() 除外，它与 thread_siblings 对应）。

为了在所有架构上保持一致性，include/linux/topology.h 为 include/asm-XXX/topology.h 未定义的任何上述宏提供默认定义

  1. topology_physical_package_id: -1

  2. topology_die_id: -1

  3. topology_cluster_id: -1

  4. topology_core_id: 0

  5. topology_book_id: -1

  6. topology_drawer_id: -1

  7. topology_sibling_cpumask: 仅给定的 CPU

  8. topology_core_cpumask: 仅给定的 CPU

  9. topology_cluster_cpumask: 仅给定的 CPU

  10. topology_die_cpumask: 仅给定的 CPU

  11. topology_book_cpumask: 仅给定的 CPU

  12. topology_drawer_cpumask: 仅给定的 CPU

此外，CPU 拓扑信息在 /sys/devices/system/cpu 下提供，包括这些文件。输出的内部来源在括号中（“[]”）。

kernel_max

内核配置允许的最大 CPU 索引。[NR_CPUS-1]

offline

由于已被热插拔关闭或超出内核配置允许的 CPU 限制（上面的 kernel_max），因此未在线的 CPU。[~cpu_online_mask + cpus >= NR_CPUS]

online

在线并正在被调度的 CPU。[cpu_online_mask]

possible

已分配资源并且如果存在可以上线的 CPU。[cpu_possible_mask]

present

已被识别为存在于系统中的 CPU。[cpu_present_mask]

以上输出的格式与 cpulist_parse() 兼容 [请参阅 <linux/cpumask.h>]。以下是一些示例。

在此示例中，系统中有 64 个 CPU，但 CPU 32-63 超出了内核最大值，NR_CPUS 配置选项为 32，限制为 0..31。另请注意，CPU 2 和 4-31 未在线，但由于它们既存在又有可能，因此可以上线

kernel_max: 31
   offline: 2,4-31,32-63
    online: 0-1,3
  possible: 0-31
   present: 0-31

在此示例中，NR_CPUS 配置选项为 128，但内核启动时使用了 possible_cpus=144。系统中有 4 个 CPU，并且 cpu2 被手动下线（并且是唯一可以上线的 CPU。）

kernel_max: 127
   offline: 2,4-127,128-143
    online: 0-1,3
  possible: 0-127
   present: 0-3

有关 possible_cpus=NUM 内核启动参数以及有关各种 cpumask 的更多信息，请参阅内核中的 CPU 热插拔。