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 | |
37 | #ifndef UVERBS_H |
38 | #define UVERBS_H |
39 | |
40 | #include <linux/kref.h> |
41 | #include <linux/idr.h> |
42 | #include <linux/mutex.h> |
43 | #include <linux/completion.h> |
44 | #include <linux/cdev.h> |
45 | |
46 | #include <rdma/ib_verbs.h> |
47 | #include <rdma/ib_umem.h> |
48 | #include <rdma/ib_user_verbs.h> |
49 | #include <rdma/uverbs_std_types.h> |
50 | |
51 | #define UVERBS_MODULE_NAME ib_uverbs |
52 | #include <rdma/uverbs_named_ioctl.h> |
53 | |
54 | static inline void |
55 | ib_uverbs_init_udata(struct ib_udata *udata, |
56 | const void __user *ibuf, |
57 | void __user *obuf, |
58 | size_t ilen, size_t olen) |
59 | { |
60 | udata->inbuf = ibuf; |
61 | udata->outbuf = obuf; |
62 | udata->inlen = ilen; |
63 | udata->outlen = olen; |
64 | } |
65 | |
66 | static inline void |
67 | ib_uverbs_init_udata_buf_or_null(struct ib_udata *udata, |
68 | const void __user *ibuf, |
69 | void __user *obuf, |
70 | size_t ilen, size_t olen) |
71 | { |
72 | ib_uverbs_init_udata(udata, |
73 | ibuf: ilen ? ibuf : NULL, obuf: olen ? obuf : NULL, |
74 | ilen, olen); |
75 | } |
76 | |
77 | /* |
78 | * Our lifetime rules for these structs are the following: |
79 | * |
80 | * struct ib_uverbs_device: One reference is held by the module and |
81 | * released in ib_uverbs_remove_one(). Another reference is taken by |
82 | * ib_uverbs_open() each time the character special file is opened, |
83 | * and released in ib_uverbs_release_file() when the file is released. |
84 | * |
85 | * struct ib_uverbs_file: One reference is held by the VFS and |
86 | * released when the file is closed. Another reference is taken when |
87 | * an asynchronous event queue file is created and released when the |
88 | * event file is closed. |
89 | * |
90 | * struct ib_uverbs_event_queue: Base structure for |
91 | * struct ib_uverbs_async_event_file and struct ib_uverbs_completion_event_file. |
92 | * One reference is held by the VFS and released when the file is closed. |
93 | * For asynchronous event files, another reference is held by the corresponding |
94 | * main context file and released when that file is closed. For completion |
95 | * event files, a reference is taken when a CQ is created that uses the file, |
96 | * and released when the CQ is destroyed. |
97 | */ |
98 | |
99 | struct ib_uverbs_device { |
100 | refcount_t refcount; |
101 | u32 num_comp_vectors; |
102 | struct completion comp; |
103 | struct device dev; |
104 | /* First group for device attributes, NULL terminated array */ |
105 | const struct attribute_group *groups[2]; |
106 | struct ib_device __rcu *ib_dev; |
107 | int devnum; |
108 | struct cdev cdev; |
109 | struct rb_root xrcd_tree; |
110 | struct mutex xrcd_tree_mutex; |
111 | struct srcu_struct disassociate_srcu; |
112 | struct mutex lists_mutex; /* protect lists */ |
113 | struct list_head uverbs_file_list; |
114 | struct uverbs_api *uapi; |
115 | }; |
116 | |
117 | struct ib_uverbs_event_queue { |
118 | spinlock_t lock; |
119 | int is_closed; |
120 | wait_queue_head_t poll_wait; |
121 | struct fasync_struct *async_queue; |
122 | struct list_head event_list; |
123 | }; |
124 | |
125 | struct ib_uverbs_async_event_file { |
126 | struct ib_uobject uobj; |
127 | struct ib_uverbs_event_queue ev_queue; |
128 | struct ib_event_handler event_handler; |
129 | }; |
130 | |
131 | struct ib_uverbs_completion_event_file { |
132 | struct ib_uobject uobj; |
133 | struct ib_uverbs_event_queue ev_queue; |
134 | }; |
135 | |
136 | struct ib_uverbs_event { |
137 | union { |
138 | struct ib_uverbs_async_event_desc async; |
139 | struct ib_uverbs_comp_event_desc comp; |
140 | } desc; |
141 | struct list_head list; |
142 | struct list_head obj_list; |
143 | u32 *counter; |
144 | }; |
145 | |
146 | struct ib_uverbs_mcast_entry { |
147 | struct list_head list; |
148 | union ib_gid gid; |
149 | u16 lid; |
150 | }; |
151 | |
152 | struct ib_uevent_object { |
153 | struct ib_uobject uobject; |
154 | struct ib_uverbs_async_event_file *event_file; |
155 | /* List member for ib_uverbs_async_event_file list */ |
156 | struct list_head event_list; |
157 | u32 events_reported; |
158 | }; |
159 | |
160 | struct ib_uxrcd_object { |
161 | struct ib_uobject uobject; |
162 | atomic_t refcnt; |
163 | }; |
164 | |
165 | struct ib_usrq_object { |
166 | struct ib_uevent_object uevent; |
167 | struct ib_uxrcd_object *uxrcd; |
168 | }; |
169 | |
170 | struct ib_uqp_object { |
171 | struct ib_uevent_object uevent; |
172 | /* lock for mcast list */ |
173 | struct mutex mcast_lock; |
174 | struct list_head mcast_list; |
175 | struct ib_uxrcd_object *uxrcd; |
176 | }; |
177 | |
178 | struct ib_uwq_object { |
179 | struct ib_uevent_object uevent; |
180 | }; |
181 | |
182 | struct ib_ucq_object { |
183 | struct ib_uevent_object uevent; |
184 | struct list_head comp_list; |
185 | u32 comp_events_reported; |
186 | }; |
187 | |
188 | extern const struct file_operations uverbs_event_fops; |
189 | extern const struct file_operations uverbs_async_event_fops; |
190 | void ib_uverbs_init_event_queue(struct ib_uverbs_event_queue *ev_queue); |
191 | void ib_uverbs_init_async_event_file(struct ib_uverbs_async_event_file *ev_file); |
192 | void ib_uverbs_free_event_queue(struct ib_uverbs_event_queue *event_queue); |
193 | void ib_uverbs_flow_resources_free(struct ib_uflow_resources *uflow_res); |
194 | int uverbs_async_event_release(struct inode *inode, struct file *filp); |
195 | |
196 | int ib_alloc_ucontext(struct uverbs_attr_bundle *attrs); |
197 | int ib_init_ucontext(struct uverbs_attr_bundle *attrs); |
198 | |
199 | void ib_uverbs_release_ucq(struct ib_uverbs_completion_event_file *ev_file, |
200 | struct ib_ucq_object *uobj); |
201 | void ib_uverbs_release_uevent(struct ib_uevent_object *uobj); |
202 | void ib_uverbs_release_file(struct kref *ref); |
203 | void ib_uverbs_async_handler(struct ib_uverbs_async_event_file *async_file, |
204 | __u64 element, __u64 event, |
205 | struct list_head *obj_list, u32 *counter); |
206 | |
207 | void ib_uverbs_comp_handler(struct ib_cq *cq, void *cq_context); |
208 | void ib_uverbs_cq_event_handler(struct ib_event *event, void *context_ptr); |
209 | void ib_uverbs_qp_event_handler(struct ib_event *event, void *context_ptr); |
210 | void ib_uverbs_wq_event_handler(struct ib_event *event, void *context_ptr); |
211 | void ib_uverbs_srq_event_handler(struct ib_event *event, void *context_ptr); |
212 | int ib_uverbs_dealloc_xrcd(struct ib_uobject *uobject, struct ib_xrcd *xrcd, |
213 | enum rdma_remove_reason why, |
214 | struct uverbs_attr_bundle *attrs); |
215 | |
216 | int uverbs_dealloc_mw(struct ib_mw *mw); |
217 | void ib_uverbs_detach_umcast(struct ib_qp *qp, |
218 | struct ib_uqp_object *uobj); |
219 | |
220 | long ib_uverbs_ioctl(struct file *filp, unsigned int cmd, unsigned long arg); |
221 | |
222 | struct ib_uverbs_flow_spec { |
223 | union { |
224 | union { |
225 | struct ib_uverbs_flow_spec_hdr hdr; |
226 | struct { |
227 | __u32 type; |
228 | __u16 size; |
229 | __u16 reserved; |
230 | }; |
231 | }; |
232 | struct ib_uverbs_flow_spec_eth eth; |
233 | struct ib_uverbs_flow_spec_ipv4 ipv4; |
234 | struct ib_uverbs_flow_spec_esp esp; |
235 | struct ib_uverbs_flow_spec_tcp_udp tcp_udp; |
236 | struct ib_uverbs_flow_spec_ipv6 ipv6; |
237 | struct ib_uverbs_flow_spec_action_tag flow_tag; |
238 | struct ib_uverbs_flow_spec_action_drop drop; |
239 | struct ib_uverbs_flow_spec_action_handle action; |
240 | struct ib_uverbs_flow_spec_action_count flow_count; |
241 | }; |
242 | }; |
243 | |
244 | int ib_uverbs_kern_spec_to_ib_spec_filter(enum ib_flow_spec_type type, |
245 | const void *kern_spec_mask, |
246 | const void *kern_spec_val, |
247 | size_t kern_filter_sz, |
248 | union ib_flow_spec *ib_spec); |
249 | |
250 | /* |
251 | * ib_uverbs_query_port_resp.port_cap_flags started out as just a copy of the |
252 | * PortInfo CapabilityMask, but was extended with unique bits. |
253 | */ |
254 | static inline u32 make_port_cap_flags(const struct ib_port_attr *attr) |
255 | { |
256 | u32 res; |
257 | |
258 | /* All IBA CapabilityMask bits are passed through here, except bit 26, |
259 | * which is overridden with IP_BASED_GIDS. This is due to a historical |
260 | * mistake in the implementation of IP_BASED_GIDS. Otherwise all other |
261 | * bits match the IBA definition across all kernel versions. |
262 | */ |
263 | res = attr->port_cap_flags & ~(u32)IB_UVERBS_PCF_IP_BASED_GIDS; |
264 | |
265 | if (attr->ip_gids) |
266 | res |= IB_UVERBS_PCF_IP_BASED_GIDS; |
267 | |
268 | return res; |
269 | } |
270 | |
271 | static inline struct ib_uverbs_async_event_file * |
272 | ib_uverbs_get_async_event(struct uverbs_attr_bundle *attrs, |
273 | u16 id) |
274 | { |
275 | struct ib_uobject *async_ev_file_uobj; |
276 | struct ib_uverbs_async_event_file *async_ev_file; |
277 | |
278 | async_ev_file_uobj = uverbs_attr_get_uobject(attrs_bundle: attrs, idx: id); |
279 | if (IS_ERR(ptr: async_ev_file_uobj)) |
280 | async_ev_file = READ_ONCE(attrs->ufile->default_async_file); |
281 | else |
282 | async_ev_file = container_of(async_ev_file_uobj, |
283 | struct ib_uverbs_async_event_file, |
284 | uobj); |
285 | if (async_ev_file) |
286 | uverbs_uobject_get(uobject: &async_ev_file->uobj); |
287 | return async_ev_file; |
288 | } |
289 | |
290 | void copy_port_attr_to_resp(struct ib_port_attr *attr, |
291 | struct ib_uverbs_query_port_resp *resp, |
292 | struct ib_device *ib_dev, u8 port_num); |
293 | #endif /* UVERBS_H */ |
294 |
Definitions
- ib_uverbs_init_udata
- ib_uverbs_init_udata_buf_or_null
- ib_uverbs_device
- ib_uverbs_event_queue
- ib_uverbs_async_event_file
- ib_uverbs_completion_event_file
- ib_uverbs_event
- ib_uverbs_mcast_entry
- ib_uevent_object
- ib_uxrcd_object
- ib_usrq_object
- ib_uqp_object
- ib_uwq_object
- ib_ucq_object
- ib_uverbs_flow_spec
- make_port_cap_flags
Improve your Profiling and Debugging skills
Find out more