irqchip: crossbar: Add kerneldoc for crossbar_domain_unmap callback

Adding kerneldoc for unmap callback function. Signed-off-by: Sricharan R <r.sricharan@ti.com> Acked-by: Santosh Shilimkar <santosh.shilimkar@ti.com> Link: https://lkml.kernel.org/r/1403766634-18543-13-git-send-email-r.sricharan@ti.com Signed-off-by: Jason Cooper <jason@lakedaemon.net>

irqchip: crossbar: Add kerneldoc for crossbar_domain_unmap callback
Adding kerneldoc for unmap callback function. Signed-off-by: Sricharan R <r.sricharan@ti.com> Acked-by: Santosh Shilimkar <santosh.shilimkar@ti.com> Link: https://lkml.kernel.org/r/1403766634-18543-13-git-send-email-r.sricharan@ti.com Signed-off-by: Jason Cooper <jason@lakedaemon.net>
Sricharan R · Jason Cooper
1 parent 99e37d0ea6
Showing 1 changed file with 11 additions and 0 deletions Side-by-side Diff
drivers/irqchip/irq-crossbar.c
@@ -89,6 +89,17 @@
 	return 0;
 }
  
+/**
+ * crossbar_domain_unmap - unmap a crossbar<->irq connection
+ * @d: domain of irq to unmap
+ * @irq: virq number
+ *
+ * We do not maintain a use count of total number of map/unmap
+ * calls for a particular irq to find out if a irq can be really
+ * unmapped. This is because unmap is called during irq_dispose_mapping(irq),
+ * after which irq is anyways unusable. So an explicit map has to be called
+ * after that.
+ */
 static void crossbar_domain_unmap(struct irq_domain *d, unsigned int irq)
 {
 	irq_hw_number_t hw = irq_get_irq_data(irq)->hwirq;
...	...	@@ -89,6 +89,17 @@
89	89	return 0;
90	90	}
91	91
	92	+/**
	93	+ * crossbar_domain_unmap - unmap a crossbar<->irq connection
	94	+ * @d: domain of irq to unmap
	95	+ * @irq: virq number
	96	+ *
	97	+ * We do not maintain a use count of total number of map/unmap
	98	+ * calls for a particular irq to find out if a irq can be really
	99	+ * unmapped. This is because unmap is called during irq_dispose_mapping(irq),
	100	+ * after which irq is anyways unusable. So an explicit map has to be called
	101	+ * after that.
	102	+ */
92	103	static void crossbar_domain_unmap(struct irq_domain *d, unsigned int irq)
93	104	{
94	105	irq_hw_number_t hw = irq_get_irq_data(irq)->hwirq;