Re: [PATCH 04/11] docs/zh_CN: add core-api irq irqflags-tracing.rst translation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Wu X.C. <bobwxc@xxxxxxxx> 于2021年4月7日周三 下午1:08写道:
>
> On Wed, Apr 07, 2021 at 11:03:11AM +0800, yanteng si wrote:
> > Wu X.C. <bobwxc@xxxxxxxx> 于2021年4月7日周三 上午12:13写道:
> > >
> > > On Tue, Apr 06, 2021 at 09:02:03PM +0800, Yanteng Si wrote:
> > > > This patch translates Documentation/core-api/irq/irqflags-tracing.rst into Chinese.
> > > >
> > > > Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx>
> > > > ---
> > > >  .../zh_CN/core-api/irq/irqflags-tracing.rst   | 46 +++++++++++++++++++
> > > >  1 file changed, 46 insertions(+)
> > > >  create mode 100644 Documentation/translations/zh_CN/core-api/irq/irqflags-tracing.rst
> > > >
> > > > diff --git a/Documentation/translations/zh_CN/core-api/irq/irqflags-tracing.rst b/Documentation/translations/zh_CN/core-api/irq/irqflags-tracing.rst
> > > > new file mode 100644
> > > > index 000000000000..2a3f577ac6b5
> > > > --- /dev/null
> > > > +++ b/Documentation/translations/zh_CN/core-api/irq/irqflags-tracing.rst
> > > > @@ -0,0 +1,45 @@
> > > > +.. include:: ../../disclaimer-zh_CN.rst
> > > > +
> > > > +:Original: :doc:`../../../../core-api/irq/irqflags-tracing`
> > > > +:Translator: Yanteng Si <siyanteng@xxxxxxxxxxx>
> > > > +
> > > > +.. _cn_irqflags-tracing.rst:
> > > > +
> > > > +
> > > > +=======================
> > > > +IRQ-flags状态追踪
> > > > +=======================
> > > > +
> > > > +:Author: 最初由Ingo Molnar <mingo@xxxxxxxxxx>开始撰写
> > > > +
> > > > +"irq-flags tracing" 功能可以 "追踪" hardirq和softirq的状态,它让感兴趣的子
> > >
> > > "irq-flags tracing"(中断标志追踪) ?
> > OK!
> > >
> > > > +系统有机会了解到到内核中发生的每一个
> > > > +hardirqs-off/hardirqs-on、softirqs-off/softirqs-on事件。
> > > > +
> > > > +CONFIG_TRACE_IRQFLAGS_SUPPORT是通用锁调试代码提供的CONFIG_PROVE_SPIN_LOCKING
> > > > +和CONFIG_PROVE_RW_LOCKING所需要的。否则将只有CONFIG_PROVE_MUTEX_LOCKING和
> > > > +CONFIG_PROVE_RWSEM_LOCKING在一个架构上被提供--这些都是不在IRQ上下文中使用的
> > > > +锁API。(rwsems的一个异常是可以解决的)
> > > > +
> > > > +架构对这一点的支持当然不属于 "琐碎 "的范畴,因为很多低级的汇编代码都要处理irq-flags
> > >
> > > quotation marks
> > > “琐碎”
> > 微不足道
> > OK?
>
> Oh, you misunderstood me :P
>
> That's just for the punctuation marks, please use “” , not ""
>
OK!  ~>_<~
> > >
> > > > +的状态变化。但是一个架构可以以一种相当直接且无风险的方式启用irq-flags-tracing。
> > > > +
> > > > +架构如果想支持这个,需要先做一些代码组织上的改变:
> > > > +
> > > > +- 在他们的arch级Kconfig文件中添加并启用TRACE_IRQFLAGS_SUPPORT。
> > > > +
> > > > +然后还需要做一些功能上的改变来实现对irq-flags-tracing的支持:
> > > > +
> > > > +- 在低级入口代码中增加(构建条件)对trace_hardirqs_off()/trace_hardirqs_on()
> > >
> > > brackets
> > > (构建条件)
> > Origin: in lowlevel entry code add (build-conditional) calls to the
>
> This means to use 2-byte mode brackets, thus '()', not '()'
OK!
>
> > >
> > > > +  函数的调用。锁验证器会密切关注 "真实 "的irq-flags是否与 "虚拟 "的irq-flags
> > >
> > > “真实”  “虚拟”
> > I tried to delve into it, but I found it wasn't easy, and I needed some time.
> > also  ”irq-flags-tracing“
>
> That's also just for the punctuation marks, please use “” , not ""
>
OK!
> > >
> > > > +  状态相匹配,如果两者不匹配,则会大声抱怨(并关闭自己)。通常对于arch支持
> > >
> > > 大声抱怨 -> 发出警告 ?
> > > so as followed 抱怨
> > OK!
> > >
> > > > +  irq-flags-track的大部分时间都是在这种状态下度过的:看看lockdep的抱怨,试着
> > >
> > > Maybe this is better
> > > 通常维护arch中irq-flags-track的大部分时间...
> > OK!
> > >
> > > > +  找出我们还没有涉及的汇编代码。修复并重复。一旦系统启动,并且在irq-flags跟踪功
> > >
> > > ...还没有搞定的汇编代码,修复并重复。
> > OK!
> > >
> > > irq-flags-tracing  check this term's translation
> > >
> > > > +  能中没有出现lockdep抱怨的情况下,arch支持就完成了。
> > > > +
> > > > +- 如果该架构有不可屏蔽的中断,那么需要通过lockdep_off()/lockdep_on()将这些中
> > > > +  断从irq跟踪[和锁验证]机制中排除。
> > > > +
> > >
> > > wrong indent for next paragraph
> > OK!
> > >
> > > > +  一般来说,在一个架构中,不完整的irq-flags-tracing实现是没有风险的:lockdep
> > > > +  会检测到这一点,并将自己关闭。即锁验证器仍然可靠。应该不会因为irq-tracing的错
> > > > +  误而崩溃。(除非通过修改不该修改的条件来更改汇编或寄存器而破坏其他代码)
> > > > --
> > > > 2.27.0
> > >
>

Thank you very much!

Yanteng




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux