]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - include/linux/interrupt.h
fs/affs/file.c: use BUG_ON
[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
107extern int irq_set_affinity(unsigned int irq, cpumask_t cpumask);
108extern int irq_can_set_affinity(unsigned int irq);
109
110#else /* CONFIG_SMP */
111
112static inline int irq_set_affinity(unsigned int irq, cpumask_t cpumask)
113{
114 return -EINVAL;
115}
116
117static inline int irq_can_set_affinity(unsigned int irq)
118{
119 return 0;
120}
121
122#endif /* CONFIG_SMP && CONFIG_GENERIC_HARDIRQS */
123
e9ed7e72 124#ifdef CONFIG_GENERIC_HARDIRQS
c01d403b
IM
125/*
126 * Special lockdep variants of irq disabling/enabling.
127 * These should be used for locking constructs that
128 * know that a particular irq context which is disabled,
129 * and which is the only irq-context user of a lock,
130 * that it's safe to take the lock in the irq-disabled
131 * section without disabling hardirqs.
132 *
133 * On !CONFIG_LOCKDEP they are equivalent to the normal
134 * irq disable/enable methods.
135 */
136static inline void disable_irq_nosync_lockdep(unsigned int irq)
137{
138 disable_irq_nosync(irq);
139#ifdef CONFIG_LOCKDEP
140 local_irq_disable();
141#endif
142}
143
e8106b94
AV
144static inline void disable_irq_nosync_lockdep_irqsave(unsigned int irq, unsigned long *flags)
145{
146 disable_irq_nosync(irq);
147#ifdef CONFIG_LOCKDEP
148 local_irq_save(*flags);
149#endif
150}
151
c01d403b
IM
152static inline void disable_irq_lockdep(unsigned int irq)
153{
154 disable_irq(irq);
155#ifdef CONFIG_LOCKDEP
156 local_irq_disable();
157#endif
158}
159
160static inline void enable_irq_lockdep(unsigned int irq)
161{
162#ifdef CONFIG_LOCKDEP
163 local_irq_enable();
164#endif
165 enable_irq(irq);
166}
167
e8106b94
AV
168static inline void enable_irq_lockdep_irqrestore(unsigned int irq, unsigned long *flags)
169{
170#ifdef CONFIG_LOCKDEP
171 local_irq_restore(*flags);
172#endif
173 enable_irq(irq);
174}
175
ba9a2331
TG
176/* IRQ wakeup (PM) control: */
177extern int set_irq_wake(unsigned int irq, unsigned int on);
178
179static inline int enable_irq_wake(unsigned int irq)
180{
181 return set_irq_wake(irq, 1);
182}
183
184static inline int disable_irq_wake(unsigned int irq)
185{
186 return set_irq_wake(irq, 0);
187}
188
c01d403b
IM
189#else /* !CONFIG_GENERIC_HARDIRQS */
190/*
191 * NOTE: non-genirq architectures, if they want to support the lock
192 * validator need to define the methods below in their asm/irq.h
193 * files, under an #ifdef CONFIG_LOCKDEP section.
194 */
b3e2fd9c 195#ifndef CONFIG_LOCKDEP
c01d403b 196# define disable_irq_nosync_lockdep(irq) disable_irq_nosync(irq)
b3e2fd9c
RZ
197# define disable_irq_nosync_lockdep_irqsave(irq, flags) \
198 disable_irq_nosync(irq)
c01d403b
IM
199# define disable_irq_lockdep(irq) disable_irq(irq)
200# define enable_irq_lockdep(irq) enable_irq(irq)
b3e2fd9c
RZ
201# define enable_irq_lockdep_irqrestore(irq, flags) \
202 enable_irq(irq)
c01d403b
IM
203# endif
204
aa5346a2
GL
205static inline int enable_irq_wake(unsigned int irq)
206{
207 return 0;
208}
209
210static inline int disable_irq_wake(unsigned int irq)
211{
212 return 0;
213}
c01d403b 214#endif /* CONFIG_GENERIC_HARDIRQS */
1da177e4 215
3f74478b
AK
216#ifndef __ARCH_SET_SOFTIRQ_PENDING
217#define set_softirq_pending(x) (local_softirq_pending() = (x))
218#define or_softirq_pending(x) (local_softirq_pending() |= (x))
219#endif
220
1da177e4
LT
221/*
222 * Temporary defines for UP kernels, until all code gets fixed.
223 */
224#ifndef CONFIG_SMP
225static inline void __deprecated cli(void)
226{
227 local_irq_disable();
228}
229static inline void __deprecated sti(void)
230{
231 local_irq_enable();
232}
233static inline void __deprecated save_flags(unsigned long *x)
234{
235 local_save_flags(*x);
236}
ef9ceab2 237#define save_flags(x) save_flags(&x)
1da177e4
LT
238static inline void __deprecated restore_flags(unsigned long x)
239{
240 local_irq_restore(x);
241}
242
243static inline void __deprecated save_and_cli(unsigned long *x)
244{
245 local_irq_save(*x);
246}
247#define save_and_cli(x) save_and_cli(&x)
248#endif /* CONFIG_SMP */
249
2d3fbbb3
BH
250/* Some architectures might implement lazy enabling/disabling of
251 * interrupts. In some cases, such as stop_machine, we might want
252 * to ensure that after a local_irq_disable(), interrupts have
253 * really been disabled in hardware. Such architectures need to
254 * implement the following hook.
255 */
256#ifndef hard_irq_disable
257#define hard_irq_disable() do { } while(0)
258#endif
259
1da177e4
LT
260/* PLEASE, avoid to allocate new softirqs, if you need not _really_ high
261 frequency threaded job scheduling. For almost all the purposes
262 tasklets are more than enough. F.e. all serial device BHs et
263 al. should be converted to tasklets, not to softirqs.
264 */
265
266enum
267{
268 HI_SOFTIRQ=0,
269 TIMER_SOFTIRQ,
270 NET_TX_SOFTIRQ,
271 NET_RX_SOFTIRQ,
ff856bad 272 BLOCK_SOFTIRQ,
c9819f45
CL
273 TASKLET_SOFTIRQ,
274 SCHED_SOFTIRQ,
54cdfdb4
TG
275#ifdef CONFIG_HIGH_RES_TIMERS
276 HRTIMER_SOFTIRQ,
277#endif
c2d727aa 278 RCU_SOFTIRQ, /* Preferable RCU should always be the last softirq */
1da177e4
LT
279};
280
281/* softirq mask and active fields moved to irq_cpustat_t in
282 * asm/hardirq.h to get better cache usage. KAO
283 */
284
285struct softirq_action
286{
287 void (*action)(struct softirq_action *);
288 void *data;
289};
290
291asmlinkage void do_softirq(void);
292extern void open_softirq(int nr, void (*action)(struct softirq_action*), void *data);
293extern void softirq_init(void);
3f74478b 294#define __raise_softirq_irqoff(nr) do { or_softirq_pending(1UL << (nr)); } while (0)
b3c97528
HH
295extern void raise_softirq_irqoff(unsigned int nr);
296extern void raise_softirq(unsigned int nr);
1da177e4
LT
297
298
299/* Tasklets --- multithreaded analogue of BHs.
300
301 Main feature differing them of generic softirqs: tasklet
302 is running only on one CPU simultaneously.
303
304 Main feature differing them of BHs: different tasklets
305 may be run simultaneously on different CPUs.
306
307 Properties:
308 * If tasklet_schedule() is called, then tasklet is guaranteed
309 to be executed on some cpu at least once after this.
310 * If the tasklet is already scheduled, but its excecution is still not
311 started, it will be executed only once.
312 * If this tasklet is already running on another CPU (or schedule is called
313 from tasklet itself), it is rescheduled for later.
314 * Tasklet is strictly serialized wrt itself, but not
315 wrt another tasklets. If client needs some intertask synchronization,
316 he makes it with spinlocks.
317 */
318
319struct tasklet_struct
320{
321 struct tasklet_struct *next;
322 unsigned long state;
323 atomic_t count;
324 void (*func)(unsigned long);
325 unsigned long data;
326};
327
328#define DECLARE_TASKLET(name, func, data) \
329struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(0), func, data }
330
331#define DECLARE_TASKLET_DISABLED(name, func, data) \
332struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(1), func, data }
333
334
335enum
336{
337 TASKLET_STATE_SCHED, /* Tasklet is scheduled for execution */
338 TASKLET_STATE_RUN /* Tasklet is running (SMP only) */
339};
340
341#ifdef CONFIG_SMP
342static inline int tasklet_trylock(struct tasklet_struct *t)
343{
344 return !test_and_set_bit(TASKLET_STATE_RUN, &(t)->state);
345}
346
347static inline void tasklet_unlock(struct tasklet_struct *t)
348{
349 smp_mb__before_clear_bit();
350 clear_bit(TASKLET_STATE_RUN, &(t)->state);
351}
352
353static inline void tasklet_unlock_wait(struct tasklet_struct *t)
354{
355 while (test_bit(TASKLET_STATE_RUN, &(t)->state)) { barrier(); }
356}
357#else
358#define tasklet_trylock(t) 1
359#define tasklet_unlock_wait(t) do { } while (0)
360#define tasklet_unlock(t) do { } while (0)
361#endif
362
b3c97528 363extern void __tasklet_schedule(struct tasklet_struct *t);
1da177e4
LT
364
365static inline void tasklet_schedule(struct tasklet_struct *t)
366{
367 if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
368 __tasklet_schedule(t);
369}
370
b3c97528 371extern void __tasklet_hi_schedule(struct tasklet_struct *t);
1da177e4
LT
372
373static inline void tasklet_hi_schedule(struct tasklet_struct *t)
374{
375 if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
376 __tasklet_hi_schedule(t);
377}
378
379
380static inline void tasklet_disable_nosync(struct tasklet_struct *t)
381{
382 atomic_inc(&t->count);
383 smp_mb__after_atomic_inc();
384}
385
386static inline void tasklet_disable(struct tasklet_struct *t)
387{
388 tasklet_disable_nosync(t);
389 tasklet_unlock_wait(t);
390 smp_mb();
391}
392
393static inline void tasklet_enable(struct tasklet_struct *t)
394{
395 smp_mb__before_atomic_dec();
396 atomic_dec(&t->count);
397}
398
399static inline void tasklet_hi_enable(struct tasklet_struct *t)
400{
401 smp_mb__before_atomic_dec();
402 atomic_dec(&t->count);
403}
404
405extern void tasklet_kill(struct tasklet_struct *t);
406extern void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu);
407extern void tasklet_init(struct tasklet_struct *t,
408 void (*func)(unsigned long), unsigned long data);
409
410/*
411 * Autoprobing for irqs:
412 *
413 * probe_irq_on() and probe_irq_off() provide robust primitives
414 * for accurate IRQ probing during kernel initialization. They are
415 * reasonably simple to use, are not "fooled" by spurious interrupts,
416 * and, unlike other attempts at IRQ probing, they do not get hung on
417 * stuck interrupts (such as unused PS2 mouse interfaces on ASUS boards).
418 *
419 * For reasonably foolproof probing, use them as follows:
420 *
421 * 1. clear and/or mask the device's internal interrupt.
422 * 2. sti();
423 * 3. irqs = probe_irq_on(); // "take over" all unassigned idle IRQs
424 * 4. enable the device and cause it to trigger an interrupt.
425 * 5. wait for the device to interrupt, using non-intrusive polling or a delay.
426 * 6. irq = probe_irq_off(irqs); // get IRQ number, 0=none, negative=multiple
427 * 7. service the device to clear its pending interrupt.
428 * 8. loop again if paranoia is required.
429 *
430 * probe_irq_on() returns a mask of allocated irq's.
431 *
432 * probe_irq_off() takes the mask as a parameter,
433 * and returns the irq number which occurred,
434 * or zero if none occurred, or a negative irq number
435 * if more than one irq occurred.
436 */
437
438#if defined(CONFIG_GENERIC_HARDIRQS) && !defined(CONFIG_GENERIC_IRQ_PROBE)
439static inline unsigned long probe_irq_on(void)
440{
441 return 0;
442}
443static inline int probe_irq_off(unsigned long val)
444{
445 return 0;
446}
447static inline unsigned int probe_irq_mask(unsigned long val)
448{
449 return 0;
450}
451#else
452extern unsigned long probe_irq_on(void); /* returns 0 on failure */
453extern int probe_irq_off(unsigned long); /* returns 0 or negative on failure */
454extern unsigned int probe_irq_mask(unsigned long); /* returns mask of ISA interrupts */
455#endif
456
6168a702
AM
457#ifdef CONFIG_PROC_FS
458/* Initialize /proc/irq/ */
459extern void init_irq_proc(void);
460#else
461static inline void init_irq_proc(void)
462{
463}
464#endif
465
f74596d0
AB
466int show_interrupts(struct seq_file *p, void *v);
467
1da177e4 468#endif