genirq: Add kerneldoc for irq_disable.
authorAndreas Fenkart <andreas.fenkart@streamunlimited.com>
Fri, 10 May 2013 10:21:30 +0000 (12:21 +0200)
committerThomas Gleixner <tglx@linutronix.de>
Wed, 29 May 2013 09:09:10 +0000 (11:09 +0200)
Document the lazy disable functionality. comment based on changelog of
d209a699a0b975ad

Signed-off-by: Andreas Fenkart <andreas.fenkart@streamunlimited.com>
Cc: balbi@ti.com
Link: http://lkml.kernel.org/r/1368181290-1583-1-git-send-email-andreas.fenkart@streamunlimited.com
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
kernel/irq/chip.c

index cbd97ce..a3bb14f 100644 (file)
@@ -213,6 +213,19 @@ void irq_enable(struct irq_desc *desc)
        irq_state_clr_masked(desc);
 }
 
+/**
+ * irq_disable - Mark interupt disabled
+ * @desc:      irq descriptor which should be disabled
+ *
+ * If the chip does not implement the irq_disable callback, we
+ * use a lazy disable approach. That means we mark the interrupt
+ * disabled, but leave the hardware unmasked. That's an
+ * optimization because we avoid the hardware access for the
+ * common case where no interrupt happens after we marked it
+ * disabled. If an interrupt happens, then the interrupt flow
+ * handler masks the line at the hardware level and marks it
+ * pending.
+ */
 void irq_disable(struct irq_desc *desc)
 {
        irq_state_set_disabled(desc);