Commit fe450eeb authored by Changbin Du's avatar Changbin Du Committed by Jonathan Corbet
Browse files

Documentation: in_irq() cleanup 



Replace the obsolete and ambiguos macro in_irq() with new
macro in_hardirq().

Signed-off-by: default avatarChangbin Du <changbin.du@gmail.com>

Link: https://lore.kernel.org/r/20210814014831.53083-1-changbin.du@gmail.com


Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent f08fe9d2

Documentation/kernel-hacking/hacking.rst

+2 −2
Original line number Diff line number Diff line
@@ -76,8 +76,8 @@ handler is never re-entered: if the same interrupt arrives, it is queued 
fast: frequently it simply acknowledges the interrupt, marks a 'software

interrupt' for execution and exits.



You can tell you are in a hardware interrupt, because

:c:func:`in_irq()` returns true.

You can tell you are in a hardware interrupt, because in_hardirq() returns

true.



.. warning::

Documentation/kernel-hacking/locking.rst

+2 −2
Original line number Diff line number Diff line
@@ -1406,7 +1406,7 @@ bh 
  half will be running at any time.



Hardware Interrupt / Hardware IRQ

  Hardware interrupt request. in_irq() returns true in a

  Hardware interrupt request. in_hardirq() returns true in a

  hardware interrupt handler.



Interrupt Context
@@ -1418,7 +1418,7 @@ SMP 
  (``CONFIG_SMP=y``).



Software Interrupt / softirq

  Software interrupt handler. in_irq() returns false;

  Software interrupt handler. in_hardirq() returns false;

  in_softirq() returns true. Tasklets and softirqs both

  fall into the category of 'software interrupts'.

Documentation/translations/it_IT/kernel-hacking/hacking.rst

+1 −1
Original line number Diff line number Diff line
@@ -90,7 +90,7 @@ i gestori d'interruzioni devono essere veloci: spesso si limitano 
esclusivamente a notificare la presa in carico dell'interruzione,

programmare una 'interruzione software' per l'esecuzione e quindi terminare.



Potete dire d'essere in una interruzione hardware perché :c:func:`in_irq()`

Potete dire d'essere in una interruzione hardware perché in_hardirq()

ritorna vero.



.. warning::

Documentation/translations/it_IT/kernel-hacking/locking.rst

+2 −2
Original line number Diff line number Diff line
@@ -1459,11 +1459,11 @@ contesto utente 
  che hardware.



interruzione hardware

  Richiesta di interruzione hardware. in_irq() ritorna vero in un

  Richiesta di interruzione hardware. in_hardirq() ritorna vero in un

  gestore d'interruzioni hardware.



interruzione software / softirq

  Gestore di interruzioni software: in_irq() ritorna falso;

  Gestore di interruzioni software: in_hardirq() ritorna falso;

  in_softirq() ritorna vero. I tasklet e le softirq sono entrambi

  considerati 'interruzioni software'.

Documentation/translations/zh_CN/kernel-hacking/hacking.rst

+1 −1
Original line number Diff line number Diff line
@@ -68,7 +68,7 @@ 
它将被排队（或丢弃）。因为它会关闭中断，所以处理程序必须很快：通常它只是

确认中断，标记一个“软件中断”以执行并退出。



您可以通过 :c:func:`in_irq()` 返回真来判断您处于硬件中断状态。

您可以通过 in_hardirq() 返回真来判断您处于硬件中断状态。



.. warning::