1 // SPDX-License-Identifier: GPL-2.0-only
3 * linux/net/sunrpc/xprt.c
5 * This is a generic RPC call interface supporting congestion avoidance,
6 * and asynchronous calls.
8 * The interface works like this:
10 * - When a process places a call, it allocates a request slot if
11 * one is available. Otherwise, it sleeps on the backlog queue
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
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
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
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.
41 #include <linux/module.h>
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>
49 #include <linux/sunrpc/clnt.h>
50 #include <linux/sunrpc/metrics.h>
51 #include <linux/sunrpc/bc_xprt.h>
52 #include <linux/rcupdate.h>
53 #include <linux/sched/mm.h>
55 #include <trace/events/sunrpc.h>
63 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
64 # define RPCDBG_FACILITY RPCDBG_XPRT
70 static void xprt_init(struct rpc_xprt *xprt, struct net *net);
71 static __be32 xprt_alloc_xid(struct rpc_xprt *xprt);
72 static void xprt_destroy(struct rpc_xprt *xprt);
74 static DEFINE_SPINLOCK(xprt_list_lock);
75 static LIST_HEAD(xprt_list);
77 static unsigned long xprt_request_timeout(const struct rpc_rqst *req)
79 unsigned long timeout = jiffies + req->rq_timeout;
81 if (time_before(timeout, req->rq_majortimeo))
83 return req->rq_majortimeo;
87 * xprt_register_transport - register a transport implementation
88 * @transport: transport to register
90 * If a transport implementation is loaded as a kernel module, it can
91 * call this interface to make itself known to the RPC client.
94 * 0: transport successfully registered
95 * -EEXIST: transport already registered
96 * -EINVAL: transport module being unloaded
98 int xprt_register_transport(struct xprt_class *transport)
100 struct xprt_class *t;
104 spin_lock(&xprt_list_lock);
105 list_for_each_entry(t, &xprt_list, list) {
106 /* don't register the same transport class twice */
107 if (t->ident == transport->ident)
111 list_add_tail(&transport->list, &xprt_list);
112 printk(KERN_INFO "RPC: Registered %s transport module.\n",
117 spin_unlock(&xprt_list_lock);
120 EXPORT_SYMBOL_GPL(xprt_register_transport);
123 * xprt_unregister_transport - unregister a transport implementation
124 * @transport: transport to unregister
127 * 0: transport successfully unregistered
128 * -ENOENT: transport never registered
130 int xprt_unregister_transport(struct xprt_class *transport)
132 struct xprt_class *t;
136 spin_lock(&xprt_list_lock);
137 list_for_each_entry(t, &xprt_list, list) {
138 if (t == transport) {
140 "RPC: Unregistered %s transport module.\n",
142 list_del_init(&transport->list);
149 spin_unlock(&xprt_list_lock);
152 EXPORT_SYMBOL_GPL(xprt_unregister_transport);
155 * xprt_load_transport - load a transport implementation
156 * @transport_name: transport to load
159 * 0: transport successfully loaded
160 * -ENOENT: transport module not available
162 int xprt_load_transport(const char *transport_name)
164 struct xprt_class *t;
168 spin_lock(&xprt_list_lock);
169 list_for_each_entry(t, &xprt_list, list) {
170 if (strcmp(t->name, transport_name) == 0) {
171 spin_unlock(&xprt_list_lock);
175 spin_unlock(&xprt_list_lock);
176 result = request_module("xprt%s", transport_name);
180 EXPORT_SYMBOL_GPL(xprt_load_transport);
182 static void xprt_clear_locked(struct rpc_xprt *xprt)
184 xprt->snd_task = NULL;
185 if (!test_bit(XPRT_CLOSE_WAIT, &xprt->state)) {
186 smp_mb__before_atomic();
187 clear_bit(XPRT_LOCKED, &xprt->state);
188 smp_mb__after_atomic();
190 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
194 * xprt_reserve_xprt - serialize write access to transports
195 * @task: task that is requesting access to the transport
196 * @xprt: pointer to the target transport
198 * This prevents mixing the payload of separate requests, and prevents
199 * transport connects from colliding with writes. No congestion control
202 int xprt_reserve_xprt(struct rpc_xprt *xprt, struct rpc_task *task)
204 struct rpc_rqst *req = task->tk_rqstp;
206 if (test_and_set_bit(XPRT_LOCKED, &xprt->state)) {
207 if (task == xprt->snd_task)
211 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
213 xprt->snd_task = task;
216 trace_xprt_reserve_xprt(xprt, task);
220 xprt_clear_locked(xprt);
222 task->tk_status = -EAGAIN;
223 if (RPC_IS_SOFT(task))
224 rpc_sleep_on_timeout(&xprt->sending, task, NULL,
225 xprt_request_timeout(req));
227 rpc_sleep_on(&xprt->sending, task, NULL);
230 EXPORT_SYMBOL_GPL(xprt_reserve_xprt);
233 xprt_need_congestion_window_wait(struct rpc_xprt *xprt)
235 return test_bit(XPRT_CWND_WAIT, &xprt->state);
239 xprt_set_congestion_window_wait(struct rpc_xprt *xprt)
241 if (!list_empty(&xprt->xmit_queue)) {
242 /* Peek at head of queue to see if it can make progress */
243 if (list_first_entry(&xprt->xmit_queue, struct rpc_rqst,
247 set_bit(XPRT_CWND_WAIT, &xprt->state);
251 xprt_test_and_clear_congestion_window_wait(struct rpc_xprt *xprt)
253 if (!RPCXPRT_CONGESTED(xprt))
254 clear_bit(XPRT_CWND_WAIT, &xprt->state);
258 * xprt_reserve_xprt_cong - serialize write access to transports
259 * @task: task that is requesting access to the transport
261 * Same as xprt_reserve_xprt, but Van Jacobson congestion control is
262 * integrated into the decision of whether a request is allowed to be
263 * woken up and given access to the transport.
264 * Note that the lock is only granted if we know there are free slots.
266 int xprt_reserve_xprt_cong(struct rpc_xprt *xprt, struct rpc_task *task)
268 struct rpc_rqst *req = task->tk_rqstp;
270 if (test_and_set_bit(XPRT_LOCKED, &xprt->state)) {
271 if (task == xprt->snd_task)
276 xprt->snd_task = task;
279 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
281 if (!xprt_need_congestion_window_wait(xprt)) {
282 xprt->snd_task = task;
286 xprt_clear_locked(xprt);
288 task->tk_status = -EAGAIN;
289 if (RPC_IS_SOFT(task))
290 rpc_sleep_on_timeout(&xprt->sending, task, NULL,
291 xprt_request_timeout(req));
293 rpc_sleep_on(&xprt->sending, task, NULL);
296 trace_xprt_reserve_cong(xprt, task);
299 EXPORT_SYMBOL_GPL(xprt_reserve_xprt_cong);
301 static inline int xprt_lock_write(struct rpc_xprt *xprt, struct rpc_task *task)
305 if (test_bit(XPRT_LOCKED, &xprt->state) && xprt->snd_task == task)
307 spin_lock(&xprt->transport_lock);
308 retval = xprt->ops->reserve_xprt(xprt, task);
309 spin_unlock(&xprt->transport_lock);
313 static bool __xprt_lock_write_func(struct rpc_task *task, void *data)
315 struct rpc_xprt *xprt = data;
317 xprt->snd_task = task;
321 static void __xprt_lock_write_next(struct rpc_xprt *xprt)
323 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
325 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
327 if (rpc_wake_up_first_on_wq(xprtiod_workqueue, &xprt->sending,
328 __xprt_lock_write_func, xprt))
331 xprt_clear_locked(xprt);
334 static void __xprt_lock_write_next_cong(struct rpc_xprt *xprt)
336 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
338 if (test_bit(XPRT_WRITE_SPACE, &xprt->state))
340 if (xprt_need_congestion_window_wait(xprt))
342 if (rpc_wake_up_first_on_wq(xprtiod_workqueue, &xprt->sending,
343 __xprt_lock_write_func, xprt))
346 xprt_clear_locked(xprt);
350 * xprt_release_xprt - allow other requests to use a transport
351 * @xprt: transport with other tasks potentially waiting
352 * @task: task that is releasing access to the transport
354 * Note that "task" can be NULL. No congestion control is provided.
356 void xprt_release_xprt(struct rpc_xprt *xprt, struct rpc_task *task)
358 if (xprt->snd_task == task) {
359 xprt_clear_locked(xprt);
360 __xprt_lock_write_next(xprt);
362 trace_xprt_release_xprt(xprt, task);
364 EXPORT_SYMBOL_GPL(xprt_release_xprt);
367 * xprt_release_xprt_cong - allow other requests to use a transport
368 * @xprt: transport with other tasks potentially waiting
369 * @task: task that is releasing access to the transport
371 * Note that "task" can be NULL. Another task is awoken to use the
372 * transport if the transport's congestion window allows it.
374 void xprt_release_xprt_cong(struct rpc_xprt *xprt, struct rpc_task *task)
376 if (xprt->snd_task == task) {
377 xprt_clear_locked(xprt);
378 __xprt_lock_write_next_cong(xprt);
380 trace_xprt_release_cong(xprt, task);
382 EXPORT_SYMBOL_GPL(xprt_release_xprt_cong);
384 static inline void xprt_release_write(struct rpc_xprt *xprt, struct rpc_task *task)
386 if (xprt->snd_task != task)
388 spin_lock(&xprt->transport_lock);
389 xprt->ops->release_xprt(xprt, task);
390 spin_unlock(&xprt->transport_lock);
394 * Van Jacobson congestion avoidance. Check if the congestion window
395 * overflowed. Put the task to sleep if this is the case.
398 __xprt_get_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
402 trace_xprt_get_cong(xprt, req->rq_task);
403 if (RPCXPRT_CONGESTED(xprt)) {
404 xprt_set_congestion_window_wait(xprt);
408 xprt->cong += RPC_CWNDSCALE;
413 * Adjust the congestion window, and wake up the next task
414 * that has been sleeping due to congestion
417 __xprt_put_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
422 xprt->cong -= RPC_CWNDSCALE;
423 xprt_test_and_clear_congestion_window_wait(xprt);
424 trace_xprt_put_cong(xprt, req->rq_task);
425 __xprt_lock_write_next_cong(xprt);
429 * xprt_request_get_cong - Request congestion control credits
430 * @xprt: pointer to transport
431 * @req: pointer to RPC request
433 * Useful for transports that require congestion control.
436 xprt_request_get_cong(struct rpc_xprt *xprt, struct rpc_rqst *req)
442 spin_lock(&xprt->transport_lock);
443 ret = __xprt_get_cong(xprt, req) != 0;
444 spin_unlock(&xprt->transport_lock);
447 EXPORT_SYMBOL_GPL(xprt_request_get_cong);
450 * xprt_release_rqst_cong - housekeeping when request is complete
451 * @task: RPC request that recently completed
453 * Useful for transports that require congestion control.
455 void xprt_release_rqst_cong(struct rpc_task *task)
457 struct rpc_rqst *req = task->tk_rqstp;
459 __xprt_put_cong(req->rq_xprt, req);
461 EXPORT_SYMBOL_GPL(xprt_release_rqst_cong);
463 static void xprt_clear_congestion_window_wait_locked(struct rpc_xprt *xprt)
465 if (test_and_clear_bit(XPRT_CWND_WAIT, &xprt->state))
466 __xprt_lock_write_next_cong(xprt);
470 * Clear the congestion window wait flag and wake up the next
471 * entry on xprt->sending
474 xprt_clear_congestion_window_wait(struct rpc_xprt *xprt)
476 if (test_and_clear_bit(XPRT_CWND_WAIT, &xprt->state)) {
477 spin_lock(&xprt->transport_lock);
478 __xprt_lock_write_next_cong(xprt);
479 spin_unlock(&xprt->transport_lock);
484 * xprt_adjust_cwnd - adjust transport congestion window
485 * @xprt: pointer to xprt
486 * @task: recently completed RPC request used to adjust window
487 * @result: result code of completed RPC request
489 * The transport code maintains an estimate on the maximum number of out-
490 * standing RPC requests, using a smoothed version of the congestion
491 * avoidance implemented in 44BSD. This is basically the Van Jacobson
492 * congestion algorithm: If a retransmit occurs, the congestion window is
493 * halved; otherwise, it is incremented by 1/cwnd when
495 * - a reply is received and
496 * - a full number of requests are outstanding and
497 * - the congestion window hasn't been updated recently.
499 void xprt_adjust_cwnd(struct rpc_xprt *xprt, struct rpc_task *task, int result)
501 struct rpc_rqst *req = task->tk_rqstp;
502 unsigned long cwnd = xprt->cwnd;
504 if (result >= 0 && cwnd <= xprt->cong) {
505 /* The (cwnd >> 1) term makes sure
506 * the result gets rounded properly. */
507 cwnd += (RPC_CWNDSCALE * RPC_CWNDSCALE + (cwnd >> 1)) / cwnd;
508 if (cwnd > RPC_MAXCWND(xprt))
509 cwnd = RPC_MAXCWND(xprt);
510 __xprt_lock_write_next_cong(xprt);
511 } else if (result == -ETIMEDOUT) {
513 if (cwnd < RPC_CWNDSCALE)
514 cwnd = RPC_CWNDSCALE;
516 dprintk("RPC: cong %ld, cwnd was %ld, now %ld\n",
517 xprt->cong, xprt->cwnd, cwnd);
519 __xprt_put_cong(xprt, req);
521 EXPORT_SYMBOL_GPL(xprt_adjust_cwnd);
524 * xprt_wake_pending_tasks - wake all tasks on a transport's pending queue
525 * @xprt: transport with waiting tasks
526 * @status: result code to plant in each task before waking it
529 void xprt_wake_pending_tasks(struct rpc_xprt *xprt, int status)
532 rpc_wake_up_status(&xprt->pending, status);
534 rpc_wake_up(&xprt->pending);
536 EXPORT_SYMBOL_GPL(xprt_wake_pending_tasks);
539 * xprt_wait_for_buffer_space - wait for transport output buffer to clear
542 * Note that we only set the timer for the case of RPC_IS_SOFT(), since
543 * we don't in general want to force a socket disconnection due to
544 * an incomplete RPC call transmission.
546 void xprt_wait_for_buffer_space(struct rpc_xprt *xprt)
548 set_bit(XPRT_WRITE_SPACE, &xprt->state);
550 EXPORT_SYMBOL_GPL(xprt_wait_for_buffer_space);
553 xprt_clear_write_space_locked(struct rpc_xprt *xprt)
555 if (test_and_clear_bit(XPRT_WRITE_SPACE, &xprt->state)) {
556 __xprt_lock_write_next(xprt);
557 dprintk("RPC: write space: waking waiting task on "
565 * xprt_write_space - wake the task waiting for transport output buffer space
566 * @xprt: transport with waiting tasks
568 * Can be called in a soft IRQ context, so xprt_write_space never sleeps.
570 bool xprt_write_space(struct rpc_xprt *xprt)
574 if (!test_bit(XPRT_WRITE_SPACE, &xprt->state))
576 spin_lock(&xprt->transport_lock);
577 ret = xprt_clear_write_space_locked(xprt);
578 spin_unlock(&xprt->transport_lock);
581 EXPORT_SYMBOL_GPL(xprt_write_space);
583 static unsigned long xprt_abs_ktime_to_jiffies(ktime_t abstime)
585 s64 delta = ktime_to_ns(ktime_get() - abstime);
586 return likely(delta >= 0) ?
587 jiffies - nsecs_to_jiffies(delta) :
588 jiffies + nsecs_to_jiffies(-delta);
591 static unsigned long xprt_calc_majortimeo(struct rpc_rqst *req)
593 const struct rpc_timeout *to = req->rq_task->tk_client->cl_timeout;
594 unsigned long majortimeo = req->rq_timeout;
596 if (to->to_exponential)
597 majortimeo <<= to->to_retries;
599 majortimeo += to->to_increment * to->to_retries;
600 if (majortimeo > to->to_maxval || majortimeo == 0)
601 majortimeo = to->to_maxval;
605 static void xprt_reset_majortimeo(struct rpc_rqst *req)
607 req->rq_majortimeo += xprt_calc_majortimeo(req);
610 static void xprt_init_majortimeo(struct rpc_task *task, struct rpc_rqst *req)
612 unsigned long time_init;
613 struct rpc_xprt *xprt = req->rq_xprt;
615 if (likely(xprt && xprt_connected(xprt)))
618 time_init = xprt_abs_ktime_to_jiffies(task->tk_start);
619 req->rq_timeout = task->tk_client->cl_timeout->to_initval;
620 req->rq_majortimeo = time_init + xprt_calc_majortimeo(req);
624 * xprt_adjust_timeout - adjust timeout values for next retransmit
625 * @req: RPC request containing parameters to use for the adjustment
628 int xprt_adjust_timeout(struct rpc_rqst *req)
630 struct rpc_xprt *xprt = req->rq_xprt;
631 const struct rpc_timeout *to = req->rq_task->tk_client->cl_timeout;
634 if (time_before(jiffies, req->rq_majortimeo)) {
635 if (to->to_exponential)
636 req->rq_timeout <<= 1;
638 req->rq_timeout += to->to_increment;
639 if (to->to_maxval && req->rq_timeout >= to->to_maxval)
640 req->rq_timeout = to->to_maxval;
643 req->rq_timeout = to->to_initval;
645 xprt_reset_majortimeo(req);
646 /* Reset the RTT counters == "slow start" */
647 spin_lock(&xprt->transport_lock);
648 rpc_init_rtt(req->rq_task->tk_client->cl_rtt, to->to_initval);
649 spin_unlock(&xprt->transport_lock);
653 if (req->rq_timeout == 0) {
654 printk(KERN_WARNING "xprt_adjust_timeout: rq_timeout = 0!\n");
655 req->rq_timeout = 5 * HZ;
660 static void xprt_autoclose(struct work_struct *work)
662 struct rpc_xprt *xprt =
663 container_of(work, struct rpc_xprt, task_cleanup);
664 unsigned int pflags = memalloc_nofs_save();
666 clear_bit(XPRT_CLOSE_WAIT, &xprt->state);
667 xprt->ops->close(xprt);
668 xprt_release_write(xprt, NULL);
669 wake_up_bit(&xprt->state, XPRT_LOCKED);
670 memalloc_nofs_restore(pflags);
674 * xprt_disconnect_done - mark a transport as disconnected
675 * @xprt: transport to flag for disconnect
678 void xprt_disconnect_done(struct rpc_xprt *xprt)
680 dprintk("RPC: disconnected transport %p\n", xprt);
681 spin_lock(&xprt->transport_lock);
682 xprt_clear_connected(xprt);
683 xprt_clear_write_space_locked(xprt);
684 xprt_clear_congestion_window_wait_locked(xprt);
685 xprt_wake_pending_tasks(xprt, -ENOTCONN);
686 spin_unlock(&xprt->transport_lock);
688 EXPORT_SYMBOL_GPL(xprt_disconnect_done);
691 * xprt_force_disconnect - force a transport to disconnect
692 * @xprt: transport to disconnect
695 void xprt_force_disconnect(struct rpc_xprt *xprt)
697 /* Don't race with the test_bit() in xprt_clear_locked() */
698 spin_lock(&xprt->transport_lock);
699 set_bit(XPRT_CLOSE_WAIT, &xprt->state);
700 /* Try to schedule an autoclose RPC call */
701 if (test_and_set_bit(XPRT_LOCKED, &xprt->state) == 0)
702 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
703 else if (xprt->snd_task)
704 rpc_wake_up_queued_task_set_status(&xprt->pending,
705 xprt->snd_task, -ENOTCONN);
706 spin_unlock(&xprt->transport_lock);
708 EXPORT_SYMBOL_GPL(xprt_force_disconnect);
711 xprt_connect_cookie(struct rpc_xprt *xprt)
713 return READ_ONCE(xprt->connect_cookie);
717 xprt_request_retransmit_after_disconnect(struct rpc_task *task)
719 struct rpc_rqst *req = task->tk_rqstp;
720 struct rpc_xprt *xprt = req->rq_xprt;
722 return req->rq_connect_cookie != xprt_connect_cookie(xprt) ||
723 !xprt_connected(xprt);
727 * xprt_conditional_disconnect - force a transport to disconnect
728 * @xprt: transport to disconnect
729 * @cookie: 'connection cookie'
731 * This attempts to break the connection if and only if 'cookie' matches
732 * the current transport 'connection cookie'. It ensures that we don't
733 * try to break the connection more than once when we need to retransmit
734 * a batch of RPC requests.
737 void xprt_conditional_disconnect(struct rpc_xprt *xprt, unsigned int cookie)
739 /* Don't race with the test_bit() in xprt_clear_locked() */
740 spin_lock(&xprt->transport_lock);
741 if (cookie != xprt->connect_cookie)
743 if (test_bit(XPRT_CLOSING, &xprt->state))
745 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);
749 xprt_wake_pending_tasks(xprt, -EAGAIN);
751 spin_unlock(&xprt->transport_lock);
755 xprt_has_timer(const struct rpc_xprt *xprt)
757 return xprt->idle_timeout != 0;
761 xprt_schedule_autodisconnect(struct rpc_xprt *xprt)
762 __must_hold(&xprt->transport_lock)
764 xprt->last_used = jiffies;
765 if (RB_EMPTY_ROOT(&xprt->recv_queue) && xprt_has_timer(xprt))
766 mod_timer(&xprt->timer, xprt->last_used + xprt->idle_timeout);
770 xprt_init_autodisconnect(struct timer_list *t)
772 struct rpc_xprt *xprt = from_timer(xprt, t, timer);
774 if (!RB_EMPTY_ROOT(&xprt->recv_queue))
776 /* Reset xprt->last_used to avoid connect/autodisconnect cycling */
777 xprt->last_used = jiffies;
778 if (test_and_set_bit(XPRT_LOCKED, &xprt->state))
780 queue_work(xprtiod_workqueue, &xprt->task_cleanup);
783 bool xprt_lock_connect(struct rpc_xprt *xprt,
784 struct rpc_task *task,
789 spin_lock(&xprt->transport_lock);
790 if (!test_bit(XPRT_LOCKED, &xprt->state))
792 if (xprt->snd_task != task)
794 xprt->snd_task = cookie;
797 spin_unlock(&xprt->transport_lock);
801 void xprt_unlock_connect(struct rpc_xprt *xprt, void *cookie)
803 spin_lock(&xprt->transport_lock);
804 if (xprt->snd_task != cookie)
806 if (!test_bit(XPRT_LOCKED, &xprt->state))
808 xprt->snd_task =NULL;
809 xprt->ops->release_xprt(xprt, NULL);
810 xprt_schedule_autodisconnect(xprt);
812 spin_unlock(&xprt->transport_lock);
813 wake_up_bit(&xprt->state, XPRT_LOCKED);
817 * xprt_connect - schedule a transport connect operation
818 * @task: RPC task that is requesting the connect
821 void xprt_connect(struct rpc_task *task)
823 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
825 dprintk("RPC: %5u xprt_connect xprt %p %s connected\n", task->tk_pid,
826 xprt, (xprt_connected(xprt) ? "is" : "is not"));
828 if (!xprt_bound(xprt)) {
829 task->tk_status = -EAGAIN;
832 if (!xprt_lock_write(xprt, task))
835 if (test_and_clear_bit(XPRT_CLOSE_WAIT, &xprt->state))
836 xprt->ops->close(xprt);
838 if (!xprt_connected(xprt)) {
839 task->tk_rqstp->rq_connect_cookie = xprt->connect_cookie;
840 rpc_sleep_on_timeout(&xprt->pending, task, NULL,
841 xprt_request_timeout(task->tk_rqstp));
843 if (test_bit(XPRT_CLOSING, &xprt->state))
845 if (xprt_test_and_set_connecting(xprt))
848 if (!xprt_connected(xprt)) {
849 xprt->stat.connect_start = jiffies;
850 xprt->ops->connect(xprt, task);
852 xprt_clear_connecting(xprt);
854 rpc_wake_up_queued_task(&xprt->pending, task);
857 xprt_release_write(xprt, task);
861 * xprt_reconnect_delay - compute the wait before scheduling a connect
862 * @xprt: transport instance
865 unsigned long xprt_reconnect_delay(const struct rpc_xprt *xprt)
867 unsigned long start, now = jiffies;
869 start = xprt->stat.connect_start + xprt->reestablish_timeout;
870 if (time_after(start, now))
874 EXPORT_SYMBOL_GPL(xprt_reconnect_delay);
877 * xprt_reconnect_backoff - compute the new re-establish timeout
878 * @xprt: transport instance
879 * @init_to: initial reestablish timeout
882 void xprt_reconnect_backoff(struct rpc_xprt *xprt, unsigned long init_to)
884 xprt->reestablish_timeout <<= 1;
885 if (xprt->reestablish_timeout > xprt->max_reconnect_timeout)
886 xprt->reestablish_timeout = xprt->max_reconnect_timeout;
887 if (xprt->reestablish_timeout < init_to)
888 xprt->reestablish_timeout = init_to;
890 EXPORT_SYMBOL_GPL(xprt_reconnect_backoff);
892 enum xprt_xid_rb_cmp {
897 static enum xprt_xid_rb_cmp
898 xprt_xid_cmp(__be32 xid1, __be32 xid2)
902 if ((__force u32)xid1 < (__force u32)xid2)
907 static struct rpc_rqst *
908 xprt_request_rb_find(struct rpc_xprt *xprt, __be32 xid)
910 struct rb_node *n = xprt->recv_queue.rb_node;
911 struct rpc_rqst *req;
914 req = rb_entry(n, struct rpc_rqst, rq_recv);
915 switch (xprt_xid_cmp(xid, req->rq_xid)) {
930 xprt_request_rb_insert(struct rpc_xprt *xprt, struct rpc_rqst *new)
932 struct rb_node **p = &xprt->recv_queue.rb_node;
933 struct rb_node *n = NULL;
934 struct rpc_rqst *req;
938 req = rb_entry(n, struct rpc_rqst, rq_recv);
939 switch(xprt_xid_cmp(new->rq_xid, req->rq_xid)) {
947 WARN_ON_ONCE(new != req);
951 rb_link_node(&new->rq_recv, n, p);
952 rb_insert_color(&new->rq_recv, &xprt->recv_queue);
956 xprt_request_rb_remove(struct rpc_xprt *xprt, struct rpc_rqst *req)
958 rb_erase(&req->rq_recv, &xprt->recv_queue);
962 * xprt_lookup_rqst - find an RPC request corresponding to an XID
963 * @xprt: transport on which the original request was transmitted
964 * @xid: RPC XID of incoming reply
966 * Caller holds xprt->queue_lock.
968 struct rpc_rqst *xprt_lookup_rqst(struct rpc_xprt *xprt, __be32 xid)
970 struct rpc_rqst *entry;
972 entry = xprt_request_rb_find(xprt, xid);
974 trace_xprt_lookup_rqst(xprt, xid, 0);
975 entry->rq_rtt = ktime_sub(ktime_get(), entry->rq_xtime);
979 dprintk("RPC: xprt_lookup_rqst did not find xid %08x\n",
981 trace_xprt_lookup_rqst(xprt, xid, -ENOENT);
982 xprt->stat.bad_xids++;
985 EXPORT_SYMBOL_GPL(xprt_lookup_rqst);
988 xprt_is_pinned_rqst(struct rpc_rqst *req)
990 return atomic_read(&req->rq_pin) != 0;
994 * xprt_pin_rqst - Pin a request on the transport receive list
995 * @req: Request to pin
997 * Caller must ensure this is atomic with the call to xprt_lookup_rqst()
998 * so should be holding xprt->queue_lock.
1000 void xprt_pin_rqst(struct rpc_rqst *req)
1002 atomic_inc(&req->rq_pin);
1004 EXPORT_SYMBOL_GPL(xprt_pin_rqst);
1007 * xprt_unpin_rqst - Unpin a request on the transport receive list
1008 * @req: Request to pin
1010 * Caller should be holding xprt->queue_lock.
1012 void xprt_unpin_rqst(struct rpc_rqst *req)
1014 if (!test_bit(RPC_TASK_MSG_PIN_WAIT, &req->rq_task->tk_runstate)) {
1015 atomic_dec(&req->rq_pin);
1018 if (atomic_dec_and_test(&req->rq_pin))
1019 wake_up_var(&req->rq_pin);
1021 EXPORT_SYMBOL_GPL(xprt_unpin_rqst);
1023 static void xprt_wait_on_pinned_rqst(struct rpc_rqst *req)
1025 wait_var_event(&req->rq_pin, !xprt_is_pinned_rqst(req));
1029 xprt_request_data_received(struct rpc_task *task)
1031 return !test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) &&
1032 READ_ONCE(task->tk_rqstp->rq_reply_bytes_recvd) != 0;
1036 xprt_request_need_enqueue_receive(struct rpc_task *task, struct rpc_rqst *req)
1038 return !test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) &&
1039 READ_ONCE(task->tk_rqstp->rq_reply_bytes_recvd) == 0;
1043 * xprt_request_enqueue_receive - Add an request to the receive queue
1048 xprt_request_enqueue_receive(struct rpc_task *task)
1050 struct rpc_rqst *req = task->tk_rqstp;
1051 struct rpc_xprt *xprt = req->rq_xprt;
1053 if (!xprt_request_need_enqueue_receive(task, req))
1056 xprt_request_prepare(task->tk_rqstp);
1057 spin_lock(&xprt->queue_lock);
1059 /* Update the softirq receive buffer */
1060 memcpy(&req->rq_private_buf, &req->rq_rcv_buf,
1061 sizeof(req->rq_private_buf));
1063 /* Add request to the receive list */
1064 xprt_request_rb_insert(xprt, req);
1065 set_bit(RPC_TASK_NEED_RECV, &task->tk_runstate);
1066 spin_unlock(&xprt->queue_lock);
1068 /* Turn off autodisconnect */
1069 del_singleshot_timer_sync(&xprt->timer);
1073 * xprt_request_dequeue_receive_locked - Remove a request from the receive queue
1076 * Caller must hold xprt->queue_lock.
1079 xprt_request_dequeue_receive_locked(struct rpc_task *task)
1081 struct rpc_rqst *req = task->tk_rqstp;
1083 if (test_and_clear_bit(RPC_TASK_NEED_RECV, &task->tk_runstate))
1084 xprt_request_rb_remove(req->rq_xprt, req);
1088 * xprt_update_rtt - Update RPC RTT statistics
1089 * @task: RPC request that recently completed
1091 * Caller holds xprt->queue_lock.
1093 void xprt_update_rtt(struct rpc_task *task)
1095 struct rpc_rqst *req = task->tk_rqstp;
1096 struct rpc_rtt *rtt = task->tk_client->cl_rtt;
1097 unsigned int timer = task->tk_msg.rpc_proc->p_timer;
1098 long m = usecs_to_jiffies(ktime_to_us(req->rq_rtt));
1101 if (req->rq_ntrans == 1)
1102 rpc_update_rtt(rtt, timer, m);
1103 rpc_set_timeo(rtt, timer, req->rq_ntrans - 1);
1106 EXPORT_SYMBOL_GPL(xprt_update_rtt);
1109 * xprt_complete_rqst - called when reply processing is complete
1110 * @task: RPC request that recently completed
1111 * @copied: actual number of bytes received from the transport
1113 * Caller holds xprt->queue_lock.
1115 void xprt_complete_rqst(struct rpc_task *task, int copied)
1117 struct rpc_rqst *req = task->tk_rqstp;
1118 struct rpc_xprt *xprt = req->rq_xprt;
1120 dprintk("RPC: %5u xid %08x complete (%d bytes received)\n",
1121 task->tk_pid, ntohl(req->rq_xid), copied);
1122 trace_xprt_complete_rqst(xprt, req->rq_xid, copied);
1126 req->rq_private_buf.len = copied;
1127 /* Ensure all writes are done before we update */
1128 /* req->rq_reply_bytes_recvd */
1130 req->rq_reply_bytes_recvd = copied;
1131 xprt_request_dequeue_receive_locked(task);
1132 rpc_wake_up_queued_task(&xprt->pending, task);
1134 EXPORT_SYMBOL_GPL(xprt_complete_rqst);
1136 static void xprt_timer(struct rpc_task *task)
1138 struct rpc_rqst *req = task->tk_rqstp;
1139 struct rpc_xprt *xprt = req->rq_xprt;
1141 if (task->tk_status != -ETIMEDOUT)
1144 trace_xprt_timer(xprt, req->rq_xid, task->tk_status);
1145 if (!req->rq_reply_bytes_recvd) {
1146 if (xprt->ops->timer)
1147 xprt->ops->timer(xprt, task);
1149 task->tk_status = 0;
1153 * xprt_wait_for_reply_request_def - wait for reply
1154 * @task: pointer to rpc_task
1156 * Set a request's retransmit timeout based on the transport's
1157 * default timeout parameters. Used by transports that don't adjust
1158 * the retransmit timeout based on round-trip time estimation,
1159 * and put the task to sleep on the pending queue.
1161 void xprt_wait_for_reply_request_def(struct rpc_task *task)
1163 struct rpc_rqst *req = task->tk_rqstp;
1165 rpc_sleep_on_timeout(&req->rq_xprt->pending, task, xprt_timer,
1166 xprt_request_timeout(req));
1168 EXPORT_SYMBOL_GPL(xprt_wait_for_reply_request_def);
1171 * xprt_wait_for_reply_request_rtt - wait for reply using RTT estimator
1172 * @task: pointer to rpc_task
1174 * Set a request's retransmit timeout using the RTT estimator,
1175 * and put the task to sleep on the pending queue.
1177 void xprt_wait_for_reply_request_rtt(struct rpc_task *task)
1179 int timer = task->tk_msg.rpc_proc->p_timer;
1180 struct rpc_clnt *clnt = task->tk_client;
1181 struct rpc_rtt *rtt = clnt->cl_rtt;
1182 struct rpc_rqst *req = task->tk_rqstp;
1183 unsigned long max_timeout = clnt->cl_timeout->to_maxval;
1184 unsigned long timeout;
1186 timeout = rpc_calc_rto(rtt, timer);
1187 timeout <<= rpc_ntimeo(rtt, timer) + req->rq_retries;
1188 if (timeout > max_timeout || timeout == 0)
1189 timeout = max_timeout;
1190 rpc_sleep_on_timeout(&req->rq_xprt->pending, task, xprt_timer,
1193 EXPORT_SYMBOL_GPL(xprt_wait_for_reply_request_rtt);
1196 * xprt_request_wait_receive - wait for the reply to an RPC request
1197 * @task: RPC task about to send a request
1200 void xprt_request_wait_receive(struct rpc_task *task)
1202 struct rpc_rqst *req = task->tk_rqstp;
1203 struct rpc_xprt *xprt = req->rq_xprt;
1205 if (!test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate))
1208 * Sleep on the pending queue if we're expecting a reply.
1209 * The spinlock ensures atomicity between the test of
1210 * req->rq_reply_bytes_recvd, and the call to rpc_sleep_on().
1212 spin_lock(&xprt->queue_lock);
1213 if (test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate)) {
1214 xprt->ops->wait_for_reply_request(task);
1216 * Send an extra queue wakeup call if the
1217 * connection was dropped in case the call to
1218 * rpc_sleep_on() raced.
1220 if (xprt_request_retransmit_after_disconnect(task))
1221 rpc_wake_up_queued_task_set_status(&xprt->pending,
1224 spin_unlock(&xprt->queue_lock);
1228 xprt_request_need_enqueue_transmit(struct rpc_task *task, struct rpc_rqst *req)
1230 return !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
1234 * xprt_request_enqueue_transmit - queue a task for transmission
1235 * @task: pointer to rpc_task
1237 * Add a task to the transmission queue.
1240 xprt_request_enqueue_transmit(struct rpc_task *task)
1242 struct rpc_rqst *pos, *req = task->tk_rqstp;
1243 struct rpc_xprt *xprt = req->rq_xprt;
1245 if (xprt_request_need_enqueue_transmit(task, req)) {
1246 req->rq_bytes_sent = 0;
1247 spin_lock(&xprt->queue_lock);
1249 * Requests that carry congestion control credits are added
1250 * to the head of the list to avoid starvation issues.
1253 xprt_clear_congestion_window_wait(xprt);
1254 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1257 /* Note: req is added _before_ pos */
1258 list_add_tail(&req->rq_xmit, &pos->rq_xmit);
1259 INIT_LIST_HEAD(&req->rq_xmit2);
1260 trace_xprt_enq_xmit(task, 1);
1263 } else if (RPC_IS_SWAPPER(task)) {
1264 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1265 if (pos->rq_cong || pos->rq_bytes_sent)
1267 if (RPC_IS_SWAPPER(pos->rq_task))
1269 /* Note: req is added _before_ pos */
1270 list_add_tail(&req->rq_xmit, &pos->rq_xmit);
1271 INIT_LIST_HEAD(&req->rq_xmit2);
1272 trace_xprt_enq_xmit(task, 2);
1275 } else if (!req->rq_seqno) {
1276 list_for_each_entry(pos, &xprt->xmit_queue, rq_xmit) {
1277 if (pos->rq_task->tk_owner != task->tk_owner)
1279 list_add_tail(&req->rq_xmit2, &pos->rq_xmit2);
1280 INIT_LIST_HEAD(&req->rq_xmit);
1281 trace_xprt_enq_xmit(task, 3);
1285 list_add_tail(&req->rq_xmit, &xprt->xmit_queue);
1286 INIT_LIST_HEAD(&req->rq_xmit2);
1287 trace_xprt_enq_xmit(task, 4);
1289 set_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
1290 spin_unlock(&xprt->queue_lock);
1295 * xprt_request_dequeue_transmit_locked - remove a task from the transmission queue
1296 * @task: pointer to rpc_task
1298 * Remove a task from the transmission queue
1299 * Caller must hold xprt->queue_lock
1302 xprt_request_dequeue_transmit_locked(struct rpc_task *task)
1304 struct rpc_rqst *req = task->tk_rqstp;
1306 if (!test_and_clear_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1308 if (!list_empty(&req->rq_xmit)) {
1309 list_del(&req->rq_xmit);
1310 if (!list_empty(&req->rq_xmit2)) {
1311 struct rpc_rqst *next = list_first_entry(&req->rq_xmit2,
1312 struct rpc_rqst, rq_xmit2);
1313 list_del(&req->rq_xmit2);
1314 list_add_tail(&next->rq_xmit, &next->rq_xprt->xmit_queue);
1317 list_del(&req->rq_xmit2);
1321 * xprt_request_dequeue_transmit - remove a task from the transmission queue
1322 * @task: pointer to rpc_task
1324 * Remove a task from the transmission queue
1327 xprt_request_dequeue_transmit(struct rpc_task *task)
1329 struct rpc_rqst *req = task->tk_rqstp;
1330 struct rpc_xprt *xprt = req->rq_xprt;
1332 spin_lock(&xprt->queue_lock);
1333 xprt_request_dequeue_transmit_locked(task);
1334 spin_unlock(&xprt->queue_lock);
1338 * xprt_request_dequeue_xprt - remove a task from the transmit+receive queue
1339 * @task: pointer to rpc_task
1341 * Remove a task from the transmit and receive queues, and ensure that
1342 * it is not pinned by the receive work item.
1345 xprt_request_dequeue_xprt(struct rpc_task *task)
1347 struct rpc_rqst *req = task->tk_rqstp;
1348 struct rpc_xprt *xprt = req->rq_xprt;
1350 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate) ||
1351 test_bit(RPC_TASK_NEED_RECV, &task->tk_runstate) ||
1352 xprt_is_pinned_rqst(req)) {
1353 spin_lock(&xprt->queue_lock);
1354 xprt_request_dequeue_transmit_locked(task);
1355 xprt_request_dequeue_receive_locked(task);
1356 while (xprt_is_pinned_rqst(req)) {
1357 set_bit(RPC_TASK_MSG_PIN_WAIT, &task->tk_runstate);
1358 spin_unlock(&xprt->queue_lock);
1359 xprt_wait_on_pinned_rqst(req);
1360 spin_lock(&xprt->queue_lock);
1361 clear_bit(RPC_TASK_MSG_PIN_WAIT, &task->tk_runstate);
1363 spin_unlock(&xprt->queue_lock);
1368 * xprt_request_prepare - prepare an encoded request for transport
1369 * @req: pointer to rpc_rqst
1371 * Calls into the transport layer to do whatever is needed to prepare
1372 * the request for transmission or receive.
1375 xprt_request_prepare(struct rpc_rqst *req)
1377 struct rpc_xprt *xprt = req->rq_xprt;
1379 if (xprt->ops->prepare_request)
1380 xprt->ops->prepare_request(req);
1384 * xprt_request_need_retransmit - Test if a task needs retransmission
1385 * @task: pointer to rpc_task
1387 * Test for whether a connection breakage requires the task to retransmit
1390 xprt_request_need_retransmit(struct rpc_task *task)
1392 return xprt_request_retransmit_after_disconnect(task);
1396 * xprt_prepare_transmit - reserve the transport before sending a request
1397 * @task: RPC task about to send a request
1400 bool xprt_prepare_transmit(struct rpc_task *task)
1402 struct rpc_rqst *req = task->tk_rqstp;
1403 struct rpc_xprt *xprt = req->rq_xprt;
1405 dprintk("RPC: %5u xprt_prepare_transmit\n", task->tk_pid);
1407 if (!xprt_lock_write(xprt, task)) {
1408 /* Race breaker: someone may have transmitted us */
1409 if (!test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1410 rpc_wake_up_queued_task_set_status(&xprt->sending,
1418 void xprt_end_transmit(struct rpc_task *task)
1420 xprt_release_write(task->tk_rqstp->rq_xprt, task);
1424 * xprt_request_transmit - send an RPC request on a transport
1425 * @req: pointer to request to transmit
1426 * @snd_task: RPC task that owns the transport lock
1428 * This performs the transmission of a single request.
1429 * Note that if the request is not the same as snd_task, then it
1430 * does need to be pinned.
1431 * Returns '0' on success.
1434 xprt_request_transmit(struct rpc_rqst *req, struct rpc_task *snd_task)
1436 struct rpc_xprt *xprt = req->rq_xprt;
1437 struct rpc_task *task = req->rq_task;
1438 unsigned int connect_cookie;
1439 int is_retrans = RPC_WAS_SENT(task);
1442 if (!req->rq_bytes_sent) {
1443 if (xprt_request_data_received(task)) {
1447 /* Verify that our message lies in the RPCSEC_GSS window */
1448 if (rpcauth_xmit_need_reencode(task)) {
1452 if (RPC_SIGNALLED(task)) {
1453 status = -ERESTARTSYS;
1459 * Update req->rq_ntrans before transmitting to avoid races with
1460 * xprt_update_rtt(), which needs to know that it is recording a
1461 * reply to the first transmission.
1465 connect_cookie = xprt->connect_cookie;
1466 status = xprt->ops->send_request(req);
1469 trace_xprt_transmit(req, status);
1474 task->tk_client->cl_stats->rpcretrans++;
1476 xprt_inject_disconnect(xprt);
1478 task->tk_flags |= RPC_TASK_SENT;
1479 spin_lock(&xprt->transport_lock);
1482 xprt->stat.req_u += xprt->stat.sends - xprt->stat.recvs;
1483 xprt->stat.bklog_u += xprt->backlog.qlen;
1484 xprt->stat.sending_u += xprt->sending.qlen;
1485 xprt->stat.pending_u += xprt->pending.qlen;
1486 spin_unlock(&xprt->transport_lock);
1488 req->rq_connect_cookie = connect_cookie;
1490 trace_xprt_transmit(req, status);
1491 xprt_request_dequeue_transmit(task);
1492 rpc_wake_up_queued_task_set_status(&xprt->sending, task, status);
1497 * xprt_transmit - send an RPC request on a transport
1498 * @task: controlling RPC task
1500 * Attempts to drain the transmit queue. On exit, either the transport
1501 * signalled an error that needs to be handled before transmission can
1502 * resume, or @task finished transmitting, and detected that it already
1506 xprt_transmit(struct rpc_task *task)
1508 struct rpc_rqst *next, *req = task->tk_rqstp;
1509 struct rpc_xprt *xprt = req->rq_xprt;
1512 spin_lock(&xprt->queue_lock);
1513 while (!list_empty(&xprt->xmit_queue)) {
1514 next = list_first_entry(&xprt->xmit_queue,
1515 struct rpc_rqst, rq_xmit);
1516 xprt_pin_rqst(next);
1517 spin_unlock(&xprt->queue_lock);
1518 status = xprt_request_transmit(next, task);
1519 if (status == -EBADMSG && next != req)
1522 spin_lock(&xprt->queue_lock);
1523 xprt_unpin_rqst(next);
1525 if (!xprt_request_data_received(task) ||
1526 test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1528 } else if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate))
1529 task->tk_status = status;
1532 spin_unlock(&xprt->queue_lock);
1535 static void xprt_add_backlog(struct rpc_xprt *xprt, struct rpc_task *task)
1537 set_bit(XPRT_CONGESTED, &xprt->state);
1538 rpc_sleep_on(&xprt->backlog, task, NULL);
1541 static void xprt_wake_up_backlog(struct rpc_xprt *xprt)
1543 if (rpc_wake_up_next(&xprt->backlog) == NULL)
1544 clear_bit(XPRT_CONGESTED, &xprt->state);
1547 static bool xprt_throttle_congested(struct rpc_xprt *xprt, struct rpc_task *task)
1551 if (!test_bit(XPRT_CONGESTED, &xprt->state))
1553 spin_lock(&xprt->reserve_lock);
1554 if (test_bit(XPRT_CONGESTED, &xprt->state)) {
1555 rpc_sleep_on(&xprt->backlog, task, NULL);
1558 spin_unlock(&xprt->reserve_lock);
1563 static struct rpc_rqst *xprt_dynamic_alloc_slot(struct rpc_xprt *xprt)
1565 struct rpc_rqst *req = ERR_PTR(-EAGAIN);
1567 if (xprt->num_reqs >= xprt->max_reqs)
1570 spin_unlock(&xprt->reserve_lock);
1571 req = kzalloc(sizeof(struct rpc_rqst), GFP_NOFS);
1572 spin_lock(&xprt->reserve_lock);
1576 req = ERR_PTR(-ENOMEM);
1581 static bool xprt_dynamic_free_slot(struct rpc_xprt *xprt, struct rpc_rqst *req)
1583 if (xprt->num_reqs > xprt->min_reqs) {
1591 void xprt_alloc_slot(struct rpc_xprt *xprt, struct rpc_task *task)
1593 struct rpc_rqst *req;
1595 spin_lock(&xprt->reserve_lock);
1596 if (!list_empty(&xprt->free)) {
1597 req = list_entry(xprt->free.next, struct rpc_rqst, rq_list);
1598 list_del(&req->rq_list);
1601 req = xprt_dynamic_alloc_slot(xprt);
1604 switch (PTR_ERR(req)) {
1606 dprintk("RPC: dynamic allocation of request slot "
1607 "failed! Retrying\n");
1608 task->tk_status = -ENOMEM;
1611 xprt_add_backlog(xprt, task);
1612 dprintk("RPC: waiting for request slot\n");
1615 task->tk_status = -EAGAIN;
1617 spin_unlock(&xprt->reserve_lock);
1620 xprt->stat.max_slots = max_t(unsigned int, xprt->stat.max_slots,
1622 spin_unlock(&xprt->reserve_lock);
1624 task->tk_status = 0;
1625 task->tk_rqstp = req;
1627 EXPORT_SYMBOL_GPL(xprt_alloc_slot);
1629 void xprt_free_slot(struct rpc_xprt *xprt, struct rpc_rqst *req)
1631 spin_lock(&xprt->reserve_lock);
1632 if (!xprt_dynamic_free_slot(xprt, req)) {
1633 memset(req, 0, sizeof(*req)); /* mark unused */
1634 list_add(&req->rq_list, &xprt->free);
1636 xprt_wake_up_backlog(xprt);
1637 spin_unlock(&xprt->reserve_lock);
1639 EXPORT_SYMBOL_GPL(xprt_free_slot);
1641 static void xprt_free_all_slots(struct rpc_xprt *xprt)
1643 struct rpc_rqst *req;
1644 while (!list_empty(&xprt->free)) {
1645 req = list_first_entry(&xprt->free, struct rpc_rqst, rq_list);
1646 list_del(&req->rq_list);
1651 struct rpc_xprt *xprt_alloc(struct net *net, size_t size,
1652 unsigned int num_prealloc,
1653 unsigned int max_alloc)
1655 struct rpc_xprt *xprt;
1656 struct rpc_rqst *req;
1659 xprt = kzalloc(size, GFP_KERNEL);
1663 xprt_init(xprt, net);
1665 for (i = 0; i < num_prealloc; i++) {
1666 req = kzalloc(sizeof(struct rpc_rqst), GFP_KERNEL);
1669 list_add(&req->rq_list, &xprt->free);
1671 if (max_alloc > num_prealloc)
1672 xprt->max_reqs = max_alloc;
1674 xprt->max_reqs = num_prealloc;
1675 xprt->min_reqs = num_prealloc;
1676 xprt->num_reqs = num_prealloc;
1685 EXPORT_SYMBOL_GPL(xprt_alloc);
1687 void xprt_free(struct rpc_xprt *xprt)
1689 put_net(xprt->xprt_net);
1690 xprt_free_all_slots(xprt);
1691 kfree_rcu(xprt, rcu);
1693 EXPORT_SYMBOL_GPL(xprt_free);
1696 xprt_init_connect_cookie(struct rpc_rqst *req, struct rpc_xprt *xprt)
1698 req->rq_connect_cookie = xprt_connect_cookie(xprt) - 1;
1702 xprt_alloc_xid(struct rpc_xprt *xprt)
1706 spin_lock(&xprt->reserve_lock);
1707 xid = (__force __be32)xprt->xid++;
1708 spin_unlock(&xprt->reserve_lock);
1713 xprt_init_xid(struct rpc_xprt *xprt)
1715 xprt->xid = prandom_u32();
1719 xprt_request_init(struct rpc_task *task)
1721 struct rpc_xprt *xprt = task->tk_xprt;
1722 struct rpc_rqst *req = task->tk_rqstp;
1724 req->rq_task = task;
1725 req->rq_xprt = xprt;
1726 req->rq_buffer = NULL;
1727 req->rq_xid = xprt_alloc_xid(xprt);
1728 xprt_init_connect_cookie(req, xprt);
1729 req->rq_snd_buf.len = 0;
1730 req->rq_snd_buf.buflen = 0;
1731 req->rq_rcv_buf.len = 0;
1732 req->rq_rcv_buf.buflen = 0;
1733 req->rq_snd_buf.bvec = NULL;
1734 req->rq_rcv_buf.bvec = NULL;
1735 req->rq_release_snd_buf = NULL;
1736 xprt_init_majortimeo(task, req);
1737 dprintk("RPC: %5u reserved req %p xid %08x\n", task->tk_pid,
1738 req, ntohl(req->rq_xid));
1742 xprt_do_reserve(struct rpc_xprt *xprt, struct rpc_task *task)
1744 xprt->ops->alloc_slot(xprt, task);
1745 if (task->tk_rqstp != NULL)
1746 xprt_request_init(task);
1750 * xprt_reserve - allocate an RPC request slot
1751 * @task: RPC task requesting a slot allocation
1753 * If the transport is marked as being congested, or if no more
1754 * slots are available, place the task on the transport's
1757 void xprt_reserve(struct rpc_task *task)
1759 struct rpc_xprt *xprt = task->tk_xprt;
1761 task->tk_status = 0;
1762 if (task->tk_rqstp != NULL)
1765 task->tk_status = -EAGAIN;
1766 if (!xprt_throttle_congested(xprt, task))
1767 xprt_do_reserve(xprt, task);
1771 * xprt_retry_reserve - allocate an RPC request slot
1772 * @task: RPC task requesting a slot allocation
1774 * If no more slots are available, place the task on the transport's
1776 * Note that the only difference with xprt_reserve is that we now
1777 * ignore the value of the XPRT_CONGESTED flag.
1779 void xprt_retry_reserve(struct rpc_task *task)
1781 struct rpc_xprt *xprt = task->tk_xprt;
1783 task->tk_status = 0;
1784 if (task->tk_rqstp != NULL)
1787 task->tk_status = -EAGAIN;
1788 xprt_do_reserve(xprt, task);
1792 * xprt_release - release an RPC request slot
1793 * @task: task which is finished with the slot
1796 void xprt_release(struct rpc_task *task)
1798 struct rpc_xprt *xprt;
1799 struct rpc_rqst *req = task->tk_rqstp;
1802 if (task->tk_client) {
1803 xprt = task->tk_xprt;
1804 xprt_release_write(xprt, task);
1809 xprt = req->rq_xprt;
1810 xprt_request_dequeue_xprt(task);
1811 spin_lock(&xprt->transport_lock);
1812 xprt->ops->release_xprt(xprt, task);
1813 if (xprt->ops->release_request)
1814 xprt->ops->release_request(task);
1815 xprt_schedule_autodisconnect(xprt);
1816 spin_unlock(&xprt->transport_lock);
1818 xprt->ops->buf_free(task);
1819 xprt_inject_disconnect(xprt);
1820 xdr_free_bvec(&req->rq_rcv_buf);
1821 xdr_free_bvec(&req->rq_snd_buf);
1822 if (req->rq_cred != NULL)
1823 put_rpccred(req->rq_cred);
1824 task->tk_rqstp = NULL;
1825 if (req->rq_release_snd_buf)
1826 req->rq_release_snd_buf(req);
1828 dprintk("RPC: %5u release request %p\n", task->tk_pid, req);
1829 if (likely(!bc_prealloc(req)))
1830 xprt->ops->free_slot(xprt, req);
1832 xprt_free_bc_request(req);
1835 #ifdef CONFIG_SUNRPC_BACKCHANNEL
1837 xprt_init_bc_request(struct rpc_rqst *req, struct rpc_task *task)
1839 struct xdr_buf *xbufp = &req->rq_snd_buf;
1841 task->tk_rqstp = req;
1842 req->rq_task = task;
1843 xprt_init_connect_cookie(req, req->rq_xprt);
1845 * Set up the xdr_buf length.
1846 * This also indicates that the buffer is XDR encoded already.
1848 xbufp->len = xbufp->head[0].iov_len + xbufp->page_len +
1849 xbufp->tail[0].iov_len;
1853 static void xprt_init(struct rpc_xprt *xprt, struct net *net)
1855 kref_init(&xprt->kref);
1857 spin_lock_init(&xprt->transport_lock);
1858 spin_lock_init(&xprt->reserve_lock);
1859 spin_lock_init(&xprt->queue_lock);
1861 INIT_LIST_HEAD(&xprt->free);
1862 xprt->recv_queue = RB_ROOT;
1863 INIT_LIST_HEAD(&xprt->xmit_queue);
1864 #if defined(CONFIG_SUNRPC_BACKCHANNEL)
1865 spin_lock_init(&xprt->bc_pa_lock);
1866 INIT_LIST_HEAD(&xprt->bc_pa_list);
1867 #endif /* CONFIG_SUNRPC_BACKCHANNEL */
1868 INIT_LIST_HEAD(&xprt->xprt_switch);
1870 xprt->last_used = jiffies;
1871 xprt->cwnd = RPC_INITCWND;
1872 xprt->bind_index = 0;
1874 rpc_init_wait_queue(&xprt->binding, "xprt_binding");
1875 rpc_init_wait_queue(&xprt->pending, "xprt_pending");
1876 rpc_init_wait_queue(&xprt->sending, "xprt_sending");
1877 rpc_init_priority_wait_queue(&xprt->backlog, "xprt_backlog");
1879 xprt_init_xid(xprt);
1881 xprt->xprt_net = get_net(net);
1885 * xprt_create_transport - create an RPC transport
1886 * @args: rpc transport creation arguments
1889 struct rpc_xprt *xprt_create_transport(struct xprt_create *args)
1891 struct rpc_xprt *xprt;
1892 struct xprt_class *t;
1894 spin_lock(&xprt_list_lock);
1895 list_for_each_entry(t, &xprt_list, list) {
1896 if (t->ident == args->ident) {
1897 spin_unlock(&xprt_list_lock);
1901 spin_unlock(&xprt_list_lock);
1902 dprintk("RPC: transport (%d) not supported\n", args->ident);
1903 return ERR_PTR(-EIO);
1906 xprt = t->setup(args);
1908 dprintk("RPC: xprt_create_transport: failed, %ld\n",
1912 if (args->flags & XPRT_CREATE_NO_IDLE_TIMEOUT)
1913 xprt->idle_timeout = 0;
1914 INIT_WORK(&xprt->task_cleanup, xprt_autoclose);
1915 if (xprt_has_timer(xprt))
1916 timer_setup(&xprt->timer, xprt_init_autodisconnect, 0);
1918 timer_setup(&xprt->timer, NULL, 0);
1920 if (strlen(args->servername) > RPC_MAXNETNAMELEN) {
1922 return ERR_PTR(-EINVAL);
1924 xprt->servername = kstrdup(args->servername, GFP_KERNEL);
1925 if (xprt->servername == NULL) {
1927 return ERR_PTR(-ENOMEM);
1930 rpc_xprt_debugfs_register(xprt);
1932 dprintk("RPC: created transport %p with %u slots\n", xprt,
1938 static void xprt_destroy_cb(struct work_struct *work)
1940 struct rpc_xprt *xprt =
1941 container_of(work, struct rpc_xprt, task_cleanup);
1943 rpc_xprt_debugfs_unregister(xprt);
1944 rpc_destroy_wait_queue(&xprt->binding);
1945 rpc_destroy_wait_queue(&xprt->pending);
1946 rpc_destroy_wait_queue(&xprt->sending);
1947 rpc_destroy_wait_queue(&xprt->backlog);
1948 kfree(xprt->servername);
1950 * Destroy any existing back channel
1952 xprt_destroy_backchannel(xprt, UINT_MAX);
1955 * Tear down transport state and free the rpc_xprt
1957 xprt->ops->destroy(xprt);
1961 * xprt_destroy - destroy an RPC transport, killing off all requests.
1962 * @xprt: transport to destroy
1965 static void xprt_destroy(struct rpc_xprt *xprt)
1967 dprintk("RPC: destroying transport %p\n", xprt);
1970 * Exclude transport connect/disconnect handlers and autoclose
1972 wait_on_bit_lock(&xprt->state, XPRT_LOCKED, TASK_UNINTERRUPTIBLE);
1974 del_timer_sync(&xprt->timer);
1977 * Destroy sockets etc from the system workqueue so they can
1978 * safely flush receive work running on rpciod.
1980 INIT_WORK(&xprt->task_cleanup, xprt_destroy_cb);
1981 schedule_work(&xprt->task_cleanup);
1984 static void xprt_destroy_kref(struct kref *kref)
1986 xprt_destroy(container_of(kref, struct rpc_xprt, kref));
1990 * xprt_get - return a reference to an RPC transport.
1991 * @xprt: pointer to the transport
1994 struct rpc_xprt *xprt_get(struct rpc_xprt *xprt)
1996 if (xprt != NULL && kref_get_unless_zero(&xprt->kref))
2000 EXPORT_SYMBOL_GPL(xprt_get);
2003 * xprt_put - release a reference to an RPC transport.
2004 * @xprt: pointer to the transport
2007 void xprt_put(struct rpc_xprt *xprt)
2010 kref_put(&xprt->kref, xprt_destroy_kref);
2012 EXPORT_SYMBOL_GPL(xprt_put);