manage.c 41 KB

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