2 * Copyright (c) 2015 Oracle. All rights reserved.
4 * Support for backward direction RPCs on RPC/RDMA.
7 #include <linux/module.h>
8 #include <linux/sunrpc/xprt.h>
9 #include <linux/sunrpc/svc.h>
10 #include <linux/sunrpc/svc_xprt.h>
12 #include "xprt_rdma.h"
14 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
15 # define RPCDBG_FACILITY RPCDBG_TRANS
18 #undef RPCRDMA_BACKCHANNEL_DEBUG
20 static void rpcrdma_bc_free_rqst(struct rpcrdma_xprt
*r_xprt
,
21 struct rpc_rqst
*rqst
)
23 struct rpcrdma_buffer
*buf
= &r_xprt
->rx_buf
;
24 struct rpcrdma_req
*req
= rpcr_to_rdmar(rqst
);
26 spin_lock(&buf
->rb_reqslock
);
27 list_del(&req
->rl_all
);
28 spin_unlock(&buf
->rb_reqslock
);
30 rpcrdma_destroy_req(req
);
35 static int rpcrdma_bc_setup_rqst(struct rpcrdma_xprt
*r_xprt
,
36 struct rpc_rqst
*rqst
)
38 struct rpcrdma_regbuf
*rb
;
39 struct rpcrdma_req
*req
;
42 req
= rpcrdma_create_req(r_xprt
);
45 req
->rl_backchannel
= true;
47 rb
= rpcrdma_alloc_regbuf(RPCRDMA_HDRBUF_SIZE
,
48 DMA_TO_DEVICE
, GFP_KERNEL
);
52 xdr_buf_init(&req
->rl_hdrbuf
, rb
->rg_base
, rdmab_length(rb
));
54 size
= r_xprt
->rx_data
.inline_rsize
;
55 rb
= rpcrdma_alloc_regbuf(size
, DMA_TO_DEVICE
, GFP_KERNEL
);
59 xdr_buf_init(&rqst
->rq_snd_buf
, rb
->rg_base
,
60 min_t(size_t, size
, PAGE_SIZE
));
61 rpcrdma_set_xprtdata(rqst
, req
);
65 rpcrdma_bc_free_rqst(r_xprt
, rqst
);
69 /* Allocate and add receive buffers to the rpcrdma_buffer's
70 * existing list of rep's. These are released when the
71 * transport is destroyed.
73 static int rpcrdma_bc_setup_reps(struct rpcrdma_xprt
*r_xprt
,
76 struct rpcrdma_rep
*rep
;
80 rep
= rpcrdma_create_rep(r_xprt
);
82 pr_err("RPC: %s: reply buffer alloc failed\n",
88 rpcrdma_recv_buffer_put(rep
);
95 * xprt_rdma_bc_setup - Pre-allocate resources for handling backchannel requests
96 * @xprt: transport associated with these backchannel resources
97 * @reqs: number of concurrent incoming requests to expect
99 * Returns 0 on success; otherwise a negative errno
101 int xprt_rdma_bc_setup(struct rpc_xprt
*xprt
, unsigned int reqs
)
103 struct rpcrdma_xprt
*r_xprt
= rpcx_to_rdmax(xprt
);
104 struct rpcrdma_buffer
*buffer
= &r_xprt
->rx_buf
;
105 struct rpc_rqst
*rqst
;
109 /* The backchannel reply path returns each rpc_rqst to the
110 * bc_pa_list _after_ the reply is sent. If the server is
111 * faster than the client, it can send another backward
112 * direction request before the rpc_rqst is returned to the
113 * list. The client rejects the request in this case.
115 * Twice as many rpc_rqsts are prepared to ensure there is
116 * always an rpc_rqst available as soon as a reply is sent.
118 if (reqs
> RPCRDMA_BACKWARD_WRS
>> 1)
121 for (i
= 0; i
< (reqs
<< 1); i
++) {
122 rqst
= kzalloc(sizeof(*rqst
), GFP_KERNEL
);
126 dprintk("RPC: %s: new rqst %p\n", __func__
, rqst
);
128 rqst
->rq_xprt
= &r_xprt
->rx_xprt
;
129 INIT_LIST_HEAD(&rqst
->rq_list
);
130 INIT_LIST_HEAD(&rqst
->rq_bc_list
);
132 if (rpcrdma_bc_setup_rqst(r_xprt
, rqst
))
135 spin_lock_bh(&xprt
->bc_pa_lock
);
136 list_add(&rqst
->rq_bc_pa_list
, &xprt
->bc_pa_list
);
137 spin_unlock_bh(&xprt
->bc_pa_lock
);
140 rc
= rpcrdma_bc_setup_reps(r_xprt
, reqs
);
144 rc
= rpcrdma_ep_post_extra_recv(r_xprt
, reqs
);
148 buffer
->rb_bc_srv_max_requests
= reqs
;
149 request_module("svcrdma");
154 xprt_rdma_bc_destroy(xprt
, reqs
);
157 pr_err("RPC: %s: setup backchannel transport failed\n", __func__
);
162 * xprt_rdma_bc_up - Create transport endpoint for backchannel service
163 * @serv: server endpoint
164 * @net: network namespace
166 * The "xprt" is an implied argument: it supplies the name of the
167 * backchannel transport class.
169 * Returns zero on success, negative errno on failure
171 int xprt_rdma_bc_up(struct svc_serv
*serv
, struct net
*net
)
175 ret
= svc_create_xprt(serv
, "rdma-bc", net
, PF_INET
, 0, 0);
182 * xprt_rdma_bc_maxpayload - Return maximum backchannel message size
185 * Returns maximum size, in bytes, of a backchannel message
187 size_t xprt_rdma_bc_maxpayload(struct rpc_xprt
*xprt
)
189 struct rpcrdma_xprt
*r_xprt
= rpcx_to_rdmax(xprt
);
190 struct rpcrdma_create_data_internal
*cdata
= &r_xprt
->rx_data
;
193 maxmsg
= min_t(unsigned int, cdata
->inline_rsize
, cdata
->inline_wsize
);
194 maxmsg
= min_t(unsigned int, maxmsg
, PAGE_SIZE
);
195 return maxmsg
- RPCRDMA_HDRLEN_MIN
;
199 * rpcrdma_bc_marshal_reply - Send backwards direction reply
200 * @rqst: buffer containing RPC reply data
202 * Returns zero on success.
204 int rpcrdma_bc_marshal_reply(struct rpc_rqst
*rqst
)
206 struct rpcrdma_xprt
*r_xprt
= rpcx_to_rdmax(rqst
->rq_xprt
);
207 struct rpcrdma_req
*req
= rpcr_to_rdmar(rqst
);
210 rpcrdma_set_xdrlen(&req
->rl_hdrbuf
, 0);
211 xdr_init_encode(&req
->rl_stream
, &req
->rl_hdrbuf
,
212 req
->rl_rdmabuf
->rg_base
);
214 p
= xdr_reserve_space(&req
->rl_stream
, 28);
218 *p
++ = rpcrdma_version
;
219 *p
++ = cpu_to_be32(r_xprt
->rx_buf
.rb_bc_srv_max_requests
);
225 if (!rpcrdma_prepare_send_sges(&r_xprt
->rx_ia
, req
, RPCRDMA_HDRLEN_MIN
,
226 &rqst
->rq_snd_buf
, rpcrdma_noch
))
232 * xprt_rdma_bc_destroy - Release resources for handling backchannel requests
233 * @xprt: transport associated with these backchannel resources
234 * @reqs: number of incoming requests to destroy; ignored
236 void xprt_rdma_bc_destroy(struct rpc_xprt
*xprt
, unsigned int reqs
)
238 struct rpcrdma_xprt
*r_xprt
= rpcx_to_rdmax(xprt
);
239 struct rpc_rqst
*rqst
, *tmp
;
241 spin_lock_bh(&xprt
->bc_pa_lock
);
242 list_for_each_entry_safe(rqst
, tmp
, &xprt
->bc_pa_list
, rq_bc_pa_list
) {
243 list_del(&rqst
->rq_bc_pa_list
);
244 spin_unlock_bh(&xprt
->bc_pa_lock
);
246 rpcrdma_bc_free_rqst(r_xprt
, rqst
);
248 spin_lock_bh(&xprt
->bc_pa_lock
);
250 spin_unlock_bh(&xprt
->bc_pa_lock
);
254 * xprt_rdma_bc_free_rqst - Release a backchannel rqst
255 * @rqst: request to release
257 void xprt_rdma_bc_free_rqst(struct rpc_rqst
*rqst
)
259 struct rpc_xprt
*xprt
= rqst
->rq_xprt
;
261 dprintk("RPC: %s: freeing rqst %p (req %p)\n",
262 __func__
, rqst
, rpcr_to_rdmar(rqst
));
264 smp_mb__before_atomic();
265 WARN_ON_ONCE(!test_bit(RPC_BC_PA_IN_USE
, &rqst
->rq_bc_pa_state
));
266 clear_bit(RPC_BC_PA_IN_USE
, &rqst
->rq_bc_pa_state
);
267 smp_mb__after_atomic();
269 spin_lock_bh(&xprt
->bc_pa_lock
);
270 list_add_tail(&rqst
->rq_bc_pa_list
, &xprt
->bc_pa_list
);
271 spin_unlock_bh(&xprt
->bc_pa_lock
);
275 * rpcrdma_bc_receive_call - Handle a backward direction call
276 * @xprt: transport receiving the call
277 * @rep: receive buffer containing the call
279 * Operational assumptions:
280 * o Backchannel credits are ignored, just as the NFS server
281 * forechannel currently does
282 * o The ULP manages a replay cache (eg, NFSv4.1 sessions).
283 * No replay detection is done at the transport level
285 void rpcrdma_bc_receive_call(struct rpcrdma_xprt
*r_xprt
,
286 struct rpcrdma_rep
*rep
)
288 struct rpc_xprt
*xprt
= &r_xprt
->rx_xprt
;
289 struct svc_serv
*bc_serv
;
290 struct rpcrdma_req
*req
;
291 struct rpc_rqst
*rqst
;
296 p
= xdr_inline_decode(&rep
->rr_stream
, 0);
297 size
= xdr_stream_remaining(&rep
->rr_stream
);
299 #ifdef RPCRDMA_BACKCHANNEL_DEBUG
300 pr_info("RPC: %s: callback XID %08x, length=%u\n",
301 __func__
, be32_to_cpup(p
), size
);
302 pr_info("RPC: %s: %*ph\n", __func__
, size
, p
);
305 /* Grab a free bc rqst */
306 spin_lock(&xprt
->bc_pa_lock
);
307 if (list_empty(&xprt
->bc_pa_list
)) {
308 spin_unlock(&xprt
->bc_pa_lock
);
311 rqst
= list_first_entry(&xprt
->bc_pa_list
,
312 struct rpc_rqst
, rq_bc_pa_list
);
313 list_del(&rqst
->rq_bc_pa_list
);
314 spin_unlock(&xprt
->bc_pa_lock
);
315 dprintk("RPC: %s: using rqst %p\n", __func__
, rqst
);
318 rqst
->rq_reply_bytes_recvd
= 0;
319 rqst
->rq_bytes_sent
= 0;
322 rqst
->rq_private_buf
.len
= size
;
323 set_bit(RPC_BC_PA_IN_USE
, &rqst
->rq_bc_pa_state
);
325 buf
= &rqst
->rq_rcv_buf
;
326 memset(buf
, 0, sizeof(*buf
));
327 buf
->head
[0].iov_base
= p
;
328 buf
->head
[0].iov_len
= size
;
331 /* The receive buffer has to be hooked to the rpcrdma_req
332 * so that it is not released while the req is pointing
333 * to its buffer, and so that it can be reposted after
334 * the Upper Layer is done decoding it.
336 req
= rpcr_to_rdmar(rqst
);
337 dprintk("RPC: %s: attaching rep %p to req %p\n",
341 /* Defeat the retransmit detection logic in send_request */
342 req
->rl_connect_cookie
= 0;
344 /* Queue rqst for ULP's callback service */
345 bc_serv
= xprt
->bc_serv
;
346 spin_lock(&bc_serv
->sv_cb_lock
);
347 list_add(&rqst
->rq_bc_list
, &bc_serv
->sv_cb_list
);
348 spin_unlock(&bc_serv
->sv_cb_lock
);
350 wake_up(&bc_serv
->sv_cb_waitq
);
352 r_xprt
->rx_stats
.bcall_count
++;
356 pr_warn("RPC/RDMA backchannel overflow\n");
357 xprt_disconnect_done(xprt
);
358 /* This receive buffer gets reposted automatically
359 * when the connection is re-established.