manage.c 33 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291
  1. /*
  2. * linux/kernel/irq/manage.c
  3. *
  4. * Copyright (C) 1992, 1998-2006 Linus Torvalds, Ingo Molnar
  5. * Copyright (C) 2005-2006 Thomas Gleixner
  6. *
  7. * This file contains driver APIs to the irq subsystem.
  8. */
  9. #include <linux/irq.h>
  10. #include <linux/kthread.h>
  11. #include <linux/module.h>
  12. #include <linux/random.h>
  13. #include <linux/interrupt.h>
  14. #include <linux/slab.h>
  15. #include <linux/sched.h>
  16. #include "internals.h"
  17. /**
  18. * synchronize_irq - wait for pending IRQ handlers (on other CPUs)
  19. * @irq: interrupt number to wait for
  20. *
  21. * This function waits for any pending IRQ handlers for this interrupt
  22. * to complete before returning. If you use this function while
  23. * holding a resource the IRQ handler may need you will deadlock.
  24. *
  25. * This function may be called - with care - from IRQ context.
  26. */
  27. void synchronize_irq(unsigned int irq)
  28. {
  29. struct irq_desc *desc = irq_to_desc(irq);
  30. unsigned int state;
  31. if (!desc)
  32. return;
  33. do {
  34. unsigned long flags;
  35. /*
  36. * Wait until we're out of the critical section. This might
  37. * give the wrong answer due to the lack of memory barriers.
  38. */
  39. while (desc->istate & IRQS_INPROGRESS)
  40. cpu_relax();
  41. /* Ok, that indicated we're done: double-check carefully. */
  42. raw_spin_lock_irqsave(&desc->lock, flags);
  43. state = desc->istate;
  44. raw_spin_unlock_irqrestore(&desc->lock, flags);
  45. /* Oops, that failed? */
  46. } while (state & IRQS_INPROGRESS);
  47. /*
  48. * We made sure that no hardirq handler is running. Now verify
  49. * that no threaded handlers are active.
  50. */
  51. wait_event(desc->wait_for_threads, !atomic_read(&desc->threads_active));
  52. }
  53. EXPORT_SYMBOL(synchronize_irq);
  54. #ifdef CONFIG_SMP
  55. cpumask_var_t irq_default_affinity;
  56. /**
  57. * irq_can_set_affinity - Check if the affinity of a given irq can be set
  58. * @irq: Interrupt to check
  59. *
  60. */
  61. int irq_can_set_affinity(unsigned int irq)
  62. {
  63. struct irq_desc *desc = irq_to_desc(irq);
  64. if (!irqd_can_balance(&desc->irq_data) || !desc->irq_data.chip ||
  65. !desc->irq_data.chip->irq_set_affinity)
  66. return 0;
  67. return 1;
  68. }
  69. /**
  70. * irq_set_thread_affinity - Notify irq threads to adjust affinity
  71. * @desc: irq descriptor which has affitnity changed
  72. *
  73. * We just set IRQTF_AFFINITY and delegate the affinity setting
  74. * to the interrupt thread itself. We can not call
  75. * set_cpus_allowed_ptr() here as we hold desc->lock and this
  76. * code can be called from hard interrupt context.
  77. */
  78. void irq_set_thread_affinity(struct irq_desc *desc)
  79. {
  80. struct irqaction *action = desc->action;
  81. while (action) {
  82. if (action->thread)
  83. set_bit(IRQTF_AFFINITY, &action->thread_flags);
  84. action = action->next;
  85. }
  86. }
  87. #ifdef CONFIG_GENERIC_PENDING_IRQ
  88. static inline bool irq_can_move_pcntxt(struct irq_desc *desc)
  89. {
  90. return desc->status & IRQ_MOVE_PCNTXT;
  91. }
  92. static inline bool irq_move_pending(struct irq_desc *desc)
  93. {
  94. return irqd_is_setaffinity_pending(&desc->irq_data);
  95. }
  96. static inline void
  97. irq_copy_pending(struct irq_desc *desc, const struct cpumask *mask)
  98. {
  99. cpumask_copy(desc->pending_mask, mask);
  100. }
  101. static inline void
  102. irq_get_pending(struct cpumask *mask, struct irq_desc *desc)
  103. {
  104. cpumask_copy(mask, desc->pending_mask);
  105. }
  106. #else
  107. static inline bool irq_can_move_pcntxt(struct irq_desc *desc) { return true; }
  108. static inline bool irq_move_pending(struct irq_desc *desc) { return false; }
  109. static inline void
  110. irq_copy_pending(struct irq_desc *desc, const struct cpumask *mask) { }
  111. static inline void
  112. irq_get_pending(struct cpumask *mask, struct irq_desc *desc) { }
  113. #endif
  114. /**
  115. * irq_set_affinity - Set the irq affinity of a given irq
  116. * @irq: Interrupt to set affinity
  117. * @cpumask: cpumask
  118. *
  119. */
  120. int irq_set_affinity(unsigned int irq, const struct cpumask *mask)
  121. {
  122. struct irq_desc *desc = irq_to_desc(irq);
  123. struct irq_chip *chip = desc->irq_data.chip;
  124. unsigned long flags;
  125. int ret = 0;
  126. if (!chip->irq_set_affinity)
  127. return -EINVAL;
  128. raw_spin_lock_irqsave(&desc->lock, flags);
  129. if (irq_can_move_pcntxt(desc)) {
  130. ret = chip->irq_set_affinity(&desc->irq_data, mask, false);
  131. switch (ret) {
  132. case IRQ_SET_MASK_OK:
  133. cpumask_copy(desc->irq_data.affinity, mask);
  134. case IRQ_SET_MASK_OK_NOCOPY:
  135. irq_set_thread_affinity(desc);
  136. ret = 0;
  137. }
  138. } else {
  139. irqd_set_move_pending(&desc->irq_data);
  140. irq_copy_pending(desc, mask);
  141. }
  142. if (desc->affinity_notify) {
  143. kref_get(&desc->affinity_notify->kref);
  144. schedule_work(&desc->affinity_notify->work);
  145. }
  146. desc->status |= IRQ_AFFINITY_SET;
  147. raw_spin_unlock_irqrestore(&desc->lock, flags);
  148. return ret;
  149. }
  150. int irq_set_affinity_hint(unsigned int irq, const struct cpumask *m)
  151. {
  152. struct irq_desc *desc = irq_to_desc(irq);
  153. unsigned long flags;
  154. if (!desc)
  155. return -EINVAL;
  156. raw_spin_lock_irqsave(&desc->lock, flags);
  157. desc->affinity_hint = m;
  158. raw_spin_unlock_irqrestore(&desc->lock, flags);
  159. return 0;
  160. }
  161. EXPORT_SYMBOL_GPL(irq_set_affinity_hint);
  162. static void irq_affinity_notify(struct work_struct *work)
  163. {
  164. struct irq_affinity_notify *notify =
  165. container_of(work, struct irq_affinity_notify, work);
  166. struct irq_desc *desc = irq_to_desc(notify->irq);
  167. cpumask_var_t cpumask;
  168. unsigned long flags;
  169. if (!desc || !alloc_cpumask_var(&cpumask, GFP_KERNEL))
  170. goto out;
  171. raw_spin_lock_irqsave(&desc->lock, flags);
  172. if (irq_move_pending(desc))
  173. irq_get_pending(cpumask, desc);
  174. else
  175. cpumask_copy(cpumask, desc->irq_data.affinity);
  176. raw_spin_unlock_irqrestore(&desc->lock, flags);
  177. notify->notify(notify, cpumask);
  178. free_cpumask_var(cpumask);
  179. out:
  180. kref_put(&notify->kref, notify->release);
  181. }
  182. /**
  183. * irq_set_affinity_notifier - control notification of IRQ affinity changes
  184. * @irq: Interrupt for which to enable/disable notification
  185. * @notify: Context for notification, or %NULL to disable
  186. * notification. Function pointers must be initialised;
  187. * the other fields will be initialised by this function.
  188. *
  189. * Must be called in process context. Notification may only be enabled
  190. * after the IRQ is allocated and must be disabled before the IRQ is
  191. * freed using free_irq().
  192. */
  193. int
  194. irq_set_affinity_notifier(unsigned int irq, struct irq_affinity_notify *notify)
  195. {
  196. struct irq_desc *desc = irq_to_desc(irq);
  197. struct irq_affinity_notify *old_notify;
  198. unsigned long flags;
  199. /* The release function is promised process context */
  200. might_sleep();
  201. if (!desc)
  202. return -EINVAL;
  203. /* Complete initialisation of *notify */
  204. if (notify) {
  205. notify->irq = irq;
  206. kref_init(&notify->kref);
  207. INIT_WORK(&notify->work, irq_affinity_notify);
  208. }
  209. raw_spin_lock_irqsave(&desc->lock, flags);
  210. old_notify = desc->affinity_notify;
  211. desc->affinity_notify = notify;
  212. raw_spin_unlock_irqrestore(&desc->lock, flags);
  213. if (old_notify)
  214. kref_put(&old_notify->kref, old_notify->release);
  215. return 0;
  216. }
  217. EXPORT_SYMBOL_GPL(irq_set_affinity_notifier);
  218. #ifndef CONFIG_AUTO_IRQ_AFFINITY
  219. /*
  220. * Generic version of the affinity autoselector.
  221. */
  222. static int
  223. setup_affinity(unsigned int irq, struct irq_desc *desc, struct cpumask *mask)
  224. {
  225. struct irq_chip *chip = irq_desc_get_chip(desc);
  226. struct cpumask *set = irq_default_affinity;
  227. int ret;
  228. /* Excludes PER_CPU and NO_BALANCE interrupts */
  229. if (!irq_can_set_affinity(irq))
  230. return 0;
  231. /*
  232. * Preserve an userspace affinity setup, but make sure that
  233. * one of the targets is online.
  234. */
  235. if (desc->status & (IRQ_AFFINITY_SET)) {
  236. if (cpumask_intersects(desc->irq_data.affinity,
  237. cpu_online_mask))
  238. set = desc->irq_data.affinity;
  239. else
  240. desc->status &= ~IRQ_AFFINITY_SET;
  241. }
  242. cpumask_and(mask, cpu_online_mask, set);
  243. ret = chip->irq_set_affinity(&desc->irq_data, mask, false);
  244. switch (ret) {
  245. case IRQ_SET_MASK_OK:
  246. cpumask_copy(desc->irq_data.affinity, mask);
  247. case IRQ_SET_MASK_OK_NOCOPY:
  248. irq_set_thread_affinity(desc);
  249. }
  250. return 0;
  251. }
  252. #else
  253. static inline int
  254. setup_affinity(unsigned int irq, struct irq_desc *d, struct cpumask *mask)
  255. {
  256. return irq_select_affinity(irq);
  257. }
  258. #endif
  259. /*
  260. * Called when affinity is set via /proc/irq
  261. */
  262. int irq_select_affinity_usr(unsigned int irq, struct cpumask *mask)
  263. {
  264. struct irq_desc *desc = irq_to_desc(irq);
  265. unsigned long flags;
  266. int ret;
  267. raw_spin_lock_irqsave(&desc->lock, flags);
  268. ret = setup_affinity(irq, desc, mask);
  269. raw_spin_unlock_irqrestore(&desc->lock, flags);
  270. return ret;
  271. }
  272. #else
  273. static inline int
  274. setup_affinity(unsigned int irq, struct irq_desc *desc, struct cpumask *mask)
  275. {
  276. return 0;
  277. }
  278. #endif
  279. void __disable_irq(struct irq_desc *desc, unsigned int irq, bool suspend)
  280. {
  281. if (suspend) {
  282. if (!desc->action || (desc->action->flags & IRQF_NO_SUSPEND))
  283. return;
  284. desc->istate |= IRQS_SUSPENDED;
  285. }
  286. if (!desc->depth++)
  287. irq_disable(desc);
  288. }
  289. /**
  290. * disable_irq_nosync - disable an irq without waiting
  291. * @irq: Interrupt to disable
  292. *
  293. * Disable the selected interrupt line. Disables and Enables are
  294. * nested.
  295. * Unlike disable_irq(), this function does not ensure existing
  296. * instances of the IRQ handler have completed before returning.
  297. *
  298. * This function may be called from IRQ context.
  299. */
  300. void disable_irq_nosync(unsigned int irq)
  301. {
  302. struct irq_desc *desc = irq_to_desc(irq);
  303. unsigned long flags;
  304. if (!desc)
  305. return;
  306. chip_bus_lock(desc);
  307. raw_spin_lock_irqsave(&desc->lock, flags);
  308. __disable_irq(desc, irq, false);
  309. raw_spin_unlock_irqrestore(&desc->lock, flags);
  310. chip_bus_sync_unlock(desc);
  311. }
  312. EXPORT_SYMBOL(disable_irq_nosync);
  313. /**
  314. * disable_irq - disable an irq and wait for completion
  315. * @irq: Interrupt to disable
  316. *
  317. * Disable the selected interrupt line. Enables and Disables are
  318. * nested.
  319. * This function waits for any pending IRQ handlers for this interrupt
  320. * to complete before returning. If you use this function while
  321. * holding a resource the IRQ handler may need you will deadlock.
  322. *
  323. * This function may be called - with care - from IRQ context.
  324. */
  325. void disable_irq(unsigned int irq)
  326. {
  327. struct irq_desc *desc = irq_to_desc(irq);
  328. if (!desc)
  329. return;
  330. disable_irq_nosync(irq);
  331. if (desc->action)
  332. synchronize_irq(irq);
  333. }
  334. EXPORT_SYMBOL(disable_irq);
  335. void __enable_irq(struct irq_desc *desc, unsigned int irq, bool resume)
  336. {
  337. if (resume) {
  338. if (!(desc->istate & IRQS_SUSPENDED)) {
  339. if (!desc->action)
  340. return;
  341. if (!(desc->action->flags & IRQF_FORCE_RESUME))
  342. return;
  343. /* Pretend that it got disabled ! */
  344. desc->depth++;
  345. }
  346. desc->istate &= ~IRQS_SUSPENDED;
  347. }
  348. switch (desc->depth) {
  349. case 0:
  350. err_out:
  351. WARN(1, KERN_WARNING "Unbalanced enable for IRQ %d\n", irq);
  352. break;
  353. case 1: {
  354. if (desc->istate & IRQS_SUSPENDED)
  355. goto err_out;
  356. /* Prevent probing on this irq: */
  357. desc->status |= IRQ_NOPROBE;
  358. irq_enable(desc);
  359. check_irq_resend(desc, irq);
  360. /* fall-through */
  361. }
  362. default:
  363. desc->depth--;
  364. }
  365. }
  366. /**
  367. * enable_irq - enable handling of an irq
  368. * @irq: Interrupt to enable
  369. *
  370. * Undoes the effect of one call to disable_irq(). If this
  371. * matches the last disable, processing of interrupts on this
  372. * IRQ line is re-enabled.
  373. *
  374. * This function may be called from IRQ context only when
  375. * desc->irq_data.chip->bus_lock and desc->chip->bus_sync_unlock are NULL !
  376. */
  377. void enable_irq(unsigned int irq)
  378. {
  379. struct irq_desc *desc = irq_to_desc(irq);
  380. unsigned long flags;
  381. if (!desc)
  382. return;
  383. if (WARN(!desc->irq_data.chip,
  384. KERN_ERR "enable_irq before setup/request_irq: irq %u\n", irq))
  385. return;
  386. chip_bus_lock(desc);
  387. raw_spin_lock_irqsave(&desc->lock, flags);
  388. __enable_irq(desc, irq, false);
  389. raw_spin_unlock_irqrestore(&desc->lock, flags);
  390. chip_bus_sync_unlock(desc);
  391. }
  392. EXPORT_SYMBOL(enable_irq);
  393. static int set_irq_wake_real(unsigned int irq, unsigned int on)
  394. {
  395. struct irq_desc *desc = irq_to_desc(irq);
  396. int ret = -ENXIO;
  397. if (desc->irq_data.chip->irq_set_wake)
  398. ret = desc->irq_data.chip->irq_set_wake(&desc->irq_data, on);
  399. return ret;
  400. }
  401. /**
  402. * irq_set_irq_wake - control irq power management wakeup
  403. * @irq: interrupt to control
  404. * @on: enable/disable power management wakeup
  405. *
  406. * Enable/disable power management wakeup mode, which is
  407. * disabled by default. Enables and disables must match,
  408. * just as they match for non-wakeup mode support.
  409. *
  410. * Wakeup mode lets this IRQ wake the system from sleep
  411. * states like "suspend to RAM".
  412. */
  413. int irq_set_irq_wake(unsigned int irq, unsigned int on)
  414. {
  415. struct irq_desc *desc = irq_to_desc(irq);
  416. unsigned long flags;
  417. int ret = 0;
  418. /* wakeup-capable irqs can be shared between drivers that
  419. * don't need to have the same sleep mode behaviors.
  420. */
  421. chip_bus_lock(desc);
  422. raw_spin_lock_irqsave(&desc->lock, flags);
  423. if (on) {
  424. if (desc->wake_depth++ == 0) {
  425. ret = set_irq_wake_real(irq, on);
  426. if (ret)
  427. desc->wake_depth = 0;
  428. else
  429. desc->istate |= IRQS_WAKEUP;
  430. }
  431. } else {
  432. if (desc->wake_depth == 0) {
  433. WARN(1, "Unbalanced IRQ %d wake disable\n", irq);
  434. } else if (--desc->wake_depth == 0) {
  435. ret = set_irq_wake_real(irq, on);
  436. if (ret)
  437. desc->wake_depth = 1;
  438. else
  439. desc->istate &= ~IRQS_WAKEUP;
  440. }
  441. }
  442. raw_spin_unlock_irqrestore(&desc->lock, flags);
  443. chip_bus_sync_unlock(desc);
  444. return ret;
  445. }
  446. EXPORT_SYMBOL(irq_set_irq_wake);
  447. /*
  448. * Internal function that tells the architecture code whether a
  449. * particular irq has been exclusively allocated or is available
  450. * for driver use.
  451. */
  452. int can_request_irq(unsigned int irq, unsigned long irqflags)
  453. {
  454. struct irq_desc *desc = irq_to_desc(irq);
  455. struct irqaction *action;
  456. unsigned long flags;
  457. if (!desc)
  458. return 0;
  459. if (desc->status & IRQ_NOREQUEST)
  460. return 0;
  461. raw_spin_lock_irqsave(&desc->lock, flags);
  462. action = desc->action;
  463. if (action)
  464. if (irqflags & action->flags & IRQF_SHARED)
  465. action = NULL;
  466. raw_spin_unlock_irqrestore(&desc->lock, flags);
  467. return !action;
  468. }
  469. void compat_irq_chip_set_default_handler(struct irq_desc *desc)
  470. {
  471. /*
  472. * If the architecture still has not overriden
  473. * the flow handler then zap the default. This
  474. * should catch incorrect flow-type setting.
  475. */
  476. if (desc->handle_irq == &handle_bad_irq)
  477. desc->handle_irq = NULL;
  478. }
  479. int __irq_set_trigger(struct irq_desc *desc, unsigned int irq,
  480. unsigned long flags)
  481. {
  482. int ret;
  483. struct irq_chip *chip = desc->irq_data.chip;
  484. if (!chip || !chip->irq_set_type) {
  485. /*
  486. * IRQF_TRIGGER_* but the PIC does not support multiple
  487. * flow-types?
  488. */
  489. pr_debug("No set_type function for IRQ %d (%s)\n", irq,
  490. chip ? (chip->name ? : "unknown") : "unknown");
  491. return 0;
  492. }
  493. /* caller masked out all except trigger mode flags */
  494. ret = chip->irq_set_type(&desc->irq_data, flags);
  495. if (ret)
  496. pr_err("setting trigger mode %lu for irq %u failed (%pF)\n",
  497. flags, irq, chip->irq_set_type);
  498. else {
  499. if (flags & (IRQ_TYPE_LEVEL_LOW | IRQ_TYPE_LEVEL_HIGH))
  500. flags |= IRQ_LEVEL;
  501. /* note that IRQF_TRIGGER_MASK == IRQ_TYPE_SENSE_MASK */
  502. desc->status &= ~(IRQ_LEVEL | IRQ_TYPE_SENSE_MASK);
  503. desc->status |= flags;
  504. if (chip != desc->irq_data.chip)
  505. irq_chip_set_defaults(desc->irq_data.chip);
  506. }
  507. return ret;
  508. }
  509. /*
  510. * Default primary interrupt handler for threaded interrupts. Is
  511. * assigned as primary handler when request_threaded_irq is called
  512. * with handler == NULL. Useful for oneshot interrupts.
  513. */
  514. static irqreturn_t irq_default_primary_handler(int irq, void *dev_id)
  515. {
  516. return IRQ_WAKE_THREAD;
  517. }
  518. /*
  519. * Primary handler for nested threaded interrupts. Should never be
  520. * called.
  521. */
  522. static irqreturn_t irq_nested_primary_handler(int irq, void *dev_id)
  523. {
  524. WARN(1, "Primary handler called for nested irq %d\n", irq);
  525. return IRQ_NONE;
  526. }
  527. static int irq_wait_for_interrupt(struct irqaction *action)
  528. {
  529. while (!kthread_should_stop()) {
  530. set_current_state(TASK_INTERRUPTIBLE);
  531. if (test_and_clear_bit(IRQTF_RUNTHREAD,
  532. &action->thread_flags)) {
  533. __set_current_state(TASK_RUNNING);
  534. return 0;
  535. }
  536. schedule();
  537. }
  538. return -1;
  539. }
  540. /*
  541. * Oneshot interrupts keep the irq line masked until the threaded
  542. * handler finished. unmask if the interrupt has not been disabled and
  543. * is marked MASKED.
  544. */
  545. static void irq_finalize_oneshot(unsigned int irq, struct irq_desc *desc)
  546. {
  547. again:
  548. chip_bus_lock(desc);
  549. raw_spin_lock_irq(&desc->lock);
  550. /*
  551. * Implausible though it may be we need to protect us against
  552. * the following scenario:
  553. *
  554. * The thread is faster done than the hard interrupt handler
  555. * on the other CPU. If we unmask the irq line then the
  556. * interrupt can come in again and masks the line, leaves due
  557. * to IRQS_INPROGRESS and the irq line is masked forever.
  558. */
  559. if (unlikely(desc->istate & IRQS_INPROGRESS)) {
  560. raw_spin_unlock_irq(&desc->lock);
  561. chip_bus_sync_unlock(desc);
  562. cpu_relax();
  563. goto again;
  564. }
  565. if (!(desc->istate & IRQS_DISABLED) && (desc->istate & IRQS_MASKED)) {
  566. irq_compat_clr_masked(desc);
  567. desc->istate &= ~IRQS_MASKED;
  568. desc->irq_data.chip->irq_unmask(&desc->irq_data);
  569. }
  570. raw_spin_unlock_irq(&desc->lock);
  571. chip_bus_sync_unlock(desc);
  572. }
  573. #ifdef CONFIG_SMP
  574. /*
  575. * Check whether we need to change the affinity of the interrupt thread.
  576. */
  577. static void
  578. irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action)
  579. {
  580. cpumask_var_t mask;
  581. if (!test_and_clear_bit(IRQTF_AFFINITY, &action->thread_flags))
  582. return;
  583. /*
  584. * In case we are out of memory we set IRQTF_AFFINITY again and
  585. * try again next time
  586. */
  587. if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
  588. set_bit(IRQTF_AFFINITY, &action->thread_flags);
  589. return;
  590. }
  591. raw_spin_lock_irq(&desc->lock);
  592. cpumask_copy(mask, desc->irq_data.affinity);
  593. raw_spin_unlock_irq(&desc->lock);
  594. set_cpus_allowed_ptr(current, mask);
  595. free_cpumask_var(mask);
  596. }
  597. #else
  598. static inline void
  599. irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action) { }
  600. #endif
  601. /*
  602. * Interrupt handler thread
  603. */
  604. static int irq_thread(void *data)
  605. {
  606. static const struct sched_param param = {
  607. .sched_priority = MAX_USER_RT_PRIO/2,
  608. };
  609. struct irqaction *action = data;
  610. struct irq_desc *desc = irq_to_desc(action->irq);
  611. int wake, oneshot = desc->istate & IRQS_ONESHOT;
  612. sched_setscheduler(current, SCHED_FIFO, &param);
  613. current->irqaction = action;
  614. while (!irq_wait_for_interrupt(action)) {
  615. irq_thread_check_affinity(desc, action);
  616. atomic_inc(&desc->threads_active);
  617. raw_spin_lock_irq(&desc->lock);
  618. if (unlikely(desc->istate & IRQS_DISABLED)) {
  619. /*
  620. * CHECKME: We might need a dedicated
  621. * IRQ_THREAD_PENDING flag here, which
  622. * retriggers the thread in check_irq_resend()
  623. * but AFAICT IRQS_PENDING should be fine as it
  624. * retriggers the interrupt itself --- tglx
  625. */
  626. irq_compat_set_pending(desc);
  627. desc->istate |= IRQS_PENDING;
  628. raw_spin_unlock_irq(&desc->lock);
  629. } else {
  630. raw_spin_unlock_irq(&desc->lock);
  631. action->thread_fn(action->irq, action->dev_id);
  632. if (oneshot)
  633. irq_finalize_oneshot(action->irq, desc);
  634. }
  635. wake = atomic_dec_and_test(&desc->threads_active);
  636. if (wake && waitqueue_active(&desc->wait_for_threads))
  637. wake_up(&desc->wait_for_threads);
  638. }
  639. /*
  640. * Clear irqaction. Otherwise exit_irq_thread() would make
  641. * fuzz about an active irq thread going into nirvana.
  642. */
  643. current->irqaction = NULL;
  644. return 0;
  645. }
  646. /*
  647. * Called from do_exit()
  648. */
  649. void exit_irq_thread(void)
  650. {
  651. struct task_struct *tsk = current;
  652. if (!tsk->irqaction)
  653. return;
  654. printk(KERN_ERR
  655. "exiting task \"%s\" (%d) is an active IRQ thread (irq %d)\n",
  656. tsk->comm ? tsk->comm : "", tsk->pid, tsk->irqaction->irq);
  657. /*
  658. * Set the THREAD DIED flag to prevent further wakeups of the
  659. * soon to be gone threaded handler.
  660. */
  661. set_bit(IRQTF_DIED, &tsk->irqaction->flags);
  662. }
  663. /*
  664. * Internal function to register an irqaction - typically used to
  665. * allocate special interrupts that are part of the architecture.
  666. */
  667. static int
  668. __setup_irq(unsigned int irq, struct irq_desc *desc, struct irqaction *new)
  669. {
  670. struct irqaction *old, **old_ptr;
  671. const char *old_name = NULL;
  672. unsigned long flags;
  673. int ret, nested, shared = 0;
  674. cpumask_var_t mask;
  675. if (!desc)
  676. return -EINVAL;
  677. if (desc->irq_data.chip == &no_irq_chip)
  678. return -ENOSYS;
  679. /*
  680. * Some drivers like serial.c use request_irq() heavily,
  681. * so we have to be careful not to interfere with a
  682. * running system.
  683. */
  684. if (new->flags & IRQF_SAMPLE_RANDOM) {
  685. /*
  686. * This function might sleep, we want to call it first,
  687. * outside of the atomic block.
  688. * Yes, this might clear the entropy pool if the wrong
  689. * driver is attempted to be loaded, without actually
  690. * installing a new handler, but is this really a problem,
  691. * only the sysadmin is able to do this.
  692. */
  693. rand_initialize_irq(irq);
  694. }
  695. /* Oneshot interrupts are not allowed with shared */
  696. if ((new->flags & IRQF_ONESHOT) && (new->flags & IRQF_SHARED))
  697. return -EINVAL;
  698. /*
  699. * Check whether the interrupt nests into another interrupt
  700. * thread.
  701. */
  702. nested = desc->status & IRQ_NESTED_THREAD;
  703. if (nested) {
  704. if (!new->thread_fn)
  705. return -EINVAL;
  706. /*
  707. * Replace the primary handler which was provided from
  708. * the driver for non nested interrupt handling by the
  709. * dummy function which warns when called.
  710. */
  711. new->handler = irq_nested_primary_handler;
  712. }
  713. /*
  714. * Create a handler thread when a thread function is supplied
  715. * and the interrupt does not nest into another interrupt
  716. * thread.
  717. */
  718. if (new->thread_fn && !nested) {
  719. struct task_struct *t;
  720. t = kthread_create(irq_thread, new, "irq/%d-%s", irq,
  721. new->name);
  722. if (IS_ERR(t))
  723. return PTR_ERR(t);
  724. /*
  725. * We keep the reference to the task struct even if
  726. * the thread dies to avoid that the interrupt code
  727. * references an already freed task_struct.
  728. */
  729. get_task_struct(t);
  730. new->thread = t;
  731. }
  732. if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
  733. ret = -ENOMEM;
  734. goto out_thread;
  735. }
  736. /*
  737. * The following block of code has to be executed atomically
  738. */
  739. raw_spin_lock_irqsave(&desc->lock, flags);
  740. old_ptr = &desc->action;
  741. old = *old_ptr;
  742. if (old) {
  743. /*
  744. * Can't share interrupts unless both agree to and are
  745. * the same type (level, edge, polarity). So both flag
  746. * fields must have IRQF_SHARED set and the bits which
  747. * set the trigger type must match.
  748. */
  749. if (!((old->flags & new->flags) & IRQF_SHARED) ||
  750. ((old->flags ^ new->flags) & IRQF_TRIGGER_MASK)) {
  751. old_name = old->name;
  752. goto mismatch;
  753. }
  754. /* All handlers must agree on per-cpuness */
  755. if ((old->flags & IRQF_PERCPU) !=
  756. (new->flags & IRQF_PERCPU))
  757. goto mismatch;
  758. /* add new interrupt at end of irq queue */
  759. do {
  760. old_ptr = &old->next;
  761. old = *old_ptr;
  762. } while (old);
  763. shared = 1;
  764. }
  765. if (!shared) {
  766. irq_chip_set_defaults(desc->irq_data.chip);
  767. init_waitqueue_head(&desc->wait_for_threads);
  768. /* Setup the type (level, edge polarity) if configured: */
  769. if (new->flags & IRQF_TRIGGER_MASK) {
  770. ret = __irq_set_trigger(desc, irq,
  771. new->flags & IRQF_TRIGGER_MASK);
  772. if (ret)
  773. goto out_mask;
  774. } else
  775. compat_irq_chip_set_default_handler(desc);
  776. desc->istate &= ~(IRQS_AUTODETECT | IRQS_SPURIOUS_DISABLED | \
  777. IRQS_INPROGRESS | IRQS_ONESHOT | \
  778. IRQS_WAITING);
  779. if (new->flags & IRQF_PERCPU) {
  780. irqd_set(&desc->irq_data, IRQD_PER_CPU);
  781. irq_settings_set_per_cpu(desc);
  782. }
  783. if (new->flags & IRQF_ONESHOT)
  784. desc->istate |= IRQS_ONESHOT;
  785. if (!(desc->status & IRQ_NOAUTOEN))
  786. irq_startup(desc);
  787. else
  788. /* Undo nested disables: */
  789. desc->depth = 1;
  790. /* Exclude IRQ from balancing if requested */
  791. if (new->flags & IRQF_NOBALANCING) {
  792. irq_settings_set_no_balancing(desc);
  793. irqd_set(&desc->irq_data, IRQD_NO_BALANCING);
  794. }
  795. /* Set default affinity mask once everything is setup */
  796. setup_affinity(irq, desc, mask);
  797. } else if ((new->flags & IRQF_TRIGGER_MASK)
  798. && (new->flags & IRQF_TRIGGER_MASK)
  799. != (desc->status & IRQ_TYPE_SENSE_MASK)) {
  800. /* hope the handler works with the actual trigger mode... */
  801. pr_warning("IRQ %d uses trigger mode %d; requested %d\n",
  802. irq, (int)(desc->status & IRQ_TYPE_SENSE_MASK),
  803. (int)(new->flags & IRQF_TRIGGER_MASK));
  804. }
  805. new->irq = irq;
  806. *old_ptr = new;
  807. /* Reset broken irq detection when installing new handler */
  808. desc->irq_count = 0;
  809. desc->irqs_unhandled = 0;
  810. /*
  811. * Check whether we disabled the irq via the spurious handler
  812. * before. Reenable it and give it another chance.
  813. */
  814. if (shared && (desc->istate & IRQS_SPURIOUS_DISABLED)) {
  815. desc->istate &= ~IRQS_SPURIOUS_DISABLED;
  816. __enable_irq(desc, irq, false);
  817. }
  818. raw_spin_unlock_irqrestore(&desc->lock, flags);
  819. /*
  820. * Strictly no need to wake it up, but hung_task complains
  821. * when no hard interrupt wakes the thread up.
  822. */
  823. if (new->thread)
  824. wake_up_process(new->thread);
  825. register_irq_proc(irq, desc);
  826. new->dir = NULL;
  827. register_handler_proc(irq, new);
  828. return 0;
  829. mismatch:
  830. #ifdef CONFIG_DEBUG_SHIRQ
  831. if (!(new->flags & IRQF_PROBE_SHARED)) {
  832. printk(KERN_ERR "IRQ handler type mismatch for IRQ %d\n", irq);
  833. if (old_name)
  834. printk(KERN_ERR "current handler: %s\n", old_name);
  835. dump_stack();
  836. }
  837. #endif
  838. ret = -EBUSY;
  839. out_mask:
  840. free_cpumask_var(mask);
  841. out_thread:
  842. raw_spin_unlock_irqrestore(&desc->lock, flags);
  843. if (new->thread) {
  844. struct task_struct *t = new->thread;
  845. new->thread = NULL;
  846. if (likely(!test_bit(IRQTF_DIED, &new->thread_flags)))
  847. kthread_stop(t);
  848. put_task_struct(t);
  849. }
  850. return ret;
  851. }
  852. /**
  853. * setup_irq - setup an interrupt
  854. * @irq: Interrupt line to setup
  855. * @act: irqaction for the interrupt
  856. *
  857. * Used to statically setup interrupts in the early boot process.
  858. */
  859. int setup_irq(unsigned int irq, struct irqaction *act)
  860. {
  861. int retval;
  862. struct irq_desc *desc = irq_to_desc(irq);
  863. chip_bus_lock(desc);
  864. retval = __setup_irq(irq, desc, act);
  865. chip_bus_sync_unlock(desc);
  866. return retval;
  867. }
  868. EXPORT_SYMBOL_GPL(setup_irq);
  869. /*
  870. * Internal function to unregister an irqaction - used to free
  871. * regular and special interrupts that are part of the architecture.
  872. */
  873. static struct irqaction *__free_irq(unsigned int irq, void *dev_id)
  874. {
  875. struct irq_desc *desc = irq_to_desc(irq);
  876. struct irqaction *action, **action_ptr;
  877. unsigned long flags;
  878. WARN(in_interrupt(), "Trying to free IRQ %d from IRQ context!\n", irq);
  879. if (!desc)
  880. return NULL;
  881. raw_spin_lock_irqsave(&desc->lock, flags);
  882. /*
  883. * There can be multiple actions per IRQ descriptor, find the right
  884. * one based on the dev_id:
  885. */
  886. action_ptr = &desc->action;
  887. for (;;) {
  888. action = *action_ptr;
  889. if (!action) {
  890. WARN(1, "Trying to free already-free IRQ %d\n", irq);
  891. raw_spin_unlock_irqrestore(&desc->lock, flags);
  892. return NULL;
  893. }
  894. if (action->dev_id == dev_id)
  895. break;
  896. action_ptr = &action->next;
  897. }
  898. /* Found it - now remove it from the list of entries: */
  899. *action_ptr = action->next;
  900. /* Currently used only by UML, might disappear one day: */
  901. #ifdef CONFIG_IRQ_RELEASE_METHOD
  902. if (desc->irq_data.chip->release)
  903. desc->irq_data.chip->release(irq, dev_id);
  904. #endif
  905. /* If this was the last handler, shut down the IRQ line: */
  906. if (!desc->action)
  907. irq_shutdown(desc);
  908. #ifdef CONFIG_SMP
  909. /* make sure affinity_hint is cleaned up */
  910. if (WARN_ON_ONCE(desc->affinity_hint))
  911. desc->affinity_hint = NULL;
  912. #endif
  913. raw_spin_unlock_irqrestore(&desc->lock, flags);
  914. unregister_handler_proc(irq, action);
  915. /* Make sure it's not being used on another CPU: */
  916. synchronize_irq(irq);
  917. #ifdef CONFIG_DEBUG_SHIRQ
  918. /*
  919. * It's a shared IRQ -- the driver ought to be prepared for an IRQ
  920. * event to happen even now it's being freed, so let's make sure that
  921. * is so by doing an extra call to the handler ....
  922. *
  923. * ( We do this after actually deregistering it, to make sure that a
  924. * 'real' IRQ doesn't run in * parallel with our fake. )
  925. */
  926. if (action->flags & IRQF_SHARED) {
  927. local_irq_save(flags);
  928. action->handler(irq, dev_id);
  929. local_irq_restore(flags);
  930. }
  931. #endif
  932. if (action->thread) {
  933. if (!test_bit(IRQTF_DIED, &action->thread_flags))
  934. kthread_stop(action->thread);
  935. put_task_struct(action->thread);
  936. }
  937. return action;
  938. }
  939. /**
  940. * remove_irq - free an interrupt
  941. * @irq: Interrupt line to free
  942. * @act: irqaction for the interrupt
  943. *
  944. * Used to remove interrupts statically setup by the early boot process.
  945. */
  946. void remove_irq(unsigned int irq, struct irqaction *act)
  947. {
  948. __free_irq(irq, act->dev_id);
  949. }
  950. EXPORT_SYMBOL_GPL(remove_irq);
  951. /**
  952. * free_irq - free an interrupt allocated with request_irq
  953. * @irq: Interrupt line to free
  954. * @dev_id: Device identity to free
  955. *
  956. * Remove an interrupt handler. The handler is removed and if the
  957. * interrupt line is no longer in use by any driver it is disabled.
  958. * On a shared IRQ the caller must ensure the interrupt is disabled
  959. * on the card it drives before calling this function. The function
  960. * does not return until any executing interrupts for this IRQ
  961. * have completed.
  962. *
  963. * This function must not be called from interrupt context.
  964. */
  965. void free_irq(unsigned int irq, void *dev_id)
  966. {
  967. struct irq_desc *desc = irq_to_desc(irq);
  968. if (!desc)
  969. return;
  970. #ifdef CONFIG_SMP
  971. if (WARN_ON(desc->affinity_notify))
  972. desc->affinity_notify = NULL;
  973. #endif
  974. chip_bus_lock(desc);
  975. kfree(__free_irq(irq, dev_id));
  976. chip_bus_sync_unlock(desc);
  977. }
  978. EXPORT_SYMBOL(free_irq);
  979. /**
  980. * request_threaded_irq - allocate an interrupt line
  981. * @irq: Interrupt line to allocate
  982. * @handler: Function to be called when the IRQ occurs.
  983. * Primary handler for threaded interrupts
  984. * If NULL and thread_fn != NULL the default
  985. * primary handler is installed
  986. * @thread_fn: Function called from the irq handler thread
  987. * If NULL, no irq thread is created
  988. * @irqflags: Interrupt type flags
  989. * @devname: An ascii name for the claiming device
  990. * @dev_id: A cookie passed back to the handler function
  991. *
  992. * This call allocates interrupt resources and enables the
  993. * interrupt line and IRQ handling. From the point this
  994. * call is made your handler function may be invoked. Since
  995. * your handler function must clear any interrupt the board
  996. * raises, you must take care both to initialise your hardware
  997. * and to set up the interrupt handler in the right order.
  998. *
  999. * If you want to set up a threaded irq handler for your device
  1000. * then you need to supply @handler and @thread_fn. @handler ist
  1001. * still called in hard interrupt context and has to check
  1002. * whether the interrupt originates from the device. If yes it
  1003. * needs to disable the interrupt on the device and return
  1004. * IRQ_WAKE_THREAD which will wake up the handler thread and run
  1005. * @thread_fn. This split handler design is necessary to support
  1006. * shared interrupts.
  1007. *
  1008. * Dev_id must be globally unique. Normally the address of the
  1009. * device data structure is used as the cookie. Since the handler
  1010. * receives this value it makes sense to use it.
  1011. *
  1012. * If your interrupt is shared you must pass a non NULL dev_id
  1013. * as this is required when freeing the interrupt.
  1014. *
  1015. * Flags:
  1016. *
  1017. * IRQF_SHARED Interrupt is shared
  1018. * IRQF_SAMPLE_RANDOM The interrupt can be used for entropy
  1019. * IRQF_TRIGGER_* Specify active edge(s) or level
  1020. *
  1021. */
  1022. int request_threaded_irq(unsigned int irq, irq_handler_t handler,
  1023. irq_handler_t thread_fn, unsigned long irqflags,
  1024. const char *devname, void *dev_id)
  1025. {
  1026. struct irqaction *action;
  1027. struct irq_desc *desc;
  1028. int retval;
  1029. /*
  1030. * Sanity-check: shared interrupts must pass in a real dev-ID,
  1031. * otherwise we'll have trouble later trying to figure out
  1032. * which interrupt is which (messes up the interrupt freeing
  1033. * logic etc).
  1034. */
  1035. if ((irqflags & IRQF_SHARED) && !dev_id)
  1036. return -EINVAL;
  1037. desc = irq_to_desc(irq);
  1038. if (!desc)
  1039. return -EINVAL;
  1040. if (desc->status & IRQ_NOREQUEST)
  1041. return -EINVAL;
  1042. if (!handler) {
  1043. if (!thread_fn)
  1044. return -EINVAL;
  1045. handler = irq_default_primary_handler;
  1046. }
  1047. action = kzalloc(sizeof(struct irqaction), GFP_KERNEL);
  1048. if (!action)
  1049. return -ENOMEM;
  1050. action->handler = handler;
  1051. action->thread_fn = thread_fn;
  1052. action->flags = irqflags;
  1053. action->name = devname;
  1054. action->dev_id = dev_id;
  1055. chip_bus_lock(desc);
  1056. retval = __setup_irq(irq, desc, action);
  1057. chip_bus_sync_unlock(desc);
  1058. if (retval)
  1059. kfree(action);
  1060. #ifdef CONFIG_DEBUG_SHIRQ_FIXME
  1061. if (!retval && (irqflags & IRQF_SHARED)) {
  1062. /*
  1063. * It's a shared IRQ -- the driver ought to be prepared for it
  1064. * to happen immediately, so let's make sure....
  1065. * We disable the irq to make sure that a 'real' IRQ doesn't
  1066. * run in parallel with our fake.
  1067. */
  1068. unsigned long flags;
  1069. disable_irq(irq);
  1070. local_irq_save(flags);
  1071. handler(irq, dev_id);
  1072. local_irq_restore(flags);
  1073. enable_irq(irq);
  1074. }
  1075. #endif
  1076. return retval;
  1077. }
  1078. EXPORT_SYMBOL(request_threaded_irq);
  1079. /**
  1080. * request_any_context_irq - allocate an interrupt line
  1081. * @irq: Interrupt line to allocate
  1082. * @handler: Function to be called when the IRQ occurs.
  1083. * Threaded handler for threaded interrupts.
  1084. * @flags: Interrupt type flags
  1085. * @name: An ascii name for the claiming device
  1086. * @dev_id: A cookie passed back to the handler function
  1087. *
  1088. * This call allocates interrupt resources and enables the
  1089. * interrupt line and IRQ handling. It selects either a
  1090. * hardirq or threaded handling method depending on the
  1091. * context.
  1092. *
  1093. * On failure, it returns a negative value. On success,
  1094. * it returns either IRQC_IS_HARDIRQ or IRQC_IS_NESTED.
  1095. */
  1096. int request_any_context_irq(unsigned int irq, irq_handler_t handler,
  1097. unsigned long flags, const char *name, void *dev_id)
  1098. {
  1099. struct irq_desc *desc = irq_to_desc(irq);
  1100. int ret;
  1101. if (!desc)
  1102. return -EINVAL;
  1103. if (desc->status & IRQ_NESTED_THREAD) {
  1104. ret = request_threaded_irq(irq, NULL, handler,
  1105. flags, name, dev_id);
  1106. return !ret ? IRQC_IS_NESTED : ret;
  1107. }
  1108. ret = request_irq(irq, handler, flags, name, dev_id);
  1109. return !ret ? IRQC_IS_HARDIRQ : ret;
  1110. }
  1111. EXPORT_SYMBOL_GPL(request_any_context_irq);