Skip to contentSkip to conversation

genirq: doc: handle_IRQ_event() and __do_IRQ() comments

PATCH In review Ingo Molnar 1 participant 1 message May 17, 2006 IRQ

lore
Share & tools
lore
#0 lore raw

PATCH 13/50 genirq: doc: handle_IRQ_event() and __do_IRQ() comments

From: Ingo Molnar <[email protected]>

document handle_IRQ_event() and __do_IRQ().

---
 kernel/irq/handle.c |   20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)
kernel/irq/handle.c +16 -4
Index: linux-genirq.q/kernel/irq/handle.c
===================================================================
@@ -76,8 +76,13 @@ irqreturn_t no_action(int cpl, void *dev
 	return IRQ_NONE;
 }
 
-/*
- * Have got an event to handle:
+/**
+ * handle_IRQ_event - irq action chain handler
+ * @irq:	the interrupt number
+ * @regs:	pointer to a register structure
+ * @action:	the interrupt action chain for this irq
+ *
+ * Handles the action chain of an irq event
  */
 int handle_IRQ_event(unsigned int irq, struct pt_regs *regs,
 		     struct irqaction *action)
@@ -102,10 +107,17 @@ int handle_IRQ_event(unsigned int irq, s
 	return retval;
 }
 
-/*
- * do_IRQ handles all normal device IRQ's (the special
+/**
+ * __do_IRQ - original all in one highlevel IRQ handler
+ * @irq:	the interrupt number
+ * @regs:	pointer to a register structure
+ *
+ * __do_IRQ handles all normal device IRQ's (the special
  * SMP cross-CPU interrupts have their own specific
  * handlers).
+ *
+ * This is the original x86 implementation which is used for every
+ * interrupt type.
  */
 fastcall unsigned int __do_IRQ(unsigned int irq, struct pt_regs *regs)
 {