blob: 04aaca4b8bf93fa0cd2fc337153f692de6f86cea [file] [log] [blame]
David Brazdil0f672f62019-12-10 10:32:29 +00001// SPDX-License-Identifier: GPL-2.0-only
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002/*
3 * linux/net/sunrpc/xprt.c
4 *
5 * This is a generic RPC call interface supporting congestion avoidance,
6 * and asynchronous calls.
7 *
8 * The interface works like this:
9 *
10 * - When a process places a call, it allocates a request slot if
11 * one is available. Otherwise, it sleeps on the backlog queue
12 * (xprt_reserve).
13 * - Next, the caller puts together the RPC message, stuffs it into
14 * the request struct, and calls xprt_transmit().
15 * - xprt_transmit sends the message and installs the caller on the
16 * transport's wait list. At the same time, if a reply is expected,
17 * it installs a timer that is run after the packet's timeout has
18 * expired.
19 * - When a packet arrives, the data_ready handler walks the list of
20 * pending requests for that transport. If a matching XID is found, the
21 * caller is woken up, and the timer removed.
22 * - When no reply arrives within the timeout interval, the timer is
23 * fired by the kernel and runs xprt_timer(). It either adjusts the
24 * timeout values (minor timeout) or wakes up the caller with a status
25 * of -ETIMEDOUT.
26 * - When the caller receives a notification from RPC that a reply arrived,
27 * it should release the RPC slot, and process the reply.
28 * If the call timed out, it may choose to retry the operation by
29 * adjusting the initial timeout value, and simply calling rpc_call
30 * again.
31 *
32 * Support for async RPC is done through a set of RPC-specific scheduling
33 * primitives that `transparently' work for processes as well as async
34 * tasks that rely on callbacks.
35 *
36 * Copyright (C) 1995-1997, Olaf Kirch <okir@monad.swb.de>
37 *
38 * Transport switch API copyright (C) 2005, Chuck Lever <cel@netapp.com>
39 */
40
41#include <linux/module.h>
42
43#include <linux/types.h>
44#include <linux/interrupt.h>
45#include <linux/workqueue.h>
46#include <linux/net.h>
47#include <linux/ktime.h>
48
49#include <linux/sunrpc/clnt.h>
50#include <linux/sunrpc/metrics.h>
51#include <linux/sunrpc/bc_xprt.h>
52#include <linux/rcupdate.h>
David Brazdil0f672f62019-12-10 10:32:29 +000053#include <linux/sched/mm.h>
Andrew Scullb4b6d4a2019-01-02 15:54:55 +000054
55#include <trace/events/sunrpc.h>
56
57#include "sunrpc.h"
58
59/*
60 * Local variables
61 */
62
63#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
64# define RPCDBG_FACILITY RPCDBG_XPRT
65#endif
66
67/*
68 * Local functions
69 */
70static void xprt_init(struct rpc_xprt *xprt, struct net *net);
71static __be32 xprt_alloc_xid(struct rpc_xprt *xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +000072static void xprt_destroy(struct rpc_xprt *xprt);
Olivier Deprez157378f2022-04-04 15:47:50 +020073static void xprt_request_init(struct rpc_task *task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +000074
75static DEFINE_SPINLOCK(xprt_list_lock);
76static LIST_HEAD(xprt_list);
77
David Brazdil0f672f62019-12-10 10:32:29 +000078static unsigned long xprt_request_timeout(const struct rpc_rqst *req)
79{
80 unsigned long timeout = jiffies + req->rq_timeout;
81
82 if (time_before(timeout, req->rq_majortimeo))
83 return timeout;
84 return req->rq_majortimeo;
85}
86
Andrew Scullb4b6d4a2019-01-02 15:54:55 +000087/**
88 * xprt_register_transport - register a transport implementation
89 * @transport: transport to register
90 *
91 * If a transport implementation is loaded as a kernel module, it can
92 * call this interface to make itself known to the RPC client.
93 *
94 * Returns:
95 * 0: transport successfully registered
96 * -EEXIST: transport already registered
97 * -EINVAL: transport module being unloaded
98 */
99int xprt_register_transport(struct xprt_class *transport)
100{
101 struct xprt_class *t;
102 int result;
103
104 result = -EEXIST;
105 spin_lock(&xprt_list_lock);
106 list_for_each_entry(t, &xprt_list, list) {
107 /* don't register the same transport class twice */
108 if (t->ident == transport->ident)
109 goto out;
110 }
111
112 list_add_tail(&transport->list, &xprt_list);
113 printk(KERN_INFO "RPC: Registered %s transport module.\n",
114 transport->name);
115 result = 0;
116
117out:
118 spin_unlock(&xprt_list_lock);
119 return result;
120}
121EXPORT_SYMBOL_GPL(xprt_register_transport);
122
123/**
124 * xprt_unregister_transport - unregister a transport implementation
125 * @transport: transport to unregister
126 *
127 * Returns:
128 * 0: transport successfully unregistered
129 * -ENOENT: transport never registered
130 */
131int xprt_unregister_transport(struct xprt_class *transport)
132{
133 struct xprt_class *t;
134 int result;
135
136 result = 0;
137 spin_lock(&xprt_list_lock);
138 list_for_each_entry(t, &xprt_list, list) {
139 if (t == transport) {
140 printk(KERN_INFO
141 "RPC: Unregistered %s transport module.\n",
142 transport->name);
143 list_del_init(&transport->list);
144 goto out;
145 }
146 }
147 result = -ENOENT;
148
149out:
150 spin_unlock(&xprt_list_lock);
151 return result;
152}
153EXPORT_SYMBOL_GPL(xprt_unregister_transport);
154
Olivier Deprez0e641232021-09-23 10:07:05 +0200155static void
156xprt_class_release(const struct xprt_class *t)
157{
158 module_put(t->owner);
159}
160
161static const struct xprt_class *
162xprt_class_find_by_netid_locked(const char *netid)
163{
164 const struct xprt_class *t;
165 unsigned int i;
166
167 list_for_each_entry(t, &xprt_list, list) {
168 for (i = 0; t->netid[i][0] != '\0'; i++) {
169 if (strcmp(t->netid[i], netid) != 0)
170 continue;
171 if (!try_module_get(t->owner))
172 continue;
173 return t;
174 }
175 }
176 return NULL;
177}
178
179static const struct xprt_class *
180xprt_class_find_by_netid(const char *netid)
181{
182 const struct xprt_class *t;
183
184 spin_lock(&xprt_list_lock);
185 t = xprt_class_find_by_netid_locked(netid);
186 if (!t) {
187 spin_unlock(&xprt_list_lock);
188 request_module("rpc%s", netid);
189 spin_lock(&xprt_list_lock);
190 t = xprt_class_find_by_netid_locked(netid);
191 }
192 spin_unlock(&xprt_list_lock);
193 return t;
194}
195
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000196/**
197 * xprt_load_transport - load a transport implementation
Olivier Deprez0e641232021-09-23 10:07:05 +0200198 * @netid: transport to load
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000199 *
200 * Returns:
201 * 0: transport successfully loaded
202 * -ENOENT: transport module not available
203 */
Olivier Deprez0e641232021-09-23 10:07:05 +0200204int xprt_load_transport(const char *netid)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000205{
Olivier Deprez0e641232021-09-23 10:07:05 +0200206 const struct xprt_class *t;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000207
Olivier Deprez0e641232021-09-23 10:07:05 +0200208 t = xprt_class_find_by_netid(netid);
209 if (!t)
210 return -ENOENT;
211 xprt_class_release(t);
212 return 0;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000213}
214EXPORT_SYMBOL_GPL(xprt_load_transport);
215
David Brazdil0f672f62019-12-10 10:32:29 +0000216static void xprt_clear_locked(struct rpc_xprt *xprt)
217{
218 xprt->snd_task = NULL;
219 if (!test_bit(XPRT_CLOSE_WAIT, &xprt->state)) {
220 smp_mb__before_atomic();
221 clear_bit(XPRT_LOCKED, &xprt->state);
222 smp_mb__after_atomic();
223 } else
224 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
225}
226
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000227/**
228 * xprt_reserve_xprt - serialize write access to transports
229 * @task: task that is requesting access to the transport
230 * @xprt: pointer to the target transport
231 *
232 * This prevents mixing the payload of separate requests, and prevents
233 * transport connects from colliding with writes. No congestion control
234 * is provided.
235 */
236int xprt_reserve_xprt(struct rpc_xprt *xprt, struct rpc_task *task)
237{
238 struct rpc_rqst *req = task->tk_rqstp;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000239
240 if (test_and_set_bit(XPRT_LOCKED, &xprt->state)) {
241 if (task == xprt->snd_task)
Olivier Deprez157378f2022-04-04 15:47:50 +0200242 goto out_locked;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000243 goto out_sleep;
244 }
David Brazdil0f672f62019-12-10 10:32:29 +0000245 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
246 goto out_unlock;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000247 xprt->snd_task = task;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000248
Olivier Deprez157378f2022-04-04 15:47:50 +0200249out_locked:
250 trace_xprt_reserve_xprt(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000251 return 1;
252
David Brazdil0f672f62019-12-10 10:32:29 +0000253out_unlock:
254 xprt_clear_locked(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000255out_sleep:
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000256 task->tk_status = -EAGAIN;
David Brazdil0f672f62019-12-10 10:32:29 +0000257 if (RPC_IS_SOFT(task))
258 rpc_sleep_on_timeout(&xprt->sending, task, NULL,
259 xprt_request_timeout(req));
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000260 else
David Brazdil0f672f62019-12-10 10:32:29 +0000261 rpc_sleep_on(&xprt->sending, task, NULL);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000262 return 0;
263}
264EXPORT_SYMBOL_GPL(xprt_reserve_xprt);
265
David Brazdil0f672f62019-12-10 10:32:29 +0000266static bool
267xprt_need_congestion_window_wait(struct rpc_xprt *xprt)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000268{
David Brazdil0f672f62019-12-10 10:32:29 +0000269 return test_bit(XPRT_CWND_WAIT, &xprt->state);
270}
271
272static void
273xprt_set_congestion_window_wait(struct rpc_xprt *xprt)
274{
275 if (!list_empty(&xprt->xmit_queue)) {
276 /* Peek at head of queue to see if it can make progress */
277 if (list_first_entry(&xprt->xmit_queue, struct rpc_rqst,
278 rq_xmit)->rq_cong)
279 return;
280 }
281 set_bit(XPRT_CWND_WAIT, &xprt->state);
282}
283
284static void
285xprt_test_and_clear_congestion_window_wait(struct rpc_xprt *xprt)
286{
287 if (!RPCXPRT_CONGESTED(xprt))
288 clear_bit(XPRT_CWND_WAIT, &xprt->state);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000289}
290
291/*
292 * xprt_reserve_xprt_cong - serialize write access to transports
293 * @task: task that is requesting access to the transport
294 *
295 * Same as xprt_reserve_xprt, but Van Jacobson congestion control is
296 * integrated into the decision of whether a request is allowed to be
297 * woken up and given access to the transport.
David Brazdil0f672f62019-12-10 10:32:29 +0000298 * Note that the lock is only granted if we know there are free slots.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000299 */
300int xprt_reserve_xprt_cong(struct rpc_xprt *xprt, struct rpc_task *task)
301{
302 struct rpc_rqst *req = task->tk_rqstp;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000303
304 if (test_and_set_bit(XPRT_LOCKED, &xprt->state)) {
305 if (task == xprt->snd_task)
Olivier Deprez157378f2022-04-04 15:47:50 +0200306 goto out_locked;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000307 goto out_sleep;
308 }
309 if (req == NULL) {
310 xprt->snd_task = task;
Olivier Deprez157378f2022-04-04 15:47:50 +0200311 goto out_locked;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000312 }
David Brazdil0f672f62019-12-10 10:32:29 +0000313 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
314 goto out_unlock;
315 if (!xprt_need_congestion_window_wait(xprt)) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000316 xprt->snd_task = task;
Olivier Deprez157378f2022-04-04 15:47:50 +0200317 goto out_locked;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000318 }
David Brazdil0f672f62019-12-10 10:32:29 +0000319out_unlock:
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000320 xprt_clear_locked(xprt);
321out_sleep:
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000322 task->tk_status = -EAGAIN;
David Brazdil0f672f62019-12-10 10:32:29 +0000323 if (RPC_IS_SOFT(task))
324 rpc_sleep_on_timeout(&xprt->sending, task, NULL,
325 xprt_request_timeout(req));
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000326 else
David Brazdil0f672f62019-12-10 10:32:29 +0000327 rpc_sleep_on(&xprt->sending, task, NULL);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000328 return 0;
Olivier Deprez157378f2022-04-04 15:47:50 +0200329out_locked:
330 trace_xprt_reserve_cong(xprt, task);
331 return 1;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000332}
333EXPORT_SYMBOL_GPL(xprt_reserve_xprt_cong);
334
335static inline int xprt_lock_write(struct rpc_xprt *xprt, struct rpc_task *task)
336{
337 int retval;
338
David Brazdil0f672f62019-12-10 10:32:29 +0000339 if (test_bit(XPRT_LOCKED, &xprt->state) && xprt->snd_task == task)
340 return 1;
341 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000342 retval = xprt->ops->reserve_xprt(xprt, task);
David Brazdil0f672f62019-12-10 10:32:29 +0000343 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000344 return retval;
345}
346
347static bool __xprt_lock_write_func(struct rpc_task *task, void *data)
348{
349 struct rpc_xprt *xprt = data;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000350
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000351 xprt->snd_task = task;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000352 return true;
353}
354
355static void __xprt_lock_write_next(struct rpc_xprt *xprt)
356{
357 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
358 return;
David Brazdil0f672f62019-12-10 10:32:29 +0000359 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
360 goto out_unlock;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000361 if (rpc_wake_up_first_on_wq(xprtiod_workqueue, &xprt->sending,
362 __xprt_lock_write_func, xprt))
363 return;
David Brazdil0f672f62019-12-10 10:32:29 +0000364out_unlock:
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000365 xprt_clear_locked(xprt);
366}
367
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000368static void __xprt_lock_write_next_cong(struct rpc_xprt *xprt)
369{
370 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
371 return;
David Brazdil0f672f62019-12-10 10:32:29 +0000372 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
373 goto out_unlock;
374 if (xprt_need_congestion_window_wait(xprt))
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000375 goto out_unlock;
376 if (rpc_wake_up_first_on_wq(xprtiod_workqueue, &xprt->sending,
David Brazdil0f672f62019-12-10 10:32:29 +0000377 __xprt_lock_write_func, xprt))
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000378 return;
379out_unlock:
380 xprt_clear_locked(xprt);
381}
382
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000383/**
384 * xprt_release_xprt - allow other requests to use a transport
385 * @xprt: transport with other tasks potentially waiting
386 * @task: task that is releasing access to the transport
387 *
388 * Note that "task" can be NULL. No congestion control is provided.
389 */
390void xprt_release_xprt(struct rpc_xprt *xprt, struct rpc_task *task)
391{
392 if (xprt->snd_task == task) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000393 xprt_clear_locked(xprt);
394 __xprt_lock_write_next(xprt);
395 }
Olivier Deprez157378f2022-04-04 15:47:50 +0200396 trace_xprt_release_xprt(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000397}
398EXPORT_SYMBOL_GPL(xprt_release_xprt);
399
400/**
401 * xprt_release_xprt_cong - allow other requests to use a transport
402 * @xprt: transport with other tasks potentially waiting
403 * @task: task that is releasing access to the transport
404 *
405 * Note that "task" can be NULL. Another task is awoken to use the
406 * transport if the transport's congestion window allows it.
407 */
408void xprt_release_xprt_cong(struct rpc_xprt *xprt, struct rpc_task *task)
409{
410 if (xprt->snd_task == task) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000411 xprt_clear_locked(xprt);
412 __xprt_lock_write_next_cong(xprt);
413 }
Olivier Deprez157378f2022-04-04 15:47:50 +0200414 trace_xprt_release_cong(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000415}
416EXPORT_SYMBOL_GPL(xprt_release_xprt_cong);
417
418static inline void xprt_release_write(struct rpc_xprt *xprt, struct rpc_task *task)
419{
David Brazdil0f672f62019-12-10 10:32:29 +0000420 if (xprt->snd_task != task)
421 return;
422 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000423 xprt->ops->release_xprt(xprt, task);
David Brazdil0f672f62019-12-10 10:32:29 +0000424 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000425}
426
427/*
428 * Van Jacobson congestion avoidance. Check if the congestion window
429 * overflowed. Put the task to sleep if this is the case.
430 */
431static int
David Brazdil0f672f62019-12-10 10:32:29 +0000432__xprt_get_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000433{
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000434 if (req->rq_cong)
435 return 1;
Olivier Deprez157378f2022-04-04 15:47:50 +0200436 trace_xprt_get_cong(xprt, req->rq_task);
David Brazdil0f672f62019-12-10 10:32:29 +0000437 if (RPCXPRT_CONGESTED(xprt)) {
438 xprt_set_congestion_window_wait(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000439 return 0;
David Brazdil0f672f62019-12-10 10:32:29 +0000440 }
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000441 req->rq_cong = 1;
442 xprt->cong += RPC_CWNDSCALE;
443 return 1;
444}
445
446/*
447 * Adjust the congestion window, and wake up the next task
448 * that has been sleeping due to congestion
449 */
450static void
451__xprt_put_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
452{
453 if (!req->rq_cong)
454 return;
455 req->rq_cong = 0;
456 xprt->cong -= RPC_CWNDSCALE;
David Brazdil0f672f62019-12-10 10:32:29 +0000457 xprt_test_and_clear_congestion_window_wait(xprt);
Olivier Deprez157378f2022-04-04 15:47:50 +0200458 trace_xprt_put_cong(xprt, req->rq_task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000459 __xprt_lock_write_next_cong(xprt);
460}
461
462/**
David Brazdil0f672f62019-12-10 10:32:29 +0000463 * xprt_request_get_cong - Request congestion control credits
464 * @xprt: pointer to transport
465 * @req: pointer to RPC request
466 *
467 * Useful for transports that require congestion control.
468 */
469bool
470xprt_request_get_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
471{
472 bool ret = false;
473
474 if (req->rq_cong)
475 return true;
476 spin_lock(&xprt->transport_lock);
477 ret = __xprt_get_cong(xprt, req) != 0;
478 spin_unlock(&xprt->transport_lock);
479 return ret;
480}
481EXPORT_SYMBOL_GPL(xprt_request_get_cong);
482
483/**
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000484 * xprt_release_rqst_cong - housekeeping when request is complete
485 * @task: RPC request that recently completed
486 *
487 * Useful for transports that require congestion control.
488 */
489void xprt_release_rqst_cong(struct rpc_task *task)
490{
491 struct rpc_rqst *req = task->tk_rqstp;
492
493 __xprt_put_cong(req->rq_xprt, req);
494}
495EXPORT_SYMBOL_GPL(xprt_release_rqst_cong);
496
David Brazdil0f672f62019-12-10 10:32:29 +0000497static void xprt_clear_congestion_window_wait_locked(struct rpc_xprt *xprt)
498{
499 if (test_and_clear_bit(XPRT_CWND_WAIT, &xprt->state))
500 __xprt_lock_write_next_cong(xprt);
501}
502
503/*
504 * Clear the congestion window wait flag and wake up the next
505 * entry on xprt->sending
506 */
507static void
508xprt_clear_congestion_window_wait(struct rpc_xprt *xprt)
509{
510 if (test_and_clear_bit(XPRT_CWND_WAIT, &xprt->state)) {
511 spin_lock(&xprt->transport_lock);
512 __xprt_lock_write_next_cong(xprt);
513 spin_unlock(&xprt->transport_lock);
514 }
515}
516
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000517/**
518 * xprt_adjust_cwnd - adjust transport congestion window
519 * @xprt: pointer to xprt
520 * @task: recently completed RPC request used to adjust window
521 * @result: result code of completed RPC request
522 *
523 * The transport code maintains an estimate on the maximum number of out-
524 * standing RPC requests, using a smoothed version of the congestion
525 * avoidance implemented in 44BSD. This is basically the Van Jacobson
526 * congestion algorithm: If a retransmit occurs, the congestion window is
527 * halved; otherwise, it is incremented by 1/cwnd when
528 *
529 * - a reply is received and
530 * - a full number of requests are outstanding and
531 * - the congestion window hasn't been updated recently.
532 */
533void xprt_adjust_cwnd(struct rpc_xprt *xprt, struct rpc_task *task, int result)
534{
535 struct rpc_rqst *req = task->tk_rqstp;
536 unsigned long cwnd = xprt->cwnd;
537
538 if (result >= 0 && cwnd <= xprt->cong) {
539 /* The (cwnd >> 1) term makes sure
540 * the result gets rounded properly. */
541 cwnd += (RPC_CWNDSCALE * RPC_CWNDSCALE + (cwnd >> 1)) / cwnd;
542 if (cwnd > RPC_MAXCWND(xprt))
543 cwnd = RPC_MAXCWND(xprt);
544 __xprt_lock_write_next_cong(xprt);
545 } else if (result == -ETIMEDOUT) {
546 cwnd >>= 1;
547 if (cwnd < RPC_CWNDSCALE)
548 cwnd = RPC_CWNDSCALE;
549 }
550 dprintk("RPC: cong %ld, cwnd was %ld, now %ld\n",
551 xprt->cong, xprt->cwnd, cwnd);
552 xprt->cwnd = cwnd;
553 __xprt_put_cong(xprt, req);
554}
555EXPORT_SYMBOL_GPL(xprt_adjust_cwnd);
556
557/**
558 * xprt_wake_pending_tasks - wake all tasks on a transport's pending queue
559 * @xprt: transport with waiting tasks
560 * @status: result code to plant in each task before waking it
561 *
562 */
563void xprt_wake_pending_tasks(struct rpc_xprt *xprt, int status)
564{
565 if (status < 0)
566 rpc_wake_up_status(&xprt->pending, status);
567 else
568 rpc_wake_up(&xprt->pending);
569}
570EXPORT_SYMBOL_GPL(xprt_wake_pending_tasks);
571
572/**
573 * xprt_wait_for_buffer_space - wait for transport output buffer to clear
David Brazdil0f672f62019-12-10 10:32:29 +0000574 * @xprt: transport
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000575 *
576 * Note that we only set the timer for the case of RPC_IS_SOFT(), since
577 * we don't in general want to force a socket disconnection due to
578 * an incomplete RPC call transmission.
579 */
David Brazdil0f672f62019-12-10 10:32:29 +0000580void xprt_wait_for_buffer_space(struct rpc_xprt *xprt)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000581{
David Brazdil0f672f62019-12-10 10:32:29 +0000582 set_bit(XPRT_WRITE_SPACE, &xprt->state);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000583}
584EXPORT_SYMBOL_GPL(xprt_wait_for_buffer_space);
585
David Brazdil0f672f62019-12-10 10:32:29 +0000586static bool
587xprt_clear_write_space_locked(struct rpc_xprt *xprt)
588{
589 if (test_and_clear_bit(XPRT_WRITE_SPACE, &xprt->state)) {
590 __xprt_lock_write_next(xprt);
591 dprintk("RPC: write space: waking waiting task on "
592 "xprt %p\n", xprt);
593 return true;
594 }
595 return false;
596}
597
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000598/**
599 * xprt_write_space - wake the task waiting for transport output buffer space
600 * @xprt: transport with waiting tasks
601 *
602 * Can be called in a soft IRQ context, so xprt_write_space never sleeps.
603 */
David Brazdil0f672f62019-12-10 10:32:29 +0000604bool xprt_write_space(struct rpc_xprt *xprt)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000605{
David Brazdil0f672f62019-12-10 10:32:29 +0000606 bool ret;
607
608 if (!test_bit(XPRT_WRITE_SPACE, &xprt->state))
609 return false;
610 spin_lock(&xprt->transport_lock);
611 ret = xprt_clear_write_space_locked(xprt);
612 spin_unlock(&xprt->transport_lock);
613 return ret;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000614}
615EXPORT_SYMBOL_GPL(xprt_write_space);
616
David Brazdil0f672f62019-12-10 10:32:29 +0000617static unsigned long xprt_abs_ktime_to_jiffies(ktime_t abstime)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000618{
David Brazdil0f672f62019-12-10 10:32:29 +0000619 s64 delta = ktime_to_ns(ktime_get() - abstime);
620 return likely(delta >= 0) ?
621 jiffies - nsecs_to_jiffies(delta) :
622 jiffies + nsecs_to_jiffies(-delta);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000623}
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000624
David Brazdil0f672f62019-12-10 10:32:29 +0000625static unsigned long xprt_calc_majortimeo(struct rpc_rqst *req)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000626{
David Brazdil0f672f62019-12-10 10:32:29 +0000627 const struct rpc_timeout *to = req->rq_task->tk_client->cl_timeout;
628 unsigned long majortimeo = req->rq_timeout;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000629
David Brazdil0f672f62019-12-10 10:32:29 +0000630 if (to->to_exponential)
631 majortimeo <<= to->to_retries;
632 else
633 majortimeo += to->to_increment * to->to_retries;
634 if (majortimeo > to->to_maxval || majortimeo == 0)
635 majortimeo = to->to_maxval;
636 return majortimeo;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000637}
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000638
639static void xprt_reset_majortimeo(struct rpc_rqst *req)
640{
David Brazdil0f672f62019-12-10 10:32:29 +0000641 req->rq_majortimeo += xprt_calc_majortimeo(req);
642}
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000643
Olivier Deprez157378f2022-04-04 15:47:50 +0200644static void xprt_reset_minortimeo(struct rpc_rqst *req)
645{
646 req->rq_minortimeo += req->rq_timeout;
647}
648
David Brazdil0f672f62019-12-10 10:32:29 +0000649static void xprt_init_majortimeo(struct rpc_task *task, struct rpc_rqst *req)
650{
651 unsigned long time_init;
652 struct rpc_xprt *xprt = req->rq_xprt;
653
654 if (likely(xprt && xprt_connected(xprt)))
655 time_init = jiffies;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000656 else
David Brazdil0f672f62019-12-10 10:32:29 +0000657 time_init = xprt_abs_ktime_to_jiffies(task->tk_start);
658 req->rq_timeout = task->tk_client->cl_timeout->to_initval;
659 req->rq_majortimeo = time_init + xprt_calc_majortimeo(req);
Olivier Deprez157378f2022-04-04 15:47:50 +0200660 req->rq_minortimeo = time_init + req->rq_timeout;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000661}
662
663/**
664 * xprt_adjust_timeout - adjust timeout values for next retransmit
665 * @req: RPC request containing parameters to use for the adjustment
666 *
667 */
668int xprt_adjust_timeout(struct rpc_rqst *req)
669{
670 struct rpc_xprt *xprt = req->rq_xprt;
671 const struct rpc_timeout *to = req->rq_task->tk_client->cl_timeout;
672 int status = 0;
673
674 if (time_before(jiffies, req->rq_majortimeo)) {
Olivier Deprez157378f2022-04-04 15:47:50 +0200675 if (time_before(jiffies, req->rq_minortimeo))
676 return status;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000677 if (to->to_exponential)
678 req->rq_timeout <<= 1;
679 else
680 req->rq_timeout += to->to_increment;
681 if (to->to_maxval && req->rq_timeout >= to->to_maxval)
682 req->rq_timeout = to->to_maxval;
683 req->rq_retries++;
684 } else {
685 req->rq_timeout = to->to_initval;
686 req->rq_retries = 0;
687 xprt_reset_majortimeo(req);
688 /* Reset the RTT counters == "slow start" */
David Brazdil0f672f62019-12-10 10:32:29 +0000689 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000690 rpc_init_rtt(req->rq_task->tk_client->cl_rtt, to->to_initval);
David Brazdil0f672f62019-12-10 10:32:29 +0000691 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000692 status = -ETIMEDOUT;
693 }
Olivier Deprez157378f2022-04-04 15:47:50 +0200694 xprt_reset_minortimeo(req);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000695
696 if (req->rq_timeout == 0) {
697 printk(KERN_WARNING "xprt_adjust_timeout: rq_timeout = 0!\n");
698 req->rq_timeout = 5 * HZ;
699 }
700 return status;
701}
702
703static void xprt_autoclose(struct work_struct *work)
704{
705 struct rpc_xprt *xprt =
706 container_of(work, struct rpc_xprt, task_cleanup);
David Brazdil0f672f62019-12-10 10:32:29 +0000707 unsigned int pflags = memalloc_nofs_save();
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000708
Olivier Deprez157378f2022-04-04 15:47:50 +0200709 trace_xprt_disconnect_auto(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000710 clear_bit(XPRT_CLOSE_WAIT, &xprt->state);
711 xprt->ops->close(xprt);
712 xprt_release_write(xprt, NULL);
713 wake_up_bit(&xprt->state, XPRT_LOCKED);
David Brazdil0f672f62019-12-10 10:32:29 +0000714 memalloc_nofs_restore(pflags);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000715}
716
717/**
718 * xprt_disconnect_done - mark a transport as disconnected
719 * @xprt: transport to flag for disconnect
720 *
721 */
722void xprt_disconnect_done(struct rpc_xprt *xprt)
723{
Olivier Deprez157378f2022-04-04 15:47:50 +0200724 trace_xprt_disconnect_done(xprt);
David Brazdil0f672f62019-12-10 10:32:29 +0000725 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000726 xprt_clear_connected(xprt);
David Brazdil0f672f62019-12-10 10:32:29 +0000727 xprt_clear_write_space_locked(xprt);
728 xprt_clear_congestion_window_wait_locked(xprt);
729 xprt_wake_pending_tasks(xprt, -ENOTCONN);
730 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000731}
732EXPORT_SYMBOL_GPL(xprt_disconnect_done);
733
734/**
735 * xprt_force_disconnect - force a transport to disconnect
736 * @xprt: transport to disconnect
737 *
738 */
739void xprt_force_disconnect(struct rpc_xprt *xprt)
740{
Olivier Deprez157378f2022-04-04 15:47:50 +0200741 trace_xprt_disconnect_force(xprt);
742
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000743 /* Don't race with the test_bit() in xprt_clear_locked() */
David Brazdil0f672f62019-12-10 10:32:29 +0000744 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000745 set_bit(XPRT_CLOSE_WAIT, &xprt->state);
746 /* Try to schedule an autoclose RPC call */
747 if (test_and_set_bit(XPRT_LOCKED, &xprt->state) == 0)
748 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
Olivier Deprez0e641232021-09-23 10:07:05 +0200749 else if (xprt->snd_task && !test_bit(XPRT_SND_IS_COOKIE, &xprt->state))
David Brazdil0f672f62019-12-10 10:32:29 +0000750 rpc_wake_up_queued_task_set_status(&xprt->pending,
Olivier Deprez0e641232021-09-23 10:07:05 +0200751 xprt->snd_task, -ENOTCONN);
David Brazdil0f672f62019-12-10 10:32:29 +0000752 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000753}
754EXPORT_SYMBOL_GPL(xprt_force_disconnect);
755
David Brazdil0f672f62019-12-10 10:32:29 +0000756static unsigned int
757xprt_connect_cookie(struct rpc_xprt *xprt)
758{
759 return READ_ONCE(xprt->connect_cookie);
760}
761
762static bool
763xprt_request_retransmit_after_disconnect(struct rpc_task *task)
764{
765 struct rpc_rqst *req = task->tk_rqstp;
766 struct rpc_xprt *xprt = req->rq_xprt;
767
768 return req->rq_connect_cookie != xprt_connect_cookie(xprt) ||
769 !xprt_connected(xprt);
770}
771
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000772/**
773 * xprt_conditional_disconnect - force a transport to disconnect
774 * @xprt: transport to disconnect
775 * @cookie: 'connection cookie'
776 *
777 * This attempts to break the connection if and only if 'cookie' matches
778 * the current transport 'connection cookie'. It ensures that we don't
779 * try to break the connection more than once when we need to retransmit
780 * a batch of RPC requests.
781 *
782 */
783void xprt_conditional_disconnect(struct rpc_xprt *xprt, unsigned int cookie)
784{
785 /* Don't race with the test_bit() in xprt_clear_locked() */
David Brazdil0f672f62019-12-10 10:32:29 +0000786 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000787 if (cookie != xprt->connect_cookie)
788 goto out;
789 if (test_bit(XPRT_CLOSING, &xprt->state))
790 goto out;
791 set_bit(XPRT_CLOSE_WAIT, &xprt->state);
792 /* Try to schedule an autoclose RPC call */
793 if (test_and_set_bit(XPRT_LOCKED, &xprt->state) == 0)
794 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
795 xprt_wake_pending_tasks(xprt, -EAGAIN);
796out:
David Brazdil0f672f62019-12-10 10:32:29 +0000797 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000798}
799
800static bool
801xprt_has_timer(const struct rpc_xprt *xprt)
802{
803 return xprt->idle_timeout != 0;
804}
805
806static void
807xprt_schedule_autodisconnect(struct rpc_xprt *xprt)
808 __must_hold(&xprt->transport_lock)
809{
David Brazdil0f672f62019-12-10 10:32:29 +0000810 xprt->last_used = jiffies;
811 if (RB_EMPTY_ROOT(&xprt->recv_queue) && xprt_has_timer(xprt))
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000812 mod_timer(&xprt->timer, xprt->last_used + xprt->idle_timeout);
813}
814
815static void
816xprt_init_autodisconnect(struct timer_list *t)
817{
818 struct rpc_xprt *xprt = from_timer(xprt, t, timer);
819
David Brazdil0f672f62019-12-10 10:32:29 +0000820 if (!RB_EMPTY_ROOT(&xprt->recv_queue))
821 return;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000822 /* Reset xprt->last_used to avoid connect/autodisconnect cycling */
823 xprt->last_used = jiffies;
824 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
David Brazdil0f672f62019-12-10 10:32:29 +0000825 return;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000826 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000827}
828
829bool xprt_lock_connect(struct rpc_xprt *xprt,
830 struct rpc_task *task,
831 void *cookie)
832{
833 bool ret = false;
834
David Brazdil0f672f62019-12-10 10:32:29 +0000835 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000836 if (!test_bit(XPRT_LOCKED, &xprt->state))
837 goto out;
838 if (xprt->snd_task != task)
839 goto out;
Olivier Deprez0e641232021-09-23 10:07:05 +0200840 set_bit(XPRT_SND_IS_COOKIE, &xprt->state);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000841 xprt->snd_task = cookie;
842 ret = true;
843out:
David Brazdil0f672f62019-12-10 10:32:29 +0000844 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000845 return ret;
846}
Olivier Deprez157378f2022-04-04 15:47:50 +0200847EXPORT_SYMBOL_GPL(xprt_lock_connect);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000848
849void xprt_unlock_connect(struct rpc_xprt *xprt, void *cookie)
850{
David Brazdil0f672f62019-12-10 10:32:29 +0000851 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000852 if (xprt->snd_task != cookie)
853 goto out;
854 if (!test_bit(XPRT_LOCKED, &xprt->state))
855 goto out;
856 xprt->snd_task =NULL;
Olivier Deprez0e641232021-09-23 10:07:05 +0200857 clear_bit(XPRT_SND_IS_COOKIE, &xprt->state);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000858 xprt->ops->release_xprt(xprt, NULL);
859 xprt_schedule_autodisconnect(xprt);
860out:
David Brazdil0f672f62019-12-10 10:32:29 +0000861 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000862 wake_up_bit(&xprt->state, XPRT_LOCKED);
863}
Olivier Deprez157378f2022-04-04 15:47:50 +0200864EXPORT_SYMBOL_GPL(xprt_unlock_connect);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000865
866/**
867 * xprt_connect - schedule a transport connect operation
868 * @task: RPC task that is requesting the connect
869 *
870 */
871void xprt_connect(struct rpc_task *task)
872{
873 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
874
Olivier Deprez157378f2022-04-04 15:47:50 +0200875 trace_xprt_connect(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000876
877 if (!xprt_bound(xprt)) {
878 task->tk_status = -EAGAIN;
879 return;
880 }
881 if (!xprt_lock_write(xprt, task))
882 return;
883
Olivier Deprez157378f2022-04-04 15:47:50 +0200884 if (test_and_clear_bit(XPRT_CLOSE_WAIT, &xprt->state)) {
885 trace_xprt_disconnect_cleanup(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000886 xprt->ops->close(xprt);
Olivier Deprez157378f2022-04-04 15:47:50 +0200887 }
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000888
889 if (!xprt_connected(xprt)) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000890 task->tk_rqstp->rq_connect_cookie = xprt->connect_cookie;
David Brazdil0f672f62019-12-10 10:32:29 +0000891 rpc_sleep_on_timeout(&xprt->pending, task, NULL,
892 xprt_request_timeout(task->tk_rqstp));
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000893
894 if (test_bit(XPRT_CLOSING, &xprt->state))
895 return;
896 if (xprt_test_and_set_connecting(xprt))
897 return;
898 /* Race breaker */
899 if (!xprt_connected(xprt)) {
900 xprt->stat.connect_start = jiffies;
901 xprt->ops->connect(xprt, task);
902 } else {
903 xprt_clear_connecting(xprt);
904 task->tk_status = 0;
905 rpc_wake_up_queued_task(&xprt->pending, task);
906 }
907 }
908 xprt_release_write(xprt, task);
909}
910
David Brazdil0f672f62019-12-10 10:32:29 +0000911/**
912 * xprt_reconnect_delay - compute the wait before scheduling a connect
913 * @xprt: transport instance
914 *
915 */
916unsigned long xprt_reconnect_delay(const struct rpc_xprt *xprt)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000917{
David Brazdil0f672f62019-12-10 10:32:29 +0000918 unsigned long start, now = jiffies;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000919
David Brazdil0f672f62019-12-10 10:32:29 +0000920 start = xprt->stat.connect_start + xprt->reestablish_timeout;
921 if (time_after(start, now))
922 return start - now;
923 return 0;
924}
925EXPORT_SYMBOL_GPL(xprt_reconnect_delay);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000926
David Brazdil0f672f62019-12-10 10:32:29 +0000927/**
928 * xprt_reconnect_backoff - compute the new re-establish timeout
929 * @xprt: transport instance
930 * @init_to: initial reestablish timeout
931 *
932 */
933void xprt_reconnect_backoff(struct rpc_xprt *xprt, unsigned long init_to)
934{
935 xprt->reestablish_timeout <<= 1;
936 if (xprt->reestablish_timeout > xprt->max_reconnect_timeout)
937 xprt->reestablish_timeout = xprt->max_reconnect_timeout;
938 if (xprt->reestablish_timeout < init_to)
939 xprt->reestablish_timeout = init_to;
940}
941EXPORT_SYMBOL_GPL(xprt_reconnect_backoff);
942
943enum xprt_xid_rb_cmp {
944 XID_RB_EQUAL,
945 XID_RB_LEFT,
946 XID_RB_RIGHT,
947};
948static enum xprt_xid_rb_cmp
949xprt_xid_cmp(__be32 xid1, __be32 xid2)
950{
951 if (xid1 == xid2)
952 return XID_RB_EQUAL;
953 if ((__force u32)xid1 < (__force u32)xid2)
954 return XID_RB_LEFT;
955 return XID_RB_RIGHT;
956}
957
958static struct rpc_rqst *
959xprt_request_rb_find(struct rpc_xprt *xprt, __be32 xid)
960{
961 struct rb_node *n = xprt->recv_queue.rb_node;
962 struct rpc_rqst *req;
963
964 while (n != NULL) {
965 req = rb_entry(n, struct rpc_rqst, rq_recv);
966 switch (xprt_xid_cmp(xid, req->rq_xid)) {
967 case XID_RB_LEFT:
968 n = n->rb_left;
969 break;
970 case XID_RB_RIGHT:
971 n = n->rb_right;
972 break;
973 case XID_RB_EQUAL:
974 return req;
975 }
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000976 }
David Brazdil0f672f62019-12-10 10:32:29 +0000977 return NULL;
978}
979
980static void
981xprt_request_rb_insert(struct rpc_xprt *xprt, struct rpc_rqst *new)
982{
983 struct rb_node **p = &xprt->recv_queue.rb_node;
984 struct rb_node *n = NULL;
985 struct rpc_rqst *req;
986
987 while (*p != NULL) {
988 n = *p;
989 req = rb_entry(n, struct rpc_rqst, rq_recv);
990 switch(xprt_xid_cmp(new->rq_xid, req->rq_xid)) {
991 case XID_RB_LEFT:
992 p = &n->rb_left;
993 break;
994 case XID_RB_RIGHT:
995 p = &n->rb_right;
996 break;
997 case XID_RB_EQUAL:
998 WARN_ON_ONCE(new != req);
999 return;
1000 }
1001 }
1002 rb_link_node(&new->rq_recv, n, p);
1003 rb_insert_color(&new->rq_recv, &xprt->recv_queue);
1004}
1005
1006static void
1007xprt_request_rb_remove(struct rpc_xprt *xprt, struct rpc_rqst *req)
1008{
1009 rb_erase(&req->rq_recv, &xprt->recv_queue);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001010}
1011
1012/**
1013 * xprt_lookup_rqst - find an RPC request corresponding to an XID
1014 * @xprt: transport on which the original request was transmitted
1015 * @xid: RPC XID of incoming reply
1016 *
David Brazdil0f672f62019-12-10 10:32:29 +00001017 * Caller holds xprt->queue_lock.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001018 */
1019struct rpc_rqst *xprt_lookup_rqst(struct rpc_xprt *xprt, __be32 xid)
1020{
1021 struct rpc_rqst *entry;
1022
David Brazdil0f672f62019-12-10 10:32:29 +00001023 entry = xprt_request_rb_find(xprt, xid);
1024 if (entry != NULL) {
1025 trace_xprt_lookup_rqst(xprt, xid, 0);
1026 entry->rq_rtt = ktime_sub(ktime_get(), entry->rq_xtime);
1027 return entry;
1028 }
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001029
1030 dprintk("RPC: xprt_lookup_rqst did not find xid %08x\n",
1031 ntohl(xid));
1032 trace_xprt_lookup_rqst(xprt, xid, -ENOENT);
1033 xprt->stat.bad_xids++;
1034 return NULL;
1035}
1036EXPORT_SYMBOL_GPL(xprt_lookup_rqst);
1037
David Brazdil0f672f62019-12-10 10:32:29 +00001038static bool
1039xprt_is_pinned_rqst(struct rpc_rqst *req)
1040{
1041 return atomic_read(&req->rq_pin) != 0;
1042}
1043
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001044/**
1045 * xprt_pin_rqst - Pin a request on the transport receive list
1046 * @req: Request to pin
1047 *
1048 * Caller must ensure this is atomic with the call to xprt_lookup_rqst()
David Brazdil0f672f62019-12-10 10:32:29 +00001049 * so should be holding xprt->queue_lock.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001050 */
1051void xprt_pin_rqst(struct rpc_rqst *req)
1052{
David Brazdil0f672f62019-12-10 10:32:29 +00001053 atomic_inc(&req->rq_pin);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001054}
1055EXPORT_SYMBOL_GPL(xprt_pin_rqst);
1056
1057/**
1058 * xprt_unpin_rqst - Unpin a request on the transport receive list
1059 * @req: Request to pin
1060 *
David Brazdil0f672f62019-12-10 10:32:29 +00001061 * Caller should be holding xprt->queue_lock.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001062 */
1063void xprt_unpin_rqst(struct rpc_rqst *req)
1064{
David Brazdil0f672f62019-12-10 10:32:29 +00001065 if (!test_bit(RPC_TASK_MSG_PIN_WAIT, &req->rq_task->tk_runstate)) {
1066 atomic_dec(&req->rq_pin);
1067 return;
1068 }
1069 if (atomic_dec_and_test(&req->rq_pin))
1070 wake_up_var(&req->rq_pin);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001071}
1072EXPORT_SYMBOL_GPL(xprt_unpin_rqst);
1073
1074static void xprt_wait_on_pinned_rqst(struct rpc_rqst *req)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001075{
David Brazdil0f672f62019-12-10 10:32:29 +00001076 wait_var_event(&req->rq_pin, !xprt_is_pinned_rqst(req));
1077}
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001078
David Brazdil0f672f62019-12-10 10:32:29 +00001079static bool
1080xprt_request_data_received(struct rpc_task *task)
1081{
1082 return !test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) &&
1083 READ_ONCE(task->tk_rqstp->rq_reply_bytes_recvd) != 0;
1084}
1085
1086static bool
1087xprt_request_need_enqueue_receive(struct rpc_task *task, struct rpc_rqst *req)
1088{
1089 return !test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) &&
1090 READ_ONCE(task->tk_rqstp->rq_reply_bytes_recvd) == 0;
1091}
1092
1093/**
1094 * xprt_request_enqueue_receive - Add an request to the receive queue
1095 * @task: RPC task
1096 *
1097 */
1098void
1099xprt_request_enqueue_receive(struct rpc_task *task)
1100{
1101 struct rpc_rqst *req = task->tk_rqstp;
1102 struct rpc_xprt *xprt = req->rq_xprt;
1103
1104 if (!xprt_request_need_enqueue_receive(task, req))
1105 return;
1106
1107 xprt_request_prepare(task->tk_rqstp);
1108 spin_lock(&xprt->queue_lock);
1109
1110 /* Update the softirq receive buffer */
1111 memcpy(&req->rq_private_buf, &req->rq_rcv_buf,
1112 sizeof(req->rq_private_buf));
1113
1114 /* Add request to the receive list */
1115 xprt_request_rb_insert(xprt, req);
1116 set_bit(RPC_TASK_NEED_RECV, &task->tk_runstate);
1117 spin_unlock(&xprt->queue_lock);
1118
1119 /* Turn off autodisconnect */
1120 del_singleshot_timer_sync(&xprt->timer);
1121}
1122
1123/**
1124 * xprt_request_dequeue_receive_locked - Remove a request from the receive queue
1125 * @task: RPC task
1126 *
1127 * Caller must hold xprt->queue_lock.
1128 */
1129static void
1130xprt_request_dequeue_receive_locked(struct rpc_task *task)
1131{
1132 struct rpc_rqst *req = task->tk_rqstp;
1133
1134 if (test_and_clear_bit(RPC_TASK_NEED_RECV, &task->tk_runstate))
1135 xprt_request_rb_remove(req->rq_xprt, req);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001136}
1137
1138/**
1139 * xprt_update_rtt - Update RPC RTT statistics
1140 * @task: RPC request that recently completed
1141 *
David Brazdil0f672f62019-12-10 10:32:29 +00001142 * Caller holds xprt->queue_lock.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001143 */
1144void xprt_update_rtt(struct rpc_task *task)
1145{
1146 struct rpc_rqst *req = task->tk_rqstp;
1147 struct rpc_rtt *rtt = task->tk_client->cl_rtt;
1148 unsigned int timer = task->tk_msg.rpc_proc->p_timer;
1149 long m = usecs_to_jiffies(ktime_to_us(req->rq_rtt));
1150
1151 if (timer) {
1152 if (req->rq_ntrans == 1)
1153 rpc_update_rtt(rtt, timer, m);
1154 rpc_set_timeo(rtt, timer, req->rq_ntrans - 1);
1155 }
1156}
1157EXPORT_SYMBOL_GPL(xprt_update_rtt);
1158
1159/**
1160 * xprt_complete_rqst - called when reply processing is complete
1161 * @task: RPC request that recently completed
1162 * @copied: actual number of bytes received from the transport
1163 *
David Brazdil0f672f62019-12-10 10:32:29 +00001164 * Caller holds xprt->queue_lock.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001165 */
1166void xprt_complete_rqst(struct rpc_task *task, int copied)
1167{
1168 struct rpc_rqst *req = task->tk_rqstp;
1169 struct rpc_xprt *xprt = req->rq_xprt;
1170
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001171 xprt->stat.recvs++;
1172
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001173 req->rq_private_buf.len = copied;
1174 /* Ensure all writes are done before we update */
1175 /* req->rq_reply_bytes_recvd */
1176 smp_wmb();
1177 req->rq_reply_bytes_recvd = copied;
David Brazdil0f672f62019-12-10 10:32:29 +00001178 xprt_request_dequeue_receive_locked(task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001179 rpc_wake_up_queued_task(&xprt->pending, task);
1180}
1181EXPORT_SYMBOL_GPL(xprt_complete_rqst);
1182
1183static void xprt_timer(struct rpc_task *task)
1184{
1185 struct rpc_rqst *req = task->tk_rqstp;
1186 struct rpc_xprt *xprt = req->rq_xprt;
1187
1188 if (task->tk_status != -ETIMEDOUT)
1189 return;
1190
1191 trace_xprt_timer(xprt, req->rq_xid, task->tk_status);
1192 if (!req->rq_reply_bytes_recvd) {
1193 if (xprt->ops->timer)
1194 xprt->ops->timer(xprt, task);
1195 } else
1196 task->tk_status = 0;
1197}
1198
1199/**
David Brazdil0f672f62019-12-10 10:32:29 +00001200 * xprt_wait_for_reply_request_def - wait for reply
1201 * @task: pointer to rpc_task
1202 *
1203 * Set a request's retransmit timeout based on the transport's
1204 * default timeout parameters. Used by transports that don't adjust
1205 * the retransmit timeout based on round-trip time estimation,
1206 * and put the task to sleep on the pending queue.
1207 */
1208void xprt_wait_for_reply_request_def(struct rpc_task *task)
1209{
1210 struct rpc_rqst *req = task->tk_rqstp;
1211
1212 rpc_sleep_on_timeout(&req->rq_xprt->pending, task, xprt_timer,
1213 xprt_request_timeout(req));
1214}
1215EXPORT_SYMBOL_GPL(xprt_wait_for_reply_request_def);
1216
1217/**
1218 * xprt_wait_for_reply_request_rtt - wait for reply using RTT estimator
1219 * @task: pointer to rpc_task
1220 *
1221 * Set a request's retransmit timeout using the RTT estimator,
1222 * and put the task to sleep on the pending queue.
1223 */
1224void xprt_wait_for_reply_request_rtt(struct rpc_task *task)
1225{
1226 int timer = task->tk_msg.rpc_proc->p_timer;
1227 struct rpc_clnt *clnt = task->tk_client;
1228 struct rpc_rtt *rtt = clnt->cl_rtt;
1229 struct rpc_rqst *req = task->tk_rqstp;
1230 unsigned long max_timeout = clnt->cl_timeout->to_maxval;
1231 unsigned long timeout;
1232
1233 timeout = rpc_calc_rto(rtt, timer);
1234 timeout <<= rpc_ntimeo(rtt, timer) + req->rq_retries;
1235 if (timeout > max_timeout || timeout == 0)
1236 timeout = max_timeout;
1237 rpc_sleep_on_timeout(&req->rq_xprt->pending, task, xprt_timer,
1238 jiffies + timeout);
1239}
1240EXPORT_SYMBOL_GPL(xprt_wait_for_reply_request_rtt);
1241
1242/**
1243 * xprt_request_wait_receive - wait for the reply to an RPC request
1244 * @task: RPC task about to send a request
1245 *
1246 */
1247void xprt_request_wait_receive(struct rpc_task *task)
1248{
1249 struct rpc_rqst *req = task->tk_rqstp;
1250 struct rpc_xprt *xprt = req->rq_xprt;
1251
1252 if (!test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate))
1253 return;
1254 /*
1255 * Sleep on the pending queue if we're expecting a reply.
1256 * The spinlock ensures atomicity between the test of
1257 * req->rq_reply_bytes_recvd, and the call to rpc_sleep_on().
1258 */
1259 spin_lock(&xprt->queue_lock);
1260 if (test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate)) {
1261 xprt->ops->wait_for_reply_request(task);
1262 /*
1263 * Send an extra queue wakeup call if the
1264 * connection was dropped in case the call to
1265 * rpc_sleep_on() raced.
1266 */
1267 if (xprt_request_retransmit_after_disconnect(task))
1268 rpc_wake_up_queued_task_set_status(&xprt->pending,
1269 task, -ENOTCONN);
1270 }
1271 spin_unlock(&xprt->queue_lock);
1272}
1273
1274static bool
1275xprt_request_need_enqueue_transmit(struct rpc_task *task, struct rpc_rqst *req)
1276{
1277 return !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
1278}
1279
1280/**
1281 * xprt_request_enqueue_transmit - queue a task for transmission
1282 * @task: pointer to rpc_task
1283 *
1284 * Add a task to the transmission queue.
1285 */
1286void
1287xprt_request_enqueue_transmit(struct rpc_task *task)
1288{
1289 struct rpc_rqst *pos, *req = task->tk_rqstp;
1290 struct rpc_xprt *xprt = req->rq_xprt;
1291
1292 if (xprt_request_need_enqueue_transmit(task, req)) {
1293 req->rq_bytes_sent = 0;
1294 spin_lock(&xprt->queue_lock);
1295 /*
1296 * Requests that carry congestion control credits are added
1297 * to the head of the list to avoid starvation issues.
1298 */
1299 if (req->rq_cong) {
1300 xprt_clear_congestion_window_wait(xprt);
1301 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1302 if (pos->rq_cong)
1303 continue;
1304 /* Note: req is added _before_ pos */
1305 list_add_tail(&req->rq_xmit, &pos->rq_xmit);
1306 INIT_LIST_HEAD(&req->rq_xmit2);
David Brazdil0f672f62019-12-10 10:32:29 +00001307 goto out;
1308 }
1309 } else if (RPC_IS_SWAPPER(task)) {
1310 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1311 if (pos->rq_cong || pos->rq_bytes_sent)
1312 continue;
1313 if (RPC_IS_SWAPPER(pos->rq_task))
1314 continue;
1315 /* Note: req is added _before_ pos */
1316 list_add_tail(&req->rq_xmit, &pos->rq_xmit);
1317 INIT_LIST_HEAD(&req->rq_xmit2);
David Brazdil0f672f62019-12-10 10:32:29 +00001318 goto out;
1319 }
1320 } else if (!req->rq_seqno) {
1321 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1322 if (pos->rq_task->tk_owner != task->tk_owner)
1323 continue;
1324 list_add_tail(&req->rq_xmit2, &pos->rq_xmit2);
1325 INIT_LIST_HEAD(&req->rq_xmit);
David Brazdil0f672f62019-12-10 10:32:29 +00001326 goto out;
1327 }
1328 }
1329 list_add_tail(&req->rq_xmit, &xprt->xmit_queue);
1330 INIT_LIST_HEAD(&req->rq_xmit2);
David Brazdil0f672f62019-12-10 10:32:29 +00001331out:
1332 set_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
1333 spin_unlock(&xprt->queue_lock);
1334 }
1335}
1336
1337/**
1338 * xprt_request_dequeue_transmit_locked - remove a task from the transmission queue
1339 * @task: pointer to rpc_task
1340 *
1341 * Remove a task from the transmission queue
1342 * Caller must hold xprt->queue_lock
1343 */
1344static void
1345xprt_request_dequeue_transmit_locked(struct rpc_task *task)
1346{
1347 struct rpc_rqst *req = task->tk_rqstp;
1348
1349 if (!test_and_clear_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1350 return;
1351 if (!list_empty(&req->rq_xmit)) {
1352 list_del(&req->rq_xmit);
1353 if (!list_empty(&req->rq_xmit2)) {
1354 struct rpc_rqst *next = list_first_entry(&req->rq_xmit2,
1355 struct rpc_rqst, rq_xmit2);
1356 list_del(&req->rq_xmit2);
1357 list_add_tail(&next->rq_xmit, &next->rq_xprt->xmit_queue);
1358 }
1359 } else
1360 list_del(&req->rq_xmit2);
1361}
1362
1363/**
1364 * xprt_request_dequeue_transmit - remove a task from the transmission queue
1365 * @task: pointer to rpc_task
1366 *
1367 * Remove a task from the transmission queue
1368 */
1369static void
1370xprt_request_dequeue_transmit(struct rpc_task *task)
1371{
1372 struct rpc_rqst *req = task->tk_rqstp;
1373 struct rpc_xprt *xprt = req->rq_xprt;
1374
1375 spin_lock(&xprt->queue_lock);
1376 xprt_request_dequeue_transmit_locked(task);
1377 spin_unlock(&xprt->queue_lock);
1378}
1379
1380/**
1381 * xprt_request_dequeue_xprt - remove a task from the transmit+receive queue
1382 * @task: pointer to rpc_task
1383 *
1384 * Remove a task from the transmit and receive queues, and ensure that
1385 * it is not pinned by the receive work item.
1386 */
1387void
1388xprt_request_dequeue_xprt(struct rpc_task *task)
1389{
1390 struct rpc_rqst *req = task->tk_rqstp;
1391 struct rpc_xprt *xprt = req->rq_xprt;
1392
1393 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate) ||
1394 test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) ||
1395 xprt_is_pinned_rqst(req)) {
1396 spin_lock(&xprt->queue_lock);
1397 xprt_request_dequeue_transmit_locked(task);
1398 xprt_request_dequeue_receive_locked(task);
1399 while (xprt_is_pinned_rqst(req)) {
1400 set_bit(RPC_TASK_MSG_PIN_WAIT, &task->tk_runstate);
1401 spin_unlock(&xprt->queue_lock);
1402 xprt_wait_on_pinned_rqst(req);
1403 spin_lock(&xprt->queue_lock);
1404 clear_bit(RPC_TASK_MSG_PIN_WAIT, &task->tk_runstate);
1405 }
1406 spin_unlock(&xprt->queue_lock);
1407 }
1408}
1409
1410/**
1411 * xprt_request_prepare - prepare an encoded request for transport
1412 * @req: pointer to rpc_rqst
1413 *
1414 * Calls into the transport layer to do whatever is needed to prepare
1415 * the request for transmission or receive.
1416 */
1417void
1418xprt_request_prepare(struct rpc_rqst *req)
1419{
1420 struct rpc_xprt *xprt = req->rq_xprt;
1421
1422 if (xprt->ops->prepare_request)
1423 xprt->ops->prepare_request(req);
1424}
1425
1426/**
1427 * xprt_request_need_retransmit - Test if a task needs retransmission
1428 * @task: pointer to rpc_task
1429 *
1430 * Test for whether a connection breakage requires the task to retransmit
1431 */
1432bool
1433xprt_request_need_retransmit(struct rpc_task *task)
1434{
1435 return xprt_request_retransmit_after_disconnect(task);
1436}
1437
1438/**
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001439 * xprt_prepare_transmit - reserve the transport before sending a request
1440 * @task: RPC task about to send a request
1441 *
1442 */
1443bool xprt_prepare_transmit(struct rpc_task *task)
1444{
1445 struct rpc_rqst *req = task->tk_rqstp;
1446 struct rpc_xprt *xprt = req->rq_xprt;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001447
David Brazdil0f672f62019-12-10 10:32:29 +00001448 if (!xprt_lock_write(xprt, task)) {
1449 /* Race breaker: someone may have transmitted us */
1450 if (!test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1451 rpc_wake_up_queued_task_set_status(&xprt->sending,
1452 task, 0);
1453 return false;
1454
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001455 }
David Brazdil0f672f62019-12-10 10:32:29 +00001456 return true;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001457}
1458
1459void xprt_end_transmit(struct rpc_task *task)
1460{
Olivier Deprez157378f2022-04-04 15:47:50 +02001461 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
1462
1463 xprt_inject_disconnect(xprt);
1464 xprt_release_write(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001465}
1466
1467/**
David Brazdil0f672f62019-12-10 10:32:29 +00001468 * xprt_request_transmit - send an RPC request on a transport
1469 * @req: pointer to request to transmit
1470 * @snd_task: RPC task that owns the transport lock
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001471 *
David Brazdil0f672f62019-12-10 10:32:29 +00001472 * This performs the transmission of a single request.
1473 * Note that if the request is not the same as snd_task, then it
1474 * does need to be pinned.
1475 * Returns '0' on success.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001476 */
David Brazdil0f672f62019-12-10 10:32:29 +00001477static int
1478xprt_request_transmit(struct rpc_rqst *req, struct rpc_task *snd_task)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001479{
David Brazdil0f672f62019-12-10 10:32:29 +00001480 struct rpc_xprt *xprt = req->rq_xprt;
1481 struct rpc_task *task = req->rq_task;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001482 unsigned int connect_cookie;
David Brazdil0f672f62019-12-10 10:32:29 +00001483 int is_retrans = RPC_WAS_SENT(task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001484 int status;
1485
David Brazdil0f672f62019-12-10 10:32:29 +00001486 if (!req->rq_bytes_sent) {
1487 if (xprt_request_data_received(task)) {
1488 status = 0;
1489 goto out_dequeue;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001490 }
David Brazdil0f672f62019-12-10 10:32:29 +00001491 /* Verify that our message lies in the RPCSEC_GSS window */
1492 if (rpcauth_xmit_need_reencode(task)) {
1493 status = -EBADMSG;
1494 goto out_dequeue;
1495 }
1496 if (RPC_SIGNALLED(task)) {
1497 status = -ERESTARTSYS;
1498 goto out_dequeue;
1499 }
1500 }
1501
1502 /*
1503 * Update req->rq_ntrans before transmitting to avoid races with
1504 * xprt_update_rtt(), which needs to know that it is recording a
1505 * reply to the first transmission.
1506 */
1507 req->rq_ntrans++;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001508
Olivier Deprez157378f2022-04-04 15:47:50 +02001509 trace_rpc_xdr_sendto(task, &req->rq_snd_buf);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001510 connect_cookie = xprt->connect_cookie;
David Brazdil0f672f62019-12-10 10:32:29 +00001511 status = xprt->ops->send_request(req);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001512 if (status != 0) {
David Brazdil0f672f62019-12-10 10:32:29 +00001513 req->rq_ntrans--;
1514 trace_xprt_transmit(req, status);
1515 return status;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001516 }
David Brazdil0f672f62019-12-10 10:32:29 +00001517
1518 if (is_retrans)
1519 task->tk_client->cl_stats->rpcretrans++;
1520
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001521 xprt_inject_disconnect(xprt);
1522
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001523 task->tk_flags |= RPC_TASK_SENT;
David Brazdil0f672f62019-12-10 10:32:29 +00001524 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001525
1526 xprt->stat.sends++;
1527 xprt->stat.req_u += xprt->stat.sends - xprt->stat.recvs;
1528 xprt->stat.bklog_u += xprt->backlog.qlen;
1529 xprt->stat.sending_u += xprt->sending.qlen;
1530 xprt->stat.pending_u += xprt->pending.qlen;
David Brazdil0f672f62019-12-10 10:32:29 +00001531 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001532
1533 req->rq_connect_cookie = connect_cookie;
David Brazdil0f672f62019-12-10 10:32:29 +00001534out_dequeue:
1535 trace_xprt_transmit(req, status);
1536 xprt_request_dequeue_transmit(task);
1537 rpc_wake_up_queued_task_set_status(&xprt->sending, task, status);
1538 return status;
1539}
1540
1541/**
1542 * xprt_transmit - send an RPC request on a transport
1543 * @task: controlling RPC task
1544 *
1545 * Attempts to drain the transmit queue. On exit, either the transport
1546 * signalled an error that needs to be handled before transmission can
1547 * resume, or @task finished transmitting, and detected that it already
1548 * received a reply.
1549 */
1550void
1551xprt_transmit(struct rpc_task *task)
1552{
1553 struct rpc_rqst *next, *req = task->tk_rqstp;
1554 struct rpc_xprt *xprt = req->rq_xprt;
Olivier Deprez157378f2022-04-04 15:47:50 +02001555 int status;
David Brazdil0f672f62019-12-10 10:32:29 +00001556
1557 spin_lock(&xprt->queue_lock);
Olivier Deprez157378f2022-04-04 15:47:50 +02001558 for (;;) {
1559 next = list_first_entry_or_null(&xprt->xmit_queue,
1560 struct rpc_rqst, rq_xmit);
1561 if (!next)
Olivier Deprez0e641232021-09-23 10:07:05 +02001562 break;
David Brazdil0f672f62019-12-10 10:32:29 +00001563 xprt_pin_rqst(next);
1564 spin_unlock(&xprt->queue_lock);
1565 status = xprt_request_transmit(next, task);
1566 if (status == -EBADMSG && next != req)
1567 status = 0;
David Brazdil0f672f62019-12-10 10:32:29 +00001568 spin_lock(&xprt->queue_lock);
1569 xprt_unpin_rqst(next);
Olivier Deprez157378f2022-04-04 15:47:50 +02001570 if (status < 0) {
1571 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1572 task->tk_status = status;
1573 break;
1574 }
1575 /* Was @task transmitted, and has it received a reply? */
1576 if (xprt_request_data_received(task) &&
1577 !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1578 break;
1579 cond_resched_lock(&xprt->queue_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001580 }
David Brazdil0f672f62019-12-10 10:32:29 +00001581 spin_unlock(&xprt->queue_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001582}
1583
Olivier Deprez157378f2022-04-04 15:47:50 +02001584static void xprt_complete_request_init(struct rpc_task *task)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001585{
Olivier Deprez157378f2022-04-04 15:47:50 +02001586 if (task->tk_rqstp)
1587 xprt_request_init(task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001588}
1589
Olivier Deprez157378f2022-04-04 15:47:50 +02001590void xprt_add_backlog(struct rpc_xprt *xprt, struct rpc_task *task)
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001591{
Olivier Deprez157378f2022-04-04 15:47:50 +02001592 set_bit(XPRT_CONGESTED, &xprt->state);
1593 rpc_sleep_on(&xprt->backlog, task, xprt_complete_request_init);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001594}
Olivier Deprez157378f2022-04-04 15:47:50 +02001595EXPORT_SYMBOL_GPL(xprt_add_backlog);
1596
1597static bool __xprt_set_rq(struct rpc_task *task, void *data)
1598{
1599 struct rpc_rqst *req = data;
1600
1601 if (task->tk_rqstp == NULL) {
1602 memset(req, 0, sizeof(*req)); /* mark unused */
1603 task->tk_rqstp = req;
1604 return true;
1605 }
1606 return false;
1607}
1608
1609bool xprt_wake_up_backlog(struct rpc_xprt *xprt, struct rpc_rqst *req)
1610{
1611 if (rpc_wake_up_first(&xprt->backlog, __xprt_set_rq, req) == NULL) {
1612 clear_bit(XPRT_CONGESTED, &xprt->state);
1613 return false;
1614 }
1615 return true;
1616}
1617EXPORT_SYMBOL_GPL(xprt_wake_up_backlog);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001618
1619static bool xprt_throttle_congested(struct rpc_xprt *xprt, struct rpc_task *task)
1620{
1621 bool ret = false;
1622
1623 if (!test_bit(XPRT_CONGESTED, &xprt->state))
1624 goto out;
1625 spin_lock(&xprt->reserve_lock);
1626 if (test_bit(XPRT_CONGESTED, &xprt->state)) {
Olivier Deprez157378f2022-04-04 15:47:50 +02001627 xprt_add_backlog(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001628 ret = true;
1629 }
1630 spin_unlock(&xprt->reserve_lock);
1631out:
1632 return ret;
1633}
1634
1635static struct rpc_rqst *xprt_dynamic_alloc_slot(struct rpc_xprt *xprt)
1636{
1637 struct rpc_rqst *req = ERR_PTR(-EAGAIN);
1638
1639 if (xprt->num_reqs >= xprt->max_reqs)
1640 goto out;
1641 ++xprt->num_reqs;
1642 spin_unlock(&xprt->reserve_lock);
1643 req = kzalloc(sizeof(struct rpc_rqst), GFP_NOFS);
1644 spin_lock(&xprt->reserve_lock);
1645 if (req != NULL)
1646 goto out;
1647 --xprt->num_reqs;
1648 req = ERR_PTR(-ENOMEM);
1649out:
1650 return req;
1651}
1652
1653static bool xprt_dynamic_free_slot(struct rpc_xprt *xprt, struct rpc_rqst *req)
1654{
1655 if (xprt->num_reqs > xprt->min_reqs) {
1656 --xprt->num_reqs;
1657 kfree(req);
1658 return true;
1659 }
1660 return false;
1661}
1662
1663void xprt_alloc_slot(struct rpc_xprt *xprt, struct rpc_task *task)
1664{
1665 struct rpc_rqst *req;
1666
1667 spin_lock(&xprt->reserve_lock);
1668 if (!list_empty(&xprt->free)) {
1669 req = list_entry(xprt->free.next, struct rpc_rqst, rq_list);
1670 list_del(&req->rq_list);
1671 goto out_init_req;
1672 }
1673 req = xprt_dynamic_alloc_slot(xprt);
1674 if (!IS_ERR(req))
1675 goto out_init_req;
1676 switch (PTR_ERR(req)) {
1677 case -ENOMEM:
1678 dprintk("RPC: dynamic allocation of request slot "
1679 "failed! Retrying\n");
1680 task->tk_status = -ENOMEM;
1681 break;
1682 case -EAGAIN:
1683 xprt_add_backlog(xprt, task);
1684 dprintk("RPC: waiting for request slot\n");
Olivier Deprez157378f2022-04-04 15:47:50 +02001685 fallthrough;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001686 default:
1687 task->tk_status = -EAGAIN;
1688 }
1689 spin_unlock(&xprt->reserve_lock);
1690 return;
1691out_init_req:
1692 xprt->stat.max_slots = max_t(unsigned int, xprt->stat.max_slots,
1693 xprt->num_reqs);
1694 spin_unlock(&xprt->reserve_lock);
1695
1696 task->tk_status = 0;
1697 task->tk_rqstp = req;
1698}
1699EXPORT_SYMBOL_GPL(xprt_alloc_slot);
1700
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001701void xprt_free_slot(struct rpc_xprt *xprt, struct rpc_rqst *req)
1702{
1703 spin_lock(&xprt->reserve_lock);
Olivier Deprez157378f2022-04-04 15:47:50 +02001704 if (!xprt_wake_up_backlog(xprt, req) &&
1705 !xprt_dynamic_free_slot(xprt, req)) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001706 memset(req, 0, sizeof(*req)); /* mark unused */
1707 list_add(&req->rq_list, &xprt->free);
1708 }
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001709 spin_unlock(&xprt->reserve_lock);
1710}
1711EXPORT_SYMBOL_GPL(xprt_free_slot);
1712
1713static void xprt_free_all_slots(struct rpc_xprt *xprt)
1714{
1715 struct rpc_rqst *req;
1716 while (!list_empty(&xprt->free)) {
1717 req = list_first_entry(&xprt->free, struct rpc_rqst, rq_list);
1718 list_del(&req->rq_list);
1719 kfree(req);
1720 }
1721}
1722
1723struct rpc_xprt *xprt_alloc(struct net *net, size_t size,
1724 unsigned int num_prealloc,
1725 unsigned int max_alloc)
1726{
1727 struct rpc_xprt *xprt;
1728 struct rpc_rqst *req;
1729 int i;
1730
1731 xprt = kzalloc(size, GFP_KERNEL);
1732 if (xprt == NULL)
1733 goto out;
1734
1735 xprt_init(xprt, net);
1736
1737 for (i = 0; i < num_prealloc; i++) {
1738 req = kzalloc(sizeof(struct rpc_rqst), GFP_KERNEL);
1739 if (!req)
1740 goto out_free;
1741 list_add(&req->rq_list, &xprt->free);
1742 }
1743 if (max_alloc > num_prealloc)
1744 xprt->max_reqs = max_alloc;
1745 else
1746 xprt->max_reqs = num_prealloc;
1747 xprt->min_reqs = num_prealloc;
1748 xprt->num_reqs = num_prealloc;
1749
1750 return xprt;
1751
1752out_free:
1753 xprt_free(xprt);
1754out:
1755 return NULL;
1756}
1757EXPORT_SYMBOL_GPL(xprt_alloc);
1758
1759void xprt_free(struct rpc_xprt *xprt)
1760{
1761 put_net(xprt->xprt_net);
1762 xprt_free_all_slots(xprt);
1763 kfree_rcu(xprt, rcu);
1764}
1765EXPORT_SYMBOL_GPL(xprt_free);
1766
David Brazdil0f672f62019-12-10 10:32:29 +00001767static void
1768xprt_init_connect_cookie(struct rpc_rqst *req, struct rpc_xprt *xprt)
1769{
1770 req->rq_connect_cookie = xprt_connect_cookie(xprt) - 1;
1771}
1772
1773static __be32
1774xprt_alloc_xid(struct rpc_xprt *xprt)
1775{
1776 __be32 xid;
1777
1778 spin_lock(&xprt->reserve_lock);
1779 xid = (__force __be32)xprt->xid++;
1780 spin_unlock(&xprt->reserve_lock);
1781 return xid;
1782}
1783
1784static void
1785xprt_init_xid(struct rpc_xprt *xprt)
1786{
1787 xprt->xid = prandom_u32();
1788}
1789
1790static void
1791xprt_request_init(struct rpc_task *task)
1792{
1793 struct rpc_xprt *xprt = task->tk_xprt;
1794 struct rpc_rqst *req = task->tk_rqstp;
1795
1796 req->rq_task = task;
1797 req->rq_xprt = xprt;
1798 req->rq_buffer = NULL;
1799 req->rq_xid = xprt_alloc_xid(xprt);
1800 xprt_init_connect_cookie(req, xprt);
1801 req->rq_snd_buf.len = 0;
1802 req->rq_snd_buf.buflen = 0;
1803 req->rq_rcv_buf.len = 0;
1804 req->rq_rcv_buf.buflen = 0;
1805 req->rq_snd_buf.bvec = NULL;
1806 req->rq_rcv_buf.bvec = NULL;
1807 req->rq_release_snd_buf = NULL;
1808 xprt_init_majortimeo(task, req);
Olivier Deprez157378f2022-04-04 15:47:50 +02001809
1810 trace_xprt_reserve(req);
David Brazdil0f672f62019-12-10 10:32:29 +00001811}
1812
1813static void
1814xprt_do_reserve(struct rpc_xprt *xprt, struct rpc_task *task)
1815{
1816 xprt->ops->alloc_slot(xprt, task);
1817 if (task->tk_rqstp != NULL)
1818 xprt_request_init(task);
1819}
1820
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001821/**
1822 * xprt_reserve - allocate an RPC request slot
1823 * @task: RPC task requesting a slot allocation
1824 *
1825 * If the transport is marked as being congested, or if no more
1826 * slots are available, place the task on the transport's
1827 * backlog queue.
1828 */
1829void xprt_reserve(struct rpc_task *task)
1830{
1831 struct rpc_xprt *xprt = task->tk_xprt;
1832
1833 task->tk_status = 0;
1834 if (task->tk_rqstp != NULL)
1835 return;
1836
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001837 task->tk_status = -EAGAIN;
1838 if (!xprt_throttle_congested(xprt, task))
David Brazdil0f672f62019-12-10 10:32:29 +00001839 xprt_do_reserve(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001840}
1841
1842/**
1843 * xprt_retry_reserve - allocate an RPC request slot
1844 * @task: RPC task requesting a slot allocation
1845 *
1846 * If no more slots are available, place the task on the transport's
1847 * backlog queue.
1848 * Note that the only difference with xprt_reserve is that we now
1849 * ignore the value of the XPRT_CONGESTED flag.
1850 */
1851void xprt_retry_reserve(struct rpc_task *task)
1852{
1853 struct rpc_xprt *xprt = task->tk_xprt;
1854
1855 task->tk_status = 0;
1856 if (task->tk_rqstp != NULL)
1857 return;
1858
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001859 task->tk_status = -EAGAIN;
David Brazdil0f672f62019-12-10 10:32:29 +00001860 xprt_do_reserve(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001861}
1862
1863/**
1864 * xprt_release - release an RPC request slot
1865 * @task: task which is finished with the slot
1866 *
1867 */
1868void xprt_release(struct rpc_task *task)
1869{
1870 struct rpc_xprt *xprt;
1871 struct rpc_rqst *req = task->tk_rqstp;
1872
1873 if (req == NULL) {
1874 if (task->tk_client) {
1875 xprt = task->tk_xprt;
David Brazdil0f672f62019-12-10 10:32:29 +00001876 xprt_release_write(xprt, task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001877 }
1878 return;
1879 }
1880
1881 xprt = req->rq_xprt;
David Brazdil0f672f62019-12-10 10:32:29 +00001882 xprt_request_dequeue_xprt(task);
1883 spin_lock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001884 xprt->ops->release_xprt(xprt, task);
1885 if (xprt->ops->release_request)
1886 xprt->ops->release_request(task);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001887 xprt_schedule_autodisconnect(xprt);
David Brazdil0f672f62019-12-10 10:32:29 +00001888 spin_unlock(&xprt->transport_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001889 if (req->rq_buffer)
1890 xprt->ops->buf_free(task);
David Brazdil0f672f62019-12-10 10:32:29 +00001891 xdr_free_bvec(&req->rq_rcv_buf);
1892 xdr_free_bvec(&req->rq_snd_buf);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001893 if (req->rq_cred != NULL)
1894 put_rpccred(req->rq_cred);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001895 if (req->rq_release_snd_buf)
1896 req->rq_release_snd_buf(req);
1897
Olivier Deprez157378f2022-04-04 15:47:50 +02001898 task->tk_rqstp = NULL;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001899 if (likely(!bc_prealloc(req)))
1900 xprt->ops->free_slot(xprt, req);
1901 else
1902 xprt_free_bc_request(req);
1903}
1904
David Brazdil0f672f62019-12-10 10:32:29 +00001905#ifdef CONFIG_SUNRPC_BACKCHANNEL
1906void
1907xprt_init_bc_request(struct rpc_rqst *req, struct rpc_task *task)
1908{
1909 struct xdr_buf *xbufp = &req->rq_snd_buf;
1910
1911 task->tk_rqstp = req;
1912 req->rq_task = task;
1913 xprt_init_connect_cookie(req, req->rq_xprt);
1914 /*
1915 * Set up the xdr_buf length.
1916 * This also indicates that the buffer is XDR encoded already.
1917 */
1918 xbufp->len = xbufp->head[0].iov_len + xbufp->page_len +
1919 xbufp->tail[0].iov_len;
1920}
1921#endif
1922
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001923static void xprt_init(struct rpc_xprt *xprt, struct net *net)
1924{
1925 kref_init(&xprt->kref);
1926
1927 spin_lock_init(&xprt->transport_lock);
1928 spin_lock_init(&xprt->reserve_lock);
David Brazdil0f672f62019-12-10 10:32:29 +00001929 spin_lock_init(&xprt->queue_lock);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001930
1931 INIT_LIST_HEAD(&xprt->free);
David Brazdil0f672f62019-12-10 10:32:29 +00001932 xprt->recv_queue = RB_ROOT;
1933 INIT_LIST_HEAD(&xprt->xmit_queue);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001934#if defined(CONFIG_SUNRPC_BACKCHANNEL)
1935 spin_lock_init(&xprt->bc_pa_lock);
1936 INIT_LIST_HEAD(&xprt->bc_pa_list);
1937#endif /* CONFIG_SUNRPC_BACKCHANNEL */
1938 INIT_LIST_HEAD(&xprt->xprt_switch);
1939
1940 xprt->last_used = jiffies;
1941 xprt->cwnd = RPC_INITCWND;
1942 xprt->bind_index = 0;
1943
1944 rpc_init_wait_queue(&xprt->binding, "xprt_binding");
1945 rpc_init_wait_queue(&xprt->pending, "xprt_pending");
David Brazdil0f672f62019-12-10 10:32:29 +00001946 rpc_init_wait_queue(&xprt->sending, "xprt_sending");
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001947 rpc_init_priority_wait_queue(&xprt->backlog, "xprt_backlog");
1948
1949 xprt_init_xid(xprt);
1950
1951 xprt->xprt_net = get_net(net);
1952}
1953
1954/**
1955 * xprt_create_transport - create an RPC transport
1956 * @args: rpc transport creation arguments
1957 *
1958 */
1959struct rpc_xprt *xprt_create_transport(struct xprt_create *args)
1960{
1961 struct rpc_xprt *xprt;
1962 struct xprt_class *t;
1963
1964 spin_lock(&xprt_list_lock);
1965 list_for_each_entry(t, &xprt_list, list) {
1966 if (t->ident == args->ident) {
1967 spin_unlock(&xprt_list_lock);
1968 goto found;
1969 }
1970 }
1971 spin_unlock(&xprt_list_lock);
1972 dprintk("RPC: transport (%d) not supported\n", args->ident);
1973 return ERR_PTR(-EIO);
1974
1975found:
1976 xprt = t->setup(args);
Olivier Deprez157378f2022-04-04 15:47:50 +02001977 if (IS_ERR(xprt))
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001978 goto out;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001979 if (args->flags & XPRT_CREATE_NO_IDLE_TIMEOUT)
1980 xprt->idle_timeout = 0;
1981 INIT_WORK(&xprt->task_cleanup, xprt_autoclose);
1982 if (xprt_has_timer(xprt))
1983 timer_setup(&xprt->timer, xprt_init_autodisconnect, 0);
1984 else
1985 timer_setup(&xprt->timer, NULL, 0);
1986
1987 if (strlen(args->servername) > RPC_MAXNETNAMELEN) {
1988 xprt_destroy(xprt);
1989 return ERR_PTR(-EINVAL);
1990 }
1991 xprt->servername = kstrdup(args->servername, GFP_KERNEL);
1992 if (xprt->servername == NULL) {
1993 xprt_destroy(xprt);
1994 return ERR_PTR(-ENOMEM);
1995 }
1996
1997 rpc_xprt_debugfs_register(xprt);
1998
Olivier Deprez157378f2022-04-04 15:47:50 +02001999 trace_xprt_create(xprt);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002000out:
2001 return xprt;
2002}
2003
2004static void xprt_destroy_cb(struct work_struct *work)
2005{
2006 struct rpc_xprt *xprt =
2007 container_of(work, struct rpc_xprt, task_cleanup);
2008
Olivier Deprez157378f2022-04-04 15:47:50 +02002009 trace_xprt_destroy(xprt);
2010
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002011 rpc_xprt_debugfs_unregister(xprt);
2012 rpc_destroy_wait_queue(&xprt->binding);
2013 rpc_destroy_wait_queue(&xprt->pending);
2014 rpc_destroy_wait_queue(&xprt->sending);
2015 rpc_destroy_wait_queue(&xprt->backlog);
2016 kfree(xprt->servername);
2017 /*
David Brazdil0f672f62019-12-10 10:32:29 +00002018 * Destroy any existing back channel
2019 */
2020 xprt_destroy_backchannel(xprt, UINT_MAX);
2021
2022 /*
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002023 * Tear down transport state and free the rpc_xprt
2024 */
2025 xprt->ops->destroy(xprt);
2026}
2027
2028/**
2029 * xprt_destroy - destroy an RPC transport, killing off all requests.
2030 * @xprt: transport to destroy
2031 *
2032 */
2033static void xprt_destroy(struct rpc_xprt *xprt)
2034{
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002035 /*
2036 * Exclude transport connect/disconnect handlers and autoclose
2037 */
2038 wait_on_bit_lock(&xprt->state, XPRT_LOCKED, TASK_UNINTERRUPTIBLE);
2039
2040 del_timer_sync(&xprt->timer);
2041
2042 /*
2043 * Destroy sockets etc from the system workqueue so they can
2044 * safely flush receive work running on rpciod.
2045 */
2046 INIT_WORK(&xprt->task_cleanup, xprt_destroy_cb);
2047 schedule_work(&xprt->task_cleanup);
2048}
2049
2050static void xprt_destroy_kref(struct kref *kref)
2051{
2052 xprt_destroy(container_of(kref, struct rpc_xprt, kref));
2053}
2054
2055/**
2056 * xprt_get - return a reference to an RPC transport.
2057 * @xprt: pointer to the transport
2058 *
2059 */
2060struct rpc_xprt *xprt_get(struct rpc_xprt *xprt)
2061{
2062 if (xprt != NULL && kref_get_unless_zero(&xprt->kref))
2063 return xprt;
2064 return NULL;
2065}
2066EXPORT_SYMBOL_GPL(xprt_get);
2067
2068/**
2069 * xprt_put - release a reference to an RPC transport.
2070 * @xprt: pointer to the transport
2071 *
2072 */
2073void xprt_put(struct rpc_xprt *xprt)
2074{
2075 if (xprt != NULL)
2076 kref_put(&xprt->kref, xprt_destroy_kref);
2077}
2078EXPORT_SYMBOL_GPL(xprt_put);