]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - include/linux/interrupt.h
{pci,pnp} quirks.c: don't use deprecated print_fn_descriptor_symbol()
[mirror_ubuntu-zesty-kernel.git] / include / linux / interrupt.h
CommitLineData
1da177e4
LT
1/* interrupt.h */
2#ifndef _LINUX_INTERRUPT_H
3#define _LINUX_INTERRUPT_H
4
1da177e4
LT
5#include <linux/kernel.h>
6#include <linux/linkage.h>
7#include <linux/bitops.h>
8#include <linux/preempt.h>
9#include <linux/cpumask.h>
908dcecd 10#include <linux/irqreturn.h>
1da177e4 11#include <linux/hardirq.h>
f037360f 12#include <linux/sched.h>
de30a2b3 13#include <linux/irqflags.h>
1da177e4
LT
14#include <asm/atomic.h>
15#include <asm/ptrace.h>
16#include <asm/system.h>
17
6e213616
TG
18/*
19 * These correspond to the IORESOURCE_IRQ_* defines in
20 * linux/ioport.h to select the interrupt line behaviour. When
21 * requesting an interrupt without specifying a IRQF_TRIGGER, the
22 * setting should be assumed to be "as already configured", which
23 * may be as per machine or firmware initialisation.
24 */
25#define IRQF_TRIGGER_NONE 0x00000000
26#define IRQF_TRIGGER_RISING 0x00000001
27#define IRQF_TRIGGER_FALLING 0x00000002
28#define IRQF_TRIGGER_HIGH 0x00000004
29#define IRQF_TRIGGER_LOW 0x00000008
30#define IRQF_TRIGGER_MASK (IRQF_TRIGGER_HIGH | IRQF_TRIGGER_LOW | \
31 IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING)
32#define IRQF_TRIGGER_PROBE 0x00000010
33
34/*
35 * These flags used only by the kernel as part of the
36 * irq handling routines.
37 *
38 * IRQF_DISABLED - keep irqs disabled when calling the action handler
39 * IRQF_SAMPLE_RANDOM - irq is used to feed the random generator
40 * IRQF_SHARED - allow sharing the irq among several devices
41 * IRQF_PROBE_SHARED - set by callers when they expect sharing mismatches to occur
42 * IRQF_TIMER - Flag to mark this interrupt as timer interrupt
950f4427
TG
43 * IRQF_PERCPU - Interrupt is per cpu
44 * IRQF_NOBALANCING - Flag to exclude this interrupt from irq balancing
d85a60d8
BW
45 * IRQF_IRQPOLL - Interrupt is used for polling (only the interrupt that is
46 * registered first in an shared interrupt is considered for
47 * performance reasons)
6e213616
TG
48 */
49#define IRQF_DISABLED 0x00000020
50#define IRQF_SAMPLE_RANDOM 0x00000040
51#define IRQF_SHARED 0x00000080
52#define IRQF_PROBE_SHARED 0x00000100
53#define IRQF_TIMER 0x00000200
284c6680 54#define IRQF_PERCPU 0x00000400
950f4427 55#define IRQF_NOBALANCING 0x00000800
d85a60d8 56#define IRQF_IRQPOLL 0x00001000
6e213616 57
7d12e780 58typedef irqreturn_t (*irq_handler_t)(int, void *);
da482792 59
1da177e4 60struct irqaction {
da482792 61 irq_handler_t handler;
1da177e4
LT
62 unsigned long flags;
63 cpumask_t mask;
64 const char *name;
65 void *dev_id;
66 struct irqaction *next;
67 int irq;
68 struct proc_dir_entry *dir;
69};
70
7d12e780 71extern irqreturn_t no_action(int cpl, void *dev_id);
616883df 72extern int __must_check request_irq(unsigned int, irq_handler_t handler,
1da177e4
LT
73 unsigned long, const char *, void *);
74extern void free_irq(unsigned int, void *);
75
0af3678f
AV
76struct device;
77
616883df 78extern int __must_check devm_request_irq(struct device *dev, unsigned int irq,
9ac7849e
TH
79 irq_handler_t handler, unsigned long irqflags,
80 const char *devname, void *dev_id);
81extern void devm_free_irq(struct device *dev, unsigned int irq, void *dev_id);
82
d7e9629d
IM
83/*
84 * On lockdep we dont want to enable hardirqs in hardirq
85 * context. Use local_irq_enable_in_hardirq() to annotate
86 * kernel code that has to do this nevertheless (pretty much
87 * the only valid case is for old/broken hardware that is
88 * insanely slow).
89 *
90 * NOTE: in theory this might break fragile code that relies
91 * on hardirq delivery - in practice we dont seem to have such
92 * places left. So the only effect should be slightly increased
93 * irqs-off latencies.
94 */
95#ifdef CONFIG_LOCKDEP
96# define local_irq_enable_in_hardirq() do { } while (0)
97#else
98# define local_irq_enable_in_hardirq() local_irq_enable()
99#endif
1da177e4 100
1da177e4
LT
101extern void disable_irq_nosync(unsigned int irq);
102extern void disable_irq(unsigned int irq);
103extern void enable_irq(unsigned int irq);
ba9a2331 104
d7b90689
RK
105#if defined(CONFIG_SMP) && defined(CONFIG_GENERIC_HARDIRQS)
106
18404756
MK
107extern cpumask_t irq_default_affinity;
108
d7b90689
RK
109extern int irq_set_affinity(unsigned int irq, cpumask_t cpumask);
110extern int irq_can_set_affinity(unsigned int irq);
18404756 111extern int irq_select_affinity(unsigned int irq);
d7b90689
RK
112
113#else /* CONFIG_SMP */
114
115static inline int irq_set_affinity(unsigned int irq, cpumask_t cpumask)
116{
117 return -EINVAL;
118}
119
120static inline int irq_can_set_affinity(unsigned int irq)
121{
122 return 0;
123}
124
18404756
MK
125static inline int irq_select_affinity(unsigned int irq) { return 0; }
126
d7b90689
RK
127#endif /* CONFIG_SMP && CONFIG_GENERIC_HARDIRQS */
128
e9ed7e72 129#ifdef CONFIG_GENERIC_HARDIRQS
c01d403b
IM
130/*
131 * Special lockdep variants of irq disabling/enabling.
132 * These should be used for locking constructs that
133 * know that a particular irq context which is disabled,
134 * and which is the only irq-context user of a lock,
135 * that it's safe to take the lock in the irq-disabled
136 * section without disabling hardirqs.
137 *
138 * On !CONFIG_LOCKDEP they are equivalent to the normal
139 * irq disable/enable methods.
140 */
141static inline void disable_irq_nosync_lockdep(unsigned int irq)
142{
143 disable_irq_nosync(irq);
144#ifdef CONFIG_LOCKDEP
145 local_irq_disable();
146#endif
147}
148
e8106b94
AV
149static inline void disable_irq_nosync_lockdep_irqsave(unsigned int irq, unsigned long *flags)
150{
151 disable_irq_nosync(irq);
152#ifdef CONFIG_LOCKDEP
153 local_irq_save(*flags);
154#endif
155}
156
c01d403b
IM
157static inline void disable_irq_lockdep(unsigned int irq)
158{
159 disable_irq(irq);
160#ifdef CONFIG_LOCKDEP
161 local_irq_disable();
162#endif
163}
164
165static inline void enable_irq_lockdep(unsigned int irq)
166{
167#ifdef CONFIG_LOCKDEP
168 local_irq_enable();
169#endif
170 enable_irq(irq);
171}
172
e8106b94
AV
173static inline void enable_irq_lockdep_irqrestore(unsigned int irq, unsigned long *flags)
174{
175#ifdef CONFIG_LOCKDEP
176 local_irq_restore(*flags);
177#endif
178 enable_irq(irq);
179}
180
ba9a2331
TG
181/* IRQ wakeup (PM) control: */
182extern int set_irq_wake(unsigned int irq, unsigned int on);
183
184static inline int enable_irq_wake(unsigned int irq)
185{
186 return set_irq_wake(irq, 1);
187}
188
189static inline int disable_irq_wake(unsigned int irq)
190{
191 return set_irq_wake(irq, 0);
192}
193
c01d403b
IM
194#else /* !CONFIG_GENERIC_HARDIRQS */
195/*
196 * NOTE: non-genirq architectures, if they want to support the lock
197 * validator need to define the methods below in their asm/irq.h
198 * files, under an #ifdef CONFIG_LOCKDEP section.
199 */
b3e2fd9c 200#ifndef CONFIG_LOCKDEP
c01d403b 201# define disable_irq_nosync_lockdep(irq) disable_irq_nosync(irq)
b3e2fd9c
RZ
202# define disable_irq_nosync_lockdep_irqsave(irq, flags) \
203 disable_irq_nosync(irq)
c01d403b
IM
204# define disable_irq_lockdep(irq) disable_irq(irq)
205# define enable_irq_lockdep(irq) enable_irq(irq)
b3e2fd9c
RZ
206# define enable_irq_lockdep_irqrestore(irq, flags) \
207 enable_irq(irq)
c01d403b
IM
208# endif
209
aa5346a2
GL
210static inline int enable_irq_wake(unsigned int irq)
211{
212 return 0;
213}
214
215static inline int disable_irq_wake(unsigned int irq)
216{
217 return 0;
218}
c01d403b 219#endif /* CONFIG_GENERIC_HARDIRQS */
1da177e4 220
3f74478b
AK
221#ifndef __ARCH_SET_SOFTIRQ_PENDING
222#define set_softirq_pending(x) (local_softirq_pending() = (x))
223#define or_softirq_pending(x) (local_softirq_pending() |= (x))
224#endif
225
2d3fbbb3
BH
226/* Some architectures might implement lazy enabling/disabling of
227 * interrupts. In some cases, such as stop_machine, we might want
228 * to ensure that after a local_irq_disable(), interrupts have
229 * really been disabled in hardware. Such architectures need to
230 * implement the following hook.
231 */
232#ifndef hard_irq_disable
233#define hard_irq_disable() do { } while(0)
234#endif
235
1da177e4
LT
236/* PLEASE, avoid to allocate new softirqs, if you need not _really_ high
237 frequency threaded job scheduling. For almost all the purposes
238 tasklets are more than enough. F.e. all serial device BHs et
239 al. should be converted to tasklets, not to softirqs.
240 */
241
242enum
243{
244 HI_SOFTIRQ=0,
245 TIMER_SOFTIRQ,
246 NET_TX_SOFTIRQ,
247 NET_RX_SOFTIRQ,
ff856bad 248 BLOCK_SOFTIRQ,
c9819f45
CL
249 TASKLET_SOFTIRQ,
250 SCHED_SOFTIRQ,
54cdfdb4
TG
251#ifdef CONFIG_HIGH_RES_TIMERS
252 HRTIMER_SOFTIRQ,
253#endif
c2d727aa 254 RCU_SOFTIRQ, /* Preferable RCU should always be the last softirq */
978b0116
AD
255
256 NR_SOFTIRQS
1da177e4
LT
257};
258
259/* softirq mask and active fields moved to irq_cpustat_t in
260 * asm/hardirq.h to get better cache usage. KAO
261 */
262
263struct softirq_action
264{
265 void (*action)(struct softirq_action *);
1da177e4
LT
266};
267
268asmlinkage void do_softirq(void);
eb0f1c44 269asmlinkage void __do_softirq(void);
962cf36c 270extern void open_softirq(int nr, void (*action)(struct softirq_action *));
1da177e4 271extern void softirq_init(void);
3f74478b 272#define __raise_softirq_irqoff(nr) do { or_softirq_pending(1UL << (nr)); } while (0)
b3c97528
HH
273extern void raise_softirq_irqoff(unsigned int nr);
274extern void raise_softirq(unsigned int nr);
1da177e4
LT
275
276
277/* Tasklets --- multithreaded analogue of BHs.
278
279 Main feature differing them of generic softirqs: tasklet
280 is running only on one CPU simultaneously.
281
282 Main feature differing them of BHs: different tasklets
283 may be run simultaneously on different CPUs.
284
285 Properties:
286 * If tasklet_schedule() is called, then tasklet is guaranteed
287 to be executed on some cpu at least once after this.
288 * If the tasklet is already scheduled, but its excecution is still not
289 started, it will be executed only once.
290 * If this tasklet is already running on another CPU (or schedule is called
291 from tasklet itself), it is rescheduled for later.
292 * Tasklet is strictly serialized wrt itself, but not
293 wrt another tasklets. If client needs some intertask synchronization,
294 he makes it with spinlocks.
295 */
296
297struct tasklet_struct
298{
299 struct tasklet_struct *next;
300 unsigned long state;
301 atomic_t count;
302 void (*func)(unsigned long);
303 unsigned long data;
304};
305
306#define DECLARE_TASKLET(name, func, data) \
307struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(0), func, data }
308
309#define DECLARE_TASKLET_DISABLED(name, func, data) \
310struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(1), func, data }
311
312
313enum
314{
315 TASKLET_STATE_SCHED, /* Tasklet is scheduled for execution */
316 TASKLET_STATE_RUN /* Tasklet is running (SMP only) */
317};
318
319#ifdef CONFIG_SMP
320static inline int tasklet_trylock(struct tasklet_struct *t)
321{
322 return !test_and_set_bit(TASKLET_STATE_RUN, &(t)->state);
323}
324
325static inline void tasklet_unlock(struct tasklet_struct *t)
326{
327 smp_mb__before_clear_bit();
328 clear_bit(TASKLET_STATE_RUN, &(t)->state);
329}
330
331static inline void tasklet_unlock_wait(struct tasklet_struct *t)
332{
333 while (test_bit(TASKLET_STATE_RUN, &(t)->state)) { barrier(); }
334}
335#else
336#define tasklet_trylock(t) 1
337#define tasklet_unlock_wait(t) do { } while (0)
338#define tasklet_unlock(t) do { } while (0)
339#endif
340
b3c97528 341extern void __tasklet_schedule(struct tasklet_struct *t);
1da177e4
LT
342
343static inline void tasklet_schedule(struct tasklet_struct *t)
344{
345 if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
346 __tasklet_schedule(t);
347}
348
b3c97528 349extern void __tasklet_hi_schedule(struct tasklet_struct *t);
1da177e4
LT
350
351static inline void tasklet_hi_schedule(struct tasklet_struct *t)
352{
353 if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
354 __tasklet_hi_schedule(t);
355}
356
357
358static inline void tasklet_disable_nosync(struct tasklet_struct *t)
359{
360 atomic_inc(&t->count);
361 smp_mb__after_atomic_inc();
362}
363
364static inline void tasklet_disable(struct tasklet_struct *t)
365{
366 tasklet_disable_nosync(t);
367 tasklet_unlock_wait(t);
368 smp_mb();
369}
370
371static inline void tasklet_enable(struct tasklet_struct *t)
372{
373 smp_mb__before_atomic_dec();
374 atomic_dec(&t->count);
375}
376
377static inline void tasklet_hi_enable(struct tasklet_struct *t)
378{
379 smp_mb__before_atomic_dec();
380 atomic_dec(&t->count);
381}
382
383extern void tasklet_kill(struct tasklet_struct *t);
384extern void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu);
385extern void tasklet_init(struct tasklet_struct *t,
386 void (*func)(unsigned long), unsigned long data);
387
388/*
389 * Autoprobing for irqs:
390 *
391 * probe_irq_on() and probe_irq_off() provide robust primitives
392 * for accurate IRQ probing during kernel initialization. They are
393 * reasonably simple to use, are not "fooled" by spurious interrupts,
394 * and, unlike other attempts at IRQ probing, they do not get hung on
395 * stuck interrupts (such as unused PS2 mouse interfaces on ASUS boards).
396 *
397 * For reasonably foolproof probing, use them as follows:
398 *
399 * 1. clear and/or mask the device's internal interrupt.
400 * 2. sti();
401 * 3. irqs = probe_irq_on(); // "take over" all unassigned idle IRQs
402 * 4. enable the device and cause it to trigger an interrupt.
403 * 5. wait for the device to interrupt, using non-intrusive polling or a delay.
404 * 6. irq = probe_irq_off(irqs); // get IRQ number, 0=none, negative=multiple
405 * 7. service the device to clear its pending interrupt.
406 * 8. loop again if paranoia is required.
407 *
408 * probe_irq_on() returns a mask of allocated irq's.
409 *
410 * probe_irq_off() takes the mask as a parameter,
411 * and returns the irq number which occurred,
412 * or zero if none occurred, or a negative irq number
413 * if more than one irq occurred.
414 */
415
416#if defined(CONFIG_GENERIC_HARDIRQS) && !defined(CONFIG_GENERIC_IRQ_PROBE)
417static inline unsigned long probe_irq_on(void)
418{
419 return 0;
420}
421static inline int probe_irq_off(unsigned long val)
422{
423 return 0;
424}
425static inline unsigned int probe_irq_mask(unsigned long val)
426{
427 return 0;
428}
429#else
430extern unsigned long probe_irq_on(void); /* returns 0 on failure */
431extern int probe_irq_off(unsigned long); /* returns 0 or negative on failure */
432extern unsigned int probe_irq_mask(unsigned long); /* returns mask of ISA interrupts */
433#endif
434
6168a702
AM
435#ifdef CONFIG_PROC_FS
436/* Initialize /proc/irq/ */
437extern void init_irq_proc(void);
438#else
439static inline void init_irq_proc(void)
440{
441}
442#endif
443
f74596d0
AB
444int show_interrupts(struct seq_file *p, void *v);
445
1da177e4 446#endif