uverbs.h 7.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219
  1. /*
  2. * Copyright (c) 2005 Topspin Communications. All rights reserved.
  3. * Copyright (c) 2005, 2006 Cisco Systems. All rights reserved.
  4. * Copyright (c) 2005 Mellanox Technologies. All rights reserved.
  5. * Copyright (c) 2005 Voltaire, Inc. All rights reserved.
  6. * Copyright (c) 2005 PathScale, Inc. All rights reserved.
  7. *
  8. * This software is available to you under a choice of one of two
  9. * licenses. You may choose to be licensed under the terms of the GNU
  10. * General Public License (GPL) Version 2, available from the file
  11. * COPYING in the main directory of this source tree, or the
  12. * OpenIB.org BSD license below:
  13. *
  14. * Redistribution and use in source and binary forms, with or
  15. * without modification, are permitted provided that the following
  16. * conditions are met:
  17. *
  18. * - Redistributions of source code must retain the above
  19. * copyright notice, this list of conditions and the following
  20. * disclaimer.
  21. *
  22. * - Redistributions in binary form must reproduce the above
  23. * copyright notice, this list of conditions and the following
  24. * disclaimer in the documentation and/or other materials
  25. * provided with the distribution.
  26. *
  27. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  28. * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  29. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  30. * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  31. * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  32. * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  33. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  34. * SOFTWARE.
  35. */
  36. #ifndef UVERBS_H
  37. #define UVERBS_H
  38. #include <linux/kref.h>
  39. #include <linux/idr.h>
  40. #include <linux/mutex.h>
  41. #include <linux/completion.h>
  42. #include <linux/cdev.h>
  43. #include <rdma/ib_verbs.h>
  44. #include <rdma/ib_umem.h>
  45. #include <rdma/ib_user_verbs.h>
  46. /*
  47. * Our lifetime rules for these structs are the following:
  48. *
  49. * struct ib_uverbs_device: One reference is held by the module and
  50. * released in ib_uverbs_remove_one(). Another reference is taken by
  51. * ib_uverbs_open() each time the character special file is opened,
  52. * and released in ib_uverbs_release_file() when the file is released.
  53. *
  54. * struct ib_uverbs_file: One reference is held by the VFS and
  55. * released when the file is closed. Another reference is taken when
  56. * an asynchronous event queue file is created and released when the
  57. * event file is closed.
  58. *
  59. * struct ib_uverbs_event_file: One reference is held by the VFS and
  60. * released when the file is closed. For asynchronous event files,
  61. * another reference is held by the corresponding main context file
  62. * and released when that file is closed. For completion event files,
  63. * a reference is taken when a CQ is created that uses the file, and
  64. * released when the CQ is destroyed.
  65. */
  66. struct ib_uverbs_device {
  67. atomic_t refcount;
  68. int num_comp_vectors;
  69. struct completion comp;
  70. struct device *dev;
  71. struct ib_device *ib_dev;
  72. int devnum;
  73. struct cdev cdev;
  74. struct rb_root xrcd_tree;
  75. struct mutex xrcd_tree_mutex;
  76. struct kobject kobj;
  77. };
  78. struct ib_uverbs_event_file {
  79. struct kref ref;
  80. int is_async;
  81. struct ib_uverbs_file *uverbs_file;
  82. spinlock_t lock;
  83. int is_closed;
  84. wait_queue_head_t poll_wait;
  85. struct fasync_struct *async_queue;
  86. struct list_head event_list;
  87. };
  88. struct ib_uverbs_file {
  89. struct kref ref;
  90. struct mutex mutex;
  91. struct ib_uverbs_device *device;
  92. struct ib_ucontext *ucontext;
  93. struct ib_event_handler event_handler;
  94. struct ib_uverbs_event_file *async_file;
  95. };
  96. struct ib_uverbs_event {
  97. union {
  98. struct ib_uverbs_async_event_desc async;
  99. struct ib_uverbs_comp_event_desc comp;
  100. } desc;
  101. struct list_head list;
  102. struct list_head obj_list;
  103. u32 *counter;
  104. };
  105. struct ib_uverbs_mcast_entry {
  106. struct list_head list;
  107. union ib_gid gid;
  108. u16 lid;
  109. };
  110. struct ib_uevent_object {
  111. struct ib_uobject uobject;
  112. struct list_head event_list;
  113. u32 events_reported;
  114. };
  115. struct ib_uxrcd_object {
  116. struct ib_uobject uobject;
  117. atomic_t refcnt;
  118. };
  119. struct ib_usrq_object {
  120. struct ib_uevent_object uevent;
  121. struct ib_uxrcd_object *uxrcd;
  122. };
  123. struct ib_uqp_object {
  124. struct ib_uevent_object uevent;
  125. struct list_head mcast_list;
  126. };
  127. struct ib_ucq_object {
  128. struct ib_uobject uobject;
  129. struct ib_uverbs_file *uverbs_file;
  130. struct list_head comp_list;
  131. struct list_head async_list;
  132. u32 comp_events_reported;
  133. u32 async_events_reported;
  134. };
  135. extern spinlock_t ib_uverbs_idr_lock;
  136. extern struct idr ib_uverbs_pd_idr;
  137. extern struct idr ib_uverbs_mr_idr;
  138. extern struct idr ib_uverbs_mw_idr;
  139. extern struct idr ib_uverbs_ah_idr;
  140. extern struct idr ib_uverbs_cq_idr;
  141. extern struct idr ib_uverbs_qp_idr;
  142. extern struct idr ib_uverbs_srq_idr;
  143. extern struct idr ib_uverbs_xrcd_idr;
  144. void idr_remove_uobj(struct idr *idp, struct ib_uobject *uobj);
  145. struct file *ib_uverbs_alloc_event_file(struct ib_uverbs_file *uverbs_file,
  146. int is_async);
  147. struct ib_uverbs_event_file *ib_uverbs_lookup_comp_file(int fd);
  148. void ib_uverbs_release_ucq(struct ib_uverbs_file *file,
  149. struct ib_uverbs_event_file *ev_file,
  150. struct ib_ucq_object *uobj);
  151. void ib_uverbs_release_uevent(struct ib_uverbs_file *file,
  152. struct ib_uevent_object *uobj);
  153. void ib_uverbs_comp_handler(struct ib_cq *cq, void *cq_context);
  154. void ib_uverbs_cq_event_handler(struct ib_event *event, void *context_ptr);
  155. void ib_uverbs_qp_event_handler(struct ib_event *event, void *context_ptr);
  156. void ib_uverbs_srq_event_handler(struct ib_event *event, void *context_ptr);
  157. void ib_uverbs_event_handler(struct ib_event_handler *handler,
  158. struct ib_event *event);
  159. void ib_uverbs_dealloc_xrcd(struct ib_uverbs_device *dev, struct ib_xrcd *xrcd);
  160. #define IB_UVERBS_DECLARE_CMD(name) \
  161. ssize_t ib_uverbs_##name(struct ib_uverbs_file *file, \
  162. const char __user *buf, int in_len, \
  163. int out_len)
  164. IB_UVERBS_DECLARE_CMD(get_context);
  165. IB_UVERBS_DECLARE_CMD(query_device);
  166. IB_UVERBS_DECLARE_CMD(query_port);
  167. IB_UVERBS_DECLARE_CMD(alloc_pd);
  168. IB_UVERBS_DECLARE_CMD(dealloc_pd);
  169. IB_UVERBS_DECLARE_CMD(reg_mr);
  170. IB_UVERBS_DECLARE_CMD(dereg_mr);
  171. IB_UVERBS_DECLARE_CMD(create_comp_channel);
  172. IB_UVERBS_DECLARE_CMD(create_cq);
  173. IB_UVERBS_DECLARE_CMD(resize_cq);
  174. IB_UVERBS_DECLARE_CMD(poll_cq);
  175. IB_UVERBS_DECLARE_CMD(req_notify_cq);
  176. IB_UVERBS_DECLARE_CMD(destroy_cq);
  177. IB_UVERBS_DECLARE_CMD(create_qp);
  178. IB_UVERBS_DECLARE_CMD(open_qp);
  179. IB_UVERBS_DECLARE_CMD(query_qp);
  180. IB_UVERBS_DECLARE_CMD(modify_qp);
  181. IB_UVERBS_DECLARE_CMD(destroy_qp);
  182. IB_UVERBS_DECLARE_CMD(post_send);
  183. IB_UVERBS_DECLARE_CMD(post_recv);
  184. IB_UVERBS_DECLARE_CMD(post_srq_recv);
  185. IB_UVERBS_DECLARE_CMD(create_ah);
  186. IB_UVERBS_DECLARE_CMD(destroy_ah);
  187. IB_UVERBS_DECLARE_CMD(attach_mcast);
  188. IB_UVERBS_DECLARE_CMD(detach_mcast);
  189. IB_UVERBS_DECLARE_CMD(create_srq);
  190. IB_UVERBS_DECLARE_CMD(modify_srq);
  191. IB_UVERBS_DECLARE_CMD(query_srq);
  192. IB_UVERBS_DECLARE_CMD(destroy_srq);
  193. IB_UVERBS_DECLARE_CMD(create_xsrq);
  194. IB_UVERBS_DECLARE_CMD(open_xrcd);
  195. IB_UVERBS_DECLARE_CMD(close_xrcd);
  196. #endif /* UVERBS_H */