Documentation/translations/zh_TW/admin-guide/cputopology.rst

Source file repositories/reference/linux-study-clean/Documentation/translations/zh_TW/admin-guide/cputopology.rst

File Facts

System
Linux kernel
Corpus path
Documentation/translations/zh_TW/admin-guide/cputopology.rst
Extension
.rst
Size
3805 bytes
Lines
98
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: GPL-2.0
.. include:: ../disclaimer-zh_TW.rst

:Original: Documentation/admin-guide/cputopology.rst

:翻譯:

  唐藝舟 Tang Yizhou <tangyeechou@gmail.com>

==========================
如何通過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、
draw這些層次結構相關的文件僅在體系結構提供了下文描述的宏的條件下被創建。

對於支持這個特性的體系結構，它必須在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 macros`` 的類型是int。
``**_cpumask macros`` 的類型是 ``(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實際存在，可以上線。
                [cpu_possible_mask]

Annotation

Implementation Notes