irqbypass.c 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * IRQ offload/bypass manager
  4. *
  5. * Copyright (C) 2015 Red Hat, Inc.
  6. * Copyright (c) 2015 Linaro Ltd.
  7. *
  8. * Various virtualization hardware acceleration techniques allow bypassing or
  9. * offloading interrupts received from devices around the host kernel. Posted
  10. * Interrupts on Intel VT-d systems can allow interrupts to be received
  11. * directly by a virtual machine. ARM IRQ Forwarding allows forwarded physical
  12. * interrupts to be directly deactivated by the guest. This manager allows
  13. * interrupt producers and consumers to find each other to enable this sort of
  14. * bypass.
  15. */
  16. #include <linux/irqbypass.h>
  17. #include <linux/list.h>
  18. #include <linux/module.h>
  19. #include <linux/mutex.h>
  20. MODULE_LICENSE("GPL v2");
  21. MODULE_DESCRIPTION("IRQ bypass manager utility module");
  22. static LIST_HEAD(producers);
  23. static LIST_HEAD(consumers);
  24. static DEFINE_MUTEX(lock);
  25. /* @lock must be held when calling connect */
  26. static int __connect(struct irq_bypass_producer *prod,
  27. struct irq_bypass_consumer *cons)
  28. {
  29. int ret = 0;
  30. if (prod->stop)
  31. prod->stop(prod);
  32. if (cons->stop)
  33. cons->stop(cons);
  34. if (prod->add_consumer)
  35. ret = prod->add_consumer(prod, cons);
  36. if (!ret) {
  37. ret = cons->add_producer(cons, prod);
  38. if (ret && prod->del_consumer)
  39. prod->del_consumer(prod, cons);
  40. }
  41. if (cons->start)
  42. cons->start(cons);
  43. if (prod->start)
  44. prod->start(prod);
  45. return ret;
  46. }
  47. /* @lock must be held when calling disconnect */
  48. static void __disconnect(struct irq_bypass_producer *prod,
  49. struct irq_bypass_consumer *cons)
  50. {
  51. if (prod->stop)
  52. prod->stop(prod);
  53. if (cons->stop)
  54. cons->stop(cons);
  55. cons->del_producer(cons, prod);
  56. if (prod->del_consumer)
  57. prod->del_consumer(prod, cons);
  58. if (cons->start)
  59. cons->start(cons);
  60. if (prod->start)
  61. prod->start(prod);
  62. }
  63. /**
  64. * irq_bypass_register_producer - register IRQ bypass producer
  65. * @producer: pointer to producer structure
  66. *
  67. * Add the provided IRQ producer to the list of producers and connect
  68. * with any matching token found on the IRQ consumers list.
  69. */
  70. int irq_bypass_register_producer(struct irq_bypass_producer *producer)
  71. {
  72. struct irq_bypass_producer *tmp;
  73. struct irq_bypass_consumer *consumer;
  74. int ret;
  75. if (!producer->token)
  76. return -EINVAL;
  77. might_sleep();
  78. if (!try_module_get(THIS_MODULE))
  79. return -ENODEV;
  80. mutex_lock(&lock);
  81. list_for_each_entry(tmp, &producers, node) {
  82. if (tmp->token == producer->token) {
  83. ret = -EBUSY;
  84. goto out_err;
  85. }
  86. }
  87. list_for_each_entry(consumer, &consumers, node) {
  88. if (consumer->token == producer->token) {
  89. ret = __connect(producer, consumer);
  90. if (ret)
  91. goto out_err;
  92. break;
  93. }
  94. }
  95. list_add(&producer->node, &producers);
  96. mutex_unlock(&lock);
  97. return 0;
  98. out_err:
  99. mutex_unlock(&lock);
  100. module_put(THIS_MODULE);
  101. return ret;
  102. }
  103. EXPORT_SYMBOL_GPL(irq_bypass_register_producer);
  104. /**
  105. * irq_bypass_unregister_producer - unregister IRQ bypass producer
  106. * @producer: pointer to producer structure
  107. *
  108. * Remove a previously registered IRQ producer from the list of producers
  109. * and disconnect it from any connected IRQ consumer.
  110. */
  111. void irq_bypass_unregister_producer(struct irq_bypass_producer *producer)
  112. {
  113. struct irq_bypass_producer *tmp;
  114. struct irq_bypass_consumer *consumer;
  115. if (!producer->token)
  116. return;
  117. might_sleep();
  118. if (!try_module_get(THIS_MODULE))
  119. return; /* nothing in the list anyway */
  120. mutex_lock(&lock);
  121. list_for_each_entry(tmp, &producers, node) {
  122. if (tmp->token != producer->token)
  123. continue;
  124. list_for_each_entry(consumer, &consumers, node) {
  125. if (consumer->token == producer->token) {
  126. __disconnect(producer, consumer);
  127. break;
  128. }
  129. }
  130. list_del(&producer->node);
  131. module_put(THIS_MODULE);
  132. break;
  133. }
  134. mutex_unlock(&lock);
  135. module_put(THIS_MODULE);
  136. }
  137. EXPORT_SYMBOL_GPL(irq_bypass_unregister_producer);
  138. /**
  139. * irq_bypass_register_consumer - register IRQ bypass consumer
  140. * @consumer: pointer to consumer structure
  141. *
  142. * Add the provided IRQ consumer to the list of consumers and connect
  143. * with any matching token found on the IRQ producer list.
  144. */
  145. int irq_bypass_register_consumer(struct irq_bypass_consumer *consumer)
  146. {
  147. struct irq_bypass_consumer *tmp;
  148. struct irq_bypass_producer *producer;
  149. int ret;
  150. if (!consumer->token ||
  151. !consumer->add_producer || !consumer->del_producer)
  152. return -EINVAL;
  153. might_sleep();
  154. if (!try_module_get(THIS_MODULE))
  155. return -ENODEV;
  156. mutex_lock(&lock);
  157. list_for_each_entry(tmp, &consumers, node) {
  158. if (tmp->token == consumer->token || tmp == consumer) {
  159. ret = -EBUSY;
  160. goto out_err;
  161. }
  162. }
  163. list_for_each_entry(producer, &producers, node) {
  164. if (producer->token == consumer->token) {
  165. ret = __connect(producer, consumer);
  166. if (ret)
  167. goto out_err;
  168. break;
  169. }
  170. }
  171. list_add(&consumer->node, &consumers);
  172. mutex_unlock(&lock);
  173. return 0;
  174. out_err:
  175. mutex_unlock(&lock);
  176. module_put(THIS_MODULE);
  177. return ret;
  178. }
  179. EXPORT_SYMBOL_GPL(irq_bypass_register_consumer);
  180. /**
  181. * irq_bypass_unregister_consumer - unregister IRQ bypass consumer
  182. * @consumer: pointer to consumer structure
  183. *
  184. * Remove a previously registered IRQ consumer from the list of consumers
  185. * and disconnect it from any connected IRQ producer.
  186. */
  187. void irq_bypass_unregister_consumer(struct irq_bypass_consumer *consumer)
  188. {
  189. struct irq_bypass_consumer *tmp;
  190. struct irq_bypass_producer *producer;
  191. if (!consumer->token)
  192. return;
  193. might_sleep();
  194. if (!try_module_get(THIS_MODULE))
  195. return; /* nothing in the list anyway */
  196. mutex_lock(&lock);
  197. list_for_each_entry(tmp, &consumers, node) {
  198. if (tmp != consumer)
  199. continue;
  200. list_for_each_entry(producer, &producers, node) {
  201. if (producer->token == consumer->token) {
  202. __disconnect(producer, consumer);
  203. break;
  204. }
  205. }
  206. list_del(&consumer->node);
  207. module_put(THIS_MODULE);
  208. break;
  209. }
  210. mutex_unlock(&lock);
  211. module_put(THIS_MODULE);
  212. }
  213. EXPORT_SYMBOL_GPL(irq_bypass_unregister_consumer);