* [PATCH] docs/zh_CN: Add core-api/irq managed_irq Chinese translation
@ 2026-11-19 10:31 Zixin Wang
0 siblings, 0 replies; only message in thread
From: Zixin Wang @ 2026-11-19 10:31 UTC (permalink / raw)
To: linux-doc
Cc: alexs, si.yanteng, dzm91, corbet, linux-kernel, Zixin Wang, Chao Liu
Translate Documentation/core-api/irq/managed_irq.rst into Chinese
and add it to the zh_CN irq toctree.
Update the translation through commit bb6a85b4b652
("Documentation: Add managed interrupts")
Signed-off-by: Zixin Wang <w1355457260@gmail.com>
Signed-off-by: Chao Liu <chao.liu@processmission.com>
---
.../translations/zh_CN/core-api/irq/index.rst | 1 +
.../zh_CN/core-api/irq/managed_irq.rst | 147 ++++++++++++++++++
2 files changed, 148 insertions(+)
create mode 100644 Documentation/translations/zh_CN/core-api/irq/managed_irq.rst
diff --git a/Documentation/translations/zh_CN/core-api/irq/index.rst b/Documentation/translations/zh_CN/core-api/irq/index.rst
index ba6acc4..7951d69 100644
--- a/Documentation/translations/zh_CN/core-api/irq/index.rst
+++ b/Documentation/translations/zh_CN/core-api/irq/index.rst
@@ -20,3 +20,4 @@ IRQs
irq-affinity
irq-domain
irqflags-tracing
+ managed_irq
diff --git a/Documentation/translations/zh_CN/core-api/irq/managed_irq.rst b/Documentation/translations/zh_CN/core-api/irq/managed_irq.rst
new file mode 100644
index 0000000..366320e
--- /dev/null
+++ b/Documentation/translations/zh_CN/core-api/irq/managed_irq.rst
@@ -0,0 +1,147 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/core-api/irq/managed_irq.rst
+
+:翻译:
+
+ Zixin Wang <w1355457260@gmail.com>
+
+.. _cn_managed_irq.rst:
+
+=============================
+亲和性托管中断(managed IRQ)
+=============================
+
+IRQ core 支持按指定 CPU 亲和性管理中断。
+正常运行时,每个中断关联到某个特定的
+CPU。如果该 CPU 离线,中断会被迁移到
+另一个在线 CPU。
+
+中断向量很多时,设备可能给可用的
+向量空间带来压力。例如,一块带
+128 个 I/O 队列的 NVMe 设备,在至少
+有 128 个 CPU 的系统中,通常每个队列
+请求一个中断。两个这样的设备就会请求
+256 个中断。在 x86 上,中断向量空间
+出了名地少:每个 CPU 只有 256 个向量,
+内核还要保留其中一部分,从而进一步
+减少可供设备中断使用的数量。实际使用
+中通常没有问题,因为中断分散在许多
+CPU 上,每个 CPU 只分到少量向量。
+
+然而在系统挂起时,所有次级 CPU 都会
+离线,所有中断都被迁移到唯一保持在线
+的那个 CPU 上。这可能会耗尽该 CPU 上
+可用的中断向量,从而导致挂起操作失败。
+
+亲和性托管(affinity-managed)中断
+应对了这一限制。每个中断都分配一个
+CPU 亲和性掩码,指定该中断可以定向到
+的 CPU 集合。当掩码中的某个 CPU 离线
+时,中断会移到掩码中的下一个 CPU。
+如果掩码中的最后一个 CPU 也离线,
+那么该中断会被关闭。使用亲和性托管
+中断的驱动程序必须确保,在中断被禁用
+之前关联的队列已处于静默(quiesced)
+状态,以免再产生新的中断。当亲和性
+掩码中的某个 CPU 重新上线时,中断会
+被重新使能。
+
+实现
+----
+
+设备必须提供按实例划分的中断,例如
+NVMe 等存储设备的按 I/O 队列中断。
+驱动程序使用 struct irq_affinity 按
+所需的亲和性设置分配中断向量。对于
+MSI-X 设备,需要设置
+PCI_IRQ_AFFINITY 标志并调用
+pci_alloc_irq_vectors_affinity() 来
+完成。
+
+IRQ core 会根据提供的亲和性信息,尽量
+在整个系统上均匀分散中断。亲和性掩码
+在这一分配阶段计算,但最终的 IRQ 分配
+是在调用 request_irq() 时完成的。
+
+隔离 CPU
+--------
+
+托管中断的亲和性完全由内核处理,无法
+通过 /proc 接口从用户空间修改。
+isolcpus 启动选项的 managed_irq 子参数
+可指定一个 CPU 掩码,托管中断会尽量
+避开这些 CPU。这种隔离是尽力而为的:
+只有当自动分配的掩码中也包含被避开掩码
+之外的在线 CPU 时才会生效。如果请求的
+掩码只包含隔离 CPU,该设置就没有任何
+效果。
+
+被避开掩码中的 CPU 仍属于该中断的
+亲和性掩码。也就是说,如果所有非隔离
+CPU 都离线、而隔离 CPU 仍在线,中断
+就会被分配到某个隔离 CPU 上。
+
+以下示例假设系统有 8 个 CPU。
+
+- 使用 "-device virtio-scsi-pci" 启动
+ 一个 QEMU 实例。该 MSI-X 设备会暴露
+ 11 个中断:3 个“管理”中断和 8 个
+ “队列”中断。驱动程序请求这 8 个队列
+ 中断,每个中断恰好亲和到一个 CPU。
+ 如果该 CPU 离线,该中断就会被关闭。
+
+ 假设中断 48 是其中一个队列中断,那么
+ 会看到::
+
+ /proc/irq/48/effective_affinity_list:7
+ /proc/irq/48/smp_affinity_list:7
+
+ 这表明该中断只由 CPU7 服务。关闭 CPU7
+ 并不会把中断迁移到其他 CPU::
+
+ /proc/irq/48/effective_affinity_list:0
+ /proc/irq/48/smp_affinity_list:7
+
+ 可以通过 debugfs 接口
+ (/sys/kernel/debug/irq/irqs/48) 验证
+ 这一点。dstate 字段会包含
+ IRQD_IRQ_DISABLED、IRQD_IRQ_MASKED
+ 和 IRQD_MANAGED_SHUTDOWN。
+
+- 使用以下参数启动 QEMU 实例:
+ "-device virtio-scsi-pci,num_queues=2"
+ 并在内核命令行中加入:
+ "irqaffinity=0,1 isolcpus=domain,2-7
+ isolcpus=managed_irq,1-3,5-7"。
+ 该 MSI-X 设备会暴露 5 个中断:3 个
+ 管理中断和 2 个队列中断。管理中断遵循
+ irqaffinity= 设置。队列中断分散到
+ 可用的 CPU 上::
+
+ /proc/irq/47/effective_affinity_list:0
+ /proc/irq/47/smp_affinity_list:0-3
+ /proc/irq/48/effective_affinity_list:4
+ /proc/irq/48/smp_affinity_list:4-7
+
+ 这两个队列中断被均匀分配。中断 48
+ 落在 CPU4 上,因为 managed_irq 掩码
+ 会尽可能避开 CPU 5-7。
+
+ 将 managed_irq 参数换成
+ "isolcpus=managed_irq,1-3,4-5,7" 后,
+ 结果是::
+
+ /proc/irq/48/effective_affinity_list:6
+ /proc/irq/48/smp_affinity_list:4-7
+
+ 此时中断 48 由 CPU6 服务,因为系统
+ 避开了 CPU 4、5 和 7。如果 CPU6 离线,
+ 中断会迁移到某个“隔离”CPU::
+
+ /proc/irq/48/effective_affinity_list:7
+ /proc/irq/48/smp_affinity_list:4-7
+
+ 一旦其 smp_affinity 掩码中列出的所有
+ CPU 都离线,该中断就会被关闭。
--
2.54.0
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2026-11-19 10:33 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-11-19 10:31 [PATCH] docs/zh_CN: Add core-api/irq managed_irq Chinese translation Zixin Wang
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®