Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/sparc-2.6
[deliverable/linux.git] / kernel / irq / manage.c
CommitLineData
1da177e4
LT
1/*
2 * linux/kernel/irq/manage.c
3 *
a34db9b2
IM
4 * Copyright (C) 1992, 1998-2006 Linus Torvalds, Ingo Molnar
5 * Copyright (C) 2005-2006 Thomas Gleixner
1da177e4
LT
6 *
7 * This file contains driver APIs to the irq subsystem.
8 */
9
10#include <linux/irq.h>
3aa551c9 11#include <linux/kthread.h>
1da177e4
LT
12#include <linux/module.h>
13#include <linux/random.h>
14#include <linux/interrupt.h>
1aeb272c 15#include <linux/slab.h>
3aa551c9 16#include <linux/sched.h>
1da177e4
LT
17
18#include "internals.h"
19
8d32a307
TG
20#ifdef CONFIG_IRQ_FORCED_THREADING
21__read_mostly bool force_irqthreads;
22
23static int __init setup_forced_irqthreads(char *arg)
24{
25 force_irqthreads = true;
26 return 0;
27}
28early_param("threadirqs", setup_forced_irqthreads);
29#endif
30
1da177e4
LT
31/**
32 * synchronize_irq - wait for pending IRQ handlers (on other CPUs)
1e5d5331 33 * @irq: interrupt number to wait for
1da177e4
LT
34 *
35 * This function waits for any pending IRQ handlers for this interrupt
36 * to complete before returning. If you use this function while
37 * holding a resource the IRQ handler may need you will deadlock.
38 *
39 * This function may be called - with care - from IRQ context.
40 */
41void synchronize_irq(unsigned int irq)
42{
cb5bc832 43 struct irq_desc *desc = irq_to_desc(irq);
32f4125e 44 bool inprogress;
1da177e4 45
7d94f7ca 46 if (!desc)
c2b5a251
MW
47 return;
48
a98ce5c6
HX
49 do {
50 unsigned long flags;
51
52 /*
53 * Wait until we're out of the critical section. This might
54 * give the wrong answer due to the lack of memory barriers.
55 */
32f4125e 56 while (irqd_irq_inprogress(&desc->irq_data))
a98ce5c6
HX
57 cpu_relax();
58
59 /* Ok, that indicated we're done: double-check carefully. */
239007b8 60 raw_spin_lock_irqsave(&desc->lock, flags);
32f4125e 61 inprogress = irqd_irq_inprogress(&desc->irq_data);
239007b8 62 raw_spin_unlock_irqrestore(&desc->lock, flags);
a98ce5c6
HX
63
64 /* Oops, that failed? */
32f4125e 65 } while (inprogress);
3aa551c9
TG
66
67 /*
68 * We made sure that no hardirq handler is running. Now verify
69 * that no threaded handlers are active.
70 */
71 wait_event(desc->wait_for_threads, !atomic_read(&desc->threads_active));
1da177e4 72}
1da177e4
LT
73EXPORT_SYMBOL(synchronize_irq);
74
3aa551c9
TG
75#ifdef CONFIG_SMP
76cpumask_var_t irq_default_affinity;
77
771ee3b0
TG
78/**
79 * irq_can_set_affinity - Check if the affinity of a given irq can be set
80 * @irq: Interrupt to check
81 *
82 */
83int irq_can_set_affinity(unsigned int irq)
84{
08678b08 85 struct irq_desc *desc = irq_to_desc(irq);
771ee3b0 86
bce43032
TG
87 if (!desc || !irqd_can_balance(&desc->irq_data) ||
88 !desc->irq_data.chip || !desc->irq_data.chip->irq_set_affinity)
771ee3b0
TG
89 return 0;
90
91 return 1;
92}
93
591d2fb0
TG
94/**
95 * irq_set_thread_affinity - Notify irq threads to adjust affinity
96 * @desc: irq descriptor which has affitnity changed
97 *
98 * We just set IRQTF_AFFINITY and delegate the affinity setting
99 * to the interrupt thread itself. We can not call
100 * set_cpus_allowed_ptr() here as we hold desc->lock and this
101 * code can be called from hard interrupt context.
102 */
103void irq_set_thread_affinity(struct irq_desc *desc)
3aa551c9
TG
104{
105 struct irqaction *action = desc->action;
106
107 while (action) {
108 if (action->thread)
591d2fb0 109 set_bit(IRQTF_AFFINITY, &action->thread_flags);
3aa551c9
TG
110 action = action->next;
111 }
112}
113
1fa46f1f 114#ifdef CONFIG_GENERIC_PENDING_IRQ
0ef5ca1e 115static inline bool irq_can_move_pcntxt(struct irq_data *data)
1fa46f1f 116{
0ef5ca1e 117 return irqd_can_move_in_process_context(data);
1fa46f1f 118}
0ef5ca1e 119static inline bool irq_move_pending(struct irq_data *data)
1fa46f1f 120{
0ef5ca1e 121 return irqd_is_setaffinity_pending(data);
1fa46f1f
TG
122}
123static inline void
124irq_copy_pending(struct irq_desc *desc, const struct cpumask *mask)
125{
126 cpumask_copy(desc->pending_mask, mask);
127}
128static inline void
129irq_get_pending(struct cpumask *mask, struct irq_desc *desc)
130{
131 cpumask_copy(mask, desc->pending_mask);
132}
133#else
0ef5ca1e 134static inline bool irq_can_move_pcntxt(struct irq_data *data) { return true; }
cd22c0e4 135static inline bool irq_move_pending(struct irq_data *data) { return false; }
1fa46f1f
TG
136static inline void
137irq_copy_pending(struct irq_desc *desc, const struct cpumask *mask) { }
138static inline void
139irq_get_pending(struct cpumask *mask, struct irq_desc *desc) { }
140#endif
141
c2d0c555 142int __irq_set_affinity_locked(struct irq_data *data, const struct cpumask *mask)
771ee3b0 143{
c2d0c555
DD
144 struct irq_chip *chip = irq_data_get_irq_chip(data);
145 struct irq_desc *desc = irq_data_to_desc(data);
1fa46f1f 146 int ret = 0;
771ee3b0 147
c2d0c555 148 if (!chip || !chip->irq_set_affinity)
771ee3b0
TG
149 return -EINVAL;
150
0ef5ca1e 151 if (irq_can_move_pcntxt(data)) {
c2d0c555 152 ret = chip->irq_set_affinity(data, mask, false);
3b8249e7
TG
153 switch (ret) {
154 case IRQ_SET_MASK_OK:
c2d0c555 155 cpumask_copy(data->affinity, mask);
3b8249e7 156 case IRQ_SET_MASK_OK_NOCOPY:
591d2fb0 157 irq_set_thread_affinity(desc);
3b8249e7 158 ret = 0;
57b150cc 159 }
1fa46f1f 160 } else {
c2d0c555 161 irqd_set_move_pending(data);
1fa46f1f 162 irq_copy_pending(desc, mask);
57b150cc 163 }
1fa46f1f 164
cd7eab44
BH
165 if (desc->affinity_notify) {
166 kref_get(&desc->affinity_notify->kref);
167 schedule_work(&desc->affinity_notify->work);
168 }
c2d0c555
DD
169 irqd_set(data, IRQD_AFFINITY_SET);
170
171 return ret;
172}
173
174/**
175 * irq_set_affinity - Set the irq affinity of a given irq
176 * @irq: Interrupt to set affinity
30398bf6 177 * @mask: cpumask
c2d0c555
DD
178 *
179 */
180int irq_set_affinity(unsigned int irq, const struct cpumask *mask)
181{
182 struct irq_desc *desc = irq_to_desc(irq);
183 unsigned long flags;
184 int ret;
185
186 if (!desc)
187 return -EINVAL;
188
189 raw_spin_lock_irqsave(&desc->lock, flags);
190 ret = __irq_set_affinity_locked(irq_desc_get_irq_data(desc), mask);
239007b8 191 raw_spin_unlock_irqrestore(&desc->lock, flags);
1fa46f1f 192 return ret;
771ee3b0
TG
193}
194
e7a297b0
PWJ
195int irq_set_affinity_hint(unsigned int irq, const struct cpumask *m)
196{
e7a297b0 197 unsigned long flags;
02725e74 198 struct irq_desc *desc = irq_get_desc_lock(irq, &flags);
e7a297b0
PWJ
199
200 if (!desc)
201 return -EINVAL;
e7a297b0 202 desc->affinity_hint = m;
02725e74 203 irq_put_desc_unlock(desc, flags);
e7a297b0
PWJ
204 return 0;
205}
206EXPORT_SYMBOL_GPL(irq_set_affinity_hint);
207
cd7eab44
BH
208static void irq_affinity_notify(struct work_struct *work)
209{
210 struct irq_affinity_notify *notify =
211 container_of(work, struct irq_affinity_notify, work);
212 struct irq_desc *desc = irq_to_desc(notify->irq);
213 cpumask_var_t cpumask;
214 unsigned long flags;
215
1fa46f1f 216 if (!desc || !alloc_cpumask_var(&cpumask, GFP_KERNEL))
cd7eab44
BH
217 goto out;
218
219 raw_spin_lock_irqsave(&desc->lock, flags);
0ef5ca1e 220 if (irq_move_pending(&desc->irq_data))
1fa46f1f 221 irq_get_pending(cpumask, desc);
cd7eab44 222 else
1fb0ef31 223 cpumask_copy(cpumask, desc->irq_data.affinity);
cd7eab44
BH
224 raw_spin_unlock_irqrestore(&desc->lock, flags);
225
226 notify->notify(notify, cpumask);
227
228 free_cpumask_var(cpumask);
229out:
230 kref_put(&notify->kref, notify->release);
231}
232
233/**
234 * irq_set_affinity_notifier - control notification of IRQ affinity changes
235 * @irq: Interrupt for which to enable/disable notification
236 * @notify: Context for notification, or %NULL to disable
237 * notification. Function pointers must be initialised;
238 * the other fields will be initialised by this function.
239 *
240 * Must be called in process context. Notification may only be enabled
241 * after the IRQ is allocated and must be disabled before the IRQ is
242 * freed using free_irq().
243 */
244int
245irq_set_affinity_notifier(unsigned int irq, struct irq_affinity_notify *notify)
246{
247 struct irq_desc *desc = irq_to_desc(irq);
248 struct irq_affinity_notify *old_notify;
249 unsigned long flags;
250
251 /* The release function is promised process context */
252 might_sleep();
253
254 if (!desc)
255 return -EINVAL;
256
257 /* Complete initialisation of *notify */
258 if (notify) {
259 notify->irq = irq;
260 kref_init(&notify->kref);
261 INIT_WORK(&notify->work, irq_affinity_notify);
262 }
263
264 raw_spin_lock_irqsave(&desc->lock, flags);
265 old_notify = desc->affinity_notify;
266 desc->affinity_notify = notify;
267 raw_spin_unlock_irqrestore(&desc->lock, flags);
268
269 if (old_notify)
270 kref_put(&old_notify->kref, old_notify->release);
271
272 return 0;
273}
274EXPORT_SYMBOL_GPL(irq_set_affinity_notifier);
275
18404756
MK
276#ifndef CONFIG_AUTO_IRQ_AFFINITY
277/*
278 * Generic version of the affinity autoselector.
279 */
3b8249e7
TG
280static int
281setup_affinity(unsigned int irq, struct irq_desc *desc, struct cpumask *mask)
18404756 282{
35e857cb 283 struct irq_chip *chip = irq_desc_get_chip(desc);
569bda8d 284 struct cpumask *set = irq_default_affinity;
3b8249e7 285 int ret;
569bda8d 286
b008207c 287 /* Excludes PER_CPU and NO_BALANCE interrupts */
18404756
MK
288 if (!irq_can_set_affinity(irq))
289 return 0;
290
f6d87f4b
TG
291 /*
292 * Preserve an userspace affinity setup, but make sure that
293 * one of the targets is online.
294 */
2bdd1055 295 if (irqd_has_set(&desc->irq_data, IRQD_AFFINITY_SET)) {
569bda8d
TG
296 if (cpumask_intersects(desc->irq_data.affinity,
297 cpu_online_mask))
298 set = desc->irq_data.affinity;
0c6f8a8b 299 else
2bdd1055 300 irqd_clear(&desc->irq_data, IRQD_AFFINITY_SET);
f6d87f4b 301 }
18404756 302
3b8249e7
TG
303 cpumask_and(mask, cpu_online_mask, set);
304 ret = chip->irq_set_affinity(&desc->irq_data, mask, false);
305 switch (ret) {
306 case IRQ_SET_MASK_OK:
307 cpumask_copy(desc->irq_data.affinity, mask);
308 case IRQ_SET_MASK_OK_NOCOPY:
309 irq_set_thread_affinity(desc);
310 }
18404756
MK
311 return 0;
312}
f6d87f4b 313#else
3b8249e7
TG
314static inline int
315setup_affinity(unsigned int irq, struct irq_desc *d, struct cpumask *mask)
f6d87f4b
TG
316{
317 return irq_select_affinity(irq);
318}
18404756
MK
319#endif
320
f6d87f4b
TG
321/*
322 * Called when affinity is set via /proc/irq
323 */
3b8249e7 324int irq_select_affinity_usr(unsigned int irq, struct cpumask *mask)
f6d87f4b
TG
325{
326 struct irq_desc *desc = irq_to_desc(irq);
327 unsigned long flags;
328 int ret;
329
239007b8 330 raw_spin_lock_irqsave(&desc->lock, flags);
3b8249e7 331 ret = setup_affinity(irq, desc, mask);
239007b8 332 raw_spin_unlock_irqrestore(&desc->lock, flags);
f6d87f4b
TG
333 return ret;
334}
335
336#else
3b8249e7
TG
337static inline int
338setup_affinity(unsigned int irq, struct irq_desc *desc, struct cpumask *mask)
f6d87f4b
TG
339{
340 return 0;
341}
1da177e4
LT
342#endif
343
0a0c5168
RW
344void __disable_irq(struct irq_desc *desc, unsigned int irq, bool suspend)
345{
346 if (suspend) {
685fd0b4 347 if (!desc->action || (desc->action->flags & IRQF_NO_SUSPEND))
0a0c5168 348 return;
c531e836 349 desc->istate |= IRQS_SUSPENDED;
0a0c5168
RW
350 }
351
3aae994f 352 if (!desc->depth++)
87923470 353 irq_disable(desc);
0a0c5168
RW
354}
355
02725e74
TG
356static int __disable_irq_nosync(unsigned int irq)
357{
358 unsigned long flags;
359 struct irq_desc *desc = irq_get_desc_buslock(irq, &flags);
360
361 if (!desc)
362 return -EINVAL;
363 __disable_irq(desc, irq, false);
364 irq_put_desc_busunlock(desc, flags);
365 return 0;
366}
367
1da177e4
LT
368/**
369 * disable_irq_nosync - disable an irq without waiting
370 * @irq: Interrupt to disable
371 *
372 * Disable the selected interrupt line. Disables and Enables are
373 * nested.
374 * Unlike disable_irq(), this function does not ensure existing
375 * instances of the IRQ handler have completed before returning.
376 *
377 * This function may be called from IRQ context.
378 */
379void disable_irq_nosync(unsigned int irq)
380{
02725e74 381 __disable_irq_nosync(irq);
1da177e4 382}
1da177e4
LT
383EXPORT_SYMBOL(disable_irq_nosync);
384
385/**
386 * disable_irq - disable an irq and wait for completion
387 * @irq: Interrupt to disable
388 *
389 * Disable the selected interrupt line. Enables and Disables are
390 * nested.
391 * This function waits for any pending IRQ handlers for this interrupt
392 * to complete before returning. If you use this function while
393 * holding a resource the IRQ handler may need you will deadlock.
394 *
395 * This function may be called - with care - from IRQ context.
396 */
397void disable_irq(unsigned int irq)
398{
02725e74 399 if (!__disable_irq_nosync(irq))
1da177e4
LT
400 synchronize_irq(irq);
401}
1da177e4
LT
402EXPORT_SYMBOL(disable_irq);
403
0a0c5168 404void __enable_irq(struct irq_desc *desc, unsigned int irq, bool resume)
1adb0850 405{
dc5f219e 406 if (resume) {
c531e836 407 if (!(desc->istate & IRQS_SUSPENDED)) {
dc5f219e
TG
408 if (!desc->action)
409 return;
410 if (!(desc->action->flags & IRQF_FORCE_RESUME))
411 return;
412 /* Pretend that it got disabled ! */
413 desc->depth++;
414 }
c531e836 415 desc->istate &= ~IRQS_SUSPENDED;
dc5f219e 416 }
0a0c5168 417
1adb0850
TG
418 switch (desc->depth) {
419 case 0:
0a0c5168 420 err_out:
b8c512f6 421 WARN(1, KERN_WARNING "Unbalanced enable for IRQ %d\n", irq);
1adb0850
TG
422 break;
423 case 1: {
c531e836 424 if (desc->istate & IRQS_SUSPENDED)
0a0c5168 425 goto err_out;
1adb0850 426 /* Prevent probing on this irq: */
1ccb4e61 427 irq_settings_set_noprobe(desc);
3aae994f 428 irq_enable(desc);
1adb0850
TG
429 check_irq_resend(desc, irq);
430 /* fall-through */
431 }
432 default:
433 desc->depth--;
434 }
435}
436
1da177e4
LT
437/**
438 * enable_irq - enable handling of an irq
439 * @irq: Interrupt to enable
440 *
441 * Undoes the effect of one call to disable_irq(). If this
442 * matches the last disable, processing of interrupts on this
443 * IRQ line is re-enabled.
444 *
70aedd24 445 * This function may be called from IRQ context only when
6b8ff312 446 * desc->irq_data.chip->bus_lock and desc->chip->bus_sync_unlock are NULL !
1da177e4
LT
447 */
448void enable_irq(unsigned int irq)
449{
1da177e4 450 unsigned long flags;
02725e74 451 struct irq_desc *desc = irq_get_desc_buslock(irq, &flags);
1da177e4 452
7d94f7ca 453 if (!desc)
c2b5a251 454 return;
50f7c032
TG
455 if (WARN(!desc->irq_data.chip,
456 KERN_ERR "enable_irq before setup/request_irq: irq %u\n", irq))
02725e74 457 goto out;
2656c366 458
0a0c5168 459 __enable_irq(desc, irq, false);
02725e74
TG
460out:
461 irq_put_desc_busunlock(desc, flags);
1da177e4 462}
1da177e4
LT
463EXPORT_SYMBOL(enable_irq);
464
0c5d1eb7 465static int set_irq_wake_real(unsigned int irq, unsigned int on)
2db87321 466{
08678b08 467 struct irq_desc *desc = irq_to_desc(irq);
2db87321
UKK
468 int ret = -ENXIO;
469
2f7e99bb
TG
470 if (desc->irq_data.chip->irq_set_wake)
471 ret = desc->irq_data.chip->irq_set_wake(&desc->irq_data, on);
2db87321
UKK
472
473 return ret;
474}
475
ba9a2331 476/**
a0cd9ca2 477 * irq_set_irq_wake - control irq power management wakeup
ba9a2331
TG
478 * @irq: interrupt to control
479 * @on: enable/disable power management wakeup
480 *
15a647eb
DB
481 * Enable/disable power management wakeup mode, which is
482 * disabled by default. Enables and disables must match,
483 * just as they match for non-wakeup mode support.
484 *
485 * Wakeup mode lets this IRQ wake the system from sleep
486 * states like "suspend to RAM".
ba9a2331 487 */
a0cd9ca2 488int irq_set_irq_wake(unsigned int irq, unsigned int on)
ba9a2331 489{
ba9a2331 490 unsigned long flags;
02725e74 491 struct irq_desc *desc = irq_get_desc_buslock(irq, &flags);
2db87321 492 int ret = 0;
ba9a2331 493
15a647eb
DB
494 /* wakeup-capable irqs can be shared between drivers that
495 * don't need to have the same sleep mode behaviors.
496 */
15a647eb 497 if (on) {
2db87321
UKK
498 if (desc->wake_depth++ == 0) {
499 ret = set_irq_wake_real(irq, on);
500 if (ret)
501 desc->wake_depth = 0;
502 else
7f94226f 503 irqd_set(&desc->irq_data, IRQD_WAKEUP_STATE);
2db87321 504 }
15a647eb
DB
505 } else {
506 if (desc->wake_depth == 0) {
7a2c4770 507 WARN(1, "Unbalanced IRQ %d wake disable\n", irq);
2db87321
UKK
508 } else if (--desc->wake_depth == 0) {
509 ret = set_irq_wake_real(irq, on);
510 if (ret)
511 desc->wake_depth = 1;
512 else
7f94226f 513 irqd_clear(&desc->irq_data, IRQD_WAKEUP_STATE);
2db87321 514 }
15a647eb 515 }
02725e74 516 irq_put_desc_busunlock(desc, flags);
ba9a2331
TG
517 return ret;
518}
a0cd9ca2 519EXPORT_SYMBOL(irq_set_irq_wake);
ba9a2331 520
1da177e4
LT
521/*
522 * Internal function that tells the architecture code whether a
523 * particular irq has been exclusively allocated or is available
524 * for driver use.
525 */
526int can_request_irq(unsigned int irq, unsigned long irqflags)
527{
cc8c3b78 528 unsigned long flags;
02725e74
TG
529 struct irq_desc *desc = irq_get_desc_lock(irq, &flags);
530 int canrequest = 0;
1da177e4 531
7d94f7ca
YL
532 if (!desc)
533 return 0;
534
02725e74
TG
535 if (irq_settings_can_request(desc)) {
536 if (desc->action)
537 if (irqflags & desc->action->flags & IRQF_SHARED)
538 canrequest =1;
539 }
540 irq_put_desc_unlock(desc, flags);
541 return canrequest;
1da177e4
LT
542}
543
0c5d1eb7 544int __irq_set_trigger(struct irq_desc *desc, unsigned int irq,
b2ba2c30 545 unsigned long flags)
82736f4d 546{
6b8ff312 547 struct irq_chip *chip = desc->irq_data.chip;
d4d5e089 548 int ret, unmask = 0;
82736f4d 549
b2ba2c30 550 if (!chip || !chip->irq_set_type) {
82736f4d
UKK
551 /*
552 * IRQF_TRIGGER_* but the PIC does not support multiple
553 * flow-types?
554 */
3ff68a6a 555 pr_debug("No set_type function for IRQ %d (%s)\n", irq,
82736f4d
UKK
556 chip ? (chip->name ? : "unknown") : "unknown");
557 return 0;
558 }
559
876dbd4c 560 flags &= IRQ_TYPE_SENSE_MASK;
d4d5e089
TG
561
562 if (chip->flags & IRQCHIP_SET_TYPE_MASKED) {
32f4125e 563 if (!irqd_irq_masked(&desc->irq_data))
d4d5e089 564 mask_irq(desc);
32f4125e 565 if (!irqd_irq_disabled(&desc->irq_data))
d4d5e089
TG
566 unmask = 1;
567 }
568
f2b662da 569 /* caller masked out all except trigger mode flags */
b2ba2c30 570 ret = chip->irq_set_type(&desc->irq_data, flags);
82736f4d 571
876dbd4c
TG
572 switch (ret) {
573 case IRQ_SET_MASK_OK:
574 irqd_clear(&desc->irq_data, IRQD_TRIGGER_MASK);
575 irqd_set(&desc->irq_data, flags);
576
577 case IRQ_SET_MASK_OK_NOCOPY:
578 flags = irqd_get_trigger_type(&desc->irq_data);
579 irq_settings_set_trigger_mask(desc, flags);
580 irqd_clear(&desc->irq_data, IRQD_LEVEL);
581 irq_settings_clr_level(desc);
582 if (flags & IRQ_TYPE_LEVEL_MASK) {
583 irq_settings_set_level(desc);
584 irqd_set(&desc->irq_data, IRQD_LEVEL);
585 }
46732475 586
d4d5e089 587 ret = 0;
8fff39e0 588 break;
876dbd4c
TG
589 default:
590 pr_err("setting trigger mode %lu for irq %u failed (%pF)\n",
591 flags, irq, chip->irq_set_type);
0c5d1eb7 592 }
d4d5e089
TG
593 if (unmask)
594 unmask_irq(desc);
82736f4d
UKK
595 return ret;
596}
597
b25c340c
TG
598/*
599 * Default primary interrupt handler for threaded interrupts. Is
600 * assigned as primary handler when request_threaded_irq is called
601 * with handler == NULL. Useful for oneshot interrupts.
602 */
603static irqreturn_t irq_default_primary_handler(int irq, void *dev_id)
604{
605 return IRQ_WAKE_THREAD;
606}
607
399b5da2
TG
608/*
609 * Primary handler for nested threaded interrupts. Should never be
610 * called.
611 */
612static irqreturn_t irq_nested_primary_handler(int irq, void *dev_id)
613{
614 WARN(1, "Primary handler called for nested irq %d\n", irq);
615 return IRQ_NONE;
616}
617
3aa551c9
TG
618static int irq_wait_for_interrupt(struct irqaction *action)
619{
620 while (!kthread_should_stop()) {
621 set_current_state(TASK_INTERRUPTIBLE);
f48fe81e
TG
622
623 if (test_and_clear_bit(IRQTF_RUNTHREAD,
624 &action->thread_flags)) {
3aa551c9
TG
625 __set_current_state(TASK_RUNNING);
626 return 0;
f48fe81e
TG
627 }
628 schedule();
3aa551c9
TG
629 }
630 return -1;
631}
632
b25c340c
TG
633/*
634 * Oneshot interrupts keep the irq line masked until the threaded
635 * handler finished. unmask if the interrupt has not been disabled and
636 * is marked MASKED.
637 */
b5faba21
TG
638static void irq_finalize_oneshot(struct irq_desc *desc,
639 struct irqaction *action, bool force)
b25c340c 640{
b5faba21
TG
641 if (!(desc->istate & IRQS_ONESHOT))
642 return;
0b1adaa0 643again:
3876ec9e 644 chip_bus_lock(desc);
239007b8 645 raw_spin_lock_irq(&desc->lock);
0b1adaa0
TG
646
647 /*
648 * Implausible though it may be we need to protect us against
649 * the following scenario:
650 *
651 * The thread is faster done than the hard interrupt handler
652 * on the other CPU. If we unmask the irq line then the
653 * interrupt can come in again and masks the line, leaves due
009b4c3b 654 * to IRQS_INPROGRESS and the irq line is masked forever.
b5faba21
TG
655 *
656 * This also serializes the state of shared oneshot handlers
657 * versus "desc->threads_onehsot |= action->thread_mask;" in
658 * irq_wake_thread(). See the comment there which explains the
659 * serialization.
0b1adaa0 660 */
32f4125e 661 if (unlikely(irqd_irq_inprogress(&desc->irq_data))) {
0b1adaa0 662 raw_spin_unlock_irq(&desc->lock);
3876ec9e 663 chip_bus_sync_unlock(desc);
0b1adaa0
TG
664 cpu_relax();
665 goto again;
666 }
667
b5faba21
TG
668 /*
669 * Now check again, whether the thread should run. Otherwise
670 * we would clear the threads_oneshot bit of this thread which
671 * was just set.
672 */
673 if (!force && test_bit(IRQTF_RUNTHREAD, &action->thread_flags))
674 goto out_unlock;
675
676 desc->threads_oneshot &= ~action->thread_mask;
677
32f4125e
TG
678 if (!desc->threads_oneshot && !irqd_irq_disabled(&desc->irq_data) &&
679 irqd_irq_masked(&desc->irq_data))
680 unmask_irq(desc);
681
b5faba21 682out_unlock:
239007b8 683 raw_spin_unlock_irq(&desc->lock);
3876ec9e 684 chip_bus_sync_unlock(desc);
b25c340c
TG
685}
686
61f38261 687#ifdef CONFIG_SMP
591d2fb0 688/*
d4d5e089 689 * Check whether we need to chasnge the affinity of the interrupt thread.
591d2fb0
TG
690 */
691static void
692irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action)
693{
694 cpumask_var_t mask;
695
696 if (!test_and_clear_bit(IRQTF_AFFINITY, &action->thread_flags))
697 return;
698
699 /*
700 * In case we are out of memory we set IRQTF_AFFINITY again and
701 * try again next time
702 */
703 if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
704 set_bit(IRQTF_AFFINITY, &action->thread_flags);
705 return;
706 }
707
239007b8 708 raw_spin_lock_irq(&desc->lock);
6b8ff312 709 cpumask_copy(mask, desc->irq_data.affinity);
239007b8 710 raw_spin_unlock_irq(&desc->lock);
591d2fb0
TG
711
712 set_cpus_allowed_ptr(current, mask);
713 free_cpumask_var(mask);
714}
61f38261
BP
715#else
716static inline void
717irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action) { }
718#endif
591d2fb0 719
8d32a307
TG
720/*
721 * Interrupts which are not explicitely requested as threaded
722 * interrupts rely on the implicit bh/preempt disable of the hard irq
723 * context. So we need to disable bh here to avoid deadlocks and other
724 * side effects.
725 */
3a43e05f 726static irqreturn_t
8d32a307
TG
727irq_forced_thread_fn(struct irq_desc *desc, struct irqaction *action)
728{
3a43e05f
SAS
729 irqreturn_t ret;
730
8d32a307 731 local_bh_disable();
3a43e05f 732 ret = action->thread_fn(action->irq, action->dev_id);
8d32a307
TG
733 irq_finalize_oneshot(desc, action, false);
734 local_bh_enable();
3a43e05f 735 return ret;
8d32a307
TG
736}
737
738/*
739 * Interrupts explicitely requested as threaded interupts want to be
740 * preemtible - many of them need to sleep and wait for slow busses to
741 * complete.
742 */
3a43e05f
SAS
743static irqreturn_t irq_thread_fn(struct irq_desc *desc,
744 struct irqaction *action)
8d32a307 745{
3a43e05f
SAS
746 irqreturn_t ret;
747
748 ret = action->thread_fn(action->irq, action->dev_id);
8d32a307 749 irq_finalize_oneshot(desc, action, false);
3a43e05f 750 return ret;
8d32a307
TG
751}
752
3aa551c9
TG
753/*
754 * Interrupt handler thread
755 */
756static int irq_thread(void *data)
757{
c9b5f501 758 static const struct sched_param param = {
fe7de49f
KM
759 .sched_priority = MAX_USER_RT_PRIO/2,
760 };
3aa551c9
TG
761 struct irqaction *action = data;
762 struct irq_desc *desc = irq_to_desc(action->irq);
3a43e05f
SAS
763 irqreturn_t (*handler_fn)(struct irq_desc *desc,
764 struct irqaction *action);
b5faba21 765 int wake;
3aa551c9 766
8d32a307
TG
767 if (force_irqthreads & test_bit(IRQTF_FORCED_THREAD,
768 &action->thread_flags))
769 handler_fn = irq_forced_thread_fn;
770 else
771 handler_fn = irq_thread_fn;
772
3aa551c9
TG
773 sched_setscheduler(current, SCHED_FIFO, &param);
774 current->irqaction = action;
775
776 while (!irq_wait_for_interrupt(action)) {
777
591d2fb0
TG
778 irq_thread_check_affinity(desc, action);
779
3aa551c9
TG
780 atomic_inc(&desc->threads_active);
781
239007b8 782 raw_spin_lock_irq(&desc->lock);
32f4125e 783 if (unlikely(irqd_irq_disabled(&desc->irq_data))) {
3aa551c9
TG
784 /*
785 * CHECKME: We might need a dedicated
786 * IRQ_THREAD_PENDING flag here, which
787 * retriggers the thread in check_irq_resend()
2a0d6fb3 788 * but AFAICT IRQS_PENDING should be fine as it
3aa551c9
TG
789 * retriggers the interrupt itself --- tglx
790 */
2a0d6fb3 791 desc->istate |= IRQS_PENDING;
239007b8 792 raw_spin_unlock_irq(&desc->lock);
3aa551c9 793 } else {
3a43e05f
SAS
794 irqreturn_t action_ret;
795
239007b8 796 raw_spin_unlock_irq(&desc->lock);
3a43e05f
SAS
797 action_ret = handler_fn(desc, action);
798 if (!noirqdebug)
799 note_interrupt(action->irq, desc, action_ret);
3aa551c9
TG
800 }
801
802 wake = atomic_dec_and_test(&desc->threads_active);
803
804 if (wake && waitqueue_active(&desc->wait_for_threads))
805 wake_up(&desc->wait_for_threads);
806 }
807
b5faba21
TG
808 /* Prevent a stale desc->threads_oneshot */
809 irq_finalize_oneshot(desc, action, true);
810
3aa551c9
TG
811 /*
812 * Clear irqaction. Otherwise exit_irq_thread() would make
813 * fuzz about an active irq thread going into nirvana.
814 */
815 current->irqaction = NULL;
816 return 0;
817}
818
819/*
820 * Called from do_exit()
821 */
822void exit_irq_thread(void)
823{
824 struct task_struct *tsk = current;
b5faba21 825 struct irq_desc *desc;
3aa551c9
TG
826
827 if (!tsk->irqaction)
828 return;
829
830 printk(KERN_ERR
831 "exiting task \"%s\" (%d) is an active IRQ thread (irq %d)\n",
832 tsk->comm ? tsk->comm : "", tsk->pid, tsk->irqaction->irq);
833
b5faba21
TG
834 desc = irq_to_desc(tsk->irqaction->irq);
835
836 /*
837 * Prevent a stale desc->threads_oneshot. Must be called
838 * before setting the IRQTF_DIED flag.
839 */
840 irq_finalize_oneshot(desc, tsk->irqaction, true);
841
3aa551c9
TG
842 /*
843 * Set the THREAD DIED flag to prevent further wakeups of the
844 * soon to be gone threaded handler.
845 */
846 set_bit(IRQTF_DIED, &tsk->irqaction->flags);
847}
848
8d32a307
TG
849static void irq_setup_forced_threading(struct irqaction *new)
850{
851 if (!force_irqthreads)
852 return;
853 if (new->flags & (IRQF_NO_THREAD | IRQF_PERCPU | IRQF_ONESHOT))
854 return;
855
856 new->flags |= IRQF_ONESHOT;
857
858 if (!new->thread_fn) {
859 set_bit(IRQTF_FORCED_THREAD, &new->thread_flags);
860 new->thread_fn = new->handler;
861 new->handler = irq_default_primary_handler;
862 }
863}
864
1da177e4
LT
865/*
866 * Internal function to register an irqaction - typically used to
867 * allocate special interrupts that are part of the architecture.
868 */
d3c60047 869static int
327ec569 870__setup_irq(unsigned int irq, struct irq_desc *desc, struct irqaction *new)
1da177e4 871{
f17c7545 872 struct irqaction *old, **old_ptr;
8b126b77 873 const char *old_name = NULL;
b5faba21 874 unsigned long flags, thread_mask = 0;
3b8249e7
TG
875 int ret, nested, shared = 0;
876 cpumask_var_t mask;
1da177e4 877
7d94f7ca 878 if (!desc)
c2b5a251
MW
879 return -EINVAL;
880
6b8ff312 881 if (desc->irq_data.chip == &no_irq_chip)
1da177e4
LT
882 return -ENOSYS;
883 /*
884 * Some drivers like serial.c use request_irq() heavily,
885 * so we have to be careful not to interfere with a
886 * running system.
887 */
3cca53b0 888 if (new->flags & IRQF_SAMPLE_RANDOM) {
1da177e4
LT
889 /*
890 * This function might sleep, we want to call it first,
891 * outside of the atomic block.
892 * Yes, this might clear the entropy pool if the wrong
893 * driver is attempted to be loaded, without actually
894 * installing a new handler, but is this really a problem,
895 * only the sysadmin is able to do this.
896 */
897 rand_initialize_irq(irq);
898 }
899
3aa551c9 900 /*
399b5da2
TG
901 * Check whether the interrupt nests into another interrupt
902 * thread.
903 */
1ccb4e61 904 nested = irq_settings_is_nested_thread(desc);
399b5da2
TG
905 if (nested) {
906 if (!new->thread_fn)
907 return -EINVAL;
908 /*
909 * Replace the primary handler which was provided from
910 * the driver for non nested interrupt handling by the
911 * dummy function which warns when called.
912 */
913 new->handler = irq_nested_primary_handler;
8d32a307 914 } else {
7f1b1244
PM
915 if (irq_settings_can_thread(desc))
916 irq_setup_forced_threading(new);
399b5da2
TG
917 }
918
3aa551c9 919 /*
399b5da2
TG
920 * Create a handler thread when a thread function is supplied
921 * and the interrupt does not nest into another interrupt
922 * thread.
3aa551c9 923 */
399b5da2 924 if (new->thread_fn && !nested) {
3aa551c9
TG
925 struct task_struct *t;
926
927 t = kthread_create(irq_thread, new, "irq/%d-%s", irq,
928 new->name);
929 if (IS_ERR(t))
930 return PTR_ERR(t);
931 /*
932 * We keep the reference to the task struct even if
933 * the thread dies to avoid that the interrupt code
934 * references an already freed task_struct.
935 */
936 get_task_struct(t);
937 new->thread = t;
3aa551c9
TG
938 }
939
3b8249e7
TG
940 if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
941 ret = -ENOMEM;
942 goto out_thread;
943 }
944
1da177e4
LT
945 /*
946 * The following block of code has to be executed atomically
947 */
239007b8 948 raw_spin_lock_irqsave(&desc->lock, flags);
f17c7545
IM
949 old_ptr = &desc->action;
950 old = *old_ptr;
06fcb0c6 951 if (old) {
e76de9f8
TG
952 /*
953 * Can't share interrupts unless both agree to and are
954 * the same type (level, edge, polarity). So both flag
3cca53b0 955 * fields must have IRQF_SHARED set and the bits which
9d591edd
TG
956 * set the trigger type must match. Also all must
957 * agree on ONESHOT.
e76de9f8 958 */
3cca53b0 959 if (!((old->flags & new->flags) & IRQF_SHARED) ||
9d591edd
TG
960 ((old->flags ^ new->flags) & IRQF_TRIGGER_MASK) ||
961 ((old->flags ^ new->flags) & IRQF_ONESHOT)) {
8b126b77 962 old_name = old->name;
f5163427 963 goto mismatch;
8b126b77 964 }
f5163427 965
f5163427 966 /* All handlers must agree on per-cpuness */
3cca53b0
TG
967 if ((old->flags & IRQF_PERCPU) !=
968 (new->flags & IRQF_PERCPU))
f5163427 969 goto mismatch;
1da177e4
LT
970
971 /* add new interrupt at end of irq queue */
972 do {
b5faba21 973 thread_mask |= old->thread_mask;
f17c7545
IM
974 old_ptr = &old->next;
975 old = *old_ptr;
1da177e4
LT
976 } while (old);
977 shared = 1;
978 }
979
b5faba21
TG
980 /*
981 * Setup the thread mask for this irqaction. Unlikely to have
982 * 32 resp 64 irqs sharing one line, but who knows.
983 */
984 if (new->flags & IRQF_ONESHOT && thread_mask == ~0UL) {
985 ret = -EBUSY;
986 goto out_mask;
987 }
988 new->thread_mask = 1 << ffz(thread_mask);
989
1da177e4 990 if (!shared) {
3aa551c9
TG
991 init_waitqueue_head(&desc->wait_for_threads);
992
e76de9f8 993 /* Setup the type (level, edge polarity) if configured: */
3cca53b0 994 if (new->flags & IRQF_TRIGGER_MASK) {
f2b662da
DB
995 ret = __irq_set_trigger(desc, irq,
996 new->flags & IRQF_TRIGGER_MASK);
82736f4d 997
3aa551c9 998 if (ret)
3b8249e7 999 goto out_mask;
091738a2 1000 }
6a6de9ef 1001
009b4c3b 1002 desc->istate &= ~(IRQS_AUTODETECT | IRQS_SPURIOUS_DISABLED | \
32f4125e
TG
1003 IRQS_ONESHOT | IRQS_WAITING);
1004 irqd_clear(&desc->irq_data, IRQD_IRQ_INPROGRESS);
94d39e1f 1005
a005677b
TG
1006 if (new->flags & IRQF_PERCPU) {
1007 irqd_set(&desc->irq_data, IRQD_PER_CPU);
1008 irq_settings_set_per_cpu(desc);
1009 }
6a58fb3b 1010
b25c340c 1011 if (new->flags & IRQF_ONESHOT)
3d67baec 1012 desc->istate |= IRQS_ONESHOT;
b25c340c 1013
1ccb4e61 1014 if (irq_settings_can_autoenable(desc))
46999238
TG
1015 irq_startup(desc);
1016 else
e76de9f8
TG
1017 /* Undo nested disables: */
1018 desc->depth = 1;
18404756 1019
612e3684 1020 /* Exclude IRQ from balancing if requested */
a005677b
TG
1021 if (new->flags & IRQF_NOBALANCING) {
1022 irq_settings_set_no_balancing(desc);
1023 irqd_set(&desc->irq_data, IRQD_NO_BALANCING);
1024 }
612e3684 1025
18404756 1026 /* Set default affinity mask once everything is setup */
3b8249e7 1027 setup_affinity(irq, desc, mask);
0c5d1eb7 1028
876dbd4c
TG
1029 } else if (new->flags & IRQF_TRIGGER_MASK) {
1030 unsigned int nmsk = new->flags & IRQF_TRIGGER_MASK;
1031 unsigned int omsk = irq_settings_get_trigger_mask(desc);
1032
1033 if (nmsk != omsk)
1034 /* hope the handler works with current trigger mode */
1035 pr_warning("IRQ %d uses trigger mode %u; requested %u\n",
1036 irq, nmsk, omsk);
1da177e4 1037 }
82736f4d 1038
69ab8494 1039 new->irq = irq;
f17c7545 1040 *old_ptr = new;
82736f4d 1041
8528b0f1
LT
1042 /* Reset broken irq detection when installing new handler */
1043 desc->irq_count = 0;
1044 desc->irqs_unhandled = 0;
1adb0850
TG
1045
1046 /*
1047 * Check whether we disabled the irq via the spurious handler
1048 * before. Reenable it and give it another chance.
1049 */
7acdd53e
TG
1050 if (shared && (desc->istate & IRQS_SPURIOUS_DISABLED)) {
1051 desc->istate &= ~IRQS_SPURIOUS_DISABLED;
0a0c5168 1052 __enable_irq(desc, irq, false);
1adb0850
TG
1053 }
1054
239007b8 1055 raw_spin_unlock_irqrestore(&desc->lock, flags);
1da177e4 1056
69ab8494
TG
1057 /*
1058 * Strictly no need to wake it up, but hung_task complains
1059 * when no hard interrupt wakes the thread up.
1060 */
1061 if (new->thread)
1062 wake_up_process(new->thread);
1063
2c6927a3 1064 register_irq_proc(irq, desc);
1da177e4
LT
1065 new->dir = NULL;
1066 register_handler_proc(irq, new);
4f5058c3 1067 free_cpumask_var(mask);
1da177e4
LT
1068
1069 return 0;
f5163427
DS
1070
1071mismatch:
3f050447 1072#ifdef CONFIG_DEBUG_SHIRQ
3cca53b0 1073 if (!(new->flags & IRQF_PROBE_SHARED)) {
e8c4b9d0 1074 printk(KERN_ERR "IRQ handler type mismatch for IRQ %d\n", irq);
8b126b77
AM
1075 if (old_name)
1076 printk(KERN_ERR "current handler: %s\n", old_name);
13e87ec6
AM
1077 dump_stack();
1078 }
3f050447 1079#endif
3aa551c9
TG
1080 ret = -EBUSY;
1081
3b8249e7 1082out_mask:
1c389795 1083 raw_spin_unlock_irqrestore(&desc->lock, flags);
3b8249e7
TG
1084 free_cpumask_var(mask);
1085
3aa551c9 1086out_thread:
3aa551c9
TG
1087 if (new->thread) {
1088 struct task_struct *t = new->thread;
1089
1090 new->thread = NULL;
1091 if (likely(!test_bit(IRQTF_DIED, &new->thread_flags)))
1092 kthread_stop(t);
1093 put_task_struct(t);
1094 }
1095 return ret;
1da177e4
LT
1096}
1097
d3c60047
TG
1098/**
1099 * setup_irq - setup an interrupt
1100 * @irq: Interrupt line to setup
1101 * @act: irqaction for the interrupt
1102 *
1103 * Used to statically setup interrupts in the early boot process.
1104 */
1105int setup_irq(unsigned int irq, struct irqaction *act)
1106{
986c011d 1107 int retval;
d3c60047
TG
1108 struct irq_desc *desc = irq_to_desc(irq);
1109
986c011d
DD
1110 chip_bus_lock(desc);
1111 retval = __setup_irq(irq, desc, act);
1112 chip_bus_sync_unlock(desc);
1113
1114 return retval;
d3c60047 1115}
eb53b4e8 1116EXPORT_SYMBOL_GPL(setup_irq);
d3c60047 1117
cbf94f06
MD
1118 /*
1119 * Internal function to unregister an irqaction - used to free
1120 * regular and special interrupts that are part of the architecture.
1da177e4 1121 */
cbf94f06 1122static struct irqaction *__free_irq(unsigned int irq, void *dev_id)
1da177e4 1123{
d3c60047 1124 struct irq_desc *desc = irq_to_desc(irq);
f17c7545 1125 struct irqaction *action, **action_ptr;
1da177e4
LT
1126 unsigned long flags;
1127
ae88a23b 1128 WARN(in_interrupt(), "Trying to free IRQ %d from IRQ context!\n", irq);
7d94f7ca 1129
7d94f7ca 1130 if (!desc)
f21cfb25 1131 return NULL;
1da177e4 1132
239007b8 1133 raw_spin_lock_irqsave(&desc->lock, flags);
ae88a23b
IM
1134
1135 /*
1136 * There can be multiple actions per IRQ descriptor, find the right
1137 * one based on the dev_id:
1138 */
f17c7545 1139 action_ptr = &desc->action;
1da177e4 1140 for (;;) {
f17c7545 1141 action = *action_ptr;
1da177e4 1142
ae88a23b
IM
1143 if (!action) {
1144 WARN(1, "Trying to free already-free IRQ %d\n", irq);
239007b8 1145 raw_spin_unlock_irqrestore(&desc->lock, flags);
1da177e4 1146
f21cfb25 1147 return NULL;
ae88a23b 1148 }
1da177e4 1149
8316e381
IM
1150 if (action->dev_id == dev_id)
1151 break;
f17c7545 1152 action_ptr = &action->next;
ae88a23b 1153 }
dbce706e 1154
ae88a23b 1155 /* Found it - now remove it from the list of entries: */
f17c7545 1156 *action_ptr = action->next;
ae88a23b
IM
1157
1158 /* Currently used only by UML, might disappear one day: */
b77d6adc 1159#ifdef CONFIG_IRQ_RELEASE_METHOD
6b8ff312
TG
1160 if (desc->irq_data.chip->release)
1161 desc->irq_data.chip->release(irq, dev_id);
b77d6adc 1162#endif
dbce706e 1163
ae88a23b 1164 /* If this was the last handler, shut down the IRQ line: */
46999238
TG
1165 if (!desc->action)
1166 irq_shutdown(desc);
3aa551c9 1167
e7a297b0
PWJ
1168#ifdef CONFIG_SMP
1169 /* make sure affinity_hint is cleaned up */
1170 if (WARN_ON_ONCE(desc->affinity_hint))
1171 desc->affinity_hint = NULL;
1172#endif
1173
239007b8 1174 raw_spin_unlock_irqrestore(&desc->lock, flags);
ae88a23b
IM
1175
1176 unregister_handler_proc(irq, action);
1177
1178 /* Make sure it's not being used on another CPU: */
1179 synchronize_irq(irq);
1da177e4 1180
70edcd77 1181#ifdef CONFIG_DEBUG_SHIRQ
ae88a23b
IM
1182 /*
1183 * It's a shared IRQ -- the driver ought to be prepared for an IRQ
1184 * event to happen even now it's being freed, so let's make sure that
1185 * is so by doing an extra call to the handler ....
1186 *
1187 * ( We do this after actually deregistering it, to make sure that a
1188 * 'real' IRQ doesn't run in * parallel with our fake. )
1189 */
1190 if (action->flags & IRQF_SHARED) {
1191 local_irq_save(flags);
1192 action->handler(irq, dev_id);
1193 local_irq_restore(flags);
1da177e4 1194 }
ae88a23b 1195#endif
2d860ad7
LT
1196
1197 if (action->thread) {
1198 if (!test_bit(IRQTF_DIED, &action->thread_flags))
1199 kthread_stop(action->thread);
1200 put_task_struct(action->thread);
1201 }
1202
f21cfb25
MD
1203 return action;
1204}
1205
cbf94f06
MD
1206/**
1207 * remove_irq - free an interrupt
1208 * @irq: Interrupt line to free
1209 * @act: irqaction for the interrupt
1210 *
1211 * Used to remove interrupts statically setup by the early boot process.
1212 */
1213void remove_irq(unsigned int irq, struct irqaction *act)
1214{
1215 __free_irq(irq, act->dev_id);
1216}
eb53b4e8 1217EXPORT_SYMBOL_GPL(remove_irq);
cbf94f06 1218
f21cfb25
MD
1219/**
1220 * free_irq - free an interrupt allocated with request_irq
1221 * @irq: Interrupt line to free
1222 * @dev_id: Device identity to free
1223 *
1224 * Remove an interrupt handler. The handler is removed and if the
1225 * interrupt line is no longer in use by any driver it is disabled.
1226 * On a shared IRQ the caller must ensure the interrupt is disabled
1227 * on the card it drives before calling this function. The function
1228 * does not return until any executing interrupts for this IRQ
1229 * have completed.
1230 *
1231 * This function must not be called from interrupt context.
1232 */
1233void free_irq(unsigned int irq, void *dev_id)
1234{
70aedd24
TG
1235 struct irq_desc *desc = irq_to_desc(irq);
1236
1237 if (!desc)
1238 return;
1239
cd7eab44
BH
1240#ifdef CONFIG_SMP
1241 if (WARN_ON(desc->affinity_notify))
1242 desc->affinity_notify = NULL;
1243#endif
1244
3876ec9e 1245 chip_bus_lock(desc);
cbf94f06 1246 kfree(__free_irq(irq, dev_id));
3876ec9e 1247 chip_bus_sync_unlock(desc);
1da177e4 1248}
1da177e4
LT
1249EXPORT_SYMBOL(free_irq);
1250
1251/**
3aa551c9 1252 * request_threaded_irq - allocate an interrupt line
1da177e4 1253 * @irq: Interrupt line to allocate
3aa551c9
TG
1254 * @handler: Function to be called when the IRQ occurs.
1255 * Primary handler for threaded interrupts
b25c340c
TG
1256 * If NULL and thread_fn != NULL the default
1257 * primary handler is installed
f48fe81e
TG
1258 * @thread_fn: Function called from the irq handler thread
1259 * If NULL, no irq thread is created
1da177e4
LT
1260 * @irqflags: Interrupt type flags
1261 * @devname: An ascii name for the claiming device
1262 * @dev_id: A cookie passed back to the handler function
1263 *
1264 * This call allocates interrupt resources and enables the
1265 * interrupt line and IRQ handling. From the point this
1266 * call is made your handler function may be invoked. Since
1267 * your handler function must clear any interrupt the board
1268 * raises, you must take care both to initialise your hardware
1269 * and to set up the interrupt handler in the right order.
1270 *
3aa551c9
TG
1271 * If you want to set up a threaded irq handler for your device
1272 * then you need to supply @handler and @thread_fn. @handler ist
1273 * still called in hard interrupt context and has to check
1274 * whether the interrupt originates from the device. If yes it
1275 * needs to disable the interrupt on the device and return
39a2eddb 1276 * IRQ_WAKE_THREAD which will wake up the handler thread and run
3aa551c9
TG
1277 * @thread_fn. This split handler design is necessary to support
1278 * shared interrupts.
1279 *
1da177e4
LT
1280 * Dev_id must be globally unique. Normally the address of the
1281 * device data structure is used as the cookie. Since the handler
1282 * receives this value it makes sense to use it.
1283 *
1284 * If your interrupt is shared you must pass a non NULL dev_id
1285 * as this is required when freeing the interrupt.
1286 *
1287 * Flags:
1288 *
3cca53b0 1289 * IRQF_SHARED Interrupt is shared
3cca53b0 1290 * IRQF_SAMPLE_RANDOM The interrupt can be used for entropy
0c5d1eb7 1291 * IRQF_TRIGGER_* Specify active edge(s) or level
1da177e4
LT
1292 *
1293 */
3aa551c9
TG
1294int request_threaded_irq(unsigned int irq, irq_handler_t handler,
1295 irq_handler_t thread_fn, unsigned long irqflags,
1296 const char *devname, void *dev_id)
1da177e4 1297{
06fcb0c6 1298 struct irqaction *action;
08678b08 1299 struct irq_desc *desc;
d3c60047 1300 int retval;
1da177e4
LT
1301
1302 /*
1303 * Sanity-check: shared interrupts must pass in a real dev-ID,
1304 * otherwise we'll have trouble later trying to figure out
1305 * which interrupt is which (messes up the interrupt freeing
1306 * logic etc).
1307 */
3cca53b0 1308 if ((irqflags & IRQF_SHARED) && !dev_id)
1da177e4 1309 return -EINVAL;
7d94f7ca 1310
cb5bc832 1311 desc = irq_to_desc(irq);
7d94f7ca 1312 if (!desc)
1da177e4 1313 return -EINVAL;
7d94f7ca 1314
1ccb4e61 1315 if (!irq_settings_can_request(desc))
6550c775 1316 return -EINVAL;
b25c340c
TG
1317
1318 if (!handler) {
1319 if (!thread_fn)
1320 return -EINVAL;
1321 handler = irq_default_primary_handler;
1322 }
1da177e4 1323
45535732 1324 action = kzalloc(sizeof(struct irqaction), GFP_KERNEL);
1da177e4
LT
1325 if (!action)
1326 return -ENOMEM;
1327
1328 action->handler = handler;
3aa551c9 1329 action->thread_fn = thread_fn;
1da177e4 1330 action->flags = irqflags;
1da177e4 1331 action->name = devname;
1da177e4
LT
1332 action->dev_id = dev_id;
1333
3876ec9e 1334 chip_bus_lock(desc);
d3c60047 1335 retval = __setup_irq(irq, desc, action);
3876ec9e 1336 chip_bus_sync_unlock(desc);
70aedd24 1337
377bf1e4
AV
1338 if (retval)
1339 kfree(action);
1340
6d83f94d 1341#ifdef CONFIG_DEBUG_SHIRQ_FIXME
6ce51c43 1342 if (!retval && (irqflags & IRQF_SHARED)) {
a304e1b8
DW
1343 /*
1344 * It's a shared IRQ -- the driver ought to be prepared for it
1345 * to happen immediately, so let's make sure....
377bf1e4
AV
1346 * We disable the irq to make sure that a 'real' IRQ doesn't
1347 * run in parallel with our fake.
a304e1b8 1348 */
59845b1f 1349 unsigned long flags;
a304e1b8 1350
377bf1e4 1351 disable_irq(irq);
59845b1f 1352 local_irq_save(flags);
377bf1e4 1353
59845b1f 1354 handler(irq, dev_id);
377bf1e4 1355
59845b1f 1356 local_irq_restore(flags);
377bf1e4 1357 enable_irq(irq);
a304e1b8
DW
1358 }
1359#endif
1da177e4
LT
1360 return retval;
1361}
3aa551c9 1362EXPORT_SYMBOL(request_threaded_irq);
ae731f8d
MZ
1363
1364/**
1365 * request_any_context_irq - allocate an interrupt line
1366 * @irq: Interrupt line to allocate
1367 * @handler: Function to be called when the IRQ occurs.
1368 * Threaded handler for threaded interrupts.
1369 * @flags: Interrupt type flags
1370 * @name: An ascii name for the claiming device
1371 * @dev_id: A cookie passed back to the handler function
1372 *
1373 * This call allocates interrupt resources and enables the
1374 * interrupt line and IRQ handling. It selects either a
1375 * hardirq or threaded handling method depending on the
1376 * context.
1377 *
1378 * On failure, it returns a negative value. On success,
1379 * it returns either IRQC_IS_HARDIRQ or IRQC_IS_NESTED.
1380 */
1381int request_any_context_irq(unsigned int irq, irq_handler_t handler,
1382 unsigned long flags, const char *name, void *dev_id)
1383{
1384 struct irq_desc *desc = irq_to_desc(irq);
1385 int ret;
1386
1387 if (!desc)
1388 return -EINVAL;
1389
1ccb4e61 1390 if (irq_settings_is_nested_thread(desc)) {
ae731f8d
MZ
1391 ret = request_threaded_irq(irq, NULL, handler,
1392 flags, name, dev_id);
1393 return !ret ? IRQC_IS_NESTED : ret;
1394 }
1395
1396 ret = request_irq(irq, handler, flags, name, dev_id);
1397 return !ret ? IRQC_IS_HARDIRQ : ret;
1398}
1399EXPORT_SYMBOL_GPL(request_any_context_irq);
This page took 0.654409 seconds and 5 git commands to generate.