Merge tag 'for-linus-5.15-1' of git://github.com/cminyard/linux-ipmi
[linux-2.6-microblaze.git] / Documentation / translations / zh_CN / core-api / irq / irqflags-tracing.rst
1 .. include:: ../../disclaimer-zh_CN.rst
2
3 :Original: Documentation/core-api/irq/irqflags-tracing.rst
4
5 :翻译:
6
7  司延腾 Yanteng Si <siyanteng@loongson.cn>
8
9 .. _cn_irqflags-tracing.rst:
10
11 =================
12 IRQ-flags状态追踪
13 =================
14
15 :Author: 最初由Ingo Molnar <mingo@redhat.com>开始撰写
16
17 “irq-flags tracing”(中断标志追踪)功能可以 “追踪” hardirq和softirq的状态,它让
18 感兴趣的子系统有机会了解到到内核中发生的每一个
19 hardirqs-off/hardirqs-on、softirqs-off/softirqs-on事件。
20
21 CONFIG_TRACE_IRQFLAGS_SUPPORT是通用锁调试代码提供的CONFIG_PROVE_SPIN_LOCKING
22 和CONFIG_PROVE_RW_LOCKING所需要的。否则将只有CONFIG_PROVE_MUTEX_LOCKING和
23 CONFIG_PROVE_RWSEM_LOCKING在一个架构上被提供--这些都是不在IRQ上下文中使用的
24 锁API。(rwsems的一个异常是可以解决的)
25
26 架构对这一点的支持当然不属于“微不足道”的范畴,因为很多低级的汇编代码都要处理irq-flags
27 的状态变化。但是一个架构可以以一种相当直接且无风险的方式启用irq-flags-tracing。
28
29 架构如果想支持这个,需要先做一些代码组织上的改变:
30
31 - 在他们的arch级Kconfig文件中添加并启用TRACE_IRQFLAGS_SUPPORT。
32
33 然后还需要做一些功能上的改变来实现对irq-flags-tracing的支持:
34
35 - 在低级入口代码中增加(构建条件)对trace_hardirqs_off()/trace_hardirqs_on()
36   函数的调用。锁验证器会密切关注 “real”的irq-flags是否与 “virtual”的irq-flags
37   状态相匹配,如果两者不匹配,则会发出警告(并关闭自己)。通常维护arch中
38   irq-flags-track的大部分时间都是在这种状态下度过的:看看lockdep的警告,试着
39   找出我们还没有搞定的汇编代码。修复并重复。一旦系统启动,并且在irq-flags跟踪功
40   能中没有出现lockdep警告的情况下,arch支持就完成了。
41
42 - 如果该架构有不可屏蔽的中断,那么需要通过lockdep_off()/lockdep_on()将这些中
43   断从irq跟踪[和锁验证]机制中排除。
44
45  一般来说,在一个架构中,不完整的irq-flags-tracing实现是没有风险的:lockdep
46  会检测到这一点,并将自己关闭。即锁验证器仍然可靠。应该不会因为irq-tracing的错
47  误而崩溃。(除非通过修改不该修改的条件来更改汇编或寄存器而破坏其他代码)