1 // SPDX-License-Identifier: GPL-2.0-only
3 * linux/net/sunrpc/clnt.c
5 * This file contains the high-level RPC interface.
6 * It is modeled as a finite state machine to support both synchronous
7 * and asynchronous requests.
9 * - RPC header generation and argument serialization.
10 * - Credential refresh.
11 * - TCP connect handling.
12 * - Retry of operation when it is suspected the operation failed because
13 * of uid squashing on the server, or when the credentials were stale
14 * and need to be refreshed, or when a packet was damaged in transit.
15 * This may be have to be moved to the VFS layer.
22 #include <linux/module.h>
23 #include <linux/types.h>
24 #include <linux/kallsyms.h>
26 #include <linux/namei.h>
27 #include <linux/mount.h>
28 #include <linux/slab.h>
29 #include <linux/rcupdate.h>
30 #include <linux/utsname.h>
31 #include <linux/workqueue.h>
33 #include <linux/in6.h>
36 #include <linux/sunrpc/clnt.h>
37 #include <linux/sunrpc/addr.h>
38 #include <linux/sunrpc/rpc_pipe_fs.h>
39 #include <linux/sunrpc/metrics.h>
40 #include <linux/sunrpc/bc_xprt.h>
41 #include <trace/events/sunrpc.h>
47 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
48 # define RPCDBG_FACILITY RPCDBG_CALL
52 * All RPC clients are linked into this list
55 static DECLARE_WAIT_QUEUE_HEAD(destroy_wait);
58 static void call_start(struct rpc_task *task);
59 static void call_reserve(struct rpc_task *task);
60 static void call_reserveresult(struct rpc_task *task);
61 static void call_allocate(struct rpc_task *task);
62 static void call_encode(struct rpc_task *task);
63 static void call_decode(struct rpc_task *task);
64 static void call_bind(struct rpc_task *task);
65 static void call_bind_status(struct rpc_task *task);
66 static void call_transmit(struct rpc_task *task);
67 static void call_status(struct rpc_task *task);
68 static void call_transmit_status(struct rpc_task *task);
69 static void call_refresh(struct rpc_task *task);
70 static void call_refreshresult(struct rpc_task *task);
71 static void call_connect(struct rpc_task *task);
72 static void call_connect_status(struct rpc_task *task);
74 static int rpc_encode_header(struct rpc_task *task,
75 struct xdr_stream *xdr);
76 static int rpc_decode_header(struct rpc_task *task,
77 struct xdr_stream *xdr);
78 static int rpc_ping(struct rpc_clnt *clnt);
79 static int rpc_ping_noreply(struct rpc_clnt *clnt);
80 static void rpc_check_timeout(struct rpc_task *task);
82 static void rpc_register_client(struct rpc_clnt *clnt)
84 struct net *net = rpc_net_ns(clnt);
85 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
87 spin_lock(&sn->rpc_client_lock);
88 list_add(&clnt->cl_clients, &sn->all_clients);
89 spin_unlock(&sn->rpc_client_lock);
92 static void rpc_unregister_client(struct rpc_clnt *clnt)
94 struct net *net = rpc_net_ns(clnt);
95 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
97 spin_lock(&sn->rpc_client_lock);
98 list_del(&clnt->cl_clients);
99 spin_unlock(&sn->rpc_client_lock);
102 static void __rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
104 rpc_remove_client_dir(clnt);
107 static void rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
109 struct net *net = rpc_net_ns(clnt);
110 struct super_block *pipefs_sb;
112 pipefs_sb = rpc_get_sb_net(net);
114 if (pipefs_sb == clnt->pipefs_sb)
115 __rpc_clnt_remove_pipedir(clnt);
120 static struct dentry *rpc_setup_pipedir_sb(struct super_block *sb,
121 struct rpc_clnt *clnt)
123 static uint32_t clntid;
124 const char *dir_name = clnt->cl_program->pipe_dir_name;
126 struct dentry *dir, *dentry;
128 dir = rpc_d_lookup_sb(sb, dir_name);
130 pr_info("RPC: pipefs directory doesn't exist: %s\n", dir_name);
134 snprintf(name, sizeof(name), "clnt%x", (unsigned int)clntid++);
135 name[sizeof(name) - 1] = '\0';
136 dentry = rpc_create_client_dir(dir, name, clnt);
139 if (dentry == ERR_PTR(-EEXIST))
141 printk(KERN_INFO "RPC: Couldn't create pipefs entry"
142 " %s/%s, error %ld\n",
143 dir_name, name, PTR_ERR(dentry));
151 rpc_setup_pipedir(struct super_block *pipefs_sb, struct rpc_clnt *clnt)
153 struct dentry *dentry;
155 clnt->pipefs_sb = pipefs_sb;
157 if (clnt->cl_program->pipe_dir_name != NULL) {
158 dentry = rpc_setup_pipedir_sb(pipefs_sb, clnt);
160 return PTR_ERR(dentry);
165 static int rpc_clnt_skip_event(struct rpc_clnt *clnt, unsigned long event)
167 if (clnt->cl_program->pipe_dir_name == NULL)
171 case RPC_PIPEFS_MOUNT:
172 if (clnt->cl_pipedir_objects.pdh_dentry != NULL)
174 if (refcount_read(&clnt->cl_count) == 0)
177 case RPC_PIPEFS_UMOUNT:
178 if (clnt->cl_pipedir_objects.pdh_dentry == NULL)
185 static int __rpc_clnt_handle_event(struct rpc_clnt *clnt, unsigned long event,
186 struct super_block *sb)
188 struct dentry *dentry;
191 case RPC_PIPEFS_MOUNT:
192 dentry = rpc_setup_pipedir_sb(sb, clnt);
196 return PTR_ERR(dentry);
198 case RPC_PIPEFS_UMOUNT:
199 __rpc_clnt_remove_pipedir(clnt);
202 printk(KERN_ERR "%s: unknown event: %ld\n", __func__, event);
208 static int __rpc_pipefs_event(struct rpc_clnt *clnt, unsigned long event,
209 struct super_block *sb)
213 for (;; clnt = clnt->cl_parent) {
214 if (!rpc_clnt_skip_event(clnt, event))
215 error = __rpc_clnt_handle_event(clnt, event, sb);
216 if (error || clnt == clnt->cl_parent)
222 static struct rpc_clnt *rpc_get_client_for_event(struct net *net, int event)
224 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
225 struct rpc_clnt *clnt;
227 spin_lock(&sn->rpc_client_lock);
228 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
229 if (rpc_clnt_skip_event(clnt, event))
231 spin_unlock(&sn->rpc_client_lock);
234 spin_unlock(&sn->rpc_client_lock);
238 static int rpc_pipefs_event(struct notifier_block *nb, unsigned long event,
241 struct super_block *sb = ptr;
242 struct rpc_clnt *clnt;
245 while ((clnt = rpc_get_client_for_event(sb->s_fs_info, event))) {
246 error = __rpc_pipefs_event(clnt, event, sb);
253 static struct notifier_block rpc_clients_block = {
254 .notifier_call = rpc_pipefs_event,
255 .priority = SUNRPC_PIPEFS_RPC_PRIO,
258 int rpc_clients_notifier_register(void)
260 return rpc_pipefs_notifier_register(&rpc_clients_block);
263 void rpc_clients_notifier_unregister(void)
265 return rpc_pipefs_notifier_unregister(&rpc_clients_block);
268 static struct rpc_xprt *rpc_clnt_set_transport(struct rpc_clnt *clnt,
269 struct rpc_xprt *xprt,
270 const struct rpc_timeout *timeout)
272 struct rpc_xprt *old;
274 spin_lock(&clnt->cl_lock);
275 old = rcu_dereference_protected(clnt->cl_xprt,
276 lockdep_is_held(&clnt->cl_lock));
278 if (!xprt_bound(xprt))
279 clnt->cl_autobind = 1;
281 clnt->cl_timeout = timeout;
282 rcu_assign_pointer(clnt->cl_xprt, xprt);
283 spin_unlock(&clnt->cl_lock);
288 static void rpc_clnt_set_nodename(struct rpc_clnt *clnt, const char *nodename)
292 copied = strscpy(clnt->cl_nodename,
293 nodename, sizeof(clnt->cl_nodename));
295 clnt->cl_nodelen = copied < 0
296 ? sizeof(clnt->cl_nodename) - 1
300 static int rpc_client_register(struct rpc_clnt *clnt,
301 rpc_authflavor_t pseudoflavor,
302 const char *client_name)
304 struct rpc_auth_create_args auth_args = {
305 .pseudoflavor = pseudoflavor,
306 .target_name = client_name,
308 struct rpc_auth *auth;
309 struct net *net = rpc_net_ns(clnt);
310 struct super_block *pipefs_sb;
313 rpc_clnt_debugfs_register(clnt);
315 pipefs_sb = rpc_get_sb_net(net);
317 err = rpc_setup_pipedir(pipefs_sb, clnt);
322 rpc_register_client(clnt);
326 auth = rpcauth_create(&auth_args, clnt);
328 dprintk("RPC: Couldn't create auth handle (flavor %u)\n",
335 pipefs_sb = rpc_get_sb_net(net);
336 rpc_unregister_client(clnt);
337 __rpc_clnt_remove_pipedir(clnt);
341 rpc_sysfs_client_destroy(clnt);
342 rpc_clnt_debugfs_unregister(clnt);
346 static DEFINE_IDA(rpc_clids);
348 void rpc_cleanup_clids(void)
350 ida_destroy(&rpc_clids);
353 static int rpc_alloc_clid(struct rpc_clnt *clnt)
357 clid = ida_alloc(&rpc_clids, GFP_KERNEL);
360 clnt->cl_clid = clid;
364 static void rpc_free_clid(struct rpc_clnt *clnt)
366 ida_free(&rpc_clids, clnt->cl_clid);
369 static struct rpc_clnt * rpc_new_client(const struct rpc_create_args *args,
370 struct rpc_xprt_switch *xps,
371 struct rpc_xprt *xprt,
372 struct rpc_clnt *parent)
374 const struct rpc_program *program = args->program;
375 const struct rpc_version *version;
376 struct rpc_clnt *clnt = NULL;
377 const struct rpc_timeout *timeout;
378 const char *nodename = args->nodename;
386 if (args->version >= program->nrvers)
388 version = program->version[args->version];
393 clnt = kzalloc(sizeof(*clnt), GFP_KERNEL);
396 clnt->cl_parent = parent ? : clnt;
397 clnt->cl_xprtsec = args->xprtsec;
399 err = rpc_alloc_clid(clnt);
403 clnt->cl_cred = get_cred(args->cred);
404 clnt->cl_procinfo = version->procs;
405 clnt->cl_maxproc = version->nrprocs;
406 clnt->cl_prog = args->prognumber ? : program->number;
407 clnt->cl_vers = version->number;
408 clnt->cl_stats = program->stats;
409 clnt->cl_metrics = rpc_alloc_iostats(clnt);
410 rpc_init_pipe_dir_head(&clnt->cl_pipedir_objects);
412 if (clnt->cl_metrics == NULL)
414 clnt->cl_program = program;
415 INIT_LIST_HEAD(&clnt->cl_tasks);
416 spin_lock_init(&clnt->cl_lock);
418 timeout = xprt->timeout;
419 if (args->timeout != NULL) {
420 memcpy(&clnt->cl_timeout_default, args->timeout,
421 sizeof(clnt->cl_timeout_default));
422 timeout = &clnt->cl_timeout_default;
425 rpc_clnt_set_transport(clnt, xprt, timeout);
427 xprt_iter_init(&clnt->cl_xpi, xps);
428 xprt_switch_put(xps);
430 clnt->cl_rtt = &clnt->cl_rtt_default;
431 rpc_init_rtt(&clnt->cl_rtt_default, clnt->cl_timeout->to_initval);
433 refcount_set(&clnt->cl_count, 1);
435 if (nodename == NULL)
436 nodename = utsname()->nodename;
437 /* save the nodename */
438 rpc_clnt_set_nodename(clnt, nodename);
440 rpc_sysfs_client_setup(clnt, xps, rpc_net_ns(clnt));
441 err = rpc_client_register(clnt, args->authflavor, args->client_name);
445 refcount_inc(&parent->cl_count);
447 trace_rpc_clnt_new(clnt, xprt, args);
451 rpc_free_iostats(clnt->cl_metrics);
453 put_cred(clnt->cl_cred);
460 xprt_switch_put(xps);
462 trace_rpc_clnt_new_err(program->name, args->servername, err);
466 static struct rpc_clnt *rpc_create_xprt(struct rpc_create_args *args,
467 struct rpc_xprt *xprt)
469 struct rpc_clnt *clnt = NULL;
470 struct rpc_xprt_switch *xps;
472 if (args->bc_xprt && args->bc_xprt->xpt_bc_xps) {
473 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
474 xps = args->bc_xprt->xpt_bc_xps;
475 xprt_switch_get(xps);
477 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
480 return ERR_PTR(-ENOMEM);
483 xprt_switch_get(xps);
484 xprt->bc_xprt->xpt_bc_xps = xps;
487 clnt = rpc_new_client(args, xps, xprt, NULL);
491 if (!(args->flags & RPC_CLNT_CREATE_NOPING)) {
492 int err = rpc_ping(clnt);
494 rpc_shutdown_client(clnt);
497 } else if (args->flags & RPC_CLNT_CREATE_CONNECTED) {
498 int err = rpc_ping_noreply(clnt);
500 rpc_shutdown_client(clnt);
505 clnt->cl_softrtry = 1;
506 if (args->flags & (RPC_CLNT_CREATE_HARDRTRY|RPC_CLNT_CREATE_SOFTERR)) {
507 clnt->cl_softrtry = 0;
508 if (args->flags & RPC_CLNT_CREATE_SOFTERR)
509 clnt->cl_softerr = 1;
512 if (args->flags & RPC_CLNT_CREATE_AUTOBIND)
513 clnt->cl_autobind = 1;
514 if (args->flags & RPC_CLNT_CREATE_NO_RETRANS_TIMEOUT)
515 clnt->cl_noretranstimeo = 1;
516 if (args->flags & RPC_CLNT_CREATE_DISCRTRY)
517 clnt->cl_discrtry = 1;
518 if (!(args->flags & RPC_CLNT_CREATE_QUIET))
525 * rpc_create - create an RPC client and transport with one call
526 * @args: rpc_clnt create argument structure
528 * Creates and initializes an RPC transport and an RPC client.
530 * It can ping the server in order to determine if it is up, and to see if
531 * it supports this program and version. RPC_CLNT_CREATE_NOPING disables
532 * this behavior so asynchronous tasks can also use rpc_create.
534 struct rpc_clnt *rpc_create(struct rpc_create_args *args)
536 struct rpc_xprt *xprt;
537 struct xprt_create xprtargs = {
539 .ident = args->protocol,
540 .srcaddr = args->saddress,
541 .dstaddr = args->address,
542 .addrlen = args->addrsize,
543 .servername = args->servername,
544 .bc_xprt = args->bc_xprt,
545 .xprtsec = args->xprtsec,
546 .connect_timeout = args->connect_timeout,
547 .reconnect_timeout = args->reconnect_timeout,
550 struct rpc_clnt *clnt;
554 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
555 xprt = args->bc_xprt->xpt_bc_xprt;
558 return rpc_create_xprt(args, xprt);
562 if (args->flags & RPC_CLNT_CREATE_INFINITE_SLOTS)
563 xprtargs.flags |= XPRT_CREATE_INFINITE_SLOTS;
564 if (args->flags & RPC_CLNT_CREATE_NO_IDLE_TIMEOUT)
565 xprtargs.flags |= XPRT_CREATE_NO_IDLE_TIMEOUT;
567 * If the caller chooses not to specify a hostname, whip
568 * up a string representation of the passed-in address.
570 if (xprtargs.servername == NULL) {
571 struct sockaddr_un *sun =
572 (struct sockaddr_un *)args->address;
573 struct sockaddr_in *sin =
574 (struct sockaddr_in *)args->address;
575 struct sockaddr_in6 *sin6 =
576 (struct sockaddr_in6 *)args->address;
578 servername[0] = '\0';
579 switch (args->address->sa_family) {
581 if (sun->sun_path[0])
582 snprintf(servername, sizeof(servername), "%s",
585 snprintf(servername, sizeof(servername), "@%s",
589 snprintf(servername, sizeof(servername), "%pI4",
590 &sin->sin_addr.s_addr);
593 snprintf(servername, sizeof(servername), "%pI6",
597 /* caller wants default server name, but
598 * address family isn't recognized. */
599 return ERR_PTR(-EINVAL);
601 xprtargs.servername = servername;
604 xprt = xprt_create_transport(&xprtargs);
606 return (struct rpc_clnt *)xprt;
609 * By default, kernel RPC client connects from a reserved port.
610 * CAP_NET_BIND_SERVICE will not be set for unprivileged requesters,
611 * but it is always enabled for rpciod, which handles the connect
615 if (args->flags & RPC_CLNT_CREATE_NONPRIVPORT)
618 if (args->flags & RPC_CLNT_CREATE_REUSEPORT)
621 clnt = rpc_create_xprt(args, xprt);
622 if (IS_ERR(clnt) || args->nconnect <= 1)
625 for (i = 0; i < args->nconnect - 1; i++) {
626 if (rpc_clnt_add_xprt(clnt, &xprtargs, NULL, NULL) < 0)
631 EXPORT_SYMBOL_GPL(rpc_create);
634 * This function clones the RPC client structure. It allows us to share the
635 * same transport while varying parameters such as the authentication
638 static struct rpc_clnt *__rpc_clone_client(struct rpc_create_args *args,
639 struct rpc_clnt *clnt)
641 struct rpc_xprt_switch *xps;
642 struct rpc_xprt *xprt;
643 struct rpc_clnt *new;
648 xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
649 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
651 if (xprt == NULL || xps == NULL) {
653 xprt_switch_put(xps);
656 args->servername = xprt->servername;
657 args->nodename = clnt->cl_nodename;
659 new = rpc_new_client(args, xps, xprt, clnt);
663 /* Turn off autobind on clones */
664 new->cl_autobind = 0;
665 new->cl_softrtry = clnt->cl_softrtry;
666 new->cl_softerr = clnt->cl_softerr;
667 new->cl_noretranstimeo = clnt->cl_noretranstimeo;
668 new->cl_discrtry = clnt->cl_discrtry;
669 new->cl_chatty = clnt->cl_chatty;
670 new->cl_principal = clnt->cl_principal;
671 new->cl_max_connect = clnt->cl_max_connect;
675 trace_rpc_clnt_clone_err(clnt, err);
680 * rpc_clone_client - Clone an RPC client structure
682 * @clnt: RPC client whose parameters are copied
684 * Returns a fresh RPC client or an ERR_PTR.
686 struct rpc_clnt *rpc_clone_client(struct rpc_clnt *clnt)
688 struct rpc_create_args args = {
689 .program = clnt->cl_program,
690 .prognumber = clnt->cl_prog,
691 .version = clnt->cl_vers,
692 .authflavor = clnt->cl_auth->au_flavor,
693 .cred = clnt->cl_cred,
695 return __rpc_clone_client(&args, clnt);
697 EXPORT_SYMBOL_GPL(rpc_clone_client);
700 * rpc_clone_client_set_auth - Clone an RPC client structure and set its auth
702 * @clnt: RPC client whose parameters are copied
703 * @flavor: security flavor for new client
705 * Returns a fresh RPC client or an ERR_PTR.
708 rpc_clone_client_set_auth(struct rpc_clnt *clnt, rpc_authflavor_t flavor)
710 struct rpc_create_args args = {
711 .program = clnt->cl_program,
712 .prognumber = clnt->cl_prog,
713 .version = clnt->cl_vers,
714 .authflavor = flavor,
715 .cred = clnt->cl_cred,
717 return __rpc_clone_client(&args, clnt);
719 EXPORT_SYMBOL_GPL(rpc_clone_client_set_auth);
722 * rpc_switch_client_transport: switch the RPC transport on the fly
723 * @clnt: pointer to a struct rpc_clnt
724 * @args: pointer to the new transport arguments
725 * @timeout: pointer to the new timeout parameters
727 * This function allows the caller to switch the RPC transport for the
728 * rpc_clnt structure 'clnt' to allow it to connect to a mirrored NFS
729 * server, for instance. It assumes that the caller has ensured that
730 * there are no active RPC tasks by using some form of locking.
732 * Returns zero if "clnt" is now using the new xprt. Otherwise a
733 * negative errno is returned, and "clnt" continues to use the old
736 int rpc_switch_client_transport(struct rpc_clnt *clnt,
737 struct xprt_create *args,
738 const struct rpc_timeout *timeout)
740 const struct rpc_timeout *old_timeo;
741 rpc_authflavor_t pseudoflavor;
742 struct rpc_xprt_switch *xps, *oldxps;
743 struct rpc_xprt *xprt, *old;
744 struct rpc_clnt *parent;
747 args->xprtsec = clnt->cl_xprtsec;
748 xprt = xprt_create_transport(args);
750 return PTR_ERR(xprt);
752 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
758 pseudoflavor = clnt->cl_auth->au_flavor;
760 old_timeo = clnt->cl_timeout;
761 old = rpc_clnt_set_transport(clnt, xprt, timeout);
762 oldxps = xprt_iter_xchg_switch(&clnt->cl_xpi, xps);
764 rpc_unregister_client(clnt);
765 __rpc_clnt_remove_pipedir(clnt);
766 rpc_sysfs_client_destroy(clnt);
767 rpc_clnt_debugfs_unregister(clnt);
770 * A new transport was created. "clnt" therefore
771 * becomes the root of a new cl_parent tree. clnt's
772 * children, if it has any, still point to the old xprt.
774 parent = clnt->cl_parent;
775 clnt->cl_parent = clnt;
778 * The old rpc_auth cache cannot be re-used. GSS
779 * contexts in particular are between a single
782 err = rpc_client_register(clnt, pseudoflavor, NULL);
788 rpc_release_client(parent);
789 xprt_switch_put(oldxps);
791 trace_rpc_clnt_replace_xprt(clnt);
795 xps = xprt_iter_xchg_switch(&clnt->cl_xpi, oldxps);
796 rpc_clnt_set_transport(clnt, old, old_timeo);
797 clnt->cl_parent = parent;
798 rpc_client_register(clnt, pseudoflavor, NULL);
799 xprt_switch_put(xps);
801 trace_rpc_clnt_replace_xprt_err(clnt);
804 EXPORT_SYMBOL_GPL(rpc_switch_client_transport);
806 static struct rpc_xprt_switch *rpc_clnt_xprt_switch_get(struct rpc_clnt *clnt)
808 struct rpc_xprt_switch *xps;
811 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
818 int _rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi,
819 void func(struct rpc_xprt_iter *xpi, struct rpc_xprt_switch *xps))
821 struct rpc_xprt_switch *xps;
823 xps = rpc_clnt_xprt_switch_get(clnt);
827 xprt_switch_put(xps);
832 int rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi)
834 return _rpc_clnt_xprt_iter_init(clnt, xpi, xprt_iter_init_listall);
838 int rpc_clnt_xprt_iter_offline_init(struct rpc_clnt *clnt,
839 struct rpc_xprt_iter *xpi)
841 return _rpc_clnt_xprt_iter_init(clnt, xpi, xprt_iter_init_listoffline);
845 * rpc_clnt_iterate_for_each_xprt - Apply a function to all transports
846 * @clnt: pointer to client
847 * @fn: function to apply
848 * @data: void pointer to function data
850 * Iterates through the list of RPC transports currently attached to the
851 * client and applies the function fn(clnt, xprt, data).
853 * On error, the iteration stops, and the function returns the error value.
855 int rpc_clnt_iterate_for_each_xprt(struct rpc_clnt *clnt,
856 int (*fn)(struct rpc_clnt *, struct rpc_xprt *, void *),
859 struct rpc_xprt_iter xpi;
862 ret = rpc_clnt_xprt_iter_init(clnt, &xpi);
866 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
870 ret = fn(clnt, xprt, data);
875 xprt_iter_destroy(&xpi);
878 EXPORT_SYMBOL_GPL(rpc_clnt_iterate_for_each_xprt);
881 * Kill all tasks for the given client.
882 * XXX: kill their descendants as well?
884 void rpc_killall_tasks(struct rpc_clnt *clnt)
886 struct rpc_task *rovr;
889 if (list_empty(&clnt->cl_tasks))
893 * Spin lock all_tasks to prevent changes...
895 trace_rpc_clnt_killall(clnt);
896 spin_lock(&clnt->cl_lock);
897 list_for_each_entry(rovr, &clnt->cl_tasks, tk_task)
898 rpc_signal_task(rovr);
899 spin_unlock(&clnt->cl_lock);
901 EXPORT_SYMBOL_GPL(rpc_killall_tasks);
904 * rpc_cancel_tasks - try to cancel a set of RPC tasks
905 * @clnt: Pointer to RPC client
906 * @error: RPC task error value to set
907 * @fnmatch: Pointer to selector function
910 * Uses @fnmatch to define a set of RPC tasks that are to be cancelled.
911 * The argument @error must be a negative error value.
913 unsigned long rpc_cancel_tasks(struct rpc_clnt *clnt, int error,
914 bool (*fnmatch)(const struct rpc_task *,
918 struct rpc_task *task;
919 unsigned long count = 0;
921 if (list_empty(&clnt->cl_tasks))
924 * Spin lock all_tasks to prevent changes...
926 spin_lock(&clnt->cl_lock);
927 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
928 if (!RPC_IS_ACTIVATED(task))
930 if (!fnmatch(task, data))
932 rpc_task_try_cancel(task, error);
935 spin_unlock(&clnt->cl_lock);
938 EXPORT_SYMBOL_GPL(rpc_cancel_tasks);
940 static int rpc_clnt_disconnect_xprt(struct rpc_clnt *clnt,
941 struct rpc_xprt *xprt, void *dummy)
943 if (xprt_connected(xprt))
944 xprt_force_disconnect(xprt);
948 void rpc_clnt_disconnect(struct rpc_clnt *clnt)
950 rpc_clnt_iterate_for_each_xprt(clnt, rpc_clnt_disconnect_xprt, NULL);
952 EXPORT_SYMBOL_GPL(rpc_clnt_disconnect);
955 * Properly shut down an RPC client, terminating all outstanding
958 void rpc_shutdown_client(struct rpc_clnt *clnt)
962 trace_rpc_clnt_shutdown(clnt);
964 while (!list_empty(&clnt->cl_tasks)) {
965 rpc_killall_tasks(clnt);
966 wait_event_timeout(destroy_wait,
967 list_empty(&clnt->cl_tasks), 1*HZ);
970 rpc_release_client(clnt);
972 EXPORT_SYMBOL_GPL(rpc_shutdown_client);
977 static void rpc_free_client_work(struct work_struct *work)
979 struct rpc_clnt *clnt = container_of(work, struct rpc_clnt, cl_work);
981 trace_rpc_clnt_free(clnt);
983 /* These might block on processes that might allocate memory,
984 * so they cannot be called in rpciod, so they are handled separately
987 rpc_sysfs_client_destroy(clnt);
988 rpc_clnt_debugfs_unregister(clnt);
990 rpc_clnt_remove_pipedir(clnt);
991 xprt_put(rcu_dereference_raw(clnt->cl_xprt));
996 static struct rpc_clnt *
997 rpc_free_client(struct rpc_clnt *clnt)
999 struct rpc_clnt *parent = NULL;
1001 trace_rpc_clnt_release(clnt);
1002 if (clnt->cl_parent != clnt)
1003 parent = clnt->cl_parent;
1004 rpc_unregister_client(clnt);
1005 rpc_free_iostats(clnt->cl_metrics);
1006 clnt->cl_metrics = NULL;
1007 xprt_iter_destroy(&clnt->cl_xpi);
1008 put_cred(clnt->cl_cred);
1010 INIT_WORK(&clnt->cl_work, rpc_free_client_work);
1011 schedule_work(&clnt->cl_work);
1016 * Free an RPC client
1018 static struct rpc_clnt *
1019 rpc_free_auth(struct rpc_clnt *clnt)
1022 * Note: RPCSEC_GSS may need to send NULL RPC calls in order to
1023 * release remaining GSS contexts. This mechanism ensures
1024 * that it can do so safely.
1026 if (clnt->cl_auth != NULL) {
1027 rpcauth_release(clnt->cl_auth);
1028 clnt->cl_auth = NULL;
1030 if (refcount_dec_and_test(&clnt->cl_count))
1031 return rpc_free_client(clnt);
1036 * Release reference to the RPC client
1039 rpc_release_client(struct rpc_clnt *clnt)
1042 if (list_empty(&clnt->cl_tasks))
1043 wake_up(&destroy_wait);
1044 if (refcount_dec_not_one(&clnt->cl_count))
1046 clnt = rpc_free_auth(clnt);
1047 } while (clnt != NULL);
1049 EXPORT_SYMBOL_GPL(rpc_release_client);
1052 * rpc_bind_new_program - bind a new RPC program to an existing client
1053 * @old: old rpc_client
1054 * @program: rpc program to set
1055 * @vers: rpc program version
1057 * Clones the rpc client and sets up a new RPC program. This is mainly
1058 * of use for enabling different RPC programs to share the same transport.
1059 * The Sun NFSv2/v3 ACL protocol can do this.
1061 struct rpc_clnt *rpc_bind_new_program(struct rpc_clnt *old,
1062 const struct rpc_program *program,
1065 struct rpc_create_args args = {
1067 .prognumber = program->number,
1069 .authflavor = old->cl_auth->au_flavor,
1070 .cred = old->cl_cred,
1072 struct rpc_clnt *clnt;
1075 clnt = __rpc_clone_client(&args, old);
1078 err = rpc_ping(clnt);
1080 rpc_shutdown_client(clnt);
1081 clnt = ERR_PTR(err);
1086 EXPORT_SYMBOL_GPL(rpc_bind_new_program);
1089 rpc_task_get_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
1091 struct rpc_xprt_switch *xps;
1096 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
1097 atomic_long_inc(&xps->xps_queuelen);
1099 atomic_long_inc(&xprt->queuelen);
1105 rpc_task_release_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
1107 struct rpc_xprt_switch *xps;
1109 atomic_long_dec(&xprt->queuelen);
1111 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
1112 atomic_long_dec(&xps->xps_queuelen);
1118 void rpc_task_release_transport(struct rpc_task *task)
1120 struct rpc_xprt *xprt = task->tk_xprt;
1123 task->tk_xprt = NULL;
1124 if (task->tk_client)
1125 rpc_task_release_xprt(task->tk_client, xprt);
1130 EXPORT_SYMBOL_GPL(rpc_task_release_transport);
1132 void rpc_task_release_client(struct rpc_task *task)
1134 struct rpc_clnt *clnt = task->tk_client;
1136 rpc_task_release_transport(task);
1138 /* Remove from client task list */
1139 spin_lock(&clnt->cl_lock);
1140 list_del(&task->tk_task);
1141 spin_unlock(&clnt->cl_lock);
1142 task->tk_client = NULL;
1144 rpc_release_client(clnt);
1148 static struct rpc_xprt *
1149 rpc_task_get_first_xprt(struct rpc_clnt *clnt)
1151 struct rpc_xprt *xprt;
1154 xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
1156 return rpc_task_get_xprt(clnt, xprt);
1159 static struct rpc_xprt *
1160 rpc_task_get_next_xprt(struct rpc_clnt *clnt)
1162 return rpc_task_get_xprt(clnt, xprt_iter_get_next(&clnt->cl_xpi));
1166 void rpc_task_set_transport(struct rpc_task *task, struct rpc_clnt *clnt)
1168 if (task->tk_xprt) {
1169 if (!(test_bit(XPRT_OFFLINE, &task->tk_xprt->state) &&
1170 (task->tk_flags & RPC_TASK_MOVEABLE)))
1173 xprt_put(task->tk_xprt);
1175 if (task->tk_flags & RPC_TASK_NO_ROUND_ROBIN)
1176 task->tk_xprt = rpc_task_get_first_xprt(clnt);
1178 task->tk_xprt = rpc_task_get_next_xprt(clnt);
1182 void rpc_task_set_client(struct rpc_task *task, struct rpc_clnt *clnt)
1184 rpc_task_set_transport(task, clnt);
1185 task->tk_client = clnt;
1186 refcount_inc(&clnt->cl_count);
1187 if (clnt->cl_softrtry)
1188 task->tk_flags |= RPC_TASK_SOFT;
1189 if (clnt->cl_softerr)
1190 task->tk_flags |= RPC_TASK_TIMEOUT;
1191 if (clnt->cl_noretranstimeo)
1192 task->tk_flags |= RPC_TASK_NO_RETRANS_TIMEOUT;
1193 /* Add to the client's list of all tasks */
1194 spin_lock(&clnt->cl_lock);
1195 list_add_tail(&task->tk_task, &clnt->cl_tasks);
1196 spin_unlock(&clnt->cl_lock);
1200 rpc_task_set_rpc_message(struct rpc_task *task, const struct rpc_message *msg)
1203 task->tk_msg.rpc_proc = msg->rpc_proc;
1204 task->tk_msg.rpc_argp = msg->rpc_argp;
1205 task->tk_msg.rpc_resp = msg->rpc_resp;
1206 task->tk_msg.rpc_cred = msg->rpc_cred;
1207 if (!(task->tk_flags & RPC_TASK_CRED_NOREF))
1208 get_cred(task->tk_msg.rpc_cred);
1213 * Default callback for async RPC calls
1216 rpc_default_callback(struct rpc_task *task, void *data)
1220 static const struct rpc_call_ops rpc_default_ops = {
1221 .rpc_call_done = rpc_default_callback,
1225 * rpc_run_task - Allocate a new RPC task, then run rpc_execute against it
1226 * @task_setup_data: pointer to task initialisation data
1228 struct rpc_task *rpc_run_task(const struct rpc_task_setup *task_setup_data)
1230 struct rpc_task *task;
1232 task = rpc_new_task(task_setup_data);
1236 if (!RPC_IS_ASYNC(task))
1237 task->tk_flags |= RPC_TASK_CRED_NOREF;
1239 rpc_task_set_client(task, task_setup_data->rpc_client);
1240 rpc_task_set_rpc_message(task, task_setup_data->rpc_message);
1242 if (task->tk_action == NULL)
1243 rpc_call_start(task);
1245 atomic_inc(&task->tk_count);
1249 EXPORT_SYMBOL_GPL(rpc_run_task);
1252 * rpc_call_sync - Perform a synchronous RPC call
1253 * @clnt: pointer to RPC client
1254 * @msg: RPC call parameters
1255 * @flags: RPC call flags
1257 int rpc_call_sync(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags)
1259 struct rpc_task *task;
1260 struct rpc_task_setup task_setup_data = {
1263 .callback_ops = &rpc_default_ops,
1268 WARN_ON_ONCE(flags & RPC_TASK_ASYNC);
1269 if (flags & RPC_TASK_ASYNC) {
1270 rpc_release_calldata(task_setup_data.callback_ops,
1271 task_setup_data.callback_data);
1275 task = rpc_run_task(&task_setup_data);
1277 return PTR_ERR(task);
1278 status = task->tk_status;
1282 EXPORT_SYMBOL_GPL(rpc_call_sync);
1285 * rpc_call_async - Perform an asynchronous RPC call
1286 * @clnt: pointer to RPC client
1287 * @msg: RPC call parameters
1288 * @flags: RPC call flags
1289 * @tk_ops: RPC call ops
1290 * @data: user call data
1293 rpc_call_async(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags,
1294 const struct rpc_call_ops *tk_ops, void *data)
1296 struct rpc_task *task;
1297 struct rpc_task_setup task_setup_data = {
1300 .callback_ops = tk_ops,
1301 .callback_data = data,
1302 .flags = flags|RPC_TASK_ASYNC,
1305 task = rpc_run_task(&task_setup_data);
1307 return PTR_ERR(task);
1311 EXPORT_SYMBOL_GPL(rpc_call_async);
1313 #if defined(CONFIG_SUNRPC_BACKCHANNEL)
1314 static void call_bc_encode(struct rpc_task *task);
1317 * rpc_run_bc_task - Allocate a new RPC task for backchannel use, then run
1318 * rpc_execute against it
1320 * @timeout: timeout values to use for this task
1322 struct rpc_task *rpc_run_bc_task(struct rpc_rqst *req,
1323 struct rpc_timeout *timeout)
1325 struct rpc_task *task;
1326 struct rpc_task_setup task_setup_data = {
1327 .callback_ops = &rpc_default_ops,
1328 .flags = RPC_TASK_SOFTCONN |
1329 RPC_TASK_NO_RETRANS_TIMEOUT,
1332 dprintk("RPC: rpc_run_bc_task req= %p\n", req);
1334 * Create an rpc_task to send the data
1336 task = rpc_new_task(&task_setup_data);
1338 xprt_free_bc_request(req);
1342 xprt_init_bc_request(req, task, timeout);
1344 task->tk_action = call_bc_encode;
1345 atomic_inc(&task->tk_count);
1346 WARN_ON_ONCE(atomic_read(&task->tk_count) != 2);
1349 dprintk("RPC: rpc_run_bc_task: task= %p\n", task);
1352 #endif /* CONFIG_SUNRPC_BACKCHANNEL */
1355 * rpc_prepare_reply_pages - Prepare to receive a reply data payload into pages
1356 * @req: RPC request to prepare
1357 * @pages: vector of struct page pointers
1358 * @base: offset in first page where receive should start, in bytes
1359 * @len: expected size of the upper layer data payload, in bytes
1360 * @hdrsize: expected size of upper layer reply header, in XDR words
1363 void rpc_prepare_reply_pages(struct rpc_rqst *req, struct page **pages,
1364 unsigned int base, unsigned int len,
1365 unsigned int hdrsize)
1367 hdrsize += RPC_REPHDRSIZE + req->rq_cred->cr_auth->au_ralign;
1369 xdr_inline_pages(&req->rq_rcv_buf, hdrsize << 2, pages, base, len);
1370 trace_rpc_xdr_reply_pages(req->rq_task, &req->rq_rcv_buf);
1372 EXPORT_SYMBOL_GPL(rpc_prepare_reply_pages);
1375 rpc_call_start(struct rpc_task *task)
1377 task->tk_action = call_start;
1379 EXPORT_SYMBOL_GPL(rpc_call_start);
1382 * rpc_peeraddr - extract remote peer address from clnt's xprt
1383 * @clnt: RPC client structure
1384 * @buf: target buffer
1385 * @bufsize: length of target buffer
1387 * Returns the number of bytes that are actually in the stored address.
1389 size_t rpc_peeraddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t bufsize)
1392 struct rpc_xprt *xprt;
1395 xprt = rcu_dereference(clnt->cl_xprt);
1397 bytes = xprt->addrlen;
1398 if (bytes > bufsize)
1400 memcpy(buf, &xprt->addr, bytes);
1405 EXPORT_SYMBOL_GPL(rpc_peeraddr);
1408 * rpc_peeraddr2str - return remote peer address in printable format
1409 * @clnt: RPC client structure
1410 * @format: address format
1412 * NB: the lifetime of the memory referenced by the returned pointer is
1413 * the same as the rpc_xprt itself. As long as the caller uses this
1414 * pointer, it must hold the RCU read lock.
1416 const char *rpc_peeraddr2str(struct rpc_clnt *clnt,
1417 enum rpc_display_format_t format)
1419 struct rpc_xprt *xprt;
1421 xprt = rcu_dereference(clnt->cl_xprt);
1423 if (xprt->address_strings[format] != NULL)
1424 return xprt->address_strings[format];
1426 return "unprintable";
1428 EXPORT_SYMBOL_GPL(rpc_peeraddr2str);
1430 static const struct sockaddr_in rpc_inaddr_loopback = {
1431 .sin_family = AF_INET,
1432 .sin_addr.s_addr = htonl(INADDR_ANY),
1435 static const struct sockaddr_in6 rpc_in6addr_loopback = {
1436 .sin6_family = AF_INET6,
1437 .sin6_addr = IN6ADDR_ANY_INIT,
1441 * Try a getsockname() on a connected datagram socket. Using a
1442 * connected datagram socket prevents leaving a socket in TIME_WAIT.
1443 * This conserves the ephemeral port number space.
1445 * Returns zero and fills in "buf" if successful; otherwise, a
1446 * negative errno is returned.
1448 static int rpc_sockname(struct net *net, struct sockaddr *sap, size_t salen,
1449 struct sockaddr *buf)
1451 struct socket *sock;
1454 err = __sock_create(net, sap->sa_family,
1455 SOCK_DGRAM, IPPROTO_UDP, &sock, 1);
1457 dprintk("RPC: can't create UDP socket (%d)\n", err);
1461 switch (sap->sa_family) {
1463 err = kernel_bind(sock,
1464 (struct sockaddr *)&rpc_inaddr_loopback,
1465 sizeof(rpc_inaddr_loopback));
1468 err = kernel_bind(sock,
1469 (struct sockaddr *)&rpc_in6addr_loopback,
1470 sizeof(rpc_in6addr_loopback));
1473 err = -EAFNOSUPPORT;
1477 dprintk("RPC: can't bind UDP socket (%d)\n", err);
1481 err = kernel_connect(sock, sap, salen, 0);
1483 dprintk("RPC: can't connect UDP socket (%d)\n", err);
1487 err = kernel_getsockname(sock, buf);
1489 dprintk("RPC: getsockname failed (%d)\n", err);
1494 if (buf->sa_family == AF_INET6) {
1495 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)buf;
1496 sin6->sin6_scope_id = 0;
1498 dprintk("RPC: %s succeeded\n", __func__);
1507 * Scraping a connected socket failed, so we don't have a useable
1508 * local address. Fallback: generate an address that will prevent
1509 * the server from calling us back.
1511 * Returns zero and fills in "buf" if successful; otherwise, a
1512 * negative errno is returned.
1514 static int rpc_anyaddr(int family, struct sockaddr *buf, size_t buflen)
1518 if (buflen < sizeof(rpc_inaddr_loopback))
1520 memcpy(buf, &rpc_inaddr_loopback,
1521 sizeof(rpc_inaddr_loopback));
1524 if (buflen < sizeof(rpc_in6addr_loopback))
1526 memcpy(buf, &rpc_in6addr_loopback,
1527 sizeof(rpc_in6addr_loopback));
1530 dprintk("RPC: %s: address family not supported\n",
1532 return -EAFNOSUPPORT;
1534 dprintk("RPC: %s: succeeded\n", __func__);
1539 * rpc_localaddr - discover local endpoint address for an RPC client
1540 * @clnt: RPC client structure
1541 * @buf: target buffer
1542 * @buflen: size of target buffer, in bytes
1544 * Returns zero and fills in "buf" and "buflen" if successful;
1545 * otherwise, a negative errno is returned.
1547 * This works even if the underlying transport is not currently connected,
1548 * or if the upper layer never previously provided a source address.
1550 * The result of this function call is transient: multiple calls in
1551 * succession may give different results, depending on how local
1552 * networking configuration changes over time.
1554 int rpc_localaddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t buflen)
1556 struct sockaddr_storage address;
1557 struct sockaddr *sap = (struct sockaddr *)&address;
1558 struct rpc_xprt *xprt;
1564 xprt = rcu_dereference(clnt->cl_xprt);
1565 salen = xprt->addrlen;
1566 memcpy(sap, &xprt->addr, salen);
1567 net = get_net(xprt->xprt_net);
1570 rpc_set_port(sap, 0);
1571 err = rpc_sockname(net, sap, salen, buf);
1574 /* Couldn't discover local address, return ANYADDR */
1575 return rpc_anyaddr(sap->sa_family, buf, buflen);
1578 EXPORT_SYMBOL_GPL(rpc_localaddr);
1581 rpc_setbufsize(struct rpc_clnt *clnt, unsigned int sndsize, unsigned int rcvsize)
1583 struct rpc_xprt *xprt;
1586 xprt = rcu_dereference(clnt->cl_xprt);
1587 if (xprt->ops->set_buffer_size)
1588 xprt->ops->set_buffer_size(xprt, sndsize, rcvsize);
1591 EXPORT_SYMBOL_GPL(rpc_setbufsize);
1594 * rpc_net_ns - Get the network namespace for this RPC client
1595 * @clnt: RPC client to query
1598 struct net *rpc_net_ns(struct rpc_clnt *clnt)
1603 ret = rcu_dereference(clnt->cl_xprt)->xprt_net;
1607 EXPORT_SYMBOL_GPL(rpc_net_ns);
1610 * rpc_max_payload - Get maximum payload size for a transport, in bytes
1611 * @clnt: RPC client to query
1613 * For stream transports, this is one RPC record fragment (see RFC
1614 * 1831), as we don't support multi-record requests yet. For datagram
1615 * transports, this is the size of an IP packet minus the IP, UDP, and
1618 size_t rpc_max_payload(struct rpc_clnt *clnt)
1623 ret = rcu_dereference(clnt->cl_xprt)->max_payload;
1627 EXPORT_SYMBOL_GPL(rpc_max_payload);
1630 * rpc_max_bc_payload - Get maximum backchannel payload size, in bytes
1631 * @clnt: RPC client to query
1633 size_t rpc_max_bc_payload(struct rpc_clnt *clnt)
1635 struct rpc_xprt *xprt;
1639 xprt = rcu_dereference(clnt->cl_xprt);
1640 ret = xprt->ops->bc_maxpayload(xprt);
1644 EXPORT_SYMBOL_GPL(rpc_max_bc_payload);
1646 unsigned int rpc_num_bc_slots(struct rpc_clnt *clnt)
1648 struct rpc_xprt *xprt;
1652 xprt = rcu_dereference(clnt->cl_xprt);
1653 ret = xprt->ops->bc_num_slots(xprt);
1657 EXPORT_SYMBOL_GPL(rpc_num_bc_slots);
1660 * rpc_force_rebind - force transport to check that remote port is unchanged
1661 * @clnt: client to rebind
1664 void rpc_force_rebind(struct rpc_clnt *clnt)
1666 if (clnt->cl_autobind) {
1668 xprt_clear_bound(rcu_dereference(clnt->cl_xprt));
1672 EXPORT_SYMBOL_GPL(rpc_force_rebind);
1675 __rpc_restart_call(struct rpc_task *task, void (*action)(struct rpc_task *))
1677 task->tk_status = 0;
1678 task->tk_rpc_status = 0;
1679 task->tk_action = action;
1684 * Restart an (async) RPC call. Usually called from within the
1688 rpc_restart_call(struct rpc_task *task)
1690 return __rpc_restart_call(task, call_start);
1692 EXPORT_SYMBOL_GPL(rpc_restart_call);
1695 * Restart an (async) RPC call from the call_prepare state.
1696 * Usually called from within the exit handler.
1699 rpc_restart_call_prepare(struct rpc_task *task)
1701 if (task->tk_ops->rpc_call_prepare != NULL)
1702 return __rpc_restart_call(task, rpc_prepare_task);
1703 return rpc_restart_call(task);
1705 EXPORT_SYMBOL_GPL(rpc_restart_call_prepare);
1708 *rpc_proc_name(const struct rpc_task *task)
1710 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1714 return proc->p_name;
1722 __rpc_call_rpcerror(struct rpc_task *task, int tk_status, int rpc_status)
1724 trace_rpc_call_rpcerror(task, tk_status, rpc_status);
1725 rpc_task_set_rpc_status(task, rpc_status);
1726 rpc_exit(task, tk_status);
1730 rpc_call_rpcerror(struct rpc_task *task, int status)
1732 __rpc_call_rpcerror(task, status, status);
1738 * Other FSM states can be visited zero or more times, but
1739 * this state is visited exactly once for each RPC.
1742 call_start(struct rpc_task *task)
1744 struct rpc_clnt *clnt = task->tk_client;
1745 int idx = task->tk_msg.rpc_proc->p_statidx;
1747 trace_rpc_request(task);
1749 if (task->tk_client->cl_shutdown) {
1750 rpc_call_rpcerror(task, -EIO);
1754 /* Increment call count (version might not be valid for ping) */
1755 if (clnt->cl_program->version[clnt->cl_vers])
1756 clnt->cl_program->version[clnt->cl_vers]->counts[idx]++;
1757 clnt->cl_stats->rpccnt++;
1758 task->tk_action = call_reserve;
1759 rpc_task_set_transport(task, clnt);
1763 * 1. Reserve an RPC call slot
1766 call_reserve(struct rpc_task *task)
1768 task->tk_status = 0;
1769 task->tk_action = call_reserveresult;
1773 static void call_retry_reserve(struct rpc_task *task);
1776 * 1b. Grok the result of xprt_reserve()
1779 call_reserveresult(struct rpc_task *task)
1781 int status = task->tk_status;
1784 * After a call to xprt_reserve(), we must have either
1785 * a request slot or else an error status.
1787 task->tk_status = 0;
1789 if (task->tk_rqstp) {
1790 task->tk_action = call_refresh;
1794 rpc_call_rpcerror(task, -EIO);
1800 rpc_delay(task, HZ >> 2);
1802 case -EAGAIN: /* woken up; retry */
1803 task->tk_action = call_retry_reserve;
1806 rpc_call_rpcerror(task, status);
1811 * 1c. Retry reserving an RPC call slot
1814 call_retry_reserve(struct rpc_task *task)
1816 task->tk_status = 0;
1817 task->tk_action = call_reserveresult;
1818 xprt_retry_reserve(task);
1822 * 2. Bind and/or refresh the credentials
1825 call_refresh(struct rpc_task *task)
1827 task->tk_action = call_refreshresult;
1828 task->tk_status = 0;
1829 task->tk_client->cl_stats->rpcauthrefresh++;
1830 rpcauth_refreshcred(task);
1834 * 2a. Process the results of a credential refresh
1837 call_refreshresult(struct rpc_task *task)
1839 int status = task->tk_status;
1841 task->tk_status = 0;
1842 task->tk_action = call_refresh;
1845 if (rpcauth_uptodatecred(task)) {
1846 task->tk_action = call_allocate;
1849 /* Use rate-limiting and a max number of retries if refresh
1850 * had status 0 but failed to update the cred.
1854 rpc_delay(task, 3*HZ);
1860 if (!task->tk_cred_retry)
1862 task->tk_cred_retry--;
1863 trace_rpc_retry_refresh_status(task);
1866 rpc_delay(task, HZ >> 4);
1869 trace_rpc_refresh_status(task);
1870 rpc_call_rpcerror(task, status);
1874 * 2b. Allocate the buffer. For details, see sched.c:rpc_malloc.
1875 * (Note: buffer memory is freed in xprt_release).
1878 call_allocate(struct rpc_task *task)
1880 const struct rpc_auth *auth = task->tk_rqstp->rq_cred->cr_auth;
1881 struct rpc_rqst *req = task->tk_rqstp;
1882 struct rpc_xprt *xprt = req->rq_xprt;
1883 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1886 task->tk_status = 0;
1887 task->tk_action = call_encode;
1892 if (proc->p_proc != 0) {
1893 BUG_ON(proc->p_arglen == 0);
1894 if (proc->p_decode != NULL)
1895 BUG_ON(proc->p_replen == 0);
1899 * Calculate the size (in quads) of the RPC call
1900 * and reply headers, and convert both values
1903 req->rq_callsize = RPC_CALLHDRSIZE + (auth->au_cslack << 1) +
1905 req->rq_callsize <<= 2;
1907 * Note: the reply buffer must at minimum allocate enough space
1908 * for the 'struct accepted_reply' from RFC5531.
1910 req->rq_rcvsize = RPC_REPHDRSIZE + auth->au_rslack + \
1911 max_t(size_t, proc->p_replen, 2);
1912 req->rq_rcvsize <<= 2;
1914 status = xprt->ops->buf_alloc(task);
1915 trace_rpc_buf_alloc(task, status);
1918 if (status != -ENOMEM) {
1919 rpc_call_rpcerror(task, status);
1923 if (RPC_IS_ASYNC(task) || !fatal_signal_pending(current)) {
1924 task->tk_action = call_allocate;
1925 rpc_delay(task, HZ>>4);
1929 rpc_call_rpcerror(task, -ERESTARTSYS);
1933 rpc_task_need_encode(struct rpc_task *task)
1935 return test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate) == 0 &&
1936 (!(task->tk_flags & RPC_TASK_SENT) ||
1937 !(task->tk_flags & RPC_TASK_NO_RETRANS_TIMEOUT) ||
1938 xprt_request_need_retransmit(task));
1942 rpc_xdr_encode(struct rpc_task *task)
1944 struct rpc_rqst *req = task->tk_rqstp;
1945 struct xdr_stream xdr;
1947 xdr_buf_init(&req->rq_snd_buf,
1950 xdr_buf_init(&req->rq_rcv_buf,
1954 req->rq_reply_bytes_recvd = 0;
1955 req->rq_snd_buf.head[0].iov_len = 0;
1956 xdr_init_encode(&xdr, &req->rq_snd_buf,
1957 req->rq_snd_buf.head[0].iov_base, req);
1958 if (rpc_encode_header(task, &xdr))
1961 task->tk_status = rpcauth_wrap_req(task, &xdr);
1965 * 3. Encode arguments of an RPC call
1968 call_encode(struct rpc_task *task)
1970 if (!rpc_task_need_encode(task))
1973 /* Dequeue task from the receive queue while we're encoding */
1974 xprt_request_dequeue_xprt(task);
1975 /* Encode here so that rpcsec_gss can use correct sequence number. */
1976 rpc_xdr_encode(task);
1977 /* Add task to reply queue before transmission to avoid races */
1978 if (task->tk_status == 0 && rpc_reply_expected(task))
1979 task->tk_status = xprt_request_enqueue_receive(task);
1980 /* Did the encode result in an error condition? */
1981 if (task->tk_status != 0) {
1982 /* Was the error nonfatal? */
1983 switch (task->tk_status) {
1986 rpc_delay(task, HZ >> 4);
1989 if (!task->tk_cred_retry) {
1990 rpc_call_rpcerror(task, task->tk_status);
1992 task->tk_action = call_refresh;
1993 task->tk_cred_retry--;
1994 trace_rpc_retry_refresh_status(task);
1998 rpc_call_rpcerror(task, task->tk_status);
2003 xprt_request_enqueue_transmit(task);
2005 task->tk_action = call_transmit;
2006 /* Check that the connection is OK */
2007 if (!xprt_bound(task->tk_xprt))
2008 task->tk_action = call_bind;
2009 else if (!xprt_connected(task->tk_xprt))
2010 task->tk_action = call_connect;
2014 * Helpers to check if the task was already transmitted, and
2015 * to take action when that is the case.
2018 rpc_task_transmitted(struct rpc_task *task)
2020 return !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
2024 rpc_task_handle_transmitted(struct rpc_task *task)
2026 xprt_end_transmit(task);
2027 task->tk_action = call_transmit_status;
2031 * 4. Get the server port number if not yet set
2034 call_bind(struct rpc_task *task)
2036 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2038 if (rpc_task_transmitted(task)) {
2039 rpc_task_handle_transmitted(task);
2043 if (xprt_bound(xprt)) {
2044 task->tk_action = call_connect;
2048 task->tk_action = call_bind_status;
2049 if (!xprt_prepare_transmit(task))
2052 xprt->ops->rpcbind(task);
2056 * 4a. Sort out bind result
2059 call_bind_status(struct rpc_task *task)
2061 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2064 if (rpc_task_transmitted(task)) {
2065 rpc_task_handle_transmitted(task);
2069 if (task->tk_status >= 0)
2071 if (xprt_bound(xprt)) {
2072 task->tk_status = 0;
2076 switch (task->tk_status) {
2078 rpc_delay(task, HZ >> 2);
2081 trace_rpcb_prog_unavail_err(task);
2082 /* fail immediately if this is an RPC ping */
2083 if (task->tk_msg.rpc_proc->p_proc == 0) {
2084 status = -EOPNOTSUPP;
2087 rpc_delay(task, 3*HZ);
2090 rpc_delay(task, HZ >> 2);
2095 trace_rpcb_timeout_err(task);
2098 /* server doesn't support any rpcbind version we know of */
2099 trace_rpcb_bind_version_err(task);
2101 case -EPROTONOSUPPORT:
2102 trace_rpcb_bind_version_err(task);
2104 case -ECONNREFUSED: /* connection problems */
2113 trace_rpcb_unreachable_err(task);
2114 if (!RPC_IS_SOFTCONN(task)) {
2115 rpc_delay(task, 5*HZ);
2118 status = task->tk_status;
2121 trace_rpcb_unrecognized_err(task);
2124 rpc_call_rpcerror(task, status);
2127 task->tk_action = call_connect;
2130 task->tk_status = 0;
2131 task->tk_action = call_bind;
2132 rpc_check_timeout(task);
2136 * 4b. Connect to the RPC server
2139 call_connect(struct rpc_task *task)
2141 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2143 if (rpc_task_transmitted(task)) {
2144 rpc_task_handle_transmitted(task);
2148 if (xprt_connected(xprt)) {
2149 task->tk_action = call_transmit;
2153 task->tk_action = call_connect_status;
2154 if (task->tk_status < 0)
2156 if (task->tk_flags & RPC_TASK_NOCONNECT) {
2157 rpc_call_rpcerror(task, -ENOTCONN);
2160 if (!xprt_prepare_transmit(task))
2166 * 4c. Sort out connect result
2169 call_connect_status(struct rpc_task *task)
2171 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2172 struct rpc_clnt *clnt = task->tk_client;
2173 int status = task->tk_status;
2175 if (rpc_task_transmitted(task)) {
2176 rpc_task_handle_transmitted(task);
2180 trace_rpc_connect_status(task);
2182 if (task->tk_status == 0) {
2183 clnt->cl_stats->netreconn++;
2186 if (xprt_connected(xprt)) {
2187 task->tk_status = 0;
2191 task->tk_status = 0;
2195 /* A positive refusal suggests a rebind is needed. */
2196 if (RPC_IS_SOFTCONN(task))
2198 if (clnt->cl_autobind) {
2199 rpc_force_rebind(clnt);
2209 xprt_conditional_disconnect(task->tk_rqstp->rq_xprt,
2210 task->tk_rqstp->rq_connect_cookie);
2211 if (RPC_IS_SOFTCONN(task))
2213 /* retry with existing socket, after a delay */
2214 rpc_delay(task, 3*HZ);
2220 if (!(task->tk_flags & RPC_TASK_NO_ROUND_ROBIN) &&
2221 (task->tk_flags & RPC_TASK_MOVEABLE) &&
2222 test_bit(XPRT_REMOVE, &xprt->state)) {
2223 struct rpc_xprt *saved = task->tk_xprt;
2224 struct rpc_xprt_switch *xps;
2226 xps = rpc_clnt_xprt_switch_get(clnt);
2227 if (xps->xps_nxprts > 1) {
2231 value = atomic_long_dec_return(&xprt->queuelen);
2233 rpc_xprt_switch_remove_xprt(xps, saved,
2236 task->tk_xprt = NULL;
2237 task->tk_action = call_start;
2239 xprt_switch_put(xps);
2245 rpc_delay(task, HZ >> 2);
2248 rpc_call_rpcerror(task, status);
2251 task->tk_action = call_transmit;
2254 /* Check for timeouts before looping back to call_bind */
2255 task->tk_action = call_bind;
2257 rpc_check_timeout(task);
2261 * 5. Transmit the RPC request, and wait for reply
2264 call_transmit(struct rpc_task *task)
2266 if (rpc_task_transmitted(task)) {
2267 rpc_task_handle_transmitted(task);
2271 task->tk_action = call_transmit_status;
2272 if (!xprt_prepare_transmit(task))
2274 task->tk_status = 0;
2275 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2276 if (!xprt_connected(task->tk_xprt)) {
2277 task->tk_status = -ENOTCONN;
2280 xprt_transmit(task);
2282 xprt_end_transmit(task);
2286 * 5a. Handle cleanup after a transmission
2289 call_transmit_status(struct rpc_task *task)
2291 task->tk_action = call_status;
2294 * Common case: success. Force the compiler to put this
2297 if (rpc_task_transmitted(task)) {
2298 task->tk_status = 0;
2299 xprt_request_wait_receive(task);
2303 switch (task->tk_status) {
2307 task->tk_status = 0;
2308 task->tk_action = call_encode;
2311 * Special cases: if we've been waiting on the
2312 * socket's write_space() callback, or if the
2313 * socket just returned a connection error,
2314 * then hold onto the transport lock.
2318 rpc_delay(task, HZ>>2);
2322 task->tk_action = call_transmit;
2323 task->tk_status = 0;
2331 if (RPC_IS_SOFTCONN(task)) {
2332 if (!task->tk_msg.rpc_proc->p_proc)
2333 trace_xprt_ping(task->tk_xprt,
2335 rpc_call_rpcerror(task, task->tk_status);
2344 task->tk_action = call_bind;
2345 task->tk_status = 0;
2348 rpc_check_timeout(task);
2351 #if defined(CONFIG_SUNRPC_BACKCHANNEL)
2352 static void call_bc_transmit(struct rpc_task *task);
2353 static void call_bc_transmit_status(struct rpc_task *task);
2356 call_bc_encode(struct rpc_task *task)
2358 xprt_request_enqueue_transmit(task);
2359 task->tk_action = call_bc_transmit;
2363 * 5b. Send the backchannel RPC reply. On error, drop the reply. In
2364 * addition, disconnect on connectivity errors.
2367 call_bc_transmit(struct rpc_task *task)
2369 task->tk_action = call_bc_transmit_status;
2370 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2371 if (!xprt_prepare_transmit(task))
2373 task->tk_status = 0;
2374 xprt_transmit(task);
2376 xprt_end_transmit(task);
2380 call_bc_transmit_status(struct rpc_task *task)
2382 struct rpc_rqst *req = task->tk_rqstp;
2384 if (rpc_task_transmitted(task))
2385 task->tk_status = 0;
2387 switch (task->tk_status) {
2402 rpc_delay(task, HZ>>2);
2406 task->tk_status = 0;
2407 task->tk_action = call_bc_transmit;
2411 * Problem reaching the server. Disconnect and let the
2412 * forechannel reestablish the connection. The server will
2413 * have to retransmit the backchannel request and we'll
2414 * reprocess it. Since these ops are idempotent, there's no
2415 * need to cache our reply at this time.
2417 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2418 "error: %d\n", task->tk_status);
2419 xprt_conditional_disconnect(req->rq_xprt,
2420 req->rq_connect_cookie);
2424 * We were unable to reply and will have to drop the
2425 * request. The server should reconnect and retransmit.
2427 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2428 "error: %d\n", task->tk_status);
2431 task->tk_action = rpc_exit_task;
2433 #endif /* CONFIG_SUNRPC_BACKCHANNEL */
2436 * 6. Sort out the RPC call status
2439 call_status(struct rpc_task *task)
2441 struct rpc_clnt *clnt = task->tk_client;
2444 if (!task->tk_msg.rpc_proc->p_proc)
2445 trace_xprt_ping(task->tk_xprt, task->tk_status);
2447 status = task->tk_status;
2449 task->tk_action = call_decode;
2453 trace_rpc_call_status(task);
2454 task->tk_status = 0;
2461 if (RPC_IS_SOFTCONN(task))
2464 * Delay any retries for 3 seconds, then handle as if it
2467 rpc_delay(task, 3*HZ);
2475 rpc_force_rebind(clnt);
2478 rpc_delay(task, 3*HZ);
2486 rpc_delay(task, HZ>>2);
2489 /* shutdown or soft timeout */
2492 if (clnt->cl_chatty)
2493 printk("%s: RPC call returned error %d\n",
2494 clnt->cl_program->name, -status);
2497 task->tk_action = call_encode;
2498 rpc_check_timeout(task);
2501 rpc_call_rpcerror(task, status);
2505 rpc_check_connected(const struct rpc_rqst *req)
2507 /* No allocated request or transport? return true */
2508 if (!req || !req->rq_xprt)
2510 return xprt_connected(req->rq_xprt);
2514 rpc_check_timeout(struct rpc_task *task)
2516 struct rpc_clnt *clnt = task->tk_client;
2518 if (RPC_SIGNALLED(task))
2521 if (xprt_adjust_timeout(task->tk_rqstp) == 0)
2524 trace_rpc_timeout_status(task);
2525 task->tk_timeouts++;
2527 if (RPC_IS_SOFTCONN(task) && !rpc_check_connected(task->tk_rqstp)) {
2528 rpc_call_rpcerror(task, -ETIMEDOUT);
2532 if (RPC_IS_SOFT(task)) {
2534 * Once a "no retrans timeout" soft tasks (a.k.a NFSv4) has
2535 * been sent, it should time out only if the transport
2536 * connection gets terminally broken.
2538 if ((task->tk_flags & RPC_TASK_NO_RETRANS_TIMEOUT) &&
2539 rpc_check_connected(task->tk_rqstp))
2542 if (clnt->cl_chatty) {
2543 pr_notice_ratelimited(
2544 "%s: server %s not responding, timed out\n",
2545 clnt->cl_program->name,
2546 task->tk_xprt->servername);
2548 if (task->tk_flags & RPC_TASK_TIMEOUT)
2549 rpc_call_rpcerror(task, -ETIMEDOUT);
2551 __rpc_call_rpcerror(task, -EIO, -ETIMEDOUT);
2555 if (!(task->tk_flags & RPC_CALL_MAJORSEEN)) {
2556 task->tk_flags |= RPC_CALL_MAJORSEEN;
2557 if (clnt->cl_chatty) {
2558 pr_notice_ratelimited(
2559 "%s: server %s not responding, still trying\n",
2560 clnt->cl_program->name,
2561 task->tk_xprt->servername);
2564 rpc_force_rebind(clnt);
2566 * Did our request time out due to an RPCSEC_GSS out-of-sequence
2567 * event? RFC2203 requires the server to drop all such requests.
2569 rpcauth_invalcred(task);
2573 * 7. Decode the RPC reply
2576 call_decode(struct rpc_task *task)
2578 struct rpc_clnt *clnt = task->tk_client;
2579 struct rpc_rqst *req = task->tk_rqstp;
2580 struct xdr_stream xdr;
2583 if (!task->tk_msg.rpc_proc->p_decode) {
2584 task->tk_action = rpc_exit_task;
2588 if (task->tk_flags & RPC_CALL_MAJORSEEN) {
2589 if (clnt->cl_chatty) {
2590 pr_notice_ratelimited("%s: server %s OK\n",
2591 clnt->cl_program->name,
2592 task->tk_xprt->servername);
2594 task->tk_flags &= ~RPC_CALL_MAJORSEEN;
2598 * Did we ever call xprt_complete_rqst()? If not, we should assume
2599 * the message is incomplete.
2602 if (!req->rq_reply_bytes_recvd)
2605 /* Ensure that we see all writes made by xprt_complete_rqst()
2606 * before it changed req->rq_reply_bytes_recvd.
2610 req->rq_rcv_buf.len = req->rq_private_buf.len;
2611 trace_rpc_xdr_recvfrom(task, &req->rq_rcv_buf);
2613 /* Check that the softirq receive buffer is valid */
2614 WARN_ON(memcmp(&req->rq_rcv_buf, &req->rq_private_buf,
2615 sizeof(req->rq_rcv_buf)) != 0);
2617 xdr_init_decode(&xdr, &req->rq_rcv_buf,
2618 req->rq_rcv_buf.head[0].iov_base, req);
2619 err = rpc_decode_header(task, &xdr);
2623 task->tk_action = rpc_exit_task;
2624 task->tk_status = rpcauth_unwrap_resp(task, &xdr);
2625 xdr_finish_decode(&xdr);
2628 task->tk_status = 0;
2629 if (task->tk_client->cl_discrtry)
2630 xprt_conditional_disconnect(req->rq_xprt,
2631 req->rq_connect_cookie);
2632 task->tk_action = call_encode;
2633 rpc_check_timeout(task);
2636 task->tk_action = call_reserve;
2637 rpc_check_timeout(task);
2638 rpcauth_invalcred(task);
2639 /* Ensure we obtain a new XID if we retry! */
2645 rpc_encode_header(struct rpc_task *task, struct xdr_stream *xdr)
2647 struct rpc_clnt *clnt = task->tk_client;
2648 struct rpc_rqst *req = task->tk_rqstp;
2653 p = xdr_reserve_space(xdr, RPC_CALLHDRSIZE << 2);
2658 *p++ = cpu_to_be32(RPC_VERSION);
2659 *p++ = cpu_to_be32(clnt->cl_prog);
2660 *p++ = cpu_to_be32(clnt->cl_vers);
2661 *p = cpu_to_be32(task->tk_msg.rpc_proc->p_proc);
2663 error = rpcauth_marshcred(task, xdr);
2668 trace_rpc_bad_callhdr(task);
2669 rpc_call_rpcerror(task, error);
2674 rpc_decode_header(struct rpc_task *task, struct xdr_stream *xdr)
2676 struct rpc_clnt *clnt = task->tk_client;
2680 /* RFC-1014 says that the representation of XDR data must be a
2681 * multiple of four bytes
2682 * - if it isn't pointer subtraction in the NFS client may give
2685 if (task->tk_rqstp->rq_rcv_buf.len & 3)
2686 goto out_unparsable;
2688 p = xdr_inline_decode(xdr, 3 * sizeof(*p));
2690 goto out_unparsable;
2692 if (*p++ != rpc_reply)
2693 goto out_unparsable;
2694 if (*p++ != rpc_msg_accepted)
2695 goto out_msg_denied;
2697 error = rpcauth_checkverf(task, xdr);
2701 p = xdr_inline_decode(xdr, sizeof(*p));
2703 goto out_unparsable;
2707 case rpc_prog_unavail:
2708 trace_rpc__prog_unavail(task);
2709 error = -EPFNOSUPPORT;
2711 case rpc_prog_mismatch:
2712 trace_rpc__prog_mismatch(task);
2713 error = -EPROTONOSUPPORT;
2715 case rpc_proc_unavail:
2716 trace_rpc__proc_unavail(task);
2717 error = -EOPNOTSUPP;
2719 case rpc_garbage_args:
2720 case rpc_system_err:
2721 trace_rpc__garbage_args(task);
2725 goto out_unparsable;
2729 clnt->cl_stats->rpcgarbage++;
2730 if (task->tk_garb_retry) {
2731 task->tk_garb_retry--;
2732 task->tk_action = call_encode;
2736 rpc_call_rpcerror(task, error);
2740 trace_rpc__unparsable(task);
2745 trace_rpc_bad_verifier(task);
2747 case -EPROTONOSUPPORT:
2750 /* Re-encode with a fresh cred */
2758 p = xdr_inline_decode(xdr, sizeof(*p));
2760 goto out_unparsable;
2762 case rpc_auth_error:
2765 trace_rpc__mismatch(task);
2766 error = -EPROTONOSUPPORT;
2769 goto out_unparsable;
2772 p = xdr_inline_decode(xdr, sizeof(*p));
2774 goto out_unparsable;
2776 case rpc_autherr_rejectedcred:
2777 case rpc_autherr_rejectedverf:
2778 case rpcsec_gsserr_credproblem:
2779 case rpcsec_gsserr_ctxproblem:
2780 rpcauth_invalcred(task);
2781 if (!task->tk_cred_retry)
2783 task->tk_cred_retry--;
2784 trace_rpc__stale_creds(task);
2785 return -EKEYREJECTED;
2786 case rpc_autherr_badcred:
2787 case rpc_autherr_badverf:
2788 /* possibly garbled cred/verf? */
2789 if (!task->tk_garb_retry)
2791 task->tk_garb_retry--;
2792 trace_rpc__bad_creds(task);
2793 task->tk_action = call_encode;
2795 case rpc_autherr_tooweak:
2796 trace_rpc__auth_tooweak(task);
2797 pr_warn("RPC: server %s requires stronger authentication.\n",
2798 task->tk_xprt->servername);
2801 goto out_unparsable;
2806 static void rpcproc_encode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2811 static int rpcproc_decode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2817 static const struct rpc_procinfo rpcproc_null = {
2818 .p_encode = rpcproc_encode_null,
2819 .p_decode = rpcproc_decode_null,
2822 static const struct rpc_procinfo rpcproc_null_noreply = {
2823 .p_encode = rpcproc_encode_null,
2827 rpc_null_call_prepare(struct rpc_task *task, void *data)
2829 task->tk_flags &= ~RPC_TASK_NO_RETRANS_TIMEOUT;
2830 rpc_call_start(task);
2833 static const struct rpc_call_ops rpc_null_ops = {
2834 .rpc_call_prepare = rpc_null_call_prepare,
2835 .rpc_call_done = rpc_default_callback,
2839 struct rpc_task *rpc_call_null_helper(struct rpc_clnt *clnt,
2840 struct rpc_xprt *xprt, struct rpc_cred *cred, int flags,
2841 const struct rpc_call_ops *ops, void *data)
2843 struct rpc_message msg = {
2844 .rpc_proc = &rpcproc_null,
2846 struct rpc_task_setup task_setup_data = {
2849 .rpc_message = &msg,
2850 .rpc_op_cred = cred,
2851 .callback_ops = ops ?: &rpc_null_ops,
2852 .callback_data = data,
2853 .flags = flags | RPC_TASK_SOFT | RPC_TASK_SOFTCONN |
2857 return rpc_run_task(&task_setup_data);
2860 struct rpc_task *rpc_call_null(struct rpc_clnt *clnt, struct rpc_cred *cred, int flags)
2862 return rpc_call_null_helper(clnt, NULL, cred, flags, NULL, NULL);
2864 EXPORT_SYMBOL_GPL(rpc_call_null);
2866 static int rpc_ping(struct rpc_clnt *clnt)
2868 struct rpc_task *task;
2871 if (clnt->cl_auth->au_ops->ping)
2872 return clnt->cl_auth->au_ops->ping(clnt);
2874 task = rpc_call_null_helper(clnt, NULL, NULL, 0, NULL, NULL);
2876 return PTR_ERR(task);
2877 status = task->tk_status;
2882 static int rpc_ping_noreply(struct rpc_clnt *clnt)
2884 struct rpc_message msg = {
2885 .rpc_proc = &rpcproc_null_noreply,
2887 struct rpc_task_setup task_setup_data = {
2889 .rpc_message = &msg,
2890 .callback_ops = &rpc_null_ops,
2891 .flags = RPC_TASK_SOFT | RPC_TASK_SOFTCONN | RPC_TASK_NULLCREDS,
2893 struct rpc_task *task;
2896 task = rpc_run_task(&task_setup_data);
2898 return PTR_ERR(task);
2899 status = task->tk_status;
2904 struct rpc_cb_add_xprt_calldata {
2905 struct rpc_xprt_switch *xps;
2906 struct rpc_xprt *xprt;
2909 static void rpc_cb_add_xprt_done(struct rpc_task *task, void *calldata)
2911 struct rpc_cb_add_xprt_calldata *data = calldata;
2913 if (task->tk_status == 0)
2914 rpc_xprt_switch_add_xprt(data->xps, data->xprt);
2917 static void rpc_cb_add_xprt_release(void *calldata)
2919 struct rpc_cb_add_xprt_calldata *data = calldata;
2921 xprt_put(data->xprt);
2922 xprt_switch_put(data->xps);
2926 static const struct rpc_call_ops rpc_cb_add_xprt_call_ops = {
2927 .rpc_call_prepare = rpc_null_call_prepare,
2928 .rpc_call_done = rpc_cb_add_xprt_done,
2929 .rpc_release = rpc_cb_add_xprt_release,
2933 * rpc_clnt_test_and_add_xprt - Test and add a new transport to a rpc_clnt
2934 * @clnt: pointer to struct rpc_clnt
2935 * @xps: pointer to struct rpc_xprt_switch,
2936 * @xprt: pointer struct rpc_xprt
2937 * @in_max_connect: pointer to the max_connect value for the passed in xprt transport
2939 int rpc_clnt_test_and_add_xprt(struct rpc_clnt *clnt,
2940 struct rpc_xprt_switch *xps, struct rpc_xprt *xprt,
2941 void *in_max_connect)
2943 struct rpc_cb_add_xprt_calldata *data;
2944 struct rpc_task *task;
2945 int max_connect = clnt->cl_max_connect;
2948 max_connect = *(int *)in_max_connect;
2949 if (xps->xps_nunique_destaddr_xprts + 1 > max_connect) {
2951 pr_warn("SUNRPC: reached max allowed number (%d) did not add "
2952 "transport to server: %s\n", max_connect,
2953 rpc_peeraddr2str(clnt, RPC_DISPLAY_ADDR));
2958 data = kmalloc(sizeof(*data), GFP_KERNEL);
2961 data->xps = xprt_switch_get(xps);
2962 data->xprt = xprt_get(xprt);
2963 if (rpc_xprt_switch_has_addr(data->xps, (struct sockaddr *)&xprt->addr)) {
2964 rpc_cb_add_xprt_release(data);
2968 task = rpc_call_null_helper(clnt, xprt, NULL, RPC_TASK_ASYNC,
2969 &rpc_cb_add_xprt_call_ops, data);
2971 return PTR_ERR(task);
2973 data->xps->xps_nunique_destaddr_xprts++;
2978 EXPORT_SYMBOL_GPL(rpc_clnt_test_and_add_xprt);
2980 static int rpc_clnt_add_xprt_helper(struct rpc_clnt *clnt,
2981 struct rpc_xprt *xprt,
2982 struct rpc_add_xprt_test *data)
2984 struct rpc_task *task;
2985 int status = -EADDRINUSE;
2987 /* Test the connection */
2988 task = rpc_call_null_helper(clnt, xprt, NULL, 0, NULL, NULL);
2990 return PTR_ERR(task);
2992 status = task->tk_status;
2998 /* rpc_xprt_switch and rpc_xprt are deferrenced by add_xprt_test() */
2999 data->add_xprt_test(clnt, xprt, data->data);
3005 * rpc_clnt_setup_test_and_add_xprt()
3007 * This is an rpc_clnt_add_xprt setup() function which returns 1 so:
3008 * 1) caller of the test function must dereference the rpc_xprt_switch
3010 * 2) test function must call rpc_xprt_switch_add_xprt, usually in
3011 * the rpc_call_done routine.
3013 * Upon success (return of 1), the test function adds the new
3014 * transport to the rpc_clnt xprt switch
3016 * @clnt: struct rpc_clnt to get the new transport
3017 * @xps: the rpc_xprt_switch to hold the new transport
3018 * @xprt: the rpc_xprt to test
3019 * @data: a struct rpc_add_xprt_test pointer that holds the test function
3020 * and test function call data
3022 int rpc_clnt_setup_test_and_add_xprt(struct rpc_clnt *clnt,
3023 struct rpc_xprt_switch *xps,
3024 struct rpc_xprt *xprt,
3027 int status = -EADDRINUSE;
3029 xprt = xprt_get(xprt);
3030 xprt_switch_get(xps);
3032 if (rpc_xprt_switch_has_addr(xps, (struct sockaddr *)&xprt->addr))
3035 status = rpc_clnt_add_xprt_helper(clnt, xprt, data);
3042 xprt_switch_put(xps);
3044 pr_info("RPC: rpc_clnt_test_xprt failed: %d addr %s not "
3046 xprt->address_strings[RPC_DISPLAY_ADDR]);
3047 /* so that rpc_clnt_add_xprt does not call rpc_xprt_switch_add_xprt */
3050 EXPORT_SYMBOL_GPL(rpc_clnt_setup_test_and_add_xprt);
3053 * rpc_clnt_add_xprt - Add a new transport to a rpc_clnt
3054 * @clnt: pointer to struct rpc_clnt
3055 * @xprtargs: pointer to struct xprt_create
3056 * @setup: callback to test and/or set up the connection
3057 * @data: pointer to setup function data
3059 * Creates a new transport using the parameters set in args and
3061 * If ping is set, then test that connectivity succeeds before
3062 * adding the new transport.
3065 int rpc_clnt_add_xprt(struct rpc_clnt *clnt,
3066 struct xprt_create *xprtargs,
3067 int (*setup)(struct rpc_clnt *,
3068 struct rpc_xprt_switch *,
3073 struct rpc_xprt_switch *xps;
3074 struct rpc_xprt *xprt;
3075 unsigned long connect_timeout;
3076 unsigned long reconnect_timeout;
3077 unsigned char resvport, reuseport;
3081 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
3082 xprt = xprt_iter_xprt(&clnt->cl_xpi);
3083 if (xps == NULL || xprt == NULL) {
3085 xprt_switch_put(xps);
3088 resvport = xprt->resvport;
3089 reuseport = xprt->reuseport;
3090 connect_timeout = xprt->connect_timeout;
3091 reconnect_timeout = xprt->max_reconnect_timeout;
3092 ident = xprt->xprt_class->ident;
3095 if (!xprtargs->ident)
3096 xprtargs->ident = ident;
3097 xprtargs->xprtsec = clnt->cl_xprtsec;
3098 xprt = xprt_create_transport(xprtargs);
3100 ret = PTR_ERR(xprt);
3101 goto out_put_switch;
3103 xprt->resvport = resvport;
3104 xprt->reuseport = reuseport;
3106 if (xprtargs->connect_timeout)
3107 connect_timeout = xprtargs->connect_timeout;
3108 if (xprtargs->reconnect_timeout)
3109 reconnect_timeout = xprtargs->reconnect_timeout;
3110 if (xprt->ops->set_connect_timeout != NULL)
3111 xprt->ops->set_connect_timeout(xprt,
3115 rpc_xprt_switch_set_roundrobin(xps);
3117 ret = setup(clnt, xps, xprt, data);
3121 rpc_xprt_switch_add_xprt(xps, xprt);
3125 xprt_switch_put(xps);
3128 EXPORT_SYMBOL_GPL(rpc_clnt_add_xprt);
3130 static int rpc_xprt_probe_trunked(struct rpc_clnt *clnt,
3131 struct rpc_xprt *xprt,
3132 struct rpc_add_xprt_test *data)
3134 struct rpc_xprt *main_xprt;
3140 main_xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
3141 status = rpc_cmp_addr_port((struct sockaddr *)&xprt->addr,
3142 (struct sockaddr *)&main_xprt->addr);
3144 xprt_put(main_xprt);
3145 if (status || !test_bit(XPRT_OFFLINE, &xprt->state))
3148 status = rpc_clnt_add_xprt_helper(clnt, xprt, data);
3154 /* rpc_clnt_probe_trunked_xprt -- probe offlined transport for session trunking
3155 * @clnt rpc_clnt structure
3157 * For each offlined transport found in the rpc_clnt structure call
3158 * the function rpc_xprt_probe_trunked() which will determine if this
3159 * transport still belongs to the trunking group.
3161 void rpc_clnt_probe_trunked_xprts(struct rpc_clnt *clnt,
3162 struct rpc_add_xprt_test *data)
3164 struct rpc_xprt_iter xpi;
3167 ret = rpc_clnt_xprt_iter_offline_init(clnt, &xpi);
3171 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
3175 ret = rpc_xprt_probe_trunked(clnt, xprt, data);
3179 xprt_iter_rewind(&xpi);
3181 xprt_iter_destroy(&xpi);
3183 EXPORT_SYMBOL_GPL(rpc_clnt_probe_trunked_xprts);
3185 static int rpc_xprt_offline(struct rpc_clnt *clnt,
3186 struct rpc_xprt *xprt,
3189 struct rpc_xprt *main_xprt;
3190 struct rpc_xprt_switch *xps;
3196 main_xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
3197 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
3198 err = rpc_cmp_addr_port((struct sockaddr *)&xprt->addr,
3199 (struct sockaddr *)&main_xprt->addr);
3201 xprt_put(main_xprt);
3205 if (wait_on_bit_lock(&xprt->state, XPRT_LOCKED, TASK_KILLABLE)) {
3209 xprt_set_offline_locked(xprt, xps);
3211 xprt_release_write(xprt, NULL);
3214 xprt_switch_put(xps);
3218 /* rpc_clnt_manage_trunked_xprts -- offline trunked transports
3219 * @clnt rpc_clnt structure
3221 * For each active transport found in the rpc_clnt structure call
3222 * the function rpc_xprt_offline() which will identify trunked transports
3223 * and will mark them offline.
3225 void rpc_clnt_manage_trunked_xprts(struct rpc_clnt *clnt)
3227 rpc_clnt_iterate_for_each_xprt(clnt, rpc_xprt_offline, NULL);
3229 EXPORT_SYMBOL_GPL(rpc_clnt_manage_trunked_xprts);
3231 struct connect_timeout_data {
3232 unsigned long connect_timeout;
3233 unsigned long reconnect_timeout;
3237 rpc_xprt_set_connect_timeout(struct rpc_clnt *clnt,
3238 struct rpc_xprt *xprt,
3241 struct connect_timeout_data *timeo = data;
3243 if (xprt->ops->set_connect_timeout)
3244 xprt->ops->set_connect_timeout(xprt,
3245 timeo->connect_timeout,
3246 timeo->reconnect_timeout);
3251 rpc_set_connect_timeout(struct rpc_clnt *clnt,
3252 unsigned long connect_timeout,
3253 unsigned long reconnect_timeout)
3255 struct connect_timeout_data timeout = {
3256 .connect_timeout = connect_timeout,
3257 .reconnect_timeout = reconnect_timeout,
3259 rpc_clnt_iterate_for_each_xprt(clnt,
3260 rpc_xprt_set_connect_timeout,
3263 EXPORT_SYMBOL_GPL(rpc_set_connect_timeout);
3265 void rpc_clnt_xprt_set_online(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3267 struct rpc_xprt_switch *xps;
3269 xps = rpc_clnt_xprt_switch_get(clnt);
3270 xprt_set_online_locked(xprt, xps);
3271 xprt_switch_put(xps);
3274 void rpc_clnt_xprt_switch_add_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3276 struct rpc_xprt_switch *xps;
3278 if (rpc_clnt_xprt_switch_has_addr(clnt,
3279 (const struct sockaddr *)&xprt->addr)) {
3280 return rpc_clnt_xprt_set_online(clnt, xprt);
3283 xps = rpc_clnt_xprt_switch_get(clnt);
3284 rpc_xprt_switch_add_xprt(xps, xprt);
3285 xprt_switch_put(xps);
3287 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_add_xprt);
3289 void rpc_clnt_xprt_switch_remove_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3291 struct rpc_xprt_switch *xps;
3294 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
3295 rpc_xprt_switch_remove_xprt(rcu_dereference(clnt->cl_xpi.xpi_xpswitch),
3297 xps->xps_nunique_destaddr_xprts--;
3300 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_remove_xprt);
3302 bool rpc_clnt_xprt_switch_has_addr(struct rpc_clnt *clnt,
3303 const struct sockaddr *sap)
3305 struct rpc_xprt_switch *xps;
3309 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
3310 ret = rpc_xprt_switch_has_addr(xps, sap);
3314 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_has_addr);
3316 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
3317 static void rpc_show_header(void)
3319 printk(KERN_INFO "-pid- flgs status -client- --rqstp- "
3320 "-timeout ---ops--\n");
3323 static void rpc_show_task(const struct rpc_clnt *clnt,
3324 const struct rpc_task *task)
3326 const char *rpc_waitq = "none";
3328 if (RPC_IS_QUEUED(task))
3329 rpc_waitq = rpc_qname(task->tk_waitqueue);
3331 printk(KERN_INFO "%5u %04x %6d %8p %8p %8ld %8p %sv%u %s a:%ps q:%s\n",
3332 task->tk_pid, task->tk_flags, task->tk_status,
3333 clnt, task->tk_rqstp, rpc_task_timeout(task), task->tk_ops,
3334 clnt->cl_program->name, clnt->cl_vers, rpc_proc_name(task),
3335 task->tk_action, rpc_waitq);
3338 void rpc_show_tasks(struct net *net)
3340 struct rpc_clnt *clnt;
3341 struct rpc_task *task;
3343 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
3345 spin_lock(&sn->rpc_client_lock);
3346 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
3347 spin_lock(&clnt->cl_lock);
3348 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
3353 rpc_show_task(clnt, task);
3355 spin_unlock(&clnt->cl_lock);
3357 spin_unlock(&sn->rpc_client_lock);
3361 #if IS_ENABLED(CONFIG_SUNRPC_SWAP)
3363 rpc_clnt_swap_activate_callback(struct rpc_clnt *clnt,
3364 struct rpc_xprt *xprt,
3367 return xprt_enable_swap(xprt);
3371 rpc_clnt_swap_activate(struct rpc_clnt *clnt)
3373 while (clnt != clnt->cl_parent)
3374 clnt = clnt->cl_parent;
3375 if (atomic_inc_return(&clnt->cl_swapper) == 1)
3376 return rpc_clnt_iterate_for_each_xprt(clnt,
3377 rpc_clnt_swap_activate_callback, NULL);
3380 EXPORT_SYMBOL_GPL(rpc_clnt_swap_activate);
3383 rpc_clnt_swap_deactivate_callback(struct rpc_clnt *clnt,
3384 struct rpc_xprt *xprt,
3387 xprt_disable_swap(xprt);
3392 rpc_clnt_swap_deactivate(struct rpc_clnt *clnt)
3394 while (clnt != clnt->cl_parent)
3395 clnt = clnt->cl_parent;
3396 if (atomic_dec_if_positive(&clnt->cl_swapper) == 0)
3397 rpc_clnt_iterate_for_each_xprt(clnt,
3398 rpc_clnt_swap_deactivate_callback, NULL);
3400 EXPORT_SYMBOL_GPL(rpc_clnt_swap_deactivate);
3401 #endif /* CONFIG_SUNRPC_SWAP */