Commit | Line | Data |
---|---|---|
06fcb0c6 IM |
1 | #ifndef _LINUX_IRQ_H |
2 | #define _LINUX_IRQ_H | |
1da177e4 LT |
3 | |
4 | /* | |
5 | * Please do not include this file in generic code. There is currently | |
6 | * no requirement for any architecture to implement anything held | |
7 | * within this file. | |
8 | * | |
9 | * Thanks. --rmk | |
10 | */ | |
11 | ||
23f9b317 | 12 | #include <linux/smp.h> |
1da177e4 | 13 | |
06fcb0c6 | 14 | #ifndef CONFIG_S390 |
1da177e4 LT |
15 | |
16 | #include <linux/linkage.h> | |
17 | #include <linux/cache.h> | |
18 | #include <linux/spinlock.h> | |
19 | #include <linux/cpumask.h> | |
503e5763 | 20 | #include <linux/gfp.h> |
908dcecd | 21 | #include <linux/irqreturn.h> |
dd3a1db9 | 22 | #include <linux/irqnr.h> |
77904fd6 | 23 | #include <linux/errno.h> |
503e5763 | 24 | #include <linux/topology.h> |
3aa551c9 | 25 | #include <linux/wait.h> |
1da177e4 LT |
26 | |
27 | #include <asm/irq.h> | |
28 | #include <asm/ptrace.h> | |
7d12e780 | 29 | #include <asm/irq_regs.h> |
1da177e4 | 30 | |
57a58a94 | 31 | struct irq_desc; |
ec701584 | 32 | typedef void (*irq_flow_handler_t)(unsigned int irq, |
7d12e780 | 33 | struct irq_desc *desc); |
57a58a94 DH |
34 | |
35 | ||
1da177e4 LT |
36 | /* |
37 | * IRQ line status. | |
6e213616 | 38 | * |
950f4427 | 39 | * Bits 0-7 are reserved for the IRQF_* bits in linux/interrupt.h |
6e213616 TG |
40 | * |
41 | * IRQ types | |
1da177e4 | 42 | */ |
6e213616 TG |
43 | #define IRQ_TYPE_NONE 0x00000000 /* Default, unspecified type */ |
44 | #define IRQ_TYPE_EDGE_RISING 0x00000001 /* Edge rising type */ | |
45 | #define IRQ_TYPE_EDGE_FALLING 0x00000002 /* Edge falling type */ | |
46 | #define IRQ_TYPE_EDGE_BOTH (IRQ_TYPE_EDGE_FALLING | IRQ_TYPE_EDGE_RISING) | |
47 | #define IRQ_TYPE_LEVEL_HIGH 0x00000004 /* Level high type */ | |
48 | #define IRQ_TYPE_LEVEL_LOW 0x00000008 /* Level low type */ | |
49 | #define IRQ_TYPE_SENSE_MASK 0x0000000f /* Mask of the above */ | |
50 | #define IRQ_TYPE_PROBE 0x00000010 /* Probing in progress */ | |
51 | ||
52 | /* Internal flags */ | |
950f4427 TG |
53 | #define IRQ_INPROGRESS 0x00000100 /* IRQ handler active - do not enter! */ |
54 | #define IRQ_DISABLED 0x00000200 /* IRQ disabled - do not enter! */ | |
55 | #define IRQ_PENDING 0x00000400 /* IRQ pending - replay on enable */ | |
56 | #define IRQ_REPLAY 0x00000800 /* IRQ has been replayed but not acked yet */ | |
57 | #define IRQ_AUTODETECT 0x00001000 /* IRQ is being autodetected */ | |
58 | #define IRQ_WAITING 0x00002000 /* IRQ not yet seen - for autodetection */ | |
59 | #define IRQ_LEVEL 0x00004000 /* IRQ level triggered */ | |
60 | #define IRQ_MASKED 0x00008000 /* IRQ masked - shouldn't be seen again */ | |
61 | #define IRQ_PER_CPU 0x00010000 /* IRQ is per CPU */ | |
62 | #define IRQ_NOPROBE 0x00020000 /* IRQ is not valid for probing */ | |
63 | #define IRQ_NOREQUEST 0x00040000 /* IRQ cannot be requested */ | |
64 | #define IRQ_NOAUTOEN 0x00080000 /* IRQ will not be enabled on request irq */ | |
d7e25f33 IM |
65 | #define IRQ_WAKEUP 0x00100000 /* IRQ triggers system wakeup */ |
66 | #define IRQ_MOVE_PENDING 0x00200000 /* need to re-target IRQ destination */ | |
67 | #define IRQ_NO_BALANCING 0x00400000 /* IRQ is excluded from balancing */ | |
1adb0850 | 68 | #define IRQ_SPURIOUS_DISABLED 0x00800000 /* IRQ was disabled by the spurious trap */ |
f6d87f4b TG |
69 | #define IRQ_MOVE_PCNTXT 0x01000000 /* IRQ migration from process context */ |
70 | #define IRQ_AFFINITY_SET 0x02000000 /* IRQ affinity was set from userspace*/ | |
0a0c5168 | 71 | #define IRQ_SUSPENDED 0x04000000 /* IRQ has gone through suspend sequence */ |
b25c340c | 72 | #define IRQ_ONESHOT 0x08000000 /* IRQ is not unmasked after hardirq */ |
399b5da2 | 73 | #define IRQ_NESTED_THREAD 0x10000000 /* IRQ is nested into another, no own handler thread */ |
950f4427 | 74 | |
44247184 TG |
75 | #define IRQF_MODIFY_MASK \ |
76 | (IRQ_TYPE_SENSE_MASK | IRQ_NOPROBE | IRQ_NOREQUEST | \ | |
77 | IRQ_NOAUTOEN | IRQ_MOVE_PCNTXT | IRQ_LEVEL) | |
78 | ||
0d7012a9 | 79 | #ifdef CONFIG_IRQ_PER_CPU |
f26fdd59 | 80 | # define CHECK_IRQ_PER_CPU(var) ((var) & IRQ_PER_CPU) |
950f4427 | 81 | # define IRQ_NO_BALANCING_MASK (IRQ_PER_CPU | IRQ_NO_BALANCING) |
f26fdd59 KW |
82 | #else |
83 | # define CHECK_IRQ_PER_CPU(var) 0 | |
950f4427 | 84 | # define IRQ_NO_BALANCING_MASK IRQ_NO_BALANCING |
f26fdd59 | 85 | #endif |
1da177e4 | 86 | |
5b912c10 | 87 | struct msi_desc; |
6a6de9ef | 88 | |
ff7dcd44 TG |
89 | /** |
90 | * struct irq_data - per irq and irq chip data passed down to chip functions | |
91 | * @irq: interrupt number | |
92 | * @node: node index useful for balancing | |
93 | * @chip: low level interrupt hardware access | |
94 | * @handler_data: per-IRQ data for the irq_chip methods | |
95 | * @chip_data: platform-specific per-chip private data for the chip | |
96 | * methods, to allow shared chip implementations | |
97 | * @msi_desc: MSI descriptor | |
98 | * @affinity: IRQ affinity on SMP | |
ff7dcd44 TG |
99 | * |
100 | * The fields here need to overlay the ones in irq_desc until we | |
101 | * cleaned up the direct references and switched everything over to | |
102 | * irq_data. | |
103 | */ | |
104 | struct irq_data { | |
105 | unsigned int irq; | |
106 | unsigned int node; | |
107 | struct irq_chip *chip; | |
108 | void *handler_data; | |
109 | void *chip_data; | |
110 | struct msi_desc *msi_desc; | |
111 | #ifdef CONFIG_SMP | |
112 | cpumask_var_t affinity; | |
113 | #endif | |
ff7dcd44 TG |
114 | }; |
115 | ||
8fee5c36 | 116 | /** |
6a6de9ef | 117 | * struct irq_chip - hardware interrupt chip descriptor |
8fee5c36 IM |
118 | * |
119 | * @name: name for /proc/interrupts | |
f8822657 TG |
120 | * @startup: deprecated, replaced by irq_startup |
121 | * @shutdown: deprecated, replaced by irq_shutdown | |
122 | * @enable: deprecated, replaced by irq_enable | |
123 | * @disable: deprecated, replaced by irq_disable | |
124 | * @ack: deprecated, replaced by irq_ack | |
125 | * @mask: deprecated, replaced by irq_mask | |
126 | * @mask_ack: deprecated, replaced by irq_mask_ack | |
127 | * @unmask: deprecated, replaced by irq_unmask | |
128 | * @eoi: deprecated, replaced by irq_eoi | |
129 | * @end: deprecated, will go away with __do_IRQ() | |
130 | * @set_affinity: deprecated, replaced by irq_set_affinity | |
131 | * @retrigger: deprecated, replaced by irq_retrigger | |
132 | * @set_type: deprecated, replaced by irq_set_type | |
133 | * @set_wake: deprecated, replaced by irq_wake | |
134 | * @bus_lock: deprecated, replaced by irq_bus_lock | |
135 | * @bus_sync_unlock: deprecated, replaced by irq_bus_sync_unlock | |
8fee5c36 | 136 | * |
f8822657 TG |
137 | * @irq_startup: start up the interrupt (defaults to ->enable if NULL) |
138 | * @irq_shutdown: shut down the interrupt (defaults to ->disable if NULL) | |
139 | * @irq_enable: enable the interrupt (defaults to chip->unmask if NULL) | |
140 | * @irq_disable: disable the interrupt | |
141 | * @irq_ack: start of a new interrupt | |
142 | * @irq_mask: mask an interrupt source | |
143 | * @irq_mask_ack: ack and mask an interrupt source | |
144 | * @irq_unmask: unmask an interrupt source | |
145 | * @irq_eoi: end of interrupt | |
146 | * @irq_set_affinity: set the CPU affinity on SMP machines | |
147 | * @irq_retrigger: resend an IRQ to the CPU | |
148 | * @irq_set_type: set the flow type (IRQ_TYPE_LEVEL/etc.) of an IRQ | |
149 | * @irq_set_wake: enable/disable power-management wake-on of an IRQ | |
150 | * @irq_bus_lock: function to lock access to slow bus (i2c) chips | |
151 | * @irq_bus_sync_unlock:function to sync and unlock slow bus (i2c) chips | |
70aedd24 | 152 | * |
8fee5c36 | 153 | * @release: release function solely used by UML |
1da177e4 | 154 | */ |
6a6de9ef TG |
155 | struct irq_chip { |
156 | const char *name; | |
bd151412 | 157 | #ifndef CONFIG_GENERIC_HARDIRQS_NO_DEPRECATED |
71d218b7 IM |
158 | unsigned int (*startup)(unsigned int irq); |
159 | void (*shutdown)(unsigned int irq); | |
160 | void (*enable)(unsigned int irq); | |
161 | void (*disable)(unsigned int irq); | |
6a6de9ef | 162 | |
71d218b7 | 163 | void (*ack)(unsigned int irq); |
6a6de9ef TG |
164 | void (*mask)(unsigned int irq); |
165 | void (*mask_ack)(unsigned int irq); | |
166 | void (*unmask)(unsigned int irq); | |
47c2a3aa | 167 | void (*eoi)(unsigned int irq); |
6a6de9ef | 168 | |
71d218b7 | 169 | void (*end)(unsigned int irq); |
d5dedd45 | 170 | int (*set_affinity)(unsigned int irq, |
0de26520 | 171 | const struct cpumask *dest); |
c0ad90a3 | 172 | int (*retrigger)(unsigned int irq); |
6a6de9ef TG |
173 | int (*set_type)(unsigned int irq, unsigned int flow_type); |
174 | int (*set_wake)(unsigned int irq, unsigned int on); | |
c0ad90a3 | 175 | |
70aedd24 TG |
176 | void (*bus_lock)(unsigned int irq); |
177 | void (*bus_sync_unlock)(unsigned int irq); | |
bd151412 | 178 | #endif |
f8822657 TG |
179 | unsigned int (*irq_startup)(struct irq_data *data); |
180 | void (*irq_shutdown)(struct irq_data *data); | |
181 | void (*irq_enable)(struct irq_data *data); | |
182 | void (*irq_disable)(struct irq_data *data); | |
183 | ||
184 | void (*irq_ack)(struct irq_data *data); | |
185 | void (*irq_mask)(struct irq_data *data); | |
186 | void (*irq_mask_ack)(struct irq_data *data); | |
187 | void (*irq_unmask)(struct irq_data *data); | |
188 | void (*irq_eoi)(struct irq_data *data); | |
189 | ||
190 | int (*irq_set_affinity)(struct irq_data *data, const struct cpumask *dest, bool force); | |
191 | int (*irq_retrigger)(struct irq_data *data); | |
192 | int (*irq_set_type)(struct irq_data *data, unsigned int flow_type); | |
193 | int (*irq_set_wake)(struct irq_data *data, unsigned int on); | |
194 | ||
195 | void (*irq_bus_lock)(struct irq_data *data); | |
196 | void (*irq_bus_sync_unlock)(struct irq_data *data); | |
197 | ||
b77d6adc PBG |
198 | /* Currently used only by UML, might disappear one day.*/ |
199 | #ifdef CONFIG_IRQ_RELEASE_METHOD | |
71d218b7 | 200 | void (*release)(unsigned int irq, void *dev_id); |
b77d6adc | 201 | #endif |
1da177e4 LT |
202 | }; |
203 | ||
e144710b TG |
204 | /* This include will go away once we isolated irq_desc usage to core code */ |
205 | #include <linux/irqdesc.h> | |
0b8f1efa | 206 | |
34ffdb72 IM |
207 | /* |
208 | * Pick up the arch-dependent methods: | |
209 | */ | |
210 | #include <asm/hw_irq.h> | |
1da177e4 | 211 | |
b683de2b TG |
212 | #ifndef NR_IRQS_LEGACY |
213 | # define NR_IRQS_LEGACY 0 | |
214 | #endif | |
215 | ||
1318a481 TG |
216 | #ifndef ARCH_IRQ_INIT_FLAGS |
217 | # define ARCH_IRQ_INIT_FLAGS 0 | |
218 | #endif | |
219 | ||
220 | #define IRQ_DEFAULT_INIT_FLAGS (IRQ_DISABLED | ARCH_IRQ_INIT_FLAGS) | |
221 | ||
e144710b | 222 | struct irqaction; |
06fcb0c6 | 223 | extern int setup_irq(unsigned int irq, struct irqaction *new); |
cbf94f06 | 224 | extern void remove_irq(unsigned int irq, struct irqaction *act); |
1da177e4 LT |
225 | |
226 | #ifdef CONFIG_GENERIC_HARDIRQS | |
06fcb0c6 | 227 | |
3a3856d0 | 228 | #if defined(CONFIG_SMP) && defined(CONFIG_GENERIC_PENDING_IRQ) |
c777ac55 | 229 | void move_native_irq(int irq); |
e7b946e9 | 230 | void move_masked_irq(int irq); |
e144710b TG |
231 | #else |
232 | static inline void move_native_irq(int irq) { } | |
233 | static inline void move_masked_irq(int irq) { } | |
234 | #endif | |
54d5d424 | 235 | |
1da177e4 | 236 | extern int no_irq_affinity; |
1da177e4 | 237 | |
6a6de9ef | 238 | /* Handle irq action chains: */ |
bedd30d9 | 239 | extern irqreturn_t handle_IRQ_event(unsigned int irq, struct irqaction *action); |
6a6de9ef TG |
240 | |
241 | /* | |
242 | * Built-in IRQ handlers for various IRQ types, | |
bebd04cc | 243 | * callable via desc->handle_irq() |
6a6de9ef | 244 | */ |
ec701584 HH |
245 | extern void handle_level_irq(unsigned int irq, struct irq_desc *desc); |
246 | extern void handle_fasteoi_irq(unsigned int irq, struct irq_desc *desc); | |
247 | extern void handle_edge_irq(unsigned int irq, struct irq_desc *desc); | |
248 | extern void handle_simple_irq(unsigned int irq, struct irq_desc *desc); | |
249 | extern void handle_percpu_irq(unsigned int irq, struct irq_desc *desc); | |
250 | extern void handle_bad_irq(unsigned int irq, struct irq_desc *desc); | |
31b47cf7 | 251 | extern void handle_nested_irq(unsigned int irq); |
6a6de9ef | 252 | |
6a6de9ef | 253 | /* Handling of unhandled and spurious interrupts: */ |
34ffdb72 | 254 | extern void note_interrupt(unsigned int irq, struct irq_desc *desc, |
bedd30d9 | 255 | irqreturn_t action_ret); |
1da177e4 | 256 | |
a4633adc | 257 | |
6a6de9ef TG |
258 | /* Enable/disable irq debugging output: */ |
259 | extern int noirqdebug_setup(char *str); | |
260 | ||
261 | /* Checks whether the interrupt can be requested by request_irq(): */ | |
262 | extern int can_request_irq(unsigned int irq, unsigned long irqflags); | |
263 | ||
f8b5473f | 264 | /* Dummy irq-chip implementations: */ |
6a6de9ef | 265 | extern struct irq_chip no_irq_chip; |
f8b5473f | 266 | extern struct irq_chip dummy_irq_chip; |
6a6de9ef | 267 | |
145fc655 IM |
268 | extern void |
269 | set_irq_chip_and_handler(unsigned int irq, struct irq_chip *chip, | |
270 | irq_flow_handler_t handle); | |
6a6de9ef | 271 | extern void |
a460e745 IM |
272 | set_irq_chip_and_handler_name(unsigned int irq, struct irq_chip *chip, |
273 | irq_flow_handler_t handle, const char *name); | |
274 | ||
6a6de9ef | 275 | extern void |
a460e745 IM |
276 | __set_irq_handler(unsigned int irq, irq_flow_handler_t handle, int is_chained, |
277 | const char *name); | |
1da177e4 | 278 | |
6a6de9ef TG |
279 | /* |
280 | * Set a highlevel flow handler for a given IRQ: | |
281 | */ | |
282 | static inline void | |
57a58a94 | 283 | set_irq_handler(unsigned int irq, irq_flow_handler_t handle) |
6a6de9ef | 284 | { |
a460e745 | 285 | __set_irq_handler(irq, handle, 0, NULL); |
6a6de9ef TG |
286 | } |
287 | ||
288 | /* | |
289 | * Set a highlevel chained flow handler for a given IRQ. | |
290 | * (a chained handler is automatically enabled and set to | |
291 | * IRQ_NOREQUEST and IRQ_NOPROBE) | |
292 | */ | |
293 | static inline void | |
294 | set_irq_chained_handler(unsigned int irq, | |
57a58a94 | 295 | irq_flow_handler_t handle) |
6a6de9ef | 296 | { |
a460e745 | 297 | __set_irq_handler(irq, handle, 1, NULL); |
6a6de9ef TG |
298 | } |
299 | ||
399b5da2 TG |
300 | extern void set_irq_nested_thread(unsigned int irq, int nest); |
301 | ||
44247184 TG |
302 | void irq_modify_status(unsigned int irq, unsigned long clr, unsigned long set); |
303 | ||
304 | static inline void irq_set_status_flags(unsigned int irq, unsigned long set) | |
305 | { | |
306 | irq_modify_status(irq, 0, set); | |
307 | } | |
308 | ||
309 | static inline void irq_clear_status_flags(unsigned int irq, unsigned long clr) | |
310 | { | |
311 | irq_modify_status(irq, clr, 0); | |
312 | } | |
313 | ||
314 | static inline void set_irq_noprobe(unsigned int irq) | |
315 | { | |
316 | irq_modify_status(irq, 0, IRQ_NOPROBE); | |
317 | } | |
318 | ||
319 | static inline void set_irq_probe(unsigned int irq) | |
320 | { | |
321 | irq_modify_status(irq, IRQ_NOPROBE, 0); | |
322 | } | |
46f4f8f6 | 323 | |
3a16d713 | 324 | /* Handle dynamic irq creation and destruction */ |
d047f53a | 325 | extern unsigned int create_irq_nr(unsigned int irq_want, int node); |
3a16d713 EB |
326 | extern int create_irq(void); |
327 | extern void destroy_irq(unsigned int irq); | |
328 | ||
b7b29338 TG |
329 | /* |
330 | * Dynamic irq helper functions. Obsolete. Use irq_alloc_desc* and | |
331 | * irq_free_desc instead. | |
332 | */ | |
3a16d713 | 333 | extern void dynamic_irq_cleanup(unsigned int irq); |
b7b29338 TG |
334 | static inline void dynamic_irq_init(unsigned int irq) |
335 | { | |
336 | dynamic_irq_cleanup(irq); | |
337 | } | |
dd87eb3a | 338 | |
3a16d713 | 339 | /* Set/get chip/data for an IRQ: */ |
dd87eb3a TG |
340 | extern int set_irq_chip(unsigned int irq, struct irq_chip *chip); |
341 | extern int set_irq_data(unsigned int irq, void *data); | |
342 | extern int set_irq_chip_data(unsigned int irq, void *data); | |
343 | extern int set_irq_type(unsigned int irq, unsigned int type); | |
5b912c10 | 344 | extern int set_irq_msi(unsigned int irq, struct msi_desc *entry); |
f303a6dd | 345 | extern struct irq_data *irq_get_irq_data(unsigned int irq); |
dd87eb3a | 346 | |
f303a6dd TG |
347 | static inline struct irq_chip *get_irq_chip(unsigned int irq) |
348 | { | |
349 | struct irq_data *d = irq_get_irq_data(irq); | |
350 | return d ? d->chip : NULL; | |
351 | } | |
352 | ||
353 | static inline struct irq_chip *irq_data_get_irq_chip(struct irq_data *d) | |
354 | { | |
355 | return d->chip; | |
356 | } | |
357 | ||
358 | static inline void *get_irq_chip_data(unsigned int irq) | |
359 | { | |
360 | struct irq_data *d = irq_get_irq_data(irq); | |
361 | return d ? d->chip_data : NULL; | |
362 | } | |
363 | ||
364 | static inline void *irq_data_get_irq_chip_data(struct irq_data *d) | |
365 | { | |
366 | return d->chip_data; | |
367 | } | |
368 | ||
369 | static inline void *get_irq_data(unsigned int irq) | |
370 | { | |
371 | struct irq_data *d = irq_get_irq_data(irq); | |
372 | return d ? d->handler_data : NULL; | |
373 | } | |
374 | ||
375 | static inline void *irq_data_get_irq_data(struct irq_data *d) | |
376 | { | |
377 | return d->handler_data; | |
378 | } | |
379 | ||
380 | static inline struct msi_desc *get_irq_msi(unsigned int irq) | |
381 | { | |
382 | struct irq_data *d = irq_get_irq_data(irq); | |
383 | return d ? d->msi_desc : NULL; | |
384 | } | |
385 | ||
386 | static inline struct msi_desc *irq_data_get_msi(struct irq_data *d) | |
387 | { | |
388 | return d->msi_desc; | |
389 | } | |
390 | ||
1f5a5b87 TG |
391 | int irq_alloc_descs(int irq, unsigned int from, unsigned int cnt, int node); |
392 | void irq_free_descs(unsigned int irq, unsigned int cnt); | |
06f6c339 | 393 | int irq_reserve_irqs(unsigned int from, unsigned int cnt); |
1f5a5b87 TG |
394 | |
395 | static inline int irq_alloc_desc(int node) | |
396 | { | |
397 | return irq_alloc_descs(-1, 0, 1, node); | |
398 | } | |
399 | ||
400 | static inline int irq_alloc_desc_at(unsigned int at, int node) | |
401 | { | |
402 | return irq_alloc_descs(at, at, 1, node); | |
403 | } | |
404 | ||
405 | static inline int irq_alloc_desc_from(unsigned int from, int node) | |
406 | { | |
407 | return irq_alloc_descs(-1, from, 1, node); | |
408 | } | |
409 | ||
410 | static inline void irq_free_desc(unsigned int irq) | |
411 | { | |
412 | irq_free_descs(irq, 1); | |
413 | } | |
414 | ||
639bd12f PM |
415 | static inline int irq_reserve_irq(unsigned int irq) |
416 | { | |
417 | return irq_reserve_irqs(irq, 1); | |
418 | } | |
419 | ||
6a6de9ef | 420 | #endif /* CONFIG_GENERIC_HARDIRQS */ |
1da177e4 | 421 | |
06fcb0c6 | 422 | #endif /* !CONFIG_S390 */ |
1da177e4 | 423 | |
06fcb0c6 | 424 | #endif /* _LINUX_IRQ_H */ |