From: BitKeeper B. <ri...@su...> - 2004-12-27 18:14:37
|
ChangeSet 1.1550.29.1, 2004/11/30 00:49:54+00:00, ia...@la... Add kerneldoc comments to teardow_irq manage.c | 24 +++++++++++++++++++----- 1 files changed, 19 insertions(+), 5 deletions(-) diff -Nru a/linux-2.6.10-rc2-xen-sparse/kernel/irq/manage.c b/linux-2.6.10-rc2-xen-sparse/kernel/irq/manage.c --- a/linux-2.6.10-rc2-xen-sparse/kernel/irq/manage.c 2004-12-27 10:05:45 -05:00 +++ b/linux-2.6.10-rc2-xen-sparse/kernel/irq/manage.c 2004-12-27 10:05:45 -05:00 @@ -144,9 +144,14 @@ return !action; } -/* - * Internal function to register an irqaction - typically used to - * allocate special interrupts that are part of the architecture. +/** + * setup_irq - register an irqaction structure + * @irq: Interrupt to register + * @irqaction: The irqaction structure to be registered + * + * Normally called by request_irq, this function can be used + * directly to allocate special interrupts that are part of the + * architecture. */ int setup_irq(unsigned int irq, struct irqaction * new) { @@ -216,8 +221,17 @@ } /* - * Internal function to unregister an irqaction - typically used to - * deallocate special interrupts that are part of the architecture. + * teardown_irq - unregister an irqaction + * @irq: Interrupt line being freed + * @old: Pointer to the irqaction that is to be unregistered + * + * This function is called by free_irq and does the actual + * business of unregistering the handler. It exists as a + * seperate function to enable handlers to be unregistered + * for irqactions that have been allocated statically at + * boot time. + * + * This function must not be called from interrupt context. */ int teardown_irq(unsigned int irq, struct irqaction * old) { |