xref: /linux/drivers/infiniband/core/rw.c (revision 9f2c9170934eace462499ba0bfe042cc72900173)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright (c) 2016 HGST, a Western Digital Company.
4  */
5 #include <linux/memremap.h>
6 #include <linux/moduleparam.h>
7 #include <linux/slab.h>
8 #include <linux/pci-p2pdma.h>
9 #include <rdma/mr_pool.h>
10 #include <rdma/rw.h>
11 
12 enum {
13 	RDMA_RW_SINGLE_WR,
14 	RDMA_RW_MULTI_WR,
15 	RDMA_RW_MR,
16 	RDMA_RW_SIG_MR,
17 };
18 
19 static bool rdma_rw_force_mr;
20 module_param_named(force_mr, rdma_rw_force_mr, bool, 0);
21 MODULE_PARM_DESC(force_mr, "Force usage of MRs for RDMA READ/WRITE operations");
22 
23 /*
24  * Report whether memory registration should be used. Memory registration must
25  * be used for iWarp devices because of iWARP-specific limitations. Memory
26  * registration is also enabled if registering memory might yield better
27  * performance than using multiple SGE entries, see rdma_rw_io_needs_mr()
28  */
29 static inline bool rdma_rw_can_use_mr(struct ib_device *dev, u32 port_num)
30 {
31 	if (rdma_protocol_iwarp(dev, port_num))
32 		return true;
33 	if (dev->attrs.max_sgl_rd)
34 		return true;
35 	if (unlikely(rdma_rw_force_mr))
36 		return true;
37 	return false;
38 }
39 
40 /*
41  * Check if the device will use memory registration for this RW operation.
42  * For RDMA READs we must use MRs on iWarp and can optionally use them as an
43  * optimization otherwise.  Additionally we have a debug option to force usage
44  * of MRs to help testing this code path.
45  */
46 static inline bool rdma_rw_io_needs_mr(struct ib_device *dev, u32 port_num,
47 		enum dma_data_direction dir, int dma_nents)
48 {
49 	if (dir == DMA_FROM_DEVICE) {
50 		if (rdma_protocol_iwarp(dev, port_num))
51 			return true;
52 		if (dev->attrs.max_sgl_rd && dma_nents > dev->attrs.max_sgl_rd)
53 			return true;
54 	}
55 	if (unlikely(rdma_rw_force_mr))
56 		return true;
57 	return false;
58 }
59 
60 static inline u32 rdma_rw_fr_page_list_len(struct ib_device *dev,
61 					   bool pi_support)
62 {
63 	u32 max_pages;
64 
65 	if (pi_support)
66 		max_pages = dev->attrs.max_pi_fast_reg_page_list_len;
67 	else
68 		max_pages = dev->attrs.max_fast_reg_page_list_len;
69 
70 	/* arbitrary limit to avoid allocating gigantic resources */
71 	return min_t(u32, max_pages, 256);
72 }
73 
74 static inline int rdma_rw_inv_key(struct rdma_rw_reg_ctx *reg)
75 {
76 	int count = 0;
77 
78 	if (reg->mr->need_inval) {
79 		reg->inv_wr.opcode = IB_WR_LOCAL_INV;
80 		reg->inv_wr.ex.invalidate_rkey = reg->mr->lkey;
81 		reg->inv_wr.next = &reg->reg_wr.wr;
82 		count++;
83 	} else {
84 		reg->inv_wr.next = NULL;
85 	}
86 
87 	return count;
88 }
89 
90 /* Caller must have zero-initialized *reg. */
91 static int rdma_rw_init_one_mr(struct ib_qp *qp, u32 port_num,
92 		struct rdma_rw_reg_ctx *reg, struct scatterlist *sg,
93 		u32 sg_cnt, u32 offset)
94 {
95 	u32 pages_per_mr = rdma_rw_fr_page_list_len(qp->pd->device,
96 						    qp->integrity_en);
97 	u32 nents = min(sg_cnt, pages_per_mr);
98 	int count = 0, ret;
99 
100 	reg->mr = ib_mr_pool_get(qp, &qp->rdma_mrs);
101 	if (!reg->mr)
102 		return -EAGAIN;
103 
104 	count += rdma_rw_inv_key(reg);
105 
106 	ret = ib_map_mr_sg(reg->mr, sg, nents, &offset, PAGE_SIZE);
107 	if (ret < 0 || ret < nents) {
108 		ib_mr_pool_put(qp, &qp->rdma_mrs, reg->mr);
109 		return -EINVAL;
110 	}
111 
112 	reg->reg_wr.wr.opcode = IB_WR_REG_MR;
113 	reg->reg_wr.mr = reg->mr;
114 	reg->reg_wr.access = IB_ACCESS_LOCAL_WRITE;
115 	if (rdma_protocol_iwarp(qp->device, port_num))
116 		reg->reg_wr.access |= IB_ACCESS_REMOTE_WRITE;
117 	count++;
118 
119 	reg->sge.addr = reg->mr->iova;
120 	reg->sge.length = reg->mr->length;
121 	return count;
122 }
123 
124 static int rdma_rw_init_mr_wrs(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
125 		u32 port_num, struct scatterlist *sg, u32 sg_cnt, u32 offset,
126 		u64 remote_addr, u32 rkey, enum dma_data_direction dir)
127 {
128 	struct rdma_rw_reg_ctx *prev = NULL;
129 	u32 pages_per_mr = rdma_rw_fr_page_list_len(qp->pd->device,
130 						    qp->integrity_en);
131 	int i, j, ret = 0, count = 0;
132 
133 	ctx->nr_ops = DIV_ROUND_UP(sg_cnt, pages_per_mr);
134 	ctx->reg = kcalloc(ctx->nr_ops, sizeof(*ctx->reg), GFP_KERNEL);
135 	if (!ctx->reg) {
136 		ret = -ENOMEM;
137 		goto out;
138 	}
139 
140 	for (i = 0; i < ctx->nr_ops; i++) {
141 		struct rdma_rw_reg_ctx *reg = &ctx->reg[i];
142 		u32 nents = min(sg_cnt, pages_per_mr);
143 
144 		ret = rdma_rw_init_one_mr(qp, port_num, reg, sg, sg_cnt,
145 				offset);
146 		if (ret < 0)
147 			goto out_free;
148 		count += ret;
149 
150 		if (prev) {
151 			if (reg->mr->need_inval)
152 				prev->wr.wr.next = &reg->inv_wr;
153 			else
154 				prev->wr.wr.next = &reg->reg_wr.wr;
155 		}
156 
157 		reg->reg_wr.wr.next = &reg->wr.wr;
158 
159 		reg->wr.wr.sg_list = &reg->sge;
160 		reg->wr.wr.num_sge = 1;
161 		reg->wr.remote_addr = remote_addr;
162 		reg->wr.rkey = rkey;
163 		if (dir == DMA_TO_DEVICE) {
164 			reg->wr.wr.opcode = IB_WR_RDMA_WRITE;
165 		} else if (!rdma_cap_read_inv(qp->device, port_num)) {
166 			reg->wr.wr.opcode = IB_WR_RDMA_READ;
167 		} else {
168 			reg->wr.wr.opcode = IB_WR_RDMA_READ_WITH_INV;
169 			reg->wr.wr.ex.invalidate_rkey = reg->mr->lkey;
170 		}
171 		count++;
172 
173 		remote_addr += reg->sge.length;
174 		sg_cnt -= nents;
175 		for (j = 0; j < nents; j++)
176 			sg = sg_next(sg);
177 		prev = reg;
178 		offset = 0;
179 	}
180 
181 	if (prev)
182 		prev->wr.wr.next = NULL;
183 
184 	ctx->type = RDMA_RW_MR;
185 	return count;
186 
187 out_free:
188 	while (--i >= 0)
189 		ib_mr_pool_put(qp, &qp->rdma_mrs, ctx->reg[i].mr);
190 	kfree(ctx->reg);
191 out:
192 	return ret;
193 }
194 
195 static int rdma_rw_init_map_wrs(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
196 		struct scatterlist *sg, u32 sg_cnt, u32 offset,
197 		u64 remote_addr, u32 rkey, enum dma_data_direction dir)
198 {
199 	u32 max_sge = dir == DMA_TO_DEVICE ? qp->max_write_sge :
200 		      qp->max_read_sge;
201 	struct ib_sge *sge;
202 	u32 total_len = 0, i, j;
203 
204 	ctx->nr_ops = DIV_ROUND_UP(sg_cnt, max_sge);
205 
206 	ctx->map.sges = sge = kcalloc(sg_cnt, sizeof(*sge), GFP_KERNEL);
207 	if (!ctx->map.sges)
208 		goto out;
209 
210 	ctx->map.wrs = kcalloc(ctx->nr_ops, sizeof(*ctx->map.wrs), GFP_KERNEL);
211 	if (!ctx->map.wrs)
212 		goto out_free_sges;
213 
214 	for (i = 0; i < ctx->nr_ops; i++) {
215 		struct ib_rdma_wr *rdma_wr = &ctx->map.wrs[i];
216 		u32 nr_sge = min(sg_cnt, max_sge);
217 
218 		if (dir == DMA_TO_DEVICE)
219 			rdma_wr->wr.opcode = IB_WR_RDMA_WRITE;
220 		else
221 			rdma_wr->wr.opcode = IB_WR_RDMA_READ;
222 		rdma_wr->remote_addr = remote_addr + total_len;
223 		rdma_wr->rkey = rkey;
224 		rdma_wr->wr.num_sge = nr_sge;
225 		rdma_wr->wr.sg_list = sge;
226 
227 		for (j = 0; j < nr_sge; j++, sg = sg_next(sg)) {
228 			sge->addr = sg_dma_address(sg) + offset;
229 			sge->length = sg_dma_len(sg) - offset;
230 			sge->lkey = qp->pd->local_dma_lkey;
231 
232 			total_len += sge->length;
233 			sge++;
234 			sg_cnt--;
235 			offset = 0;
236 		}
237 
238 		rdma_wr->wr.next = i + 1 < ctx->nr_ops ?
239 			&ctx->map.wrs[i + 1].wr : NULL;
240 	}
241 
242 	ctx->type = RDMA_RW_MULTI_WR;
243 	return ctx->nr_ops;
244 
245 out_free_sges:
246 	kfree(ctx->map.sges);
247 out:
248 	return -ENOMEM;
249 }
250 
251 static int rdma_rw_init_single_wr(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
252 		struct scatterlist *sg, u32 offset, u64 remote_addr, u32 rkey,
253 		enum dma_data_direction dir)
254 {
255 	struct ib_rdma_wr *rdma_wr = &ctx->single.wr;
256 
257 	ctx->nr_ops = 1;
258 
259 	ctx->single.sge.lkey = qp->pd->local_dma_lkey;
260 	ctx->single.sge.addr = sg_dma_address(sg) + offset;
261 	ctx->single.sge.length = sg_dma_len(sg) - offset;
262 
263 	memset(rdma_wr, 0, sizeof(*rdma_wr));
264 	if (dir == DMA_TO_DEVICE)
265 		rdma_wr->wr.opcode = IB_WR_RDMA_WRITE;
266 	else
267 		rdma_wr->wr.opcode = IB_WR_RDMA_READ;
268 	rdma_wr->wr.sg_list = &ctx->single.sge;
269 	rdma_wr->wr.num_sge = 1;
270 	rdma_wr->remote_addr = remote_addr;
271 	rdma_wr->rkey = rkey;
272 
273 	ctx->type = RDMA_RW_SINGLE_WR;
274 	return 1;
275 }
276 
277 /**
278  * rdma_rw_ctx_init - initialize a RDMA READ/WRITE context
279  * @ctx:	context to initialize
280  * @qp:		queue pair to operate on
281  * @port_num:	port num to which the connection is bound
282  * @sg:		scatterlist to READ/WRITE from/to
283  * @sg_cnt:	number of entries in @sg
284  * @sg_offset:	current byte offset into @sg
285  * @remote_addr:remote address to read/write (relative to @rkey)
286  * @rkey:	remote key to operate on
287  * @dir:	%DMA_TO_DEVICE for RDMA WRITE, %DMA_FROM_DEVICE for RDMA READ
288  *
289  * Returns the number of WQEs that will be needed on the workqueue if
290  * successful, or a negative error code.
291  */
292 int rdma_rw_ctx_init(struct rdma_rw_ctx *ctx, struct ib_qp *qp, u32 port_num,
293 		struct scatterlist *sg, u32 sg_cnt, u32 sg_offset,
294 		u64 remote_addr, u32 rkey, enum dma_data_direction dir)
295 {
296 	struct ib_device *dev = qp->pd->device;
297 	struct sg_table sgt = {
298 		.sgl = sg,
299 		.orig_nents = sg_cnt,
300 	};
301 	int ret;
302 
303 	ret = ib_dma_map_sgtable_attrs(dev, &sgt, dir, 0);
304 	if (ret)
305 		return ret;
306 	sg_cnt = sgt.nents;
307 
308 	/*
309 	 * Skip to the S/G entry that sg_offset falls into:
310 	 */
311 	for (;;) {
312 		u32 len = sg_dma_len(sg);
313 
314 		if (sg_offset < len)
315 			break;
316 
317 		sg = sg_next(sg);
318 		sg_offset -= len;
319 		sg_cnt--;
320 	}
321 
322 	ret = -EIO;
323 	if (WARN_ON_ONCE(sg_cnt == 0))
324 		goto out_unmap_sg;
325 
326 	if (rdma_rw_io_needs_mr(qp->device, port_num, dir, sg_cnt)) {
327 		ret = rdma_rw_init_mr_wrs(ctx, qp, port_num, sg, sg_cnt,
328 				sg_offset, remote_addr, rkey, dir);
329 	} else if (sg_cnt > 1) {
330 		ret = rdma_rw_init_map_wrs(ctx, qp, sg, sg_cnt, sg_offset,
331 				remote_addr, rkey, dir);
332 	} else {
333 		ret = rdma_rw_init_single_wr(ctx, qp, sg, sg_offset,
334 				remote_addr, rkey, dir);
335 	}
336 
337 	if (ret < 0)
338 		goto out_unmap_sg;
339 	return ret;
340 
341 out_unmap_sg:
342 	ib_dma_unmap_sgtable_attrs(dev, &sgt, dir, 0);
343 	return ret;
344 }
345 EXPORT_SYMBOL(rdma_rw_ctx_init);
346 
347 /**
348  * rdma_rw_ctx_signature_init - initialize a RW context with signature offload
349  * @ctx:	context to initialize
350  * @qp:		queue pair to operate on
351  * @port_num:	port num to which the connection is bound
352  * @sg:		scatterlist to READ/WRITE from/to
353  * @sg_cnt:	number of entries in @sg
354  * @prot_sg:	scatterlist to READ/WRITE protection information from/to
355  * @prot_sg_cnt: number of entries in @prot_sg
356  * @sig_attrs:	signature offloading algorithms
357  * @remote_addr:remote address to read/write (relative to @rkey)
358  * @rkey:	remote key to operate on
359  * @dir:	%DMA_TO_DEVICE for RDMA WRITE, %DMA_FROM_DEVICE for RDMA READ
360  *
361  * Returns the number of WQEs that will be needed on the workqueue if
362  * successful, or a negative error code.
363  */
364 int rdma_rw_ctx_signature_init(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
365 		u32 port_num, struct scatterlist *sg, u32 sg_cnt,
366 		struct scatterlist *prot_sg, u32 prot_sg_cnt,
367 		struct ib_sig_attrs *sig_attrs,
368 		u64 remote_addr, u32 rkey, enum dma_data_direction dir)
369 {
370 	struct ib_device *dev = qp->pd->device;
371 	u32 pages_per_mr = rdma_rw_fr_page_list_len(qp->pd->device,
372 						    qp->integrity_en);
373 	struct sg_table sgt = {
374 		.sgl = sg,
375 		.orig_nents = sg_cnt,
376 	};
377 	struct sg_table prot_sgt = {
378 		.sgl = prot_sg,
379 		.orig_nents = prot_sg_cnt,
380 	};
381 	struct ib_rdma_wr *rdma_wr;
382 	int count = 0, ret;
383 
384 	if (sg_cnt > pages_per_mr || prot_sg_cnt > pages_per_mr) {
385 		pr_err("SG count too large: sg_cnt=%u, prot_sg_cnt=%u, pages_per_mr=%u\n",
386 		       sg_cnt, prot_sg_cnt, pages_per_mr);
387 		return -EINVAL;
388 	}
389 
390 	ret = ib_dma_map_sgtable_attrs(dev, &sgt, dir, 0);
391 	if (ret)
392 		return ret;
393 
394 	if (prot_sg_cnt) {
395 		ret = ib_dma_map_sgtable_attrs(dev, &prot_sgt, dir, 0);
396 		if (ret)
397 			goto out_unmap_sg;
398 	}
399 
400 	ctx->type = RDMA_RW_SIG_MR;
401 	ctx->nr_ops = 1;
402 	ctx->reg = kzalloc(sizeof(*ctx->reg), GFP_KERNEL);
403 	if (!ctx->reg) {
404 		ret = -ENOMEM;
405 		goto out_unmap_prot_sg;
406 	}
407 
408 	ctx->reg->mr = ib_mr_pool_get(qp, &qp->sig_mrs);
409 	if (!ctx->reg->mr) {
410 		ret = -EAGAIN;
411 		goto out_free_ctx;
412 	}
413 
414 	count += rdma_rw_inv_key(ctx->reg);
415 
416 	memcpy(ctx->reg->mr->sig_attrs, sig_attrs, sizeof(struct ib_sig_attrs));
417 
418 	ret = ib_map_mr_sg_pi(ctx->reg->mr, sg, sgt.nents, NULL, prot_sg,
419 			      prot_sgt.nents, NULL, SZ_4K);
420 	if (unlikely(ret)) {
421 		pr_err("failed to map PI sg (%u)\n",
422 		       sgt.nents + prot_sgt.nents);
423 		goto out_destroy_sig_mr;
424 	}
425 
426 	ctx->reg->reg_wr.wr.opcode = IB_WR_REG_MR_INTEGRITY;
427 	ctx->reg->reg_wr.wr.wr_cqe = NULL;
428 	ctx->reg->reg_wr.wr.num_sge = 0;
429 	ctx->reg->reg_wr.wr.send_flags = 0;
430 	ctx->reg->reg_wr.access = IB_ACCESS_LOCAL_WRITE;
431 	if (rdma_protocol_iwarp(qp->device, port_num))
432 		ctx->reg->reg_wr.access |= IB_ACCESS_REMOTE_WRITE;
433 	ctx->reg->reg_wr.mr = ctx->reg->mr;
434 	ctx->reg->reg_wr.key = ctx->reg->mr->lkey;
435 	count++;
436 
437 	ctx->reg->sge.addr = ctx->reg->mr->iova;
438 	ctx->reg->sge.length = ctx->reg->mr->length;
439 	if (sig_attrs->wire.sig_type == IB_SIG_TYPE_NONE)
440 		ctx->reg->sge.length -= ctx->reg->mr->sig_attrs->meta_length;
441 
442 	rdma_wr = &ctx->reg->wr;
443 	rdma_wr->wr.sg_list = &ctx->reg->sge;
444 	rdma_wr->wr.num_sge = 1;
445 	rdma_wr->remote_addr = remote_addr;
446 	rdma_wr->rkey = rkey;
447 	if (dir == DMA_TO_DEVICE)
448 		rdma_wr->wr.opcode = IB_WR_RDMA_WRITE;
449 	else
450 		rdma_wr->wr.opcode = IB_WR_RDMA_READ;
451 	ctx->reg->reg_wr.wr.next = &rdma_wr->wr;
452 	count++;
453 
454 	return count;
455 
456 out_destroy_sig_mr:
457 	ib_mr_pool_put(qp, &qp->sig_mrs, ctx->reg->mr);
458 out_free_ctx:
459 	kfree(ctx->reg);
460 out_unmap_prot_sg:
461 	if (prot_sgt.nents)
462 		ib_dma_unmap_sgtable_attrs(dev, &prot_sgt, dir, 0);
463 out_unmap_sg:
464 	ib_dma_unmap_sgtable_attrs(dev, &sgt, dir, 0);
465 	return ret;
466 }
467 EXPORT_SYMBOL(rdma_rw_ctx_signature_init);
468 
469 /*
470  * Now that we are going to post the WRs we can update the lkey and need_inval
471  * state on the MRs.  If we were doing this at init time, we would get double
472  * or missing invalidations if a context was initialized but not actually
473  * posted.
474  */
475 static void rdma_rw_update_lkey(struct rdma_rw_reg_ctx *reg, bool need_inval)
476 {
477 	reg->mr->need_inval = need_inval;
478 	ib_update_fast_reg_key(reg->mr, ib_inc_rkey(reg->mr->lkey));
479 	reg->reg_wr.key = reg->mr->lkey;
480 	reg->sge.lkey = reg->mr->lkey;
481 }
482 
483 /**
484  * rdma_rw_ctx_wrs - return chain of WRs for a RDMA READ or WRITE operation
485  * @ctx:	context to operate on
486  * @qp:		queue pair to operate on
487  * @port_num:	port num to which the connection is bound
488  * @cqe:	completion queue entry for the last WR
489  * @chain_wr:	WR to append to the posted chain
490  *
491  * Return the WR chain for the set of RDMA READ/WRITE operations described by
492  * @ctx, as well as any memory registration operations needed.  If @chain_wr
493  * is non-NULL the WR it points to will be appended to the chain of WRs posted.
494  * If @chain_wr is not set @cqe must be set so that the caller gets a
495  * completion notification.
496  */
497 struct ib_send_wr *rdma_rw_ctx_wrs(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
498 		u32 port_num, struct ib_cqe *cqe, struct ib_send_wr *chain_wr)
499 {
500 	struct ib_send_wr *first_wr, *last_wr;
501 	int i;
502 
503 	switch (ctx->type) {
504 	case RDMA_RW_SIG_MR:
505 	case RDMA_RW_MR:
506 		for (i = 0; i < ctx->nr_ops; i++) {
507 			rdma_rw_update_lkey(&ctx->reg[i],
508 				ctx->reg[i].wr.wr.opcode !=
509 					IB_WR_RDMA_READ_WITH_INV);
510 		}
511 
512 		if (ctx->reg[0].inv_wr.next)
513 			first_wr = &ctx->reg[0].inv_wr;
514 		else
515 			first_wr = &ctx->reg[0].reg_wr.wr;
516 		last_wr = &ctx->reg[ctx->nr_ops - 1].wr.wr;
517 		break;
518 	case RDMA_RW_MULTI_WR:
519 		first_wr = &ctx->map.wrs[0].wr;
520 		last_wr = &ctx->map.wrs[ctx->nr_ops - 1].wr;
521 		break;
522 	case RDMA_RW_SINGLE_WR:
523 		first_wr = &ctx->single.wr.wr;
524 		last_wr = &ctx->single.wr.wr;
525 		break;
526 	default:
527 		BUG();
528 	}
529 
530 	if (chain_wr) {
531 		last_wr->next = chain_wr;
532 	} else {
533 		last_wr->wr_cqe = cqe;
534 		last_wr->send_flags |= IB_SEND_SIGNALED;
535 	}
536 
537 	return first_wr;
538 }
539 EXPORT_SYMBOL(rdma_rw_ctx_wrs);
540 
541 /**
542  * rdma_rw_ctx_post - post a RDMA READ or RDMA WRITE operation
543  * @ctx:	context to operate on
544  * @qp:		queue pair to operate on
545  * @port_num:	port num to which the connection is bound
546  * @cqe:	completion queue entry for the last WR
547  * @chain_wr:	WR to append to the posted chain
548  *
549  * Post the set of RDMA READ/WRITE operations described by @ctx, as well as
550  * any memory registration operations needed.  If @chain_wr is non-NULL the
551  * WR it points to will be appended to the chain of WRs posted.  If @chain_wr
552  * is not set @cqe must be set so that the caller gets a completion
553  * notification.
554  */
555 int rdma_rw_ctx_post(struct rdma_rw_ctx *ctx, struct ib_qp *qp, u32 port_num,
556 		struct ib_cqe *cqe, struct ib_send_wr *chain_wr)
557 {
558 	struct ib_send_wr *first_wr;
559 
560 	first_wr = rdma_rw_ctx_wrs(ctx, qp, port_num, cqe, chain_wr);
561 	return ib_post_send(qp, first_wr, NULL);
562 }
563 EXPORT_SYMBOL(rdma_rw_ctx_post);
564 
565 /**
566  * rdma_rw_ctx_destroy - release all resources allocated by rdma_rw_ctx_init
567  * @ctx:	context to release
568  * @qp:		queue pair to operate on
569  * @port_num:	port num to which the connection is bound
570  * @sg:		scatterlist that was used for the READ/WRITE
571  * @sg_cnt:	number of entries in @sg
572  * @dir:	%DMA_TO_DEVICE for RDMA WRITE, %DMA_FROM_DEVICE for RDMA READ
573  */
574 void rdma_rw_ctx_destroy(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
575 			 u32 port_num, struct scatterlist *sg, u32 sg_cnt,
576 			 enum dma_data_direction dir)
577 {
578 	int i;
579 
580 	switch (ctx->type) {
581 	case RDMA_RW_MR:
582 		for (i = 0; i < ctx->nr_ops; i++)
583 			ib_mr_pool_put(qp, &qp->rdma_mrs, ctx->reg[i].mr);
584 		kfree(ctx->reg);
585 		break;
586 	case RDMA_RW_MULTI_WR:
587 		kfree(ctx->map.wrs);
588 		kfree(ctx->map.sges);
589 		break;
590 	case RDMA_RW_SINGLE_WR:
591 		break;
592 	default:
593 		BUG();
594 		break;
595 	}
596 
597 	ib_dma_unmap_sg(qp->pd->device, sg, sg_cnt, dir);
598 }
599 EXPORT_SYMBOL(rdma_rw_ctx_destroy);
600 
601 /**
602  * rdma_rw_ctx_destroy_signature - release all resources allocated by
603  *	rdma_rw_ctx_signature_init
604  * @ctx:	context to release
605  * @qp:		queue pair to operate on
606  * @port_num:	port num to which the connection is bound
607  * @sg:		scatterlist that was used for the READ/WRITE
608  * @sg_cnt:	number of entries in @sg
609  * @prot_sg:	scatterlist that was used for the READ/WRITE of the PI
610  * @prot_sg_cnt: number of entries in @prot_sg
611  * @dir:	%DMA_TO_DEVICE for RDMA WRITE, %DMA_FROM_DEVICE for RDMA READ
612  */
613 void rdma_rw_ctx_destroy_signature(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
614 		u32 port_num, struct scatterlist *sg, u32 sg_cnt,
615 		struct scatterlist *prot_sg, u32 prot_sg_cnt,
616 		enum dma_data_direction dir)
617 {
618 	if (WARN_ON_ONCE(ctx->type != RDMA_RW_SIG_MR))
619 		return;
620 
621 	ib_mr_pool_put(qp, &qp->sig_mrs, ctx->reg->mr);
622 	kfree(ctx->reg);
623 
624 	if (prot_sg_cnt)
625 		ib_dma_unmap_sg(qp->pd->device, prot_sg, prot_sg_cnt, dir);
626 	ib_dma_unmap_sg(qp->pd->device, sg, sg_cnt, dir);
627 }
628 EXPORT_SYMBOL(rdma_rw_ctx_destroy_signature);
629 
630 /**
631  * rdma_rw_mr_factor - return number of MRs required for a payload
632  * @device:	device handling the connection
633  * @port_num:	port num to which the connection is bound
634  * @maxpages:	maximum payload pages per rdma_rw_ctx
635  *
636  * Returns the number of MRs the device requires to move @maxpayload
637  * bytes. The returned value is used during transport creation to
638  * compute max_rdma_ctxts and the size of the transport's Send and
639  * Send Completion Queues.
640  */
641 unsigned int rdma_rw_mr_factor(struct ib_device *device, u32 port_num,
642 			       unsigned int maxpages)
643 {
644 	unsigned int mr_pages;
645 
646 	if (rdma_rw_can_use_mr(device, port_num))
647 		mr_pages = rdma_rw_fr_page_list_len(device, false);
648 	else
649 		mr_pages = device->attrs.max_sge_rd;
650 	return DIV_ROUND_UP(maxpages, mr_pages);
651 }
652 EXPORT_SYMBOL(rdma_rw_mr_factor);
653 
654 void rdma_rw_init_qp(struct ib_device *dev, struct ib_qp_init_attr *attr)
655 {
656 	u32 factor;
657 
658 	WARN_ON_ONCE(attr->port_num == 0);
659 
660 	/*
661 	 * Each context needs at least one RDMA READ or WRITE WR.
662 	 *
663 	 * For some hardware we might need more, eventually we should ask the
664 	 * HCA driver for a multiplier here.
665 	 */
666 	factor = 1;
667 
668 	/*
669 	 * If the devices needs MRs to perform RDMA READ or WRITE operations,
670 	 * we'll need two additional MRs for the registrations and the
671 	 * invalidation.
672 	 */
673 	if (attr->create_flags & IB_QP_CREATE_INTEGRITY_EN ||
674 	    rdma_rw_can_use_mr(dev, attr->port_num))
675 		factor += 2;	/* inv + reg */
676 
677 	attr->cap.max_send_wr += factor * attr->cap.max_rdma_ctxs;
678 
679 	/*
680 	 * But maybe we were just too high in the sky and the device doesn't
681 	 * even support all we need, and we'll have to live with what we get..
682 	 */
683 	attr->cap.max_send_wr =
684 		min_t(u32, attr->cap.max_send_wr, dev->attrs.max_qp_wr);
685 }
686 
687 int rdma_rw_init_mrs(struct ib_qp *qp, struct ib_qp_init_attr *attr)
688 {
689 	struct ib_device *dev = qp->pd->device;
690 	u32 nr_mrs = 0, nr_sig_mrs = 0, max_num_sg = 0;
691 	int ret = 0;
692 
693 	if (attr->create_flags & IB_QP_CREATE_INTEGRITY_EN) {
694 		nr_sig_mrs = attr->cap.max_rdma_ctxs;
695 		nr_mrs = attr->cap.max_rdma_ctxs;
696 		max_num_sg = rdma_rw_fr_page_list_len(dev, true);
697 	} else if (rdma_rw_can_use_mr(dev, attr->port_num)) {
698 		nr_mrs = attr->cap.max_rdma_ctxs;
699 		max_num_sg = rdma_rw_fr_page_list_len(dev, false);
700 	}
701 
702 	if (nr_mrs) {
703 		ret = ib_mr_pool_init(qp, &qp->rdma_mrs, nr_mrs,
704 				IB_MR_TYPE_MEM_REG,
705 				max_num_sg, 0);
706 		if (ret) {
707 			pr_err("%s: failed to allocated %u MRs\n",
708 				__func__, nr_mrs);
709 			return ret;
710 		}
711 	}
712 
713 	if (nr_sig_mrs) {
714 		ret = ib_mr_pool_init(qp, &qp->sig_mrs, nr_sig_mrs,
715 				IB_MR_TYPE_INTEGRITY, max_num_sg, max_num_sg);
716 		if (ret) {
717 			pr_err("%s: failed to allocated %u SIG MRs\n",
718 				__func__, nr_sig_mrs);
719 			goto out_free_rdma_mrs;
720 		}
721 	}
722 
723 	return 0;
724 
725 out_free_rdma_mrs:
726 	ib_mr_pool_destroy(qp, &qp->rdma_mrs);
727 	return ret;
728 }
729 
730 void rdma_rw_cleanup_mrs(struct ib_qp *qp)
731 {
732 	ib_mr_pool_destroy(qp, &qp->sig_mrs);
733 	ib_mr_pool_destroy(qp, &qp->rdma_mrs);
734 }
735