net/sunrpc/xprtrdma/fmr_ops.c

   1 /*
   2  * Copyright (c) 2015 Oracle.  All rights reserved.
   3  * Copyright (c) 2003-2007 Network Appliance, Inc. All rights reserved.
   4  */
   5
   6 /* Lightweight memory registration using Fast Memory Regions (FMR).
   7  * Referred to sometimes as MTHCAFMR mode.
   8  *
   9  * FMR uses synchronous memory registration and deregistration.
  10  * FMR registration is known to be fast, but FMR deregistration
  11  * can take tens of usecs to complete.
  12  */
  13
  14 /* Normal operation
  15  *
  16  * A Memory Region is prepared for RDMA READ or WRITE using the
  17  * ib_map_phys_fmr verb (fmr_op_map). When the RDMA operation is
  18  * finished, the Memory Region is unmapped using the ib_unmap_fmr
  19  * verb (fmr_op_unmap).
  20  */
  21
  22 /* Transport recovery
  23  *
  24  * After a transport reconnect, fmr_op_map re-uses the MR already
  25  * allocated for the RPC, but generates a fresh rkey then maps the
  26  * MR again. This process is synchronous.
  27  */
  28
  29 #include "xprt_rdma.h"
  30
  31 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
  32 # define RPCDBG_FACILITY        RPCDBG_TRANS
  33 #endif
  34
  35 /* Maximum scatter/gather per FMR */
  36 #define RPCRDMA_MAX_FMR_SGES    (64)
  37
  38 static int
  39 fmr_op_open(struct rpcrdma_ia *ia, struct rpcrdma_ep *ep,
  40             struct rpcrdma_create_data_internal *cdata)
  41 {
  42         return 0;
  43 }
  44
  45 /* FMR mode conveys up to 64 pages of payload per chunk segment.
  46  */
  47 static size_t
  48 fmr_op_maxpages(struct rpcrdma_xprt *r_xprt)
  49 {
  50         return min_t(unsigned int, RPCRDMA_MAX_DATA_SEGS,
  51                      rpcrdma_max_segments(r_xprt) * RPCRDMA_MAX_FMR_SGES);
  52 }
  53
  54 static int
  55 fmr_op_init(struct rpcrdma_xprt *r_xprt)
  56 {
  57         struct rpcrdma_buffer *buf = &r_xprt->rx_buf;
  58         int mr_access_flags = IB_ACCESS_REMOTE_WRITE | IB_ACCESS_REMOTE_READ;
  59         struct ib_fmr_attr fmr_attr = {
  60                 .max_pages      = RPCRDMA_MAX_FMR_SGES,
  61                 .max_maps       = 1,
  62                 .page_shift     = PAGE_SHIFT
  63         };
  64         struct ib_pd *pd = r_xprt->rx_ia.ri_pd;
  65         struct rpcrdma_mw *r;
  66         int i, rc;
  67
  68         INIT_LIST_HEAD(&buf->rb_mws);
  69         INIT_LIST_HEAD(&buf->rb_all);
  70
  71         i = (buf->rb_max_requests + 1) * RPCRDMA_MAX_SEGS;
  72         dprintk("RPC:       %s: initializing %d FMRs\n", __func__, i);
  73
  74         while (i--) {
  75                 r = kzalloc(sizeof(*r), GFP_KERNEL);
  76                 if (!r)
  77                         return -ENOMEM;
  78
  79                 r->r.fmr = ib_alloc_fmr(pd, mr_access_flags, &fmr_attr);
  80                 if (IS_ERR(r->r.fmr))
  81                         goto out_fmr_err;
  82
  83                 list_add(&r->mw_list, &buf->rb_mws);
  84                 list_add(&r->mw_all, &buf->rb_all);
  85         }
  86         return 0;
  87
  88 out_fmr_err:
  89         rc = PTR_ERR(r->r.fmr);
  90         dprintk("RPC:       %s: ib_alloc_fmr status %i\n", __func__, rc);
  91         kfree(r);
  92         return rc;
  93 }
  94
  95 static int
  96 __fmr_unmap(struct rpcrdma_mw *r)
  97 {
  98         LIST_HEAD(l);
  99
 100         list_add(&r->r.fmr->list, &l);
 101         return ib_unmap_fmr(&l);
 102 }
 103
 104 /* Use the ib_map_phys_fmr() verb to register a memory region
 105  * for remote access via RDMA READ or RDMA WRITE.
 106  */
 107 static int
 108 fmr_op_map(struct rpcrdma_xprt *r_xprt, struct rpcrdma_mr_seg *seg,
 109            int nsegs, bool writing)
 110 {
 111         struct rpcrdma_ia *ia = &r_xprt->rx_ia;
 112         struct ib_device *device = ia->ri_device;
 113         enum dma_data_direction direction = rpcrdma_data_dir(writing);
 114         struct rpcrdma_mr_seg *seg1 = seg;
 115         u64 physaddrs[RPCRDMA_MAX_DATA_SEGS];
 116         int len, pageoff, i, rc;
 117         struct rpcrdma_mw *mw;
 118
 119         mw = seg1->rl_mw;
 120         seg1->rl_mw = NULL;
 121         if (!mw) {
 122                 mw = rpcrdma_get_mw(r_xprt);
 123                 if (!mw)
 124                         return -ENOMEM;
 125         } else {
 126                 /* this is a retransmit; generate a fresh rkey */
 127                 rc = __fmr_unmap(mw);
 128                 if (rc)
 129                         return rc;
 130         }
 131
 132         pageoff = offset_in_page(seg1->mr_offset);
 133         seg1->mr_offset -= pageoff;     /* start of page */
 134         seg1->mr_len += pageoff;
 135         len = -pageoff;
 136         if (nsegs > RPCRDMA_MAX_FMR_SGES)
 137                 nsegs = RPCRDMA_MAX_FMR_SGES;
 138         for (i = 0; i < nsegs;) {
 139                 rpcrdma_map_one(device, seg, direction);
 140                 physaddrs[i] = seg->mr_dma;
 141                 len += seg->mr_len;
 142                 ++seg;
 143                 ++i;
 144                 /* Check for holes */
 145                 if ((i < nsegs && offset_in_page(seg->mr_offset)) ||
 146                     offset_in_page((seg-1)->mr_offset + (seg-1)->mr_len))
 147                         break;
 148         }
 149
 150         rc = ib_map_phys_fmr(mw->r.fmr, physaddrs, i, seg1->mr_dma);
 151         if (rc)
 152                 goto out_maperr;
 153
 154         seg1->rl_mw = mw;
 155         seg1->mr_rkey = mw->r.fmr->rkey;
 156         seg1->mr_base = seg1->mr_dma + pageoff;
 157         seg1->mr_nsegs = i;
 158         seg1->mr_len = len;
 159         return i;
 160
 161 out_maperr:
 162         dprintk("RPC:       %s: ib_map_phys_fmr %u@0x%llx+%i (%d) status %i\n",
 163                 __func__, len, (unsigned long long)seg1->mr_dma,
 164                 pageoff, i, rc);
 165         while (i--)
 166                 rpcrdma_unmap_one(device, --seg);
 167         return rc;
 168 }
 169
 170 /* Use the ib_unmap_fmr() verb to prevent further remote
 171  * access via RDMA READ or RDMA WRITE.
 172  */
 173 static int
 174 fmr_op_unmap(struct rpcrdma_xprt *r_xprt, struct rpcrdma_mr_seg *seg)
 175 {
 176         struct rpcrdma_ia *ia = &r_xprt->rx_ia;
 177         struct rpcrdma_mr_seg *seg1 = seg;
 178         struct rpcrdma_mw *mw = seg1->rl_mw;
 179         int rc, nsegs = seg->mr_nsegs;
 180
 181         dprintk("RPC:       %s: FMR %p\n", __func__, mw);
 182
 183         seg1->rl_mw = NULL;
 184         while (seg1->mr_nsegs--)
 185                 rpcrdma_unmap_one(ia->ri_device, seg++);
 186         rc = __fmr_unmap(mw);
 187         if (rc)
 188                 goto out_err;
 189         rpcrdma_put_mw(r_xprt, mw);
 190         return nsegs;
 191
 192 out_err:
 193         /* The FMR is abandoned, but remains in rb_all. fmr_op_destroy
 194          * will attempt to release it when the transport is destroyed.
 195          */
 196         dprintk("RPC:       %s: ib_unmap_fmr status %i\n", __func__, rc);
 197         return nsegs;
 198 }
 199
 200 static void
 201 fmr_op_destroy(struct rpcrdma_buffer *buf)
 202 {
 203         struct rpcrdma_mw *r;
 204         int rc;
 205
 206         while (!list_empty(&buf->rb_all)) {
 207                 r = list_entry(buf->rb_all.next, struct rpcrdma_mw, mw_all);
 208                 list_del(&r->mw_all);
 209                 rc = ib_dealloc_fmr(r->r.fmr);
 210                 if (rc)
 211                         dprintk("RPC:       %s: ib_dealloc_fmr failed %i\n",
 212                                 __func__, rc);
 213                 kfree(r);
 214         }
 215 }
 216
 217 const struct rpcrdma_memreg_ops rpcrdma_fmr_memreg_ops = {
 218         .ro_map                         = fmr_op_map,
 219         .ro_unmap                       = fmr_op_unmap,
 220         .ro_open                        = fmr_op_open,
 221         .ro_maxpages                    = fmr_op_maxpages,
 222         .ro_init                        = fmr_op_init,
 223         .ro_destroy                     = fmr_op_destroy,
 224         .ro_displayname                 = "fmr",
 225 };