]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blob - kernel/irq/handle.c
IRQ: Typedef the IRQ handler function type
[mirror_ubuntu-jammy-kernel.git] / kernel / irq / handle.c
1 /*
2 * linux/kernel/irq/handle.c
3 *
4 * Copyright (C) 1992, 1998-2006 Linus Torvalds, Ingo Molnar
5 * Copyright (C) 2005-2006, Thomas Gleixner, Russell King
6 *
7 * This file contains the core interrupt handling code.
8 *
9 * Detailed information is available in Documentation/DocBook/genericirq
10 *
11 */
12
13 #include <linux/irq.h>
14 #include <linux/module.h>
15 #include <linux/random.h>
16 #include <linux/interrupt.h>
17 #include <linux/kernel_stat.h>
18
19 #include "internals.h"
20
21 /**
22 * handle_bad_irq - handle spurious and unhandled irqs
23 * @irq: the interrupt number
24 * @desc: description of the interrupt
25 * @regs: pointer to a register structure
26 *
27 * Handles spurious and unhandled IRQ's. It also prints a debugmessage.
28 */
29 void fastcall
30 handle_bad_irq(unsigned int irq, struct irq_desc *desc, struct pt_regs *regs)
31 {
32 print_irq_desc(irq, desc);
33 kstat_this_cpu.irqs[irq]++;
34 ack_bad_irq(irq);
35 }
36
37 /*
38 * Linux has a controller-independent interrupt architecture.
39 * Every controller has a 'controller-template', that is used
40 * by the main code to do the right thing. Each driver-visible
41 * interrupt source is transparently wired to the appropriate
42 * controller. Thus drivers need not be aware of the
43 * interrupt-controller.
44 *
45 * The code is designed to be easily extended with new/different
46 * interrupt controllers, without having to do assembly magic or
47 * having to touch the generic code.
48 *
49 * Controller mappings for all interrupt sources:
50 */
51 struct irq_desc irq_desc[NR_IRQS] __cacheline_aligned = {
52 [0 ... NR_IRQS-1] = {
53 .status = IRQ_DISABLED,
54 .chip = &no_irq_chip,
55 .handle_irq = handle_bad_irq,
56 .depth = 1,
57 .lock = SPIN_LOCK_UNLOCKED,
58 #ifdef CONFIG_SMP
59 .affinity = CPU_MASK_ALL
60 #endif
61 }
62 };
63
64 /*
65 * What should we do if we get a hw irq event on an illegal vector?
66 * Each architecture has to answer this themself.
67 */
68 static void ack_bad(unsigned int irq)
69 {
70 print_irq_desc(irq, irq_desc + irq);
71 ack_bad_irq(irq);
72 }
73
74 /*
75 * NOP functions
76 */
77 static void noop(unsigned int irq)
78 {
79 }
80
81 static unsigned int noop_ret(unsigned int irq)
82 {
83 return 0;
84 }
85
86 /*
87 * Generic no controller implementation
88 */
89 struct irq_chip no_irq_chip = {
90 .name = "none",
91 .startup = noop_ret,
92 .shutdown = noop,
93 .enable = noop,
94 .disable = noop,
95 .ack = ack_bad,
96 .end = noop,
97 };
98
99 /*
100 * Generic dummy implementation which can be used for
101 * real dumb interrupt sources
102 */
103 struct irq_chip dummy_irq_chip = {
104 .name = "dummy",
105 .startup = noop_ret,
106 .shutdown = noop,
107 .enable = noop,
108 .disable = noop,
109 .ack = noop,
110 .mask = noop,
111 .unmask = noop,
112 .end = noop,
113 };
114
115 /*
116 * Special, empty irq handler:
117 */
118 irqreturn_t no_action(int cpl, void *dev_id, struct pt_regs *regs)
119 {
120 return IRQ_NONE;
121 }
122
123 /**
124 * handle_IRQ_event - irq action chain handler
125 * @irq: the interrupt number
126 * @regs: pointer to a register structure
127 * @action: the interrupt action chain for this irq
128 *
129 * Handles the action chain of an irq event
130 */
131 irqreturn_t handle_IRQ_event(unsigned int irq, struct pt_regs *regs,
132 struct irqaction *action)
133 {
134 irqreturn_t ret, retval = IRQ_NONE;
135 unsigned int status = 0;
136
137 handle_dynamic_tick(action);
138
139 if (!(action->flags & IRQF_DISABLED))
140 local_irq_enable_in_hardirq();
141
142 do {
143 ret = action->handler(irq, action->dev_id, regs);
144 if (ret == IRQ_HANDLED)
145 status |= action->flags;
146 retval |= ret;
147 action = action->next;
148 } while (action);
149
150 if (status & IRQF_SAMPLE_RANDOM)
151 add_interrupt_randomness(irq);
152 local_irq_disable();
153
154 return retval;
155 }
156
157 #ifndef CONFIG_GENERIC_HARDIRQS_NO__DO_IRQ
158 /**
159 * __do_IRQ - original all in one highlevel IRQ handler
160 * @irq: the interrupt number
161 * @regs: pointer to a register structure
162 *
163 * __do_IRQ handles all normal device IRQ's (the special
164 * SMP cross-CPU interrupts have their own specific
165 * handlers).
166 *
167 * This is the original x86 implementation which is used for every
168 * interrupt type.
169 */
170 fastcall unsigned int __do_IRQ(unsigned int irq, struct pt_regs *regs)
171 {
172 struct irq_desc *desc = irq_desc + irq;
173 struct irqaction *action;
174 unsigned int status;
175
176 kstat_this_cpu.irqs[irq]++;
177 if (CHECK_IRQ_PER_CPU(desc->status)) {
178 irqreturn_t action_ret;
179
180 /*
181 * No locking required for CPU-local interrupts:
182 */
183 if (desc->chip->ack)
184 desc->chip->ack(irq);
185 action_ret = handle_IRQ_event(irq, regs, desc->action);
186 desc->chip->end(irq);
187 return 1;
188 }
189
190 spin_lock(&desc->lock);
191 if (desc->chip->ack)
192 desc->chip->ack(irq);
193 /*
194 * REPLAY is when Linux resends an IRQ that was dropped earlier
195 * WAITING is used by probe to mark irqs that are being tested
196 */
197 status = desc->status & ~(IRQ_REPLAY | IRQ_WAITING);
198 status |= IRQ_PENDING; /* we _want_ to handle it */
199
200 /*
201 * If the IRQ is disabled for whatever reason, we cannot
202 * use the action we have.
203 */
204 action = NULL;
205 if (likely(!(status & (IRQ_DISABLED | IRQ_INPROGRESS)))) {
206 action = desc->action;
207 status &= ~IRQ_PENDING; /* we commit to handling */
208 status |= IRQ_INPROGRESS; /* we are handling it */
209 }
210 desc->status = status;
211
212 /*
213 * If there is no IRQ handler or it was disabled, exit early.
214 * Since we set PENDING, if another processor is handling
215 * a different instance of this same irq, the other processor
216 * will take care of it.
217 */
218 if (unlikely(!action))
219 goto out;
220
221 /*
222 * Edge triggered interrupts need to remember
223 * pending events.
224 * This applies to any hw interrupts that allow a second
225 * instance of the same irq to arrive while we are in do_IRQ
226 * or in the handler. But the code here only handles the _second_
227 * instance of the irq, not the third or fourth. So it is mostly
228 * useful for irq hardware that does not mask cleanly in an
229 * SMP environment.
230 */
231 for (;;) {
232 irqreturn_t action_ret;
233
234 spin_unlock(&desc->lock);
235
236 action_ret = handle_IRQ_event(irq, regs, action);
237
238 spin_lock(&desc->lock);
239 if (!noirqdebug)
240 note_interrupt(irq, desc, action_ret, regs);
241 if (likely(!(desc->status & IRQ_PENDING)))
242 break;
243 desc->status &= ~IRQ_PENDING;
244 }
245 desc->status &= ~IRQ_INPROGRESS;
246
247 out:
248 /*
249 * The ->end() handler has to deal with interrupts which got
250 * disabled while the handler was running.
251 */
252 desc->chip->end(irq);
253 spin_unlock(&desc->lock);
254
255 return 1;
256 }
257 #endif
258
259 #ifdef CONFIG_TRACE_IRQFLAGS
260
261 /*
262 * lockdep: we want to handle all irq_desc locks as a single lock-class:
263 */
264 static struct lock_class_key irq_desc_lock_class;
265
266 void early_init_irq_lock_class(void)
267 {
268 int i;
269
270 for (i = 0; i < NR_IRQS; i++)
271 lockdep_set_class(&irq_desc[i].lock, &irq_desc_lock_class);
272 }
273
274 #endif