include/rdma/rw.h

0001 /* SPDX-License-Identifier: GPL-2.0-only */
0002 /*
0003  * Copyright (c) 2016 HGST, a Western Digital Company.
0004  */
0005 #ifndef _RDMA_RW_H
0006 #define _RDMA_RW_H
0007
0008 #include <linux/dma-mapping.h>
0009 #include <linux/scatterlist.h>
0010 #include <rdma/ib_verbs.h>
0011 #include <rdma/rdma_cm.h>
0012 #include <rdma/mr_pool.h>
0013
0014 struct rdma_rw_ctx {
0015     /* number of RDMA READ/WRITE WRs (not counting MR WRs) */
0016     u32         nr_ops;
0017
0018     /* tag for the union below: */
0019     u8          type;
0020
0021     union {
0022         /* for mapping a single SGE: */
0023         struct {
0024             struct ib_sge       sge;
0025             struct ib_rdma_wr   wr;
0026         } single;
0027
0028         /* for mapping of multiple SGEs: */
0029         struct {
0030             struct ib_sge       *sges;
0031             struct ib_rdma_wr   *wrs;
0032         } map;
0033
0034         /* for registering multiple WRs: */
0035         struct rdma_rw_reg_ctx {
0036             struct ib_sge       sge;
0037             struct ib_rdma_wr   wr;
0038             struct ib_reg_wr    reg_wr;
0039             struct ib_send_wr   inv_wr;
0040             struct ib_mr        *mr;
0041         } *reg;
0042     };
0043 };
0044
0045 int rdma_rw_ctx_init(struct rdma_rw_ctx *ctx, struct ib_qp *qp, u32 port_num,
0046         struct scatterlist *sg, u32 sg_cnt, u32 sg_offset,
0047         u64 remote_addr, u32 rkey, enum dma_data_direction dir);
0048 void rdma_rw_ctx_destroy(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
0049              u32 port_num, struct scatterlist *sg, u32 sg_cnt,
0050              enum dma_data_direction dir);
0051
0052 int rdma_rw_ctx_signature_init(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
0053         u32 port_num, struct scatterlist *sg, u32 sg_cnt,
0054         struct scatterlist *prot_sg, u32 prot_sg_cnt,
0055         struct ib_sig_attrs *sig_attrs, u64 remote_addr, u32 rkey,
0056         enum dma_data_direction dir);
0057 void rdma_rw_ctx_destroy_signature(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
0058         u32 port_num, struct scatterlist *sg, u32 sg_cnt,
0059         struct scatterlist *prot_sg, u32 prot_sg_cnt,
0060         enum dma_data_direction dir);
0061
0062 struct ib_send_wr *rdma_rw_ctx_wrs(struct rdma_rw_ctx *ctx, struct ib_qp *qp,
0063         u32 port_num, struct ib_cqe *cqe, struct ib_send_wr *chain_wr);
0064 int rdma_rw_ctx_post(struct rdma_rw_ctx *ctx, struct ib_qp *qp, u32 port_num,
0065         struct ib_cqe *cqe, struct ib_send_wr *chain_wr);
0066
0067 unsigned int rdma_rw_mr_factor(struct ib_device *device, u32 port_num,
0068         unsigned int maxpages);
0069 void rdma_rw_init_qp(struct ib_device *dev, struct ib_qp_init_attr *attr);
0070 int rdma_rw_init_mrs(struct ib_qp *qp, struct ib_qp_init_attr *attr);
0071 void rdma_rw_cleanup_mrs(struct ib_qp *qp);
0072
0073 #endif /* _RDMA_RW_H */