Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: Add request_irq() documentation
While checking the results of the :c:func: removal, I noticed that there
was no documentation for request_irq(), and request_threaded_irq() was not
mentioned at all. Add a kerneldoc comment for request_irq() and add
request_threaded_irq() to the list of functions.
Reviewed-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
+15
+2
Documentation/core-api/genericirq.rst
+2
Documentation/core-api/genericirq.rst
+13
include/linux/interrupt.h
+13
include/linux/interrupt.h
···
140
140
irq_handler_t thread_fn,
141
141
unsigned long flags, const char *name, void *dev);
142
142
143
+
/**
144
+
* request_irq - Add a handler for an interrupt line
145
+
* @irq: The interrupt line to allocate
146
+
* @handler: Function to be called when the IRQ occurs.
147
+
* Primary handler for threaded interrupts
148
+
* If NULL, the default primary handler is installed
149
+
* @flags: Handling flags
150
+
* @name: Name of the device generating this interrupt
151
+
* @dev: A cookie passed to the handler function
152
+
*
153
+
* This call allocates an interrupt and establishes a handler; see
154
+
* the documentation for request_threaded_irq() for details.
155
+
*/
143
156
static inline int __must_check
144
157
request_irq(unsigned int irq, irq_handler_t handler, unsigned long flags,
145
158
const char *name, void *dev)