manage.c 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611
  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. while (!kthread_should_stop()) {
  548. set_current_state(TASK_INTERRUPTIBLE);
  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. }
  556. return -1;
  557. }
  558. /*
  559. * Oneshot interrupts keep the irq line masked until the threaded
  560. * handler finished. unmask if the interrupt has not been disabled and
  561. * is marked MASKED.
  562. */
  563. static void irq_finalize_oneshot(struct irq_desc *desc,
  564. struct irqaction *action, bool force)
  565. {
  566. if (!(desc->istate & IRQS_ONESHOT))
  567. return;
  568. again:
  569. chip_bus_lock(desc);
  570. raw_spin_lock_irq(&desc->lock);
  571. /*
  572. * Implausible though it may be we need to protect us against
  573. * the following scenario:
  574. *
  575. * The thread is faster done than the hard interrupt handler
  576. * on the other CPU. If we unmask the irq line then the
  577. * interrupt can come in again and masks the line, leaves due
  578. * to IRQS_INPROGRESS and the irq line is masked forever.
  579. *
  580. * This also serializes the state of shared oneshot handlers
  581. * versus "desc->threads_onehsot |= action->thread_mask;" in
  582. * irq_wake_thread(). See the comment there which explains the
  583. * serialization.
  584. */
  585. if (unlikely(irqd_irq_inprogress(&desc->irq_data))) {
  586. raw_spin_unlock_irq(&desc->lock);
  587. chip_bus_sync_unlock(desc);
  588. cpu_relax();
  589. goto again;
  590. }
  591. /*
  592. * Now check again, whether the thread should run. Otherwise
  593. * we would clear the threads_oneshot bit of this thread which
  594. * was just set.
  595. */
  596. if (!force && test_bit(IRQTF_RUNTHREAD, &action->thread_flags))
  597. goto out_unlock;
  598. desc->threads_oneshot &= ~action->thread_mask;
  599. if (!desc->threads_oneshot && !irqd_irq_disabled(&desc->irq_data) &&
  600. irqd_irq_masked(&desc->irq_data))
  601. unmask_irq(desc);
  602. out_unlock:
  603. raw_spin_unlock_irq(&desc->lock);
  604. chip_bus_sync_unlock(desc);
  605. }
  606. #ifdef CONFIG_SMP
  607. /*
  608. * Check whether we need to chasnge the affinity of the interrupt thread.
  609. */
  610. static void
  611. irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action)
  612. {
  613. cpumask_var_t mask;
  614. if (!test_and_clear_bit(IRQTF_AFFINITY, &action->thread_flags))
  615. return;
  616. /*
  617. * In case we are out of memory we set IRQTF_AFFINITY again and
  618. * try again next time
  619. */
  620. if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
  621. set_bit(IRQTF_AFFINITY, &action->thread_flags);
  622. return;
  623. }
  624. raw_spin_lock_irq(&desc->lock);
  625. cpumask_copy(mask, desc->irq_data.affinity);
  626. raw_spin_unlock_irq(&desc->lock);
  627. set_cpus_allowed_ptr(current, mask);
  628. free_cpumask_var(mask);
  629. }
  630. #else
  631. static inline void
  632. irq_thread_check_affinity(struct irq_desc *desc, struct irqaction *action) { }
  633. #endif
  634. /*
  635. * Interrupts which are not explicitely requested as threaded
  636. * interrupts rely on the implicit bh/preempt disable of the hard irq
  637. * context. So we need to disable bh here to avoid deadlocks and other
  638. * side effects.
  639. */
  640. static irqreturn_t
  641. irq_forced_thread_fn(struct irq_desc *desc, struct irqaction *action)
  642. {
  643. irqreturn_t ret;
  644. local_bh_disable();
  645. ret = action->thread_fn(action->irq, action->dev_id);
  646. irq_finalize_oneshot(desc, action, false);
  647. local_bh_enable();
  648. return ret;
  649. }
  650. /*
  651. * Interrupts explicitely requested as threaded interupts want to be
  652. * preemtible - many of them need to sleep and wait for slow busses to
  653. * complete.
  654. */
  655. static irqreturn_t irq_thread_fn(struct irq_desc *desc,
  656. struct irqaction *action)
  657. {
  658. irqreturn_t ret;
  659. ret = action->thread_fn(action->irq, action->dev_id);
  660. irq_finalize_oneshot(desc, action, false);
  661. return ret;
  662. }
  663. /*
  664. * Interrupt handler thread
  665. */
  666. static int irq_thread(void *data)
  667. {
  668. static const struct sched_param param = {
  669. .sched_priority = MAX_USER_RT_PRIO/2,
  670. };
  671. struct irqaction *action = data;
  672. struct irq_desc *desc = irq_to_desc(action->irq);
  673. irqreturn_t (*handler_fn)(struct irq_desc *desc,
  674. struct irqaction *action);
  675. int wake;
  676. if (force_irqthreads & test_bit(IRQTF_FORCED_THREAD,
  677. &action->thread_flags))
  678. handler_fn = irq_forced_thread_fn;
  679. else
  680. handler_fn = irq_thread_fn;
  681. sched_setscheduler(current, SCHED_FIFO, &param);
  682. current->irqaction = action;
  683. while (!irq_wait_for_interrupt(action)) {
  684. irq_thread_check_affinity(desc, action);
  685. atomic_inc(&desc->threads_active);
  686. raw_spin_lock_irq(&desc->lock);
  687. if (unlikely(irqd_irq_disabled(&desc->irq_data))) {
  688. /*
  689. * CHECKME: We might need a dedicated
  690. * IRQ_THREAD_PENDING flag here, which
  691. * retriggers the thread in check_irq_resend()
  692. * but AFAICT IRQS_PENDING should be fine as it
  693. * retriggers the interrupt itself --- tglx
  694. */
  695. desc->istate |= IRQS_PENDING;
  696. raw_spin_unlock_irq(&desc->lock);
  697. } else {
  698. irqreturn_t action_ret;
  699. raw_spin_unlock_irq(&desc->lock);
  700. action_ret = handler_fn(desc, action);
  701. if (!noirqdebug)
  702. note_interrupt(action->irq, desc, action_ret);
  703. }
  704. wake = atomic_dec_and_test(&desc->threads_active);
  705. if (wake && waitqueue_active(&desc->wait_for_threads))
  706. wake_up(&desc->wait_for_threads);
  707. }
  708. /* Prevent a stale desc->threads_oneshot */
  709. irq_finalize_oneshot(desc, action, true);
  710. /*
  711. * Clear irqaction. Otherwise exit_irq_thread() would make
  712. * fuzz about an active irq thread going into nirvana.
  713. */
  714. current->irqaction = NULL;
  715. return 0;
  716. }
  717. /*
  718. * Called from do_exit()
  719. */
  720. void exit_irq_thread(void)
  721. {
  722. struct task_struct *tsk = current;
  723. struct irq_desc *desc;
  724. if (!tsk->irqaction)
  725. return;
  726. printk(KERN_ERR
  727. "exiting task \"%s\" (%d) is an active IRQ thread (irq %d)\n",
  728. tsk->comm ? tsk->comm : "", tsk->pid, tsk->irqaction->irq);
  729. desc = irq_to_desc(tsk->irqaction->irq);
  730. /*
  731. * Prevent a stale desc->threads_oneshot. Must be called
  732. * before setting the IRQTF_DIED flag.
  733. */
  734. irq_finalize_oneshot(desc, tsk->irqaction, true);
  735. /*
  736. * Set the THREAD DIED flag to prevent further wakeups of the
  737. * soon to be gone threaded handler.
  738. */
  739. set_bit(IRQTF_DIED, &tsk->irqaction->flags);
  740. }
  741. static void irq_setup_forced_threading(struct irqaction *new)
  742. {
  743. if (!force_irqthreads)
  744. return;
  745. if (new->flags & (IRQF_NO_THREAD | IRQF_PERCPU | IRQF_ONESHOT))
  746. return;
  747. new->flags |= IRQF_ONESHOT;
  748. if (!new->thread_fn) {
  749. set_bit(IRQTF_FORCED_THREAD, &new->thread_flags);
  750. new->thread_fn = new->handler;
  751. new->handler = irq_default_primary_handler;
  752. }
  753. }
  754. /*
  755. * Internal function to register an irqaction - typically used to
  756. * allocate special interrupts that are part of the architecture.
  757. */
  758. static int
  759. __setup_irq(unsigned int irq, struct irq_desc *desc, struct irqaction *new)
  760. {
  761. struct irqaction *old, **old_ptr;
  762. const char *old_name = NULL;
  763. unsigned long flags, thread_mask = 0;
  764. int ret, nested, shared = 0;
  765. cpumask_var_t mask;
  766. if (!desc)
  767. return -EINVAL;
  768. if (desc->irq_data.chip == &no_irq_chip)
  769. return -ENOSYS;
  770. if (!try_module_get(desc->owner))
  771. return -ENODEV;
  772. /*
  773. * Some drivers like serial.c use request_irq() heavily,
  774. * so we have to be careful not to interfere with a
  775. * running system.
  776. */
  777. if (new->flags & IRQF_SAMPLE_RANDOM) {
  778. /*
  779. * This function might sleep, we want to call it first,
  780. * outside of the atomic block.
  781. * Yes, this might clear the entropy pool if the wrong
  782. * driver is attempted to be loaded, without actually
  783. * installing a new handler, but is this really a problem,
  784. * only the sysadmin is able to do this.
  785. */
  786. rand_initialize_irq(irq);
  787. }
  788. /*
  789. * Check whether the interrupt nests into another interrupt
  790. * thread.
  791. */
  792. nested = irq_settings_is_nested_thread(desc);
  793. if (nested) {
  794. if (!new->thread_fn) {
  795. ret = -EINVAL;
  796. goto out_mput;
  797. }
  798. /*
  799. * Replace the primary handler which was provided from
  800. * the driver for non nested interrupt handling by the
  801. * dummy function which warns when called.
  802. */
  803. new->handler = irq_nested_primary_handler;
  804. } else {
  805. if (irq_settings_can_thread(desc))
  806. irq_setup_forced_threading(new);
  807. }
  808. /*
  809. * Create a handler thread when a thread function is supplied
  810. * and the interrupt does not nest into another interrupt
  811. * thread.
  812. */
  813. if (new->thread_fn && !nested) {
  814. struct task_struct *t;
  815. t = kthread_create(irq_thread, new, "irq/%d-%s", irq,
  816. new->name);
  817. if (IS_ERR(t)) {
  818. ret = PTR_ERR(t);
  819. goto out_mput;
  820. }
  821. /*
  822. * We keep the reference to the task struct even if
  823. * the thread dies to avoid that the interrupt code
  824. * references an already freed task_struct.
  825. */
  826. get_task_struct(t);
  827. new->thread = t;
  828. }
  829. if (!alloc_cpumask_var(&mask, GFP_KERNEL)) {
  830. ret = -ENOMEM;
  831. goto out_thread;
  832. }
  833. /*
  834. * The following block of code has to be executed atomically
  835. */
  836. raw_spin_lock_irqsave(&desc->lock, flags);
  837. old_ptr = &desc->action;
  838. old = *old_ptr;
  839. if (old) {
  840. /*
  841. * Can't share interrupts unless both agree to and are
  842. * the same type (level, edge, polarity). So both flag
  843. * fields must have IRQF_SHARED set and the bits which
  844. * set the trigger type must match. Also all must
  845. * agree on ONESHOT.
  846. */
  847. if (!((old->flags & new->flags) & IRQF_SHARED) ||
  848. ((old->flags ^ new->flags) & IRQF_TRIGGER_MASK) ||
  849. ((old->flags ^ new->flags) & IRQF_ONESHOT)) {
  850. old_name = old->name;
  851. goto mismatch;
  852. }
  853. /* All handlers must agree on per-cpuness */
  854. if ((old->flags & IRQF_PERCPU) !=
  855. (new->flags & IRQF_PERCPU))
  856. goto mismatch;
  857. /* add new interrupt at end of irq queue */
  858. do {
  859. thread_mask |= old->thread_mask;
  860. old_ptr = &old->next;
  861. old = *old_ptr;
  862. } while (old);
  863. shared = 1;
  864. }
  865. /*
  866. * Setup the thread mask for this irqaction. Unlikely to have
  867. * 32 resp 64 irqs sharing one line, but who knows.
  868. */
  869. if (new->flags & IRQF_ONESHOT && thread_mask == ~0UL) {
  870. ret = -EBUSY;
  871. goto out_mask;
  872. }
  873. new->thread_mask = 1 << ffz(thread_mask);
  874. if (!shared) {
  875. init_waitqueue_head(&desc->wait_for_threads);
  876. /* Setup the type (level, edge polarity) if configured: */
  877. if (new->flags & IRQF_TRIGGER_MASK) {
  878. ret = __irq_set_trigger(desc, irq,
  879. new->flags & IRQF_TRIGGER_MASK);
  880. if (ret)
  881. goto out_mask;
  882. }
  883. desc->istate &= ~(IRQS_AUTODETECT | IRQS_SPURIOUS_DISABLED | \
  884. IRQS_ONESHOT | IRQS_WAITING);
  885. irqd_clear(&desc->irq_data, IRQD_IRQ_INPROGRESS);
  886. if (new->flags & IRQF_PERCPU) {
  887. irqd_set(&desc->irq_data, IRQD_PER_CPU);
  888. irq_settings_set_per_cpu(desc);
  889. }
  890. if (new->flags & IRQF_ONESHOT)
  891. desc->istate |= IRQS_ONESHOT;
  892. if (irq_settings_can_autoenable(desc))
  893. irq_startup(desc);
  894. else
  895. /* Undo nested disables: */
  896. desc->depth = 1;
  897. /* Exclude IRQ from balancing if requested */
  898. if (new->flags & IRQF_NOBALANCING) {
  899. irq_settings_set_no_balancing(desc);
  900. irqd_set(&desc->irq_data, IRQD_NO_BALANCING);
  901. }
  902. /* Set default affinity mask once everything is setup */
  903. setup_affinity(irq, desc, mask);
  904. } else if (new->flags & IRQF_TRIGGER_MASK) {
  905. unsigned int nmsk = new->flags & IRQF_TRIGGER_MASK;
  906. unsigned int omsk = irq_settings_get_trigger_mask(desc);
  907. if (nmsk != omsk)
  908. /* hope the handler works with current trigger mode */
  909. pr_warning("IRQ %d uses trigger mode %u; requested %u\n",
  910. irq, nmsk, omsk);
  911. }
  912. new->irq = irq;
  913. *old_ptr = new;
  914. /* Reset broken irq detection when installing new handler */
  915. desc->irq_count = 0;
  916. desc->irqs_unhandled = 0;
  917. /*
  918. * Check whether we disabled the irq via the spurious handler
  919. * before. Reenable it and give it another chance.
  920. */
  921. if (shared && (desc->istate & IRQS_SPURIOUS_DISABLED)) {
  922. desc->istate &= ~IRQS_SPURIOUS_DISABLED;
  923. __enable_irq(desc, irq, false);
  924. }
  925. raw_spin_unlock_irqrestore(&desc->lock, flags);
  926. /*
  927. * Strictly no need to wake it up, but hung_task complains
  928. * when no hard interrupt wakes the thread up.
  929. */
  930. if (new->thread)
  931. wake_up_process(new->thread);
  932. register_irq_proc(irq, desc);
  933. new->dir = NULL;
  934. register_handler_proc(irq, new);
  935. free_cpumask_var(mask);
  936. return 0;
  937. mismatch:
  938. #ifdef CONFIG_DEBUG_SHIRQ
  939. if (!(new->flags & IRQF_PROBE_SHARED)) {
  940. printk(KERN_ERR "IRQ handler type mismatch for IRQ %d\n", irq);
  941. if (old_name)
  942. printk(KERN_ERR "current handler: %s\n", old_name);
  943. dump_stack();
  944. }
  945. #endif
  946. ret = -EBUSY;
  947. out_mask:
  948. raw_spin_unlock_irqrestore(&desc->lock, flags);
  949. free_cpumask_var(mask);
  950. out_thread:
  951. if (new->thread) {
  952. struct task_struct *t = new->thread;
  953. new->thread = NULL;
  954. if (likely(!test_bit(IRQTF_DIED, &new->thread_flags)))
  955. kthread_stop(t);
  956. put_task_struct(t);
  957. }
  958. out_mput:
  959. module_put(desc->owner);
  960. return ret;
  961. }
  962. /**
  963. * setup_irq - setup an interrupt
  964. * @irq: Interrupt line to setup
  965. * @act: irqaction for the interrupt
  966. *
  967. * Used to statically setup interrupts in the early boot process.
  968. */
  969. int setup_irq(unsigned int irq, struct irqaction *act)
  970. {
  971. int retval;
  972. struct irq_desc *desc = irq_to_desc(irq);
  973. if (WARN_ON(irq_settings_is_per_cpu_devid(desc)))
  974. return -EINVAL;
  975. chip_bus_lock(desc);
  976. retval = __setup_irq(irq, desc, act);
  977. chip_bus_sync_unlock(desc);
  978. return retval;
  979. }
  980. EXPORT_SYMBOL_GPL(setup_irq);
  981. /*
  982. * Internal function to unregister an irqaction - used to free
  983. * regular and special interrupts that are part of the architecture.
  984. */
  985. static struct irqaction *__free_irq(unsigned int irq, void *dev_id)
  986. {
  987. struct irq_desc *desc = irq_to_desc(irq);
  988. struct irqaction *action, **action_ptr;
  989. unsigned long flags;
  990. WARN(in_interrupt(), "Trying to free IRQ %d from IRQ context!\n", irq);
  991. if (!desc)
  992. return NULL;
  993. raw_spin_lock_irqsave(&desc->lock, flags);
  994. /*
  995. * There can be multiple actions per IRQ descriptor, find the right
  996. * one based on the dev_id:
  997. */
  998. action_ptr = &desc->action;
  999. for (;;) {
  1000. action = *action_ptr;
  1001. if (!action) {
  1002. WARN(1, "Trying to free already-free IRQ %d\n", irq);
  1003. raw_spin_unlock_irqrestore(&desc->lock, flags);
  1004. return NULL;
  1005. }
  1006. if (action->dev_id == dev_id)
  1007. break;
  1008. action_ptr = &action->next;
  1009. }
  1010. /* Found it - now remove it from the list of entries: */
  1011. *action_ptr = action->next;
  1012. /* Currently used only by UML, might disappear one day: */
  1013. #ifdef CONFIG_IRQ_RELEASE_METHOD
  1014. if (desc->irq_data.chip->release)
  1015. desc->irq_data.chip->release(irq, dev_id);
  1016. #endif
  1017. /* If this was the last handler, shut down the IRQ line: */
  1018. if (!desc->action)
  1019. irq_shutdown(desc);
  1020. #ifdef CONFIG_SMP
  1021. /* make sure affinity_hint is cleaned up */
  1022. if (WARN_ON_ONCE(desc->affinity_hint))
  1023. desc->affinity_hint = NULL;
  1024. #endif
  1025. raw_spin_unlock_irqrestore(&desc->lock, flags);
  1026. unregister_handler_proc(irq, action);
  1027. /* Make sure it's not being used on another CPU: */
  1028. synchronize_irq(irq);
  1029. #ifdef CONFIG_DEBUG_SHIRQ
  1030. /*
  1031. * It's a shared IRQ -- the driver ought to be prepared for an IRQ
  1032. * event to happen even now it's being freed, so let's make sure that
  1033. * is so by doing an extra call to the handler ....
  1034. *
  1035. * ( We do this after actually deregistering it, to make sure that a
  1036. * 'real' IRQ doesn't run in * parallel with our fake. )
  1037. */
  1038. if (action->flags & IRQF_SHARED) {
  1039. local_irq_save(flags);
  1040. action->handler(irq, dev_id);
  1041. local_irq_restore(flags);
  1042. }
  1043. #endif
  1044. if (action->thread) {
  1045. if (!test_bit(IRQTF_DIED, &action->thread_flags))
  1046. kthread_stop(action->thread);
  1047. put_task_struct(action->thread);
  1048. }
  1049. module_put(desc->owner);
  1050. return action;
  1051. }
  1052. /**
  1053. * remove_irq - free an interrupt
  1054. * @irq: Interrupt line to free
  1055. * @act: irqaction for the interrupt
  1056. *
  1057. * Used to remove interrupts statically setup by the early boot process.
  1058. */
  1059. void remove_irq(unsigned int irq, struct irqaction *act)
  1060. {
  1061. struct irq_desc *desc = irq_to_desc(irq);
  1062. if (desc && !WARN_ON(irq_settings_is_per_cpu_devid(desc)))
  1063. __free_irq(irq, act->dev_id);
  1064. }
  1065. EXPORT_SYMBOL_GPL(remove_irq);
  1066. /**
  1067. * free_irq - free an interrupt allocated with request_irq
  1068. * @irq: Interrupt line to free
  1069. * @dev_id: Device identity to free
  1070. *
  1071. * Remove an interrupt handler. The handler is removed and if the
  1072. * interrupt line is no longer in use by any driver it is disabled.
  1073. * On a shared IRQ the caller must ensure the interrupt is disabled
  1074. * on the card it drives before calling this function. The function
  1075. * does not return until any executing interrupts for this IRQ
  1076. * have completed.
  1077. *
  1078. * This function must not be called from interrupt context.
  1079. */
  1080. void free_irq(unsigned int irq, void *dev_id)
  1081. {
  1082. struct irq_desc *desc = irq_to_desc(irq);
  1083. if (!desc || WARN_ON(irq_settings_is_per_cpu_devid(desc)))
  1084. return;
  1085. #ifdef CONFIG_SMP
  1086. if (WARN_ON(desc->affinity_notify))
  1087. desc->affinity_notify = NULL;
  1088. #endif
  1089. chip_bus_lock(desc);
  1090. kfree(__free_irq(irq, dev_id));
  1091. chip_bus_sync_unlock(desc);
  1092. }
  1093. EXPORT_SYMBOL(free_irq);
  1094. /**
  1095. * request_threaded_irq - allocate an interrupt line
  1096. * @irq: Interrupt line to allocate
  1097. * @handler: Function to be called when the IRQ occurs.
  1098. * Primary handler for threaded interrupts
  1099. * If NULL and thread_fn != NULL the default
  1100. * primary handler is installed
  1101. * @thread_fn: Function called from the irq handler thread
  1102. * If NULL, no irq thread is created
  1103. * @irqflags: Interrupt type flags
  1104. * @devname: An ascii name for the claiming device
  1105. * @dev_id: A cookie passed back to the handler function
  1106. *
  1107. * This call allocates interrupt resources and enables the
  1108. * interrupt line and IRQ handling. From the point this
  1109. * call is made your handler function may be invoked. Since
  1110. * your handler function must clear any interrupt the board
  1111. * raises, you must take care both to initialise your hardware
  1112. * and to set up the interrupt handler in the right order.
  1113. *
  1114. * If you want to set up a threaded irq handler for your device
  1115. * then you need to supply @handler and @thread_fn. @handler ist
  1116. * still called in hard interrupt context and has to check
  1117. * whether the interrupt originates from the device. If yes it
  1118. * needs to disable the interrupt on the device and return
  1119. * IRQ_WAKE_THREAD which will wake up the handler thread and run
  1120. * @thread_fn. This split handler design is necessary to support
  1121. * shared interrupts.
  1122. *
  1123. * Dev_id must be globally unique. Normally the address of the
  1124. * device data structure is used as the cookie. Since the handler
  1125. * receives this value it makes sense to use it.
  1126. *
  1127. * If your interrupt is shared you must pass a non NULL dev_id
  1128. * as this is required when freeing the interrupt.
  1129. *
  1130. * Flags:
  1131. *
  1132. * IRQF_SHARED Interrupt is shared
  1133. * IRQF_SAMPLE_RANDOM The interrupt can be used for entropy
  1134. * IRQF_TRIGGER_* Specify active edge(s) or level
  1135. *
  1136. */
  1137. int request_threaded_irq(unsigned int irq, irq_handler_t handler,
  1138. irq_handler_t thread_fn, unsigned long irqflags,
  1139. const char *devname, void *dev_id)
  1140. {
  1141. struct irqaction *action;
  1142. struct irq_desc *desc;
  1143. int retval;
  1144. /*
  1145. * Sanity-check: shared interrupts must pass in a real dev-ID,
  1146. * otherwise we'll have trouble later trying to figure out
  1147. * which interrupt is which (messes up the interrupt freeing
  1148. * logic etc).
  1149. */
  1150. if ((irqflags & IRQF_SHARED) && !dev_id)
  1151. return -EINVAL;
  1152. desc = irq_to_desc(irq);
  1153. if (!desc)
  1154. return -EINVAL;
  1155. if (!irq_settings_can_request(desc) ||
  1156. WARN_ON(irq_settings_is_per_cpu_devid(desc)))
  1157. return -EINVAL;
  1158. if (!handler) {
  1159. if (!thread_fn)
  1160. return -EINVAL;
  1161. handler = irq_default_primary_handler;
  1162. }
  1163. action = kzalloc(sizeof(struct irqaction), GFP_KERNEL);
  1164. if (!action)
  1165. return -ENOMEM;
  1166. action->handler = handler;
  1167. action->thread_fn = thread_fn;
  1168. action->flags = irqflags;
  1169. action->name = devname;
  1170. action->dev_id = dev_id;
  1171. chip_bus_lock(desc);
  1172. retval = __setup_irq(irq, desc, action);
  1173. chip_bus_sync_unlock(desc);
  1174. if (retval)
  1175. kfree(action);
  1176. #ifdef CONFIG_DEBUG_SHIRQ_FIXME
  1177. if (!retval && (irqflags & IRQF_SHARED)) {
  1178. /*
  1179. * It's a shared IRQ -- the driver ought to be prepared for it
  1180. * to happen immediately, so let's make sure....
  1181. * We disable the irq to make sure that a 'real' IRQ doesn't
  1182. * run in parallel with our fake.
  1183. */
  1184. unsigned long flags;
  1185. disable_irq(irq);
  1186. local_irq_save(flags);
  1187. handler(irq, dev_id);
  1188. local_irq_restore(flags);
  1189. enable_irq(irq);
  1190. }
  1191. #endif
  1192. return retval;
  1193. }
  1194. EXPORT_SYMBOL(request_threaded_irq);
  1195. /**
  1196. * request_any_context_irq - allocate an interrupt line
  1197. * @irq: Interrupt line to allocate
  1198. * @handler: Function to be called when the IRQ occurs.
  1199. * Threaded handler for threaded interrupts.
  1200. * @flags: Interrupt type flags
  1201. * @name: An ascii name for the claiming device
  1202. * @dev_id: A cookie passed back to the handler function
  1203. *
  1204. * This call allocates interrupt resources and enables the
  1205. * interrupt line and IRQ handling. It selects either a
  1206. * hardirq or threaded handling method depending on the
  1207. * context.
  1208. *
  1209. * On failure, it returns a negative value. On success,
  1210. * it returns either IRQC_IS_HARDIRQ or IRQC_IS_NESTED.
  1211. */
  1212. int request_any_context_irq(unsigned int irq, irq_handler_t handler,
  1213. unsigned long flags, const char *name, void *dev_id)
  1214. {
  1215. struct irq_desc *desc = irq_to_desc(irq);
  1216. int ret;
  1217. if (!desc)
  1218. return -EINVAL;
  1219. if (irq_settings_is_nested_thread(desc)) {
  1220. ret = request_threaded_irq(irq, NULL, handler,
  1221. flags, name, dev_id);
  1222. return !ret ? IRQC_IS_NESTED : ret;
  1223. }
  1224. ret = request_irq(irq, handler, flags, name, dev_id);
  1225. return !ret ? IRQC_IS_HARDIRQ : ret;
  1226. }
  1227. EXPORT_SYMBOL_GPL(request_any_context_irq);
  1228. void enable_percpu_irq(unsigned int irq, unsigned int type)
  1229. {
  1230. unsigned int cpu = smp_processor_id();
  1231. unsigned long flags;
  1232. struct irq_desc *desc = irq_get_desc_lock(irq, &flags, IRQ_GET_DESC_CHECK_PERCPU);
  1233. if (!desc)
  1234. return;
  1235. type &= IRQ_TYPE_SENSE_MASK;
  1236. if (type != IRQ_TYPE_NONE) {
  1237. int ret;
  1238. ret = __irq_set_trigger(desc, irq, type);
  1239. if (ret) {
  1240. WARN(1, "failed to set type for IRQ%d\n", irq);
  1241. goto out;
  1242. }
  1243. }
  1244. irq_percpu_enable(desc, cpu);
  1245. out:
  1246. irq_put_desc_unlock(desc, flags);
  1247. }
  1248. void disable_percpu_irq(unsigned int irq)
  1249. {
  1250. unsigned int cpu = smp_processor_id();
  1251. unsigned long flags;
  1252. struct irq_desc *desc = irq_get_desc_lock(irq, &flags, IRQ_GET_DESC_CHECK_PERCPU);
  1253. if (!desc)
  1254. return;
  1255. irq_percpu_disable(desc, cpu);
  1256. irq_put_desc_unlock(desc, flags);
  1257. }
  1258. /*
  1259. * Internal function to unregister a percpu irqaction.
  1260. */
  1261. static struct irqaction *__free_percpu_irq(unsigned int irq, void __percpu *dev_id)
  1262. {
  1263. struct irq_desc *desc = irq_to_desc(irq);
  1264. struct irqaction *action;
  1265. unsigned long flags;
  1266. WARN(in_interrupt(), "Trying to free IRQ %d from IRQ context!\n", irq);
  1267. if (!desc)
  1268. return NULL;
  1269. raw_spin_lock_irqsave(&desc->lock, flags);
  1270. action = desc->action;
  1271. if (!action || action->percpu_dev_id != dev_id) {
  1272. WARN(1, "Trying to free already-free IRQ %d\n", irq);
  1273. goto bad;
  1274. }
  1275. if (!cpumask_empty(desc->percpu_enabled)) {
  1276. WARN(1, "percpu IRQ %d still enabled on CPU%d!\n",
  1277. irq, cpumask_first(desc->percpu_enabled));
  1278. goto bad;
  1279. }
  1280. /* Found it - now remove it from the list of entries: */
  1281. desc->action = NULL;
  1282. raw_spin_unlock_irqrestore(&desc->lock, flags);
  1283. unregister_handler_proc(irq, action);
  1284. module_put(desc->owner);
  1285. return action;
  1286. bad:
  1287. raw_spin_unlock_irqrestore(&desc->lock, flags);
  1288. return NULL;
  1289. }
  1290. /**
  1291. * remove_percpu_irq - free a per-cpu interrupt
  1292. * @irq: Interrupt line to free
  1293. * @act: irqaction for the interrupt
  1294. *
  1295. * Used to remove interrupts statically setup by the early boot process.
  1296. */
  1297. void remove_percpu_irq(unsigned int irq, struct irqaction *act)
  1298. {
  1299. struct irq_desc *desc = irq_to_desc(irq);
  1300. if (desc && irq_settings_is_per_cpu_devid(desc))
  1301. __free_percpu_irq(irq, act->percpu_dev_id);
  1302. }
  1303. /**
  1304. * free_percpu_irq - free an interrupt allocated with request_percpu_irq
  1305. * @irq: Interrupt line to free
  1306. * @dev_id: Device identity to free
  1307. *
  1308. * Remove a percpu interrupt handler. The handler is removed, but
  1309. * the interrupt line is not disabled. This must be done on each
  1310. * CPU before calling this function. The function does not return
  1311. * until any executing interrupts for this IRQ have completed.
  1312. *
  1313. * This function must not be called from interrupt context.
  1314. */
  1315. void free_percpu_irq(unsigned int irq, void __percpu *dev_id)
  1316. {
  1317. struct irq_desc *desc = irq_to_desc(irq);
  1318. if (!desc || !irq_settings_is_per_cpu_devid(desc))
  1319. return;
  1320. chip_bus_lock(desc);
  1321. kfree(__free_percpu_irq(irq, dev_id));
  1322. chip_bus_sync_unlock(desc);
  1323. }
  1324. /**
  1325. * setup_percpu_irq - setup a per-cpu interrupt
  1326. * @irq: Interrupt line to setup
  1327. * @act: irqaction for the interrupt
  1328. *
  1329. * Used to statically setup per-cpu interrupts in the early boot process.
  1330. */
  1331. int setup_percpu_irq(unsigned int irq, struct irqaction *act)
  1332. {
  1333. struct irq_desc *desc = irq_to_desc(irq);
  1334. int retval;
  1335. if (!desc || !irq_settings_is_per_cpu_devid(desc))
  1336. return -EINVAL;
  1337. chip_bus_lock(desc);
  1338. retval = __setup_irq(irq, desc, act);
  1339. chip_bus_sync_unlock(desc);
  1340. return retval;
  1341. }
  1342. /**
  1343. * request_percpu_irq - allocate a percpu interrupt line
  1344. * @irq: Interrupt line to allocate
  1345. * @handler: Function to be called when the IRQ occurs.
  1346. * @devname: An ascii name for the claiming device
  1347. * @dev_id: A percpu cookie passed back to the handler function
  1348. *
  1349. * This call allocates interrupt resources, but doesn't
  1350. * automatically enable the interrupt. It has to be done on each
  1351. * CPU using enable_percpu_irq().
  1352. *
  1353. * Dev_id must be globally unique. It is a per-cpu variable, and
  1354. * the handler gets called with the interrupted CPU's instance of
  1355. * that variable.
  1356. */
  1357. int request_percpu_irq(unsigned int irq, irq_handler_t handler,
  1358. const char *devname, void __percpu *dev_id)
  1359. {
  1360. struct irqaction *action;
  1361. struct irq_desc *desc;
  1362. int retval;
  1363. if (!dev_id)
  1364. return -EINVAL;
  1365. desc = irq_to_desc(irq);
  1366. if (!desc || !irq_settings_can_request(desc) ||
  1367. !irq_settings_is_per_cpu_devid(desc))
  1368. return -EINVAL;
  1369. action = kzalloc(sizeof(struct irqaction), GFP_KERNEL);
  1370. if (!action)
  1371. return -ENOMEM;
  1372. action->handler = handler;
  1373. action->flags = IRQF_PERCPU | IRQF_NO_SUSPEND;
  1374. action->name = devname;
  1375. action->percpu_dev_id = dev_id;
  1376. chip_bus_lock(desc);
  1377. retval = __setup_irq(irq, desc, action);
  1378. chip_bus_sync_unlock(desc);
  1379. if (retval)
  1380. kfree(action);
  1381. return retval;
  1382. }