ARC: intc: Document arc_request_percpu_irq() better
authorVineet Gupta <vgupta@synopsys.com>
Fri, 11 Dec 2015 14:01:23 +0000 (19:31 +0530)
committerVineet Gupta <vgupta@synopsys.com>
Sat, 12 Dec 2015 10:34:12 +0000 (16:04 +0530)
Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
arch/arc/kernel/irq.c

index d736678d2724e1e36a327be0241b376e5bacf285..b1f75937f0e1b07117c785107bd560c0ca9af8b8 100644 (file)
@@ -51,6 +51,18 @@ void arch_do_IRQ(unsigned int irq, struct pt_regs *regs)
        set_irq_regs(old_regs);
 }
 
+/*
+ * API called for requesting percpu interrupts - called by each CPU
+ *  - For boot CPU, actually request the IRQ with genirq core + enables
+ *  - For subsequent callers only enable called locally
+ *
+ * Relies on being called by boot cpu first (i.e. request called ahead) of
+ * any enable as expected by genirq. Hence Suitable only for TIMER, IPI
+ * which are guaranteed to be setup on boot core first.
+ * Late probed peripherals such as perf can't use this as there no guarantee
+ * of being called on boot CPU first.
+ */
+
 void arc_request_percpu_irq(int irq, int cpu,
                             irqreturn_t (*isr)(int irq, void *dev),
                             const char *irq_nm,