2 * linux/kernel/irq/handle.c
4 * Copyright (C) 1992, 1998-2006 Linus Torvalds, Ingo Molnar
5 * Copyright (C) 2005-2006, Thomas Gleixner, Russell King
7 * This file contains the core interrupt handling code.
9 * Detailed information is available in Documentation/DocBook/genericirq
13 #include <linux/irq.h>
14 #include <linux/random.h>
15 #include <linux/sched.h>
16 #include <linux/interrupt.h>
17 #include <linux/kernel_stat.h>
19 #include <trace/events/irq.h>
21 #include "internals.h"
24 * handle_bad_irq - handle spurious and unhandled irqs
25 * @irq: the interrupt number
26 * @desc: description of the interrupt
28 * Handles spurious and unhandled IRQ's. It also prints a debugmessage.
30 void handle_bad_irq(unsigned int irq, struct irq_desc *desc)
32 print_irq_desc(irq, desc);
33 kstat_incr_irqs_this_cpu(irq, desc);
38 * Special, empty irq handler:
40 irqreturn_t no_action(int cpl, void *dev_id)
45 static void warn_no_thread(unsigned int irq, struct irqaction *action)
47 if (test_and_set_bit(IRQTF_WARNED, &action->thread_flags))
50 printk(KERN_WARNING "IRQ %d device %s returned IRQ_WAKE_THREAD "
51 "but no thread function available.", irq, action->name);
55 * handle_IRQ_event - irq action chain handler
56 * @irq: the interrupt number
57 * @action: the interrupt action chain for this irq
59 * Handles the action chain of an irq event
61 irqreturn_t handle_IRQ_event(unsigned int irq, struct irqaction *action)
63 irqreturn_t ret, retval = IRQ_NONE;
64 unsigned int status = 0;
67 trace_irq_handler_entry(irq, action);
68 ret = action->handler(irq, action->dev_id);
69 trace_irq_handler_exit(irq, action, ret);
74 * Set result to handled so the spurious check
80 * Catch drivers which return WAKE_THREAD but
81 * did not set up a thread function
83 if (unlikely(!action->thread_fn)) {
84 warn_no_thread(irq, action);
89 * Wake up the handler thread for this
90 * action. In case the thread crashed and was
91 * killed we just pretend that we handled the
92 * interrupt. The hardirq handler above has
93 * disabled the device interrupt, so no irq
96 if (likely(!test_bit(IRQTF_DIED,
97 &action->thread_flags))) {
98 set_bit(IRQTF_RUNTHREAD, &action->thread_flags);
99 wake_up_process(action->thread);
102 /* Fall through to add to randomness */
104 status |= action->flags;
112 action = action->next;
115 if (status & IRQF_SAMPLE_RANDOM)
116 add_interrupt_randomness(irq);
122 #ifndef CONFIG_GENERIC_HARDIRQS_NO__DO_IRQ
124 #ifdef CONFIG_ENABLE_WARN_DEPRECATED
125 # warning __do_IRQ is deprecated. Please convert to proper flow handlers
129 * __do_IRQ - original all in one highlevel IRQ handler
130 * @irq: the interrupt number
132 * __do_IRQ handles all normal device IRQ's (the special
133 * SMP cross-CPU interrupts have their own specific
136 * This is the original x86 implementation which is used for every
139 unsigned int __do_IRQ(unsigned int irq)
141 struct irq_desc *desc = irq_to_desc(irq);
142 struct irqaction *action;
145 kstat_incr_irqs_this_cpu(irq, desc);
147 if (CHECK_IRQ_PER_CPU(desc->status)) {
148 irqreturn_t action_ret;
151 * No locking required for CPU-local interrupts:
153 if (desc->irq_data.chip->ack)
154 desc->irq_data.chip->ack(irq);
155 if (likely(!(desc->status & IRQ_DISABLED))) {
156 action_ret = handle_IRQ_event(irq, desc->action);
158 note_interrupt(irq, desc, action_ret);
160 desc->irq_data.chip->end(irq);
164 raw_spin_lock(&desc->lock);
165 if (desc->irq_data.chip->ack)
166 desc->irq_data.chip->ack(irq);
168 * REPLAY is when Linux resends an IRQ that was dropped earlier
169 * WAITING is used by probe to mark irqs that are being tested
171 status = desc->status & ~(IRQ_REPLAY | IRQ_WAITING);
172 status |= IRQ_PENDING; /* we _want_ to handle it */
175 * If the IRQ is disabled for whatever reason, we cannot
176 * use the action we have.
179 if (likely(!(status & (IRQ_DISABLED | IRQ_INPROGRESS)))) {
180 action = desc->action;
181 status &= ~IRQ_PENDING; /* we commit to handling */
182 status |= IRQ_INPROGRESS; /* we are handling it */
184 desc->status = status;
187 * If there is no IRQ handler or it was disabled, exit early.
188 * Since we set PENDING, if another processor is handling
189 * a different instance of this same irq, the other processor
190 * will take care of it.
192 if (unlikely(!action))
196 * Edge triggered interrupts need to remember
198 * This applies to any hw interrupts that allow a second
199 * instance of the same irq to arrive while we are in do_IRQ
200 * or in the handler. But the code here only handles the _second_
201 * instance of the irq, not the third or fourth. So it is mostly
202 * useful for irq hardware that does not mask cleanly in an
206 irqreturn_t action_ret;
208 raw_spin_unlock(&desc->lock);
210 action_ret = handle_IRQ_event(irq, action);
212 note_interrupt(irq, desc, action_ret);
214 raw_spin_lock(&desc->lock);
215 if (likely(!(desc->status & IRQ_PENDING)))
217 desc->status &= ~IRQ_PENDING;
219 desc->status &= ~IRQ_INPROGRESS;
223 * The ->end() handler has to deal with interrupts which got
224 * disabled while the handler was running.
226 desc->irq_data.chip->end(irq);
227 raw_spin_unlock(&desc->lock);