svc_rdma.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311
  1. /*
  2. * Copyright (c) 2005-2006 Network Appliance, Inc. All rights reserved.
  3. *
  4. * This software is available to you under a choice of one of two
  5. * licenses. You may choose to be licensed under the terms of the GNU
  6. * General Public License (GPL) Version 2, available from the file
  7. * COPYING in the main directory of this source tree, or the BSD-type
  8. * license below:
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. *
  14. * Redistributions of source code must retain the above copyright
  15. * notice, this list of conditions and the following disclaimer.
  16. *
  17. * Redistributions in binary form must reproduce the above
  18. * copyright notice, this list of conditions and the following
  19. * disclaimer in the documentation and/or other materials provided
  20. * with the distribution.
  21. *
  22. * Neither the name of the Network Appliance, Inc. nor the names of
  23. * its contributors may be used to endorse or promote products
  24. * derived from this software without specific prior written
  25. * permission.
  26. *
  27. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  28. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  29. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  30. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  31. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  32. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  33. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  34. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  35. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  36. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  37. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38. *
  39. * Author: Tom Tucker <tom@opengridcomputing.com>
  40. */
  41. #ifndef SVC_RDMA_H
  42. #define SVC_RDMA_H
  43. #include <linux/sunrpc/xdr.h>
  44. #include <linux/sunrpc/svcsock.h>
  45. #include <linux/sunrpc/rpc_rdma.h>
  46. #include <rdma/ib_verbs.h>
  47. #include <rdma/rdma_cm.h>
  48. #define SVCRDMA_DEBUG
  49. /* RPC/RDMA parameters and stats */
  50. extern unsigned int svcrdma_ord;
  51. extern unsigned int svcrdma_max_requests;
  52. extern unsigned int svcrdma_max_req_size;
  53. extern atomic_t rdma_stat_recv;
  54. extern atomic_t rdma_stat_read;
  55. extern atomic_t rdma_stat_write;
  56. extern atomic_t rdma_stat_sq_starve;
  57. extern atomic_t rdma_stat_rq_starve;
  58. extern atomic_t rdma_stat_rq_poll;
  59. extern atomic_t rdma_stat_rq_prod;
  60. extern atomic_t rdma_stat_sq_poll;
  61. extern atomic_t rdma_stat_sq_prod;
  62. #define RPCRDMA_VERSION 1
  63. /*
  64. * Contexts are built when an RDMA request is created and are a
  65. * record of the resources that can be recovered when the request
  66. * completes.
  67. */
  68. struct svc_rdma_op_ctxt {
  69. struct svc_rdma_op_ctxt *read_hdr;
  70. struct svc_rdma_fastreg_mr *frmr;
  71. int hdr_count;
  72. struct xdr_buf arg;
  73. struct list_head dto_q;
  74. enum ib_wr_opcode wr_op;
  75. enum ib_wc_status wc_status;
  76. u32 byte_len;
  77. struct svcxprt_rdma *xprt;
  78. unsigned long flags;
  79. enum dma_data_direction direction;
  80. int count;
  81. struct ib_sge sge[RPCSVC_MAXPAGES];
  82. struct page *pages[RPCSVC_MAXPAGES];
  83. };
  84. /*
  85. * NFS_ requests are mapped on the client side by the chunk lists in
  86. * the RPCRDMA header. During the fetching of the RPC from the client
  87. * and the writing of the reply to the client, the memory in the
  88. * client and the memory in the server must be mapped as contiguous
  89. * vaddr/len for access by the hardware. These data strucures keep
  90. * these mappings.
  91. *
  92. * For an RDMA_WRITE, the 'sge' maps the RPC REPLY. For RDMA_READ, the
  93. * 'sge' in the svc_rdma_req_map maps the server side RPC reply and the
  94. * 'ch' field maps the read-list of the RPCRDMA header to the 'sge'
  95. * mapping of the reply.
  96. */
  97. struct svc_rdma_chunk_sge {
  98. int start; /* sge no for this chunk */
  99. int count; /* sge count for this chunk */
  100. };
  101. struct svc_rdma_fastreg_mr {
  102. struct ib_mr *mr;
  103. void *kva;
  104. struct ib_fast_reg_page_list *page_list;
  105. int page_list_len;
  106. unsigned long access_flags;
  107. unsigned long map_len;
  108. enum dma_data_direction direction;
  109. struct list_head frmr_list;
  110. };
  111. struct svc_rdma_req_map {
  112. struct svc_rdma_fastreg_mr *frmr;
  113. unsigned long count;
  114. union {
  115. struct kvec sge[RPCSVC_MAXPAGES];
  116. struct svc_rdma_chunk_sge ch[RPCSVC_MAXPAGES];
  117. };
  118. };
  119. #define RDMACTXT_F_FAST_UNREG 1
  120. #define RDMACTXT_F_LAST_CTXT 2
  121. #define SVCRDMA_DEVCAP_FAST_REG 1 /* fast mr registration */
  122. #define SVCRDMA_DEVCAP_READ_W_INV 2 /* read w/ invalidate */
  123. struct svcxprt_rdma {
  124. struct svc_xprt sc_xprt; /* SVC transport structure */
  125. struct rdma_cm_id *sc_cm_id; /* RDMA connection id */
  126. struct list_head sc_accept_q; /* Conn. waiting accept */
  127. int sc_ord; /* RDMA read limit */
  128. int sc_max_sge;
  129. int sc_sq_depth; /* Depth of SQ */
  130. atomic_t sc_sq_count; /* Number of SQ WR on queue */
  131. int sc_max_requests; /* Depth of RQ */
  132. int sc_max_req_size; /* Size of each RQ WR buf */
  133. struct ib_pd *sc_pd;
  134. atomic_t sc_dma_used;
  135. atomic_t sc_ctxt_used;
  136. struct list_head sc_rq_dto_q;
  137. spinlock_t sc_rq_dto_lock;
  138. struct ib_qp *sc_qp;
  139. struct ib_cq *sc_rq_cq;
  140. struct ib_cq *sc_sq_cq;
  141. struct ib_mr *sc_phys_mr; /* MR for server memory */
  142. u32 sc_dev_caps; /* distilled device caps */
  143. u32 sc_dma_lkey; /* local dma key */
  144. unsigned int sc_frmr_pg_list_len;
  145. struct list_head sc_frmr_q;
  146. spinlock_t sc_frmr_q_lock;
  147. spinlock_t sc_lock; /* transport lock */
  148. wait_queue_head_t sc_send_wait; /* SQ exhaustion waitlist */
  149. unsigned long sc_flags;
  150. struct list_head sc_dto_q; /* DTO tasklet I/O pending Q */
  151. struct list_head sc_read_complete_q;
  152. struct work_struct sc_work;
  153. };
  154. /* sc_flags */
  155. #define RDMAXPRT_RQ_PENDING 1
  156. #define RDMAXPRT_SQ_PENDING 2
  157. #define RDMAXPRT_CONN_PENDING 3
  158. #define RPCRDMA_LISTEN_BACKLOG 10
  159. /* The default ORD value is based on two outstanding full-size writes with a
  160. * page size of 4k, or 32k * 2 ops / 4k = 16 outstanding RDMA_READ. */
  161. #define RPCRDMA_ORD (64/4)
  162. #define RPCRDMA_SQ_DEPTH_MULT 8
  163. #define RPCRDMA_MAX_THREADS 16
  164. #define RPCRDMA_MAX_REQUESTS 16
  165. #define RPCRDMA_MAX_REQ_SIZE 4096
  166. /* svc_rdma_marshal.c */
  167. extern void svc_rdma_rcl_chunk_counts(struct rpcrdma_read_chunk *,
  168. int *, int *);
  169. extern int svc_rdma_xdr_decode_req(struct rpcrdma_msg **, struct svc_rqst *);
  170. extern int svc_rdma_xdr_decode_deferred_req(struct svc_rqst *);
  171. extern int svc_rdma_xdr_encode_error(struct svcxprt_rdma *,
  172. struct rpcrdma_msg *,
  173. enum rpcrdma_errcode, u32 *);
  174. extern void svc_rdma_xdr_encode_write_list(struct rpcrdma_msg *, int);
  175. extern void svc_rdma_xdr_encode_reply_array(struct rpcrdma_write_array *, int);
  176. extern void svc_rdma_xdr_encode_array_chunk(struct rpcrdma_write_array *, int,
  177. __be32, __be64, u32);
  178. extern void svc_rdma_xdr_encode_reply_header(struct svcxprt_rdma *,
  179. struct rpcrdma_msg *,
  180. struct rpcrdma_msg *,
  181. enum rpcrdma_proc);
  182. extern int svc_rdma_xdr_get_reply_hdr_len(struct rpcrdma_msg *);
  183. /* svc_rdma_recvfrom.c */
  184. extern int svc_rdma_recvfrom(struct svc_rqst *);
  185. /* svc_rdma_sendto.c */
  186. extern int svc_rdma_sendto(struct svc_rqst *);
  187. /* svc_rdma_transport.c */
  188. extern int svc_rdma_send(struct svcxprt_rdma *, struct ib_send_wr *);
  189. extern void svc_rdma_send_error(struct svcxprt_rdma *, struct rpcrdma_msg *,
  190. enum rpcrdma_errcode);
  191. struct page *svc_rdma_get_page(void);
  192. extern int svc_rdma_post_recv(struct svcxprt_rdma *);
  193. extern int svc_rdma_create_listen(struct svc_serv *, int, struct sockaddr *);
  194. extern struct svc_rdma_op_ctxt *svc_rdma_get_context(struct svcxprt_rdma *);
  195. extern void svc_rdma_put_context(struct svc_rdma_op_ctxt *, int);
  196. extern void svc_rdma_unmap_dma(struct svc_rdma_op_ctxt *ctxt);
  197. extern struct svc_rdma_req_map *svc_rdma_get_req_map(void);
  198. extern void svc_rdma_put_req_map(struct svc_rdma_req_map *);
  199. extern int svc_rdma_fastreg(struct svcxprt_rdma *, struct svc_rdma_fastreg_mr *);
  200. extern struct svc_rdma_fastreg_mr *svc_rdma_get_frmr(struct svcxprt_rdma *);
  201. extern void svc_rdma_put_frmr(struct svcxprt_rdma *,
  202. struct svc_rdma_fastreg_mr *);
  203. extern void svc_sq_reap(struct svcxprt_rdma *);
  204. extern void svc_rq_reap(struct svcxprt_rdma *);
  205. extern struct svc_xprt_class svc_rdma_class;
  206. extern void svc_rdma_prep_reply_hdr(struct svc_rqst *);
  207. /* svc_rdma.c */
  208. extern int svc_rdma_init(void);
  209. extern void svc_rdma_cleanup(void);
  210. /*
  211. * Returns the address of the first read chunk or <nul> if no read chunk is
  212. * present
  213. */
  214. static inline struct rpcrdma_read_chunk *
  215. svc_rdma_get_read_chunk(struct rpcrdma_msg *rmsgp)
  216. {
  217. struct rpcrdma_read_chunk *ch =
  218. (struct rpcrdma_read_chunk *)&rmsgp->rm_body.rm_chunks[0];
  219. if (ch->rc_discrim == 0)
  220. return NULL;
  221. return ch;
  222. }
  223. /*
  224. * Returns the address of the first read write array element or <nul> if no
  225. * write array list is present
  226. */
  227. static inline struct rpcrdma_write_array *
  228. svc_rdma_get_write_array(struct rpcrdma_msg *rmsgp)
  229. {
  230. if (rmsgp->rm_body.rm_chunks[0] != 0
  231. || rmsgp->rm_body.rm_chunks[1] == 0)
  232. return NULL;
  233. return (struct rpcrdma_write_array *)&rmsgp->rm_body.rm_chunks[1];
  234. }
  235. /*
  236. * Returns the address of the first reply array element or <nul> if no
  237. * reply array is present
  238. */
  239. static inline struct rpcrdma_write_array *
  240. svc_rdma_get_reply_array(struct rpcrdma_msg *rmsgp)
  241. {
  242. struct rpcrdma_read_chunk *rch;
  243. struct rpcrdma_write_array *wr_ary;
  244. struct rpcrdma_write_array *rp_ary;
  245. /* XXX: Need to fix when reply list may occur with read-list and/or
  246. * write list */
  247. if (rmsgp->rm_body.rm_chunks[0] != 0 ||
  248. rmsgp->rm_body.rm_chunks[1] != 0)
  249. return NULL;
  250. rch = svc_rdma_get_read_chunk(rmsgp);
  251. if (rch) {
  252. while (rch->rc_discrim)
  253. rch++;
  254. /* The reply list follows an empty write array located
  255. * at 'rc_position' here. The reply array is at rc_target.
  256. */
  257. rp_ary = (struct rpcrdma_write_array *)&rch->rc_target;
  258. goto found_it;
  259. }
  260. wr_ary = svc_rdma_get_write_array(rmsgp);
  261. if (wr_ary) {
  262. rp_ary = (struct rpcrdma_write_array *)
  263. &wr_ary->
  264. wc_array[ntohl(wr_ary->wc_nchunks)].wc_target.rs_length;
  265. goto found_it;
  266. }
  267. /* No read list, no write list */
  268. rp_ary = (struct rpcrdma_write_array *)
  269. &rmsgp->rm_body.rm_chunks[2];
  270. found_it:
  271. if (rp_ary->wc_discrim == 0)
  272. return NULL;
  273. return rp_ary;
  274. }
  275. #endif