manage.c 42 KB

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