Loading...
1/*
2 * linux/net/sunrpc/clnt.c
3 *
4 * This file contains the high-level RPC interface.
5 * It is modeled as a finite state machine to support both synchronous
6 * and asynchronous requests.
7 *
8 * - RPC header generation and argument serialization.
9 * - Credential refresh.
10 * - TCP connect handling.
11 * - Retry of operation when it is suspected the operation failed because
12 * of uid squashing on the server, or when the credentials were stale
13 * and need to be refreshed, or when a packet was damaged in transit.
14 * This may be have to be moved to the VFS layer.
15 *
16 * Copyright (C) 1992,1993 Rick Sladkey <jrs@world.std.com>
17 * Copyright (C) 1995,1996 Olaf Kirch <okir@monad.swb.de>
18 */
19
20
21#include <linux/module.h>
22#include <linux/types.h>
23#include <linux/kallsyms.h>
24#include <linux/mm.h>
25#include <linux/namei.h>
26#include <linux/mount.h>
27#include <linux/slab.h>
28#include <linux/rcupdate.h>
29#include <linux/utsname.h>
30#include <linux/workqueue.h>
31#include <linux/in.h>
32#include <linux/in6.h>
33#include <linux/un.h>
34
35#include <linux/sunrpc/clnt.h>
36#include <linux/sunrpc/addr.h>
37#include <linux/sunrpc/rpc_pipe_fs.h>
38#include <linux/sunrpc/metrics.h>
39#include <linux/sunrpc/bc_xprt.h>
40#include <trace/events/sunrpc.h>
41
42#include "sunrpc.h"
43#include "netns.h"
44
45#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
46# define RPCDBG_FACILITY RPCDBG_CALL
47#endif
48
49#define dprint_status(t) \
50 dprintk("RPC: %5u %s (status %d)\n", t->tk_pid, \
51 __func__, t->tk_status)
52
53/*
54 * All RPC clients are linked into this list
55 */
56
57static DECLARE_WAIT_QUEUE_HEAD(destroy_wait);
58
59
60static void call_start(struct rpc_task *task);
61static void call_reserve(struct rpc_task *task);
62static void call_reserveresult(struct rpc_task *task);
63static void call_allocate(struct rpc_task *task);
64static void call_decode(struct rpc_task *task);
65static void call_bind(struct rpc_task *task);
66static void call_bind_status(struct rpc_task *task);
67static void call_transmit(struct rpc_task *task);
68#if defined(CONFIG_SUNRPC_BACKCHANNEL)
69static void call_bc_transmit(struct rpc_task *task);
70#endif /* CONFIG_SUNRPC_BACKCHANNEL */
71static void call_status(struct rpc_task *task);
72static void call_transmit_status(struct rpc_task *task);
73static void call_refresh(struct rpc_task *task);
74static void call_refreshresult(struct rpc_task *task);
75static void call_timeout(struct rpc_task *task);
76static void call_connect(struct rpc_task *task);
77static void call_connect_status(struct rpc_task *task);
78
79static __be32 *rpc_encode_header(struct rpc_task *task);
80static __be32 *rpc_verify_header(struct rpc_task *task);
81static int rpc_ping(struct rpc_clnt *clnt);
82
83static void rpc_register_client(struct rpc_clnt *clnt)
84{
85 struct net *net = rpc_net_ns(clnt);
86 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
87
88 spin_lock(&sn->rpc_client_lock);
89 list_add(&clnt->cl_clients, &sn->all_clients);
90 spin_unlock(&sn->rpc_client_lock);
91}
92
93static void rpc_unregister_client(struct rpc_clnt *clnt)
94{
95 struct net *net = rpc_net_ns(clnt);
96 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
97
98 spin_lock(&sn->rpc_client_lock);
99 list_del(&clnt->cl_clients);
100 spin_unlock(&sn->rpc_client_lock);
101}
102
103static void __rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
104{
105 rpc_remove_client_dir(clnt);
106}
107
108static void rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
109{
110 struct net *net = rpc_net_ns(clnt);
111 struct super_block *pipefs_sb;
112
113 pipefs_sb = rpc_get_sb_net(net);
114 if (pipefs_sb) {
115 __rpc_clnt_remove_pipedir(clnt);
116 rpc_put_sb_net(net);
117 }
118}
119
120static struct dentry *rpc_setup_pipedir_sb(struct super_block *sb,
121 struct rpc_clnt *clnt)
122{
123 static uint32_t clntid;
124 const char *dir_name = clnt->cl_program->pipe_dir_name;
125 char name[15];
126 struct dentry *dir, *dentry;
127
128 dir = rpc_d_lookup_sb(sb, dir_name);
129 if (dir == NULL) {
130 pr_info("RPC: pipefs directory doesn't exist: %s\n", dir_name);
131 return dir;
132 }
133 for (;;) {
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);
137 if (!IS_ERR(dentry))
138 break;
139 if (dentry == ERR_PTR(-EEXIST))
140 continue;
141 printk(KERN_INFO "RPC: Couldn't create pipefs entry"
142 " %s/%s, error %ld\n",
143 dir_name, name, PTR_ERR(dentry));
144 break;
145 }
146 dput(dir);
147 return dentry;
148}
149
150static int
151rpc_setup_pipedir(struct super_block *pipefs_sb, struct rpc_clnt *clnt)
152{
153 struct dentry *dentry;
154
155 if (clnt->cl_program->pipe_dir_name != NULL) {
156 dentry = rpc_setup_pipedir_sb(pipefs_sb, clnt);
157 if (IS_ERR(dentry))
158 return PTR_ERR(dentry);
159 }
160 return 0;
161}
162
163static int rpc_clnt_skip_event(struct rpc_clnt *clnt, unsigned long event)
164{
165 if (clnt->cl_program->pipe_dir_name == NULL)
166 return 1;
167
168 switch (event) {
169 case RPC_PIPEFS_MOUNT:
170 if (clnt->cl_pipedir_objects.pdh_dentry != NULL)
171 return 1;
172 if (atomic_read(&clnt->cl_count) == 0)
173 return 1;
174 break;
175 case RPC_PIPEFS_UMOUNT:
176 if (clnt->cl_pipedir_objects.pdh_dentry == NULL)
177 return 1;
178 break;
179 }
180 return 0;
181}
182
183static int __rpc_clnt_handle_event(struct rpc_clnt *clnt, unsigned long event,
184 struct super_block *sb)
185{
186 struct dentry *dentry;
187
188 switch (event) {
189 case RPC_PIPEFS_MOUNT:
190 dentry = rpc_setup_pipedir_sb(sb, clnt);
191 if (!dentry)
192 return -ENOENT;
193 if (IS_ERR(dentry))
194 return PTR_ERR(dentry);
195 break;
196 case RPC_PIPEFS_UMOUNT:
197 __rpc_clnt_remove_pipedir(clnt);
198 break;
199 default:
200 printk(KERN_ERR "%s: unknown event: %ld\n", __func__, event);
201 return -ENOTSUPP;
202 }
203 return 0;
204}
205
206static int __rpc_pipefs_event(struct rpc_clnt *clnt, unsigned long event,
207 struct super_block *sb)
208{
209 int error = 0;
210
211 for (;; clnt = clnt->cl_parent) {
212 if (!rpc_clnt_skip_event(clnt, event))
213 error = __rpc_clnt_handle_event(clnt, event, sb);
214 if (error || clnt == clnt->cl_parent)
215 break;
216 }
217 return error;
218}
219
220static struct rpc_clnt *rpc_get_client_for_event(struct net *net, int event)
221{
222 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
223 struct rpc_clnt *clnt;
224
225 spin_lock(&sn->rpc_client_lock);
226 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
227 if (rpc_clnt_skip_event(clnt, event))
228 continue;
229 spin_unlock(&sn->rpc_client_lock);
230 return clnt;
231 }
232 spin_unlock(&sn->rpc_client_lock);
233 return NULL;
234}
235
236static int rpc_pipefs_event(struct notifier_block *nb, unsigned long event,
237 void *ptr)
238{
239 struct super_block *sb = ptr;
240 struct rpc_clnt *clnt;
241 int error = 0;
242
243 while ((clnt = rpc_get_client_for_event(sb->s_fs_info, event))) {
244 error = __rpc_pipefs_event(clnt, event, sb);
245 if (error)
246 break;
247 }
248 return error;
249}
250
251static struct notifier_block rpc_clients_block = {
252 .notifier_call = rpc_pipefs_event,
253 .priority = SUNRPC_PIPEFS_RPC_PRIO,
254};
255
256int rpc_clients_notifier_register(void)
257{
258 return rpc_pipefs_notifier_register(&rpc_clients_block);
259}
260
261void rpc_clients_notifier_unregister(void)
262{
263 return rpc_pipefs_notifier_unregister(&rpc_clients_block);
264}
265
266static struct rpc_xprt *rpc_clnt_set_transport(struct rpc_clnt *clnt,
267 struct rpc_xprt *xprt,
268 const struct rpc_timeout *timeout)
269{
270 struct rpc_xprt *old;
271
272 spin_lock(&clnt->cl_lock);
273 old = rcu_dereference_protected(clnt->cl_xprt,
274 lockdep_is_held(&clnt->cl_lock));
275
276 if (!xprt_bound(xprt))
277 clnt->cl_autobind = 1;
278
279 clnt->cl_timeout = timeout;
280 rcu_assign_pointer(clnt->cl_xprt, xprt);
281 spin_unlock(&clnt->cl_lock);
282
283 return old;
284}
285
286static void rpc_clnt_set_nodename(struct rpc_clnt *clnt, const char *nodename)
287{
288 clnt->cl_nodelen = strlcpy(clnt->cl_nodename,
289 nodename, sizeof(clnt->cl_nodename));
290}
291
292static int rpc_client_register(struct rpc_clnt *clnt,
293 rpc_authflavor_t pseudoflavor,
294 const char *client_name)
295{
296 struct rpc_auth_create_args auth_args = {
297 .pseudoflavor = pseudoflavor,
298 .target_name = client_name,
299 };
300 struct rpc_auth *auth;
301 struct net *net = rpc_net_ns(clnt);
302 struct super_block *pipefs_sb;
303 int err;
304
305 rpc_clnt_debugfs_register(clnt);
306
307 pipefs_sb = rpc_get_sb_net(net);
308 if (pipefs_sb) {
309 err = rpc_setup_pipedir(pipefs_sb, clnt);
310 if (err)
311 goto out;
312 }
313
314 rpc_register_client(clnt);
315 if (pipefs_sb)
316 rpc_put_sb_net(net);
317
318 auth = rpcauth_create(&auth_args, clnt);
319 if (IS_ERR(auth)) {
320 dprintk("RPC: Couldn't create auth handle (flavor %u)\n",
321 pseudoflavor);
322 err = PTR_ERR(auth);
323 goto err_auth;
324 }
325 return 0;
326err_auth:
327 pipefs_sb = rpc_get_sb_net(net);
328 rpc_unregister_client(clnt);
329 __rpc_clnt_remove_pipedir(clnt);
330out:
331 if (pipefs_sb)
332 rpc_put_sb_net(net);
333 rpc_clnt_debugfs_unregister(clnt);
334 return err;
335}
336
337static DEFINE_IDA(rpc_clids);
338
339void rpc_cleanup_clids(void)
340{
341 ida_destroy(&rpc_clids);
342}
343
344static int rpc_alloc_clid(struct rpc_clnt *clnt)
345{
346 int clid;
347
348 clid = ida_simple_get(&rpc_clids, 0, 0, GFP_KERNEL);
349 if (clid < 0)
350 return clid;
351 clnt->cl_clid = clid;
352 return 0;
353}
354
355static void rpc_free_clid(struct rpc_clnt *clnt)
356{
357 ida_simple_remove(&rpc_clids, clnt->cl_clid);
358}
359
360static struct rpc_clnt * rpc_new_client(const struct rpc_create_args *args,
361 struct rpc_xprt_switch *xps,
362 struct rpc_xprt *xprt,
363 struct rpc_clnt *parent)
364{
365 const struct rpc_program *program = args->program;
366 const struct rpc_version *version;
367 struct rpc_clnt *clnt = NULL;
368 const struct rpc_timeout *timeout;
369 const char *nodename = args->nodename;
370 int err;
371
372 /* sanity check the name before trying to print it */
373 dprintk("RPC: creating %s client for %s (xprt %p)\n",
374 program->name, args->servername, xprt);
375
376 err = rpciod_up();
377 if (err)
378 goto out_no_rpciod;
379
380 err = -EINVAL;
381 if (args->version >= program->nrvers)
382 goto out_err;
383 version = program->version[args->version];
384 if (version == NULL)
385 goto out_err;
386
387 err = -ENOMEM;
388 clnt = kzalloc(sizeof(*clnt), GFP_KERNEL);
389 if (!clnt)
390 goto out_err;
391 clnt->cl_parent = parent ? : clnt;
392
393 err = rpc_alloc_clid(clnt);
394 if (err)
395 goto out_no_clid;
396
397 clnt->cl_procinfo = version->procs;
398 clnt->cl_maxproc = version->nrprocs;
399 clnt->cl_prog = args->prognumber ? : program->number;
400 clnt->cl_vers = version->number;
401 clnt->cl_stats = program->stats;
402 clnt->cl_metrics = rpc_alloc_iostats(clnt);
403 rpc_init_pipe_dir_head(&clnt->cl_pipedir_objects);
404 err = -ENOMEM;
405 if (clnt->cl_metrics == NULL)
406 goto out_no_stats;
407 clnt->cl_program = program;
408 INIT_LIST_HEAD(&clnt->cl_tasks);
409 spin_lock_init(&clnt->cl_lock);
410
411 timeout = xprt->timeout;
412 if (args->timeout != NULL) {
413 memcpy(&clnt->cl_timeout_default, args->timeout,
414 sizeof(clnt->cl_timeout_default));
415 timeout = &clnt->cl_timeout_default;
416 }
417
418 rpc_clnt_set_transport(clnt, xprt, timeout);
419 xprt_iter_init(&clnt->cl_xpi, xps);
420 xprt_switch_put(xps);
421
422 clnt->cl_rtt = &clnt->cl_rtt_default;
423 rpc_init_rtt(&clnt->cl_rtt_default, clnt->cl_timeout->to_initval);
424
425 atomic_set(&clnt->cl_count, 1);
426
427 if (nodename == NULL)
428 nodename = utsname()->nodename;
429 /* save the nodename */
430 rpc_clnt_set_nodename(clnt, nodename);
431
432 err = rpc_client_register(clnt, args->authflavor, args->client_name);
433 if (err)
434 goto out_no_path;
435 if (parent)
436 atomic_inc(&parent->cl_count);
437 return clnt;
438
439out_no_path:
440 rpc_free_iostats(clnt->cl_metrics);
441out_no_stats:
442 rpc_free_clid(clnt);
443out_no_clid:
444 kfree(clnt);
445out_err:
446 rpciod_down();
447out_no_rpciod:
448 xprt_switch_put(xps);
449 xprt_put(xprt);
450 return ERR_PTR(err);
451}
452
453static struct rpc_clnt *rpc_create_xprt(struct rpc_create_args *args,
454 struct rpc_xprt *xprt)
455{
456 struct rpc_clnt *clnt = NULL;
457 struct rpc_xprt_switch *xps;
458
459 if (args->bc_xprt && args->bc_xprt->xpt_bc_xps) {
460 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
461 xps = args->bc_xprt->xpt_bc_xps;
462 xprt_switch_get(xps);
463 } else {
464 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
465 if (xps == NULL) {
466 xprt_put(xprt);
467 return ERR_PTR(-ENOMEM);
468 }
469 if (xprt->bc_xprt) {
470 xprt_switch_get(xps);
471 xprt->bc_xprt->xpt_bc_xps = xps;
472 }
473 }
474 clnt = rpc_new_client(args, xps, xprt, NULL);
475 if (IS_ERR(clnt))
476 return clnt;
477
478 if (!(args->flags & RPC_CLNT_CREATE_NOPING)) {
479 int err = rpc_ping(clnt);
480 if (err != 0) {
481 rpc_shutdown_client(clnt);
482 return ERR_PTR(err);
483 }
484 }
485
486 clnt->cl_softrtry = 1;
487 if (args->flags & RPC_CLNT_CREATE_HARDRTRY)
488 clnt->cl_softrtry = 0;
489
490 if (args->flags & RPC_CLNT_CREATE_AUTOBIND)
491 clnt->cl_autobind = 1;
492 if (args->flags & RPC_CLNT_CREATE_NO_RETRANS_TIMEOUT)
493 clnt->cl_noretranstimeo = 1;
494 if (args->flags & RPC_CLNT_CREATE_DISCRTRY)
495 clnt->cl_discrtry = 1;
496 if (!(args->flags & RPC_CLNT_CREATE_QUIET))
497 clnt->cl_chatty = 1;
498
499 return clnt;
500}
501
502/**
503 * rpc_create - create an RPC client and transport with one call
504 * @args: rpc_clnt create argument structure
505 *
506 * Creates and initializes an RPC transport and an RPC client.
507 *
508 * It can ping the server in order to determine if it is up, and to see if
509 * it supports this program and version. RPC_CLNT_CREATE_NOPING disables
510 * this behavior so asynchronous tasks can also use rpc_create.
511 */
512struct rpc_clnt *rpc_create(struct rpc_create_args *args)
513{
514 struct rpc_xprt *xprt;
515 struct xprt_create xprtargs = {
516 .net = args->net,
517 .ident = args->protocol,
518 .srcaddr = args->saddress,
519 .dstaddr = args->address,
520 .addrlen = args->addrsize,
521 .servername = args->servername,
522 .bc_xprt = args->bc_xprt,
523 };
524 char servername[48];
525
526 if (args->bc_xprt) {
527 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
528 xprt = args->bc_xprt->xpt_bc_xprt;
529 if (xprt) {
530 xprt_get(xprt);
531 return rpc_create_xprt(args, xprt);
532 }
533 }
534
535 if (args->flags & RPC_CLNT_CREATE_INFINITE_SLOTS)
536 xprtargs.flags |= XPRT_CREATE_INFINITE_SLOTS;
537 if (args->flags & RPC_CLNT_CREATE_NO_IDLE_TIMEOUT)
538 xprtargs.flags |= XPRT_CREATE_NO_IDLE_TIMEOUT;
539 /*
540 * If the caller chooses not to specify a hostname, whip
541 * up a string representation of the passed-in address.
542 */
543 if (xprtargs.servername == NULL) {
544 struct sockaddr_un *sun =
545 (struct sockaddr_un *)args->address;
546 struct sockaddr_in *sin =
547 (struct sockaddr_in *)args->address;
548 struct sockaddr_in6 *sin6 =
549 (struct sockaddr_in6 *)args->address;
550
551 servername[0] = '\0';
552 switch (args->address->sa_family) {
553 case AF_LOCAL:
554 snprintf(servername, sizeof(servername), "%s",
555 sun->sun_path);
556 break;
557 case AF_INET:
558 snprintf(servername, sizeof(servername), "%pI4",
559 &sin->sin_addr.s_addr);
560 break;
561 case AF_INET6:
562 snprintf(servername, sizeof(servername), "%pI6",
563 &sin6->sin6_addr);
564 break;
565 default:
566 /* caller wants default server name, but
567 * address family isn't recognized. */
568 return ERR_PTR(-EINVAL);
569 }
570 xprtargs.servername = servername;
571 }
572
573 xprt = xprt_create_transport(&xprtargs);
574 if (IS_ERR(xprt))
575 return (struct rpc_clnt *)xprt;
576
577 /*
578 * By default, kernel RPC client connects from a reserved port.
579 * CAP_NET_BIND_SERVICE will not be set for unprivileged requesters,
580 * but it is always enabled for rpciod, which handles the connect
581 * operation.
582 */
583 xprt->resvport = 1;
584 if (args->flags & RPC_CLNT_CREATE_NONPRIVPORT)
585 xprt->resvport = 0;
586
587 return rpc_create_xprt(args, xprt);
588}
589EXPORT_SYMBOL_GPL(rpc_create);
590
591/*
592 * This function clones the RPC client structure. It allows us to share the
593 * same transport while varying parameters such as the authentication
594 * flavour.
595 */
596static struct rpc_clnt *__rpc_clone_client(struct rpc_create_args *args,
597 struct rpc_clnt *clnt)
598{
599 struct rpc_xprt_switch *xps;
600 struct rpc_xprt *xprt;
601 struct rpc_clnt *new;
602 int err;
603
604 err = -ENOMEM;
605 rcu_read_lock();
606 xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
607 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
608 rcu_read_unlock();
609 if (xprt == NULL || xps == NULL) {
610 xprt_put(xprt);
611 xprt_switch_put(xps);
612 goto out_err;
613 }
614 args->servername = xprt->servername;
615 args->nodename = clnt->cl_nodename;
616
617 new = rpc_new_client(args, xps, xprt, clnt);
618 if (IS_ERR(new)) {
619 err = PTR_ERR(new);
620 goto out_err;
621 }
622
623 /* Turn off autobind on clones */
624 new->cl_autobind = 0;
625 new->cl_softrtry = clnt->cl_softrtry;
626 new->cl_noretranstimeo = clnt->cl_noretranstimeo;
627 new->cl_discrtry = clnt->cl_discrtry;
628 new->cl_chatty = clnt->cl_chatty;
629 return new;
630
631out_err:
632 dprintk("RPC: %s: returned error %d\n", __func__, err);
633 return ERR_PTR(err);
634}
635
636/**
637 * rpc_clone_client - Clone an RPC client structure
638 *
639 * @clnt: RPC client whose parameters are copied
640 *
641 * Returns a fresh RPC client or an ERR_PTR.
642 */
643struct rpc_clnt *rpc_clone_client(struct rpc_clnt *clnt)
644{
645 struct rpc_create_args args = {
646 .program = clnt->cl_program,
647 .prognumber = clnt->cl_prog,
648 .version = clnt->cl_vers,
649 .authflavor = clnt->cl_auth->au_flavor,
650 };
651 return __rpc_clone_client(&args, clnt);
652}
653EXPORT_SYMBOL_GPL(rpc_clone_client);
654
655/**
656 * rpc_clone_client_set_auth - Clone an RPC client structure and set its auth
657 *
658 * @clnt: RPC client whose parameters are copied
659 * @flavor: security flavor for new client
660 *
661 * Returns a fresh RPC client or an ERR_PTR.
662 */
663struct rpc_clnt *
664rpc_clone_client_set_auth(struct rpc_clnt *clnt, rpc_authflavor_t flavor)
665{
666 struct rpc_create_args args = {
667 .program = clnt->cl_program,
668 .prognumber = clnt->cl_prog,
669 .version = clnt->cl_vers,
670 .authflavor = flavor,
671 };
672 return __rpc_clone_client(&args, clnt);
673}
674EXPORT_SYMBOL_GPL(rpc_clone_client_set_auth);
675
676/**
677 * rpc_switch_client_transport: switch the RPC transport on the fly
678 * @clnt: pointer to a struct rpc_clnt
679 * @args: pointer to the new transport arguments
680 * @timeout: pointer to the new timeout parameters
681 *
682 * This function allows the caller to switch the RPC transport for the
683 * rpc_clnt structure 'clnt' to allow it to connect to a mirrored NFS
684 * server, for instance. It assumes that the caller has ensured that
685 * there are no active RPC tasks by using some form of locking.
686 *
687 * Returns zero if "clnt" is now using the new xprt. Otherwise a
688 * negative errno is returned, and "clnt" continues to use the old
689 * xprt.
690 */
691int rpc_switch_client_transport(struct rpc_clnt *clnt,
692 struct xprt_create *args,
693 const struct rpc_timeout *timeout)
694{
695 const struct rpc_timeout *old_timeo;
696 rpc_authflavor_t pseudoflavor;
697 struct rpc_xprt_switch *xps, *oldxps;
698 struct rpc_xprt *xprt, *old;
699 struct rpc_clnt *parent;
700 int err;
701
702 xprt = xprt_create_transport(args);
703 if (IS_ERR(xprt)) {
704 dprintk("RPC: failed to create new xprt for clnt %p\n",
705 clnt);
706 return PTR_ERR(xprt);
707 }
708
709 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
710 if (xps == NULL) {
711 xprt_put(xprt);
712 return -ENOMEM;
713 }
714
715 pseudoflavor = clnt->cl_auth->au_flavor;
716
717 old_timeo = clnt->cl_timeout;
718 old = rpc_clnt_set_transport(clnt, xprt, timeout);
719 oldxps = xprt_iter_xchg_switch(&clnt->cl_xpi, xps);
720
721 rpc_unregister_client(clnt);
722 __rpc_clnt_remove_pipedir(clnt);
723 rpc_clnt_debugfs_unregister(clnt);
724
725 /*
726 * A new transport was created. "clnt" therefore
727 * becomes the root of a new cl_parent tree. clnt's
728 * children, if it has any, still point to the old xprt.
729 */
730 parent = clnt->cl_parent;
731 clnt->cl_parent = clnt;
732
733 /*
734 * The old rpc_auth cache cannot be re-used. GSS
735 * contexts in particular are between a single
736 * client and server.
737 */
738 err = rpc_client_register(clnt, pseudoflavor, NULL);
739 if (err)
740 goto out_revert;
741
742 synchronize_rcu();
743 if (parent != clnt)
744 rpc_release_client(parent);
745 xprt_switch_put(oldxps);
746 xprt_put(old);
747 dprintk("RPC: replaced xprt for clnt %p\n", clnt);
748 return 0;
749
750out_revert:
751 xps = xprt_iter_xchg_switch(&clnt->cl_xpi, oldxps);
752 rpc_clnt_set_transport(clnt, old, old_timeo);
753 clnt->cl_parent = parent;
754 rpc_client_register(clnt, pseudoflavor, NULL);
755 xprt_switch_put(xps);
756 xprt_put(xprt);
757 dprintk("RPC: failed to switch xprt for clnt %p\n", clnt);
758 return err;
759}
760EXPORT_SYMBOL_GPL(rpc_switch_client_transport);
761
762static
763int rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi)
764{
765 struct rpc_xprt_switch *xps;
766
767 rcu_read_lock();
768 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
769 rcu_read_unlock();
770 if (xps == NULL)
771 return -EAGAIN;
772 xprt_iter_init_listall(xpi, xps);
773 xprt_switch_put(xps);
774 return 0;
775}
776
777/**
778 * rpc_clnt_iterate_for_each_xprt - Apply a function to all transports
779 * @clnt: pointer to client
780 * @fn: function to apply
781 * @data: void pointer to function data
782 *
783 * Iterates through the list of RPC transports currently attached to the
784 * client and applies the function fn(clnt, xprt, data).
785 *
786 * On error, the iteration stops, and the function returns the error value.
787 */
788int rpc_clnt_iterate_for_each_xprt(struct rpc_clnt *clnt,
789 int (*fn)(struct rpc_clnt *, struct rpc_xprt *, void *),
790 void *data)
791{
792 struct rpc_xprt_iter xpi;
793 int ret;
794
795 ret = rpc_clnt_xprt_iter_init(clnt, &xpi);
796 if (ret)
797 return ret;
798 for (;;) {
799 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
800
801 if (!xprt)
802 break;
803 ret = fn(clnt, xprt, data);
804 xprt_put(xprt);
805 if (ret < 0)
806 break;
807 }
808 xprt_iter_destroy(&xpi);
809 return ret;
810}
811EXPORT_SYMBOL_GPL(rpc_clnt_iterate_for_each_xprt);
812
813/*
814 * Kill all tasks for the given client.
815 * XXX: kill their descendants as well?
816 */
817void rpc_killall_tasks(struct rpc_clnt *clnt)
818{
819 struct rpc_task *rovr;
820
821
822 if (list_empty(&clnt->cl_tasks))
823 return;
824 dprintk("RPC: killing all tasks for client %p\n", clnt);
825 /*
826 * Spin lock all_tasks to prevent changes...
827 */
828 spin_lock(&clnt->cl_lock);
829 list_for_each_entry(rovr, &clnt->cl_tasks, tk_task) {
830 if (!RPC_IS_ACTIVATED(rovr))
831 continue;
832 if (!(rovr->tk_flags & RPC_TASK_KILLED)) {
833 rovr->tk_flags |= RPC_TASK_KILLED;
834 rpc_exit(rovr, -EIO);
835 if (RPC_IS_QUEUED(rovr))
836 rpc_wake_up_queued_task(rovr->tk_waitqueue,
837 rovr);
838 }
839 }
840 spin_unlock(&clnt->cl_lock);
841}
842EXPORT_SYMBOL_GPL(rpc_killall_tasks);
843
844/*
845 * Properly shut down an RPC client, terminating all outstanding
846 * requests.
847 */
848void rpc_shutdown_client(struct rpc_clnt *clnt)
849{
850 might_sleep();
851
852 dprintk_rcu("RPC: shutting down %s client for %s\n",
853 clnt->cl_program->name,
854 rcu_dereference(clnt->cl_xprt)->servername);
855
856 while (!list_empty(&clnt->cl_tasks)) {
857 rpc_killall_tasks(clnt);
858 wait_event_timeout(destroy_wait,
859 list_empty(&clnt->cl_tasks), 1*HZ);
860 }
861
862 rpc_release_client(clnt);
863}
864EXPORT_SYMBOL_GPL(rpc_shutdown_client);
865
866/*
867 * Free an RPC client
868 */
869static struct rpc_clnt *
870rpc_free_client(struct rpc_clnt *clnt)
871{
872 struct rpc_clnt *parent = NULL;
873
874 dprintk_rcu("RPC: destroying %s client for %s\n",
875 clnt->cl_program->name,
876 rcu_dereference(clnt->cl_xprt)->servername);
877 if (clnt->cl_parent != clnt)
878 parent = clnt->cl_parent;
879 rpc_clnt_debugfs_unregister(clnt);
880 rpc_clnt_remove_pipedir(clnt);
881 rpc_unregister_client(clnt);
882 rpc_free_iostats(clnt->cl_metrics);
883 clnt->cl_metrics = NULL;
884 xprt_put(rcu_dereference_raw(clnt->cl_xprt));
885 xprt_iter_destroy(&clnt->cl_xpi);
886 rpciod_down();
887 rpc_free_clid(clnt);
888 kfree(clnt);
889 return parent;
890}
891
892/*
893 * Free an RPC client
894 */
895static struct rpc_clnt *
896rpc_free_auth(struct rpc_clnt *clnt)
897{
898 if (clnt->cl_auth == NULL)
899 return rpc_free_client(clnt);
900
901 /*
902 * Note: RPCSEC_GSS may need to send NULL RPC calls in order to
903 * release remaining GSS contexts. This mechanism ensures
904 * that it can do so safely.
905 */
906 atomic_inc(&clnt->cl_count);
907 rpcauth_release(clnt->cl_auth);
908 clnt->cl_auth = NULL;
909 if (atomic_dec_and_test(&clnt->cl_count))
910 return rpc_free_client(clnt);
911 return NULL;
912}
913
914/*
915 * Release reference to the RPC client
916 */
917void
918rpc_release_client(struct rpc_clnt *clnt)
919{
920 dprintk("RPC: rpc_release_client(%p)\n", clnt);
921
922 do {
923 if (list_empty(&clnt->cl_tasks))
924 wake_up(&destroy_wait);
925 if (!atomic_dec_and_test(&clnt->cl_count))
926 break;
927 clnt = rpc_free_auth(clnt);
928 } while (clnt != NULL);
929}
930EXPORT_SYMBOL_GPL(rpc_release_client);
931
932/**
933 * rpc_bind_new_program - bind a new RPC program to an existing client
934 * @old: old rpc_client
935 * @program: rpc program to set
936 * @vers: rpc program version
937 *
938 * Clones the rpc client and sets up a new RPC program. This is mainly
939 * of use for enabling different RPC programs to share the same transport.
940 * The Sun NFSv2/v3 ACL protocol can do this.
941 */
942struct rpc_clnt *rpc_bind_new_program(struct rpc_clnt *old,
943 const struct rpc_program *program,
944 u32 vers)
945{
946 struct rpc_create_args args = {
947 .program = program,
948 .prognumber = program->number,
949 .version = vers,
950 .authflavor = old->cl_auth->au_flavor,
951 };
952 struct rpc_clnt *clnt;
953 int err;
954
955 clnt = __rpc_clone_client(&args, old);
956 if (IS_ERR(clnt))
957 goto out;
958 err = rpc_ping(clnt);
959 if (err != 0) {
960 rpc_shutdown_client(clnt);
961 clnt = ERR_PTR(err);
962 }
963out:
964 return clnt;
965}
966EXPORT_SYMBOL_GPL(rpc_bind_new_program);
967
968void rpc_task_release_client(struct rpc_task *task)
969{
970 struct rpc_clnt *clnt = task->tk_client;
971 struct rpc_xprt *xprt = task->tk_xprt;
972
973 if (clnt != NULL) {
974 /* Remove from client task list */
975 spin_lock(&clnt->cl_lock);
976 list_del(&task->tk_task);
977 spin_unlock(&clnt->cl_lock);
978 task->tk_client = NULL;
979
980 rpc_release_client(clnt);
981 }
982
983 if (xprt != NULL) {
984 task->tk_xprt = NULL;
985
986 xprt_put(xprt);
987 }
988}
989
990static
991void rpc_task_set_client(struct rpc_task *task, struct rpc_clnt *clnt)
992{
993
994 if (clnt != NULL) {
995 if (task->tk_xprt == NULL)
996 task->tk_xprt = xprt_iter_get_next(&clnt->cl_xpi);
997 task->tk_client = clnt;
998 atomic_inc(&clnt->cl_count);
999 if (clnt->cl_softrtry)
1000 task->tk_flags |= RPC_TASK_SOFT;
1001 if (clnt->cl_noretranstimeo)
1002 task->tk_flags |= RPC_TASK_NO_RETRANS_TIMEOUT;
1003 if (atomic_read(&clnt->cl_swapper))
1004 task->tk_flags |= RPC_TASK_SWAPPER;
1005 /* Add to the client's list of all tasks */
1006 spin_lock(&clnt->cl_lock);
1007 list_add_tail(&task->tk_task, &clnt->cl_tasks);
1008 spin_unlock(&clnt->cl_lock);
1009 }
1010}
1011
1012static void
1013rpc_task_set_rpc_message(struct rpc_task *task, const struct rpc_message *msg)
1014{
1015 if (msg != NULL) {
1016 task->tk_msg.rpc_proc = msg->rpc_proc;
1017 task->tk_msg.rpc_argp = msg->rpc_argp;
1018 task->tk_msg.rpc_resp = msg->rpc_resp;
1019 if (msg->rpc_cred != NULL)
1020 task->tk_msg.rpc_cred = get_rpccred(msg->rpc_cred);
1021 }
1022}
1023
1024/*
1025 * Default callback for async RPC calls
1026 */
1027static void
1028rpc_default_callback(struct rpc_task *task, void *data)
1029{
1030}
1031
1032static const struct rpc_call_ops rpc_default_ops = {
1033 .rpc_call_done = rpc_default_callback,
1034};
1035
1036/**
1037 * rpc_run_task - Allocate a new RPC task, then run rpc_execute against it
1038 * @task_setup_data: pointer to task initialisation data
1039 */
1040struct rpc_task *rpc_run_task(const struct rpc_task_setup *task_setup_data)
1041{
1042 struct rpc_task *task;
1043
1044 task = rpc_new_task(task_setup_data);
1045
1046 rpc_task_set_client(task, task_setup_data->rpc_client);
1047 rpc_task_set_rpc_message(task, task_setup_data->rpc_message);
1048
1049 if (task->tk_action == NULL)
1050 rpc_call_start(task);
1051
1052 atomic_inc(&task->tk_count);
1053 rpc_execute(task);
1054 return task;
1055}
1056EXPORT_SYMBOL_GPL(rpc_run_task);
1057
1058/**
1059 * rpc_call_sync - Perform a synchronous RPC call
1060 * @clnt: pointer to RPC client
1061 * @msg: RPC call parameters
1062 * @flags: RPC call flags
1063 */
1064int rpc_call_sync(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags)
1065{
1066 struct rpc_task *task;
1067 struct rpc_task_setup task_setup_data = {
1068 .rpc_client = clnt,
1069 .rpc_message = msg,
1070 .callback_ops = &rpc_default_ops,
1071 .flags = flags,
1072 };
1073 int status;
1074
1075 WARN_ON_ONCE(flags & RPC_TASK_ASYNC);
1076 if (flags & RPC_TASK_ASYNC) {
1077 rpc_release_calldata(task_setup_data.callback_ops,
1078 task_setup_data.callback_data);
1079 return -EINVAL;
1080 }
1081
1082 task = rpc_run_task(&task_setup_data);
1083 if (IS_ERR(task))
1084 return PTR_ERR(task);
1085 status = task->tk_status;
1086 rpc_put_task(task);
1087 return status;
1088}
1089EXPORT_SYMBOL_GPL(rpc_call_sync);
1090
1091/**
1092 * rpc_call_async - Perform an asynchronous RPC call
1093 * @clnt: pointer to RPC client
1094 * @msg: RPC call parameters
1095 * @flags: RPC call flags
1096 * @tk_ops: RPC call ops
1097 * @data: user call data
1098 */
1099int
1100rpc_call_async(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags,
1101 const struct rpc_call_ops *tk_ops, void *data)
1102{
1103 struct rpc_task *task;
1104 struct rpc_task_setup task_setup_data = {
1105 .rpc_client = clnt,
1106 .rpc_message = msg,
1107 .callback_ops = tk_ops,
1108 .callback_data = data,
1109 .flags = flags|RPC_TASK_ASYNC,
1110 };
1111
1112 task = rpc_run_task(&task_setup_data);
1113 if (IS_ERR(task))
1114 return PTR_ERR(task);
1115 rpc_put_task(task);
1116 return 0;
1117}
1118EXPORT_SYMBOL_GPL(rpc_call_async);
1119
1120#if defined(CONFIG_SUNRPC_BACKCHANNEL)
1121/**
1122 * rpc_run_bc_task - Allocate a new RPC task for backchannel use, then run
1123 * rpc_execute against it
1124 * @req: RPC request
1125 */
1126struct rpc_task *rpc_run_bc_task(struct rpc_rqst *req)
1127{
1128 struct rpc_task *task;
1129 struct xdr_buf *xbufp = &req->rq_snd_buf;
1130 struct rpc_task_setup task_setup_data = {
1131 .callback_ops = &rpc_default_ops,
1132 .flags = RPC_TASK_SOFTCONN,
1133 };
1134
1135 dprintk("RPC: rpc_run_bc_task req= %p\n", req);
1136 /*
1137 * Create an rpc_task to send the data
1138 */
1139 task = rpc_new_task(&task_setup_data);
1140 task->tk_rqstp = req;
1141
1142 /*
1143 * Set up the xdr_buf length.
1144 * This also indicates that the buffer is XDR encoded already.
1145 */
1146 xbufp->len = xbufp->head[0].iov_len + xbufp->page_len +
1147 xbufp->tail[0].iov_len;
1148
1149 task->tk_action = call_bc_transmit;
1150 atomic_inc(&task->tk_count);
1151 WARN_ON_ONCE(atomic_read(&task->tk_count) != 2);
1152 rpc_execute(task);
1153
1154 dprintk("RPC: rpc_run_bc_task: task= %p\n", task);
1155 return task;
1156}
1157#endif /* CONFIG_SUNRPC_BACKCHANNEL */
1158
1159void
1160rpc_call_start(struct rpc_task *task)
1161{
1162 task->tk_action = call_start;
1163}
1164EXPORT_SYMBOL_GPL(rpc_call_start);
1165
1166/**
1167 * rpc_peeraddr - extract remote peer address from clnt's xprt
1168 * @clnt: RPC client structure
1169 * @buf: target buffer
1170 * @bufsize: length of target buffer
1171 *
1172 * Returns the number of bytes that are actually in the stored address.
1173 */
1174size_t rpc_peeraddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t bufsize)
1175{
1176 size_t bytes;
1177 struct rpc_xprt *xprt;
1178
1179 rcu_read_lock();
1180 xprt = rcu_dereference(clnt->cl_xprt);
1181
1182 bytes = xprt->addrlen;
1183 if (bytes > bufsize)
1184 bytes = bufsize;
1185 memcpy(buf, &xprt->addr, bytes);
1186 rcu_read_unlock();
1187
1188 return bytes;
1189}
1190EXPORT_SYMBOL_GPL(rpc_peeraddr);
1191
1192/**
1193 * rpc_peeraddr2str - return remote peer address in printable format
1194 * @clnt: RPC client structure
1195 * @format: address format
1196 *
1197 * NB: the lifetime of the memory referenced by the returned pointer is
1198 * the same as the rpc_xprt itself. As long as the caller uses this
1199 * pointer, it must hold the RCU read lock.
1200 */
1201const char *rpc_peeraddr2str(struct rpc_clnt *clnt,
1202 enum rpc_display_format_t format)
1203{
1204 struct rpc_xprt *xprt;
1205
1206 xprt = rcu_dereference(clnt->cl_xprt);
1207
1208 if (xprt->address_strings[format] != NULL)
1209 return xprt->address_strings[format];
1210 else
1211 return "unprintable";
1212}
1213EXPORT_SYMBOL_GPL(rpc_peeraddr2str);
1214
1215static const struct sockaddr_in rpc_inaddr_loopback = {
1216 .sin_family = AF_INET,
1217 .sin_addr.s_addr = htonl(INADDR_ANY),
1218};
1219
1220static const struct sockaddr_in6 rpc_in6addr_loopback = {
1221 .sin6_family = AF_INET6,
1222 .sin6_addr = IN6ADDR_ANY_INIT,
1223};
1224
1225/*
1226 * Try a getsockname() on a connected datagram socket. Using a
1227 * connected datagram socket prevents leaving a socket in TIME_WAIT.
1228 * This conserves the ephemeral port number space.
1229 *
1230 * Returns zero and fills in "buf" if successful; otherwise, a
1231 * negative errno is returned.
1232 */
1233static int rpc_sockname(struct net *net, struct sockaddr *sap, size_t salen,
1234 struct sockaddr *buf)
1235{
1236 struct socket *sock;
1237 int err;
1238
1239 err = __sock_create(net, sap->sa_family,
1240 SOCK_DGRAM, IPPROTO_UDP, &sock, 1);
1241 if (err < 0) {
1242 dprintk("RPC: can't create UDP socket (%d)\n", err);
1243 goto out;
1244 }
1245
1246 switch (sap->sa_family) {
1247 case AF_INET:
1248 err = kernel_bind(sock,
1249 (struct sockaddr *)&rpc_inaddr_loopback,
1250 sizeof(rpc_inaddr_loopback));
1251 break;
1252 case AF_INET6:
1253 err = kernel_bind(sock,
1254 (struct sockaddr *)&rpc_in6addr_loopback,
1255 sizeof(rpc_in6addr_loopback));
1256 break;
1257 default:
1258 err = -EAFNOSUPPORT;
1259 goto out;
1260 }
1261 if (err < 0) {
1262 dprintk("RPC: can't bind UDP socket (%d)\n", err);
1263 goto out_release;
1264 }
1265
1266 err = kernel_connect(sock, sap, salen, 0);
1267 if (err < 0) {
1268 dprintk("RPC: can't connect UDP socket (%d)\n", err);
1269 goto out_release;
1270 }
1271
1272 err = kernel_getsockname(sock, buf);
1273 if (err < 0) {
1274 dprintk("RPC: getsockname failed (%d)\n", err);
1275 goto out_release;
1276 }
1277
1278 err = 0;
1279 if (buf->sa_family == AF_INET6) {
1280 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)buf;
1281 sin6->sin6_scope_id = 0;
1282 }
1283 dprintk("RPC: %s succeeded\n", __func__);
1284
1285out_release:
1286 sock_release(sock);
1287out:
1288 return err;
1289}
1290
1291/*
1292 * Scraping a connected socket failed, so we don't have a useable
1293 * local address. Fallback: generate an address that will prevent
1294 * the server from calling us back.
1295 *
1296 * Returns zero and fills in "buf" if successful; otherwise, a
1297 * negative errno is returned.
1298 */
1299static int rpc_anyaddr(int family, struct sockaddr *buf, size_t buflen)
1300{
1301 switch (family) {
1302 case AF_INET:
1303 if (buflen < sizeof(rpc_inaddr_loopback))
1304 return -EINVAL;
1305 memcpy(buf, &rpc_inaddr_loopback,
1306 sizeof(rpc_inaddr_loopback));
1307 break;
1308 case AF_INET6:
1309 if (buflen < sizeof(rpc_in6addr_loopback))
1310 return -EINVAL;
1311 memcpy(buf, &rpc_in6addr_loopback,
1312 sizeof(rpc_in6addr_loopback));
1313 break;
1314 default:
1315 dprintk("RPC: %s: address family not supported\n",
1316 __func__);
1317 return -EAFNOSUPPORT;
1318 }
1319 dprintk("RPC: %s: succeeded\n", __func__);
1320 return 0;
1321}
1322
1323/**
1324 * rpc_localaddr - discover local endpoint address for an RPC client
1325 * @clnt: RPC client structure
1326 * @buf: target buffer
1327 * @buflen: size of target buffer, in bytes
1328 *
1329 * Returns zero and fills in "buf" and "buflen" if successful;
1330 * otherwise, a negative errno is returned.
1331 *
1332 * This works even if the underlying transport is not currently connected,
1333 * or if the upper layer never previously provided a source address.
1334 *
1335 * The result of this function call is transient: multiple calls in
1336 * succession may give different results, depending on how local
1337 * networking configuration changes over time.
1338 */
1339int rpc_localaddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t buflen)
1340{
1341 struct sockaddr_storage address;
1342 struct sockaddr *sap = (struct sockaddr *)&address;
1343 struct rpc_xprt *xprt;
1344 struct net *net;
1345 size_t salen;
1346 int err;
1347
1348 rcu_read_lock();
1349 xprt = rcu_dereference(clnt->cl_xprt);
1350 salen = xprt->addrlen;
1351 memcpy(sap, &xprt->addr, salen);
1352 net = get_net(xprt->xprt_net);
1353 rcu_read_unlock();
1354
1355 rpc_set_port(sap, 0);
1356 err = rpc_sockname(net, sap, salen, buf);
1357 put_net(net);
1358 if (err != 0)
1359 /* Couldn't discover local address, return ANYADDR */
1360 return rpc_anyaddr(sap->sa_family, buf, buflen);
1361 return 0;
1362}
1363EXPORT_SYMBOL_GPL(rpc_localaddr);
1364
1365void
1366rpc_setbufsize(struct rpc_clnt *clnt, unsigned int sndsize, unsigned int rcvsize)
1367{
1368 struct rpc_xprt *xprt;
1369
1370 rcu_read_lock();
1371 xprt = rcu_dereference(clnt->cl_xprt);
1372 if (xprt->ops->set_buffer_size)
1373 xprt->ops->set_buffer_size(xprt, sndsize, rcvsize);
1374 rcu_read_unlock();
1375}
1376EXPORT_SYMBOL_GPL(rpc_setbufsize);
1377
1378/**
1379 * rpc_net_ns - Get the network namespace for this RPC client
1380 * @clnt: RPC client to query
1381 *
1382 */
1383struct net *rpc_net_ns(struct rpc_clnt *clnt)
1384{
1385 struct net *ret;
1386
1387 rcu_read_lock();
1388 ret = rcu_dereference(clnt->cl_xprt)->xprt_net;
1389 rcu_read_unlock();
1390 return ret;
1391}
1392EXPORT_SYMBOL_GPL(rpc_net_ns);
1393
1394/**
1395 * rpc_max_payload - Get maximum payload size for a transport, in bytes
1396 * @clnt: RPC client to query
1397 *
1398 * For stream transports, this is one RPC record fragment (see RFC
1399 * 1831), as we don't support multi-record requests yet. For datagram
1400 * transports, this is the size of an IP packet minus the IP, UDP, and
1401 * RPC header sizes.
1402 */
1403size_t rpc_max_payload(struct rpc_clnt *clnt)
1404{
1405 size_t ret;
1406
1407 rcu_read_lock();
1408 ret = rcu_dereference(clnt->cl_xprt)->max_payload;
1409 rcu_read_unlock();
1410 return ret;
1411}
1412EXPORT_SYMBOL_GPL(rpc_max_payload);
1413
1414/**
1415 * rpc_max_bc_payload - Get maximum backchannel payload size, in bytes
1416 * @clnt: RPC client to query
1417 */
1418size_t rpc_max_bc_payload(struct rpc_clnt *clnt)
1419{
1420 struct rpc_xprt *xprt;
1421 size_t ret;
1422
1423 rcu_read_lock();
1424 xprt = rcu_dereference(clnt->cl_xprt);
1425 ret = xprt->ops->bc_maxpayload(xprt);
1426 rcu_read_unlock();
1427 return ret;
1428}
1429EXPORT_SYMBOL_GPL(rpc_max_bc_payload);
1430
1431/**
1432 * rpc_force_rebind - force transport to check that remote port is unchanged
1433 * @clnt: client to rebind
1434 *
1435 */
1436void rpc_force_rebind(struct rpc_clnt *clnt)
1437{
1438 if (clnt->cl_autobind) {
1439 rcu_read_lock();
1440 xprt_clear_bound(rcu_dereference(clnt->cl_xprt));
1441 rcu_read_unlock();
1442 }
1443}
1444EXPORT_SYMBOL_GPL(rpc_force_rebind);
1445
1446/*
1447 * Restart an (async) RPC call from the call_prepare state.
1448 * Usually called from within the exit handler.
1449 */
1450int
1451rpc_restart_call_prepare(struct rpc_task *task)
1452{
1453 if (RPC_ASSASSINATED(task))
1454 return 0;
1455 task->tk_action = call_start;
1456 task->tk_status = 0;
1457 if (task->tk_ops->rpc_call_prepare != NULL)
1458 task->tk_action = rpc_prepare_task;
1459 return 1;
1460}
1461EXPORT_SYMBOL_GPL(rpc_restart_call_prepare);
1462
1463/*
1464 * Restart an (async) RPC call. Usually called from within the
1465 * exit handler.
1466 */
1467int
1468rpc_restart_call(struct rpc_task *task)
1469{
1470 if (RPC_ASSASSINATED(task))
1471 return 0;
1472 task->tk_action = call_start;
1473 task->tk_status = 0;
1474 return 1;
1475}
1476EXPORT_SYMBOL_GPL(rpc_restart_call);
1477
1478const char
1479*rpc_proc_name(const struct rpc_task *task)
1480{
1481 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1482
1483 if (proc) {
1484 if (proc->p_name)
1485 return proc->p_name;
1486 else
1487 return "NULL";
1488 } else
1489 return "no proc";
1490}
1491
1492/*
1493 * 0. Initial state
1494 *
1495 * Other FSM states can be visited zero or more times, but
1496 * this state is visited exactly once for each RPC.
1497 */
1498static void
1499call_start(struct rpc_task *task)
1500{
1501 struct rpc_clnt *clnt = task->tk_client;
1502 int idx = task->tk_msg.rpc_proc->p_statidx;
1503
1504 trace_rpc_request(task);
1505 dprintk("RPC: %5u call_start %s%d proc %s (%s)\n", task->tk_pid,
1506 clnt->cl_program->name, clnt->cl_vers,
1507 rpc_proc_name(task),
1508 (RPC_IS_ASYNC(task) ? "async" : "sync"));
1509
1510 /* Increment call count (version might not be valid for ping) */
1511 if (clnt->cl_program->version[clnt->cl_vers])
1512 clnt->cl_program->version[clnt->cl_vers]->counts[idx]++;
1513 clnt->cl_stats->rpccnt++;
1514 task->tk_action = call_reserve;
1515}
1516
1517/*
1518 * 1. Reserve an RPC call slot
1519 */
1520static void
1521call_reserve(struct rpc_task *task)
1522{
1523 dprint_status(task);
1524
1525 task->tk_status = 0;
1526 task->tk_action = call_reserveresult;
1527 xprt_reserve(task);
1528}
1529
1530static void call_retry_reserve(struct rpc_task *task);
1531
1532/*
1533 * 1b. Grok the result of xprt_reserve()
1534 */
1535static void
1536call_reserveresult(struct rpc_task *task)
1537{
1538 int status = task->tk_status;
1539
1540 dprint_status(task);
1541
1542 /*
1543 * After a call to xprt_reserve(), we must have either
1544 * a request slot or else an error status.
1545 */
1546 task->tk_status = 0;
1547 if (status >= 0) {
1548 if (task->tk_rqstp) {
1549 task->tk_action = call_refresh;
1550 return;
1551 }
1552
1553 printk(KERN_ERR "%s: status=%d, but no request slot, exiting\n",
1554 __func__, status);
1555 rpc_exit(task, -EIO);
1556 return;
1557 }
1558
1559 /*
1560 * Even though there was an error, we may have acquired
1561 * a request slot somehow. Make sure not to leak it.
1562 */
1563 if (task->tk_rqstp) {
1564 printk(KERN_ERR "%s: status=%d, request allocated anyway\n",
1565 __func__, status);
1566 xprt_release(task);
1567 }
1568
1569 switch (status) {
1570 case -ENOMEM:
1571 rpc_delay(task, HZ >> 2);
1572 /* fall through */
1573 case -EAGAIN: /* woken up; retry */
1574 task->tk_action = call_retry_reserve;
1575 return;
1576 case -EIO: /* probably a shutdown */
1577 break;
1578 default:
1579 printk(KERN_ERR "%s: unrecognized error %d, exiting\n",
1580 __func__, status);
1581 break;
1582 }
1583 rpc_exit(task, status);
1584}
1585
1586/*
1587 * 1c. Retry reserving an RPC call slot
1588 */
1589static void
1590call_retry_reserve(struct rpc_task *task)
1591{
1592 dprint_status(task);
1593
1594 task->tk_status = 0;
1595 task->tk_action = call_reserveresult;
1596 xprt_retry_reserve(task);
1597}
1598
1599/*
1600 * 2. Bind and/or refresh the credentials
1601 */
1602static void
1603call_refresh(struct rpc_task *task)
1604{
1605 dprint_status(task);
1606
1607 task->tk_action = call_refreshresult;
1608 task->tk_status = 0;
1609 task->tk_client->cl_stats->rpcauthrefresh++;
1610 rpcauth_refreshcred(task);
1611}
1612
1613/*
1614 * 2a. Process the results of a credential refresh
1615 */
1616static void
1617call_refreshresult(struct rpc_task *task)
1618{
1619 int status = task->tk_status;
1620
1621 dprint_status(task);
1622
1623 task->tk_status = 0;
1624 task->tk_action = call_refresh;
1625 switch (status) {
1626 case 0:
1627 if (rpcauth_uptodatecred(task)) {
1628 task->tk_action = call_allocate;
1629 return;
1630 }
1631 /* Use rate-limiting and a max number of retries if refresh
1632 * had status 0 but failed to update the cred.
1633 */
1634 /* fall through */
1635 case -ETIMEDOUT:
1636 rpc_delay(task, 3*HZ);
1637 /* fall through */
1638 case -EAGAIN:
1639 status = -EACCES;
1640 /* fall through */
1641 case -EKEYEXPIRED:
1642 if (!task->tk_cred_retry)
1643 break;
1644 task->tk_cred_retry--;
1645 dprintk("RPC: %5u %s: retry refresh creds\n",
1646 task->tk_pid, __func__);
1647 return;
1648 }
1649 dprintk("RPC: %5u %s: refresh creds failed with error %d\n",
1650 task->tk_pid, __func__, status);
1651 rpc_exit(task, status);
1652}
1653
1654/*
1655 * 2b. Allocate the buffer. For details, see sched.c:rpc_malloc.
1656 * (Note: buffer memory is freed in xprt_release).
1657 */
1658static void
1659call_allocate(struct rpc_task *task)
1660{
1661 unsigned int slack = task->tk_rqstp->rq_cred->cr_auth->au_cslack;
1662 struct rpc_rqst *req = task->tk_rqstp;
1663 struct rpc_xprt *xprt = req->rq_xprt;
1664 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1665 int status;
1666
1667 dprint_status(task);
1668
1669 task->tk_status = 0;
1670 task->tk_action = call_bind;
1671
1672 if (req->rq_buffer)
1673 return;
1674
1675 if (proc->p_proc != 0) {
1676 BUG_ON(proc->p_arglen == 0);
1677 if (proc->p_decode != NULL)
1678 BUG_ON(proc->p_replen == 0);
1679 }
1680
1681 /*
1682 * Calculate the size (in quads) of the RPC call
1683 * and reply headers, and convert both values
1684 * to byte sizes.
1685 */
1686 req->rq_callsize = RPC_CALLHDRSIZE + (slack << 1) + proc->p_arglen;
1687 req->rq_callsize <<= 2;
1688 req->rq_rcvsize = RPC_REPHDRSIZE + slack + proc->p_replen;
1689 req->rq_rcvsize <<= 2;
1690
1691 status = xprt->ops->buf_alloc(task);
1692 xprt_inject_disconnect(xprt);
1693 if (status == 0)
1694 return;
1695 if (status != -ENOMEM) {
1696 rpc_exit(task, status);
1697 return;
1698 }
1699
1700 dprintk("RPC: %5u rpc_buffer allocation failed\n", task->tk_pid);
1701
1702 if (RPC_IS_ASYNC(task) || !fatal_signal_pending(current)) {
1703 task->tk_action = call_allocate;
1704 rpc_delay(task, HZ>>4);
1705 return;
1706 }
1707
1708 rpc_exit(task, -ERESTARTSYS);
1709}
1710
1711static inline int
1712rpc_task_need_encode(struct rpc_task *task)
1713{
1714 return task->tk_rqstp->rq_snd_buf.len == 0;
1715}
1716
1717static inline void
1718rpc_task_force_reencode(struct rpc_task *task)
1719{
1720 task->tk_rqstp->rq_snd_buf.len = 0;
1721 task->tk_rqstp->rq_bytes_sent = 0;
1722}
1723
1724/*
1725 * 3. Encode arguments of an RPC call
1726 */
1727static void
1728rpc_xdr_encode(struct rpc_task *task)
1729{
1730 struct rpc_rqst *req = task->tk_rqstp;
1731 kxdreproc_t encode;
1732 __be32 *p;
1733
1734 dprint_status(task);
1735
1736 xdr_buf_init(&req->rq_snd_buf,
1737 req->rq_buffer,
1738 req->rq_callsize);
1739 xdr_buf_init(&req->rq_rcv_buf,
1740 req->rq_rbuffer,
1741 req->rq_rcvsize);
1742
1743 p = rpc_encode_header(task);
1744 if (p == NULL) {
1745 printk(KERN_INFO "RPC: couldn't encode RPC header, exit EIO\n");
1746 rpc_exit(task, -EIO);
1747 return;
1748 }
1749
1750 encode = task->tk_msg.rpc_proc->p_encode;
1751 if (encode == NULL)
1752 return;
1753
1754 task->tk_status = rpcauth_wrap_req(task, encode, req, p,
1755 task->tk_msg.rpc_argp);
1756}
1757
1758/*
1759 * 4. Get the server port number if not yet set
1760 */
1761static void
1762call_bind(struct rpc_task *task)
1763{
1764 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
1765
1766 dprint_status(task);
1767
1768 task->tk_action = call_connect;
1769 if (!xprt_bound(xprt)) {
1770 task->tk_action = call_bind_status;
1771 task->tk_timeout = xprt->bind_timeout;
1772 xprt->ops->rpcbind(task);
1773 }
1774}
1775
1776/*
1777 * 4a. Sort out bind result
1778 */
1779static void
1780call_bind_status(struct rpc_task *task)
1781{
1782 int status = -EIO;
1783
1784 if (task->tk_status >= 0) {
1785 dprint_status(task);
1786 task->tk_status = 0;
1787 task->tk_action = call_connect;
1788 return;
1789 }
1790
1791 trace_rpc_bind_status(task);
1792 switch (task->tk_status) {
1793 case -ENOMEM:
1794 dprintk("RPC: %5u rpcbind out of memory\n", task->tk_pid);
1795 rpc_delay(task, HZ >> 2);
1796 goto retry_timeout;
1797 case -EACCES:
1798 dprintk("RPC: %5u remote rpcbind: RPC program/version "
1799 "unavailable\n", task->tk_pid);
1800 /* fail immediately if this is an RPC ping */
1801 if (task->tk_msg.rpc_proc->p_proc == 0) {
1802 status = -EOPNOTSUPP;
1803 break;
1804 }
1805 if (task->tk_rebind_retry == 0)
1806 break;
1807 task->tk_rebind_retry--;
1808 rpc_delay(task, 3*HZ);
1809 goto retry_timeout;
1810 case -ETIMEDOUT:
1811 dprintk("RPC: %5u rpcbind request timed out\n",
1812 task->tk_pid);
1813 goto retry_timeout;
1814 case -EPFNOSUPPORT:
1815 /* server doesn't support any rpcbind version we know of */
1816 dprintk("RPC: %5u unrecognized remote rpcbind service\n",
1817 task->tk_pid);
1818 break;
1819 case -EPROTONOSUPPORT:
1820 dprintk("RPC: %5u remote rpcbind version unavailable, retrying\n",
1821 task->tk_pid);
1822 goto retry_timeout;
1823 case -ECONNREFUSED: /* connection problems */
1824 case -ECONNRESET:
1825 case -ECONNABORTED:
1826 case -ENOTCONN:
1827 case -EHOSTDOWN:
1828 case -ENETDOWN:
1829 case -EHOSTUNREACH:
1830 case -ENETUNREACH:
1831 case -ENOBUFS:
1832 case -EPIPE:
1833 dprintk("RPC: %5u remote rpcbind unreachable: %d\n",
1834 task->tk_pid, task->tk_status);
1835 if (!RPC_IS_SOFTCONN(task)) {
1836 rpc_delay(task, 5*HZ);
1837 goto retry_timeout;
1838 }
1839 status = task->tk_status;
1840 break;
1841 default:
1842 dprintk("RPC: %5u unrecognized rpcbind error (%d)\n",
1843 task->tk_pid, -task->tk_status);
1844 }
1845
1846 rpc_exit(task, status);
1847 return;
1848
1849retry_timeout:
1850 task->tk_status = 0;
1851 task->tk_action = call_timeout;
1852}
1853
1854/*
1855 * 4b. Connect to the RPC server
1856 */
1857static void
1858call_connect(struct rpc_task *task)
1859{
1860 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
1861
1862 dprintk("RPC: %5u call_connect xprt %p %s connected\n",
1863 task->tk_pid, xprt,
1864 (xprt_connected(xprt) ? "is" : "is not"));
1865
1866 task->tk_action = call_transmit;
1867 if (!xprt_connected(xprt)) {
1868 task->tk_action = call_connect_status;
1869 if (task->tk_status < 0)
1870 return;
1871 if (task->tk_flags & RPC_TASK_NOCONNECT) {
1872 rpc_exit(task, -ENOTCONN);
1873 return;
1874 }
1875 xprt_connect(task);
1876 }
1877}
1878
1879/*
1880 * 4c. Sort out connect result
1881 */
1882static void
1883call_connect_status(struct rpc_task *task)
1884{
1885 struct rpc_clnt *clnt = task->tk_client;
1886 int status = task->tk_status;
1887
1888 dprint_status(task);
1889
1890 trace_rpc_connect_status(task);
1891 task->tk_status = 0;
1892 switch (status) {
1893 case -ECONNREFUSED:
1894 /* A positive refusal suggests a rebind is needed. */
1895 if (RPC_IS_SOFTCONN(task))
1896 break;
1897 if (clnt->cl_autobind) {
1898 rpc_force_rebind(clnt);
1899 task->tk_action = call_bind;
1900 return;
1901 }
1902 /* fall through */
1903 case -ECONNRESET:
1904 case -ECONNABORTED:
1905 case -ENETDOWN:
1906 case -ENETUNREACH:
1907 case -EHOSTUNREACH:
1908 case -EADDRINUSE:
1909 case -ENOBUFS:
1910 case -EPIPE:
1911 xprt_conditional_disconnect(task->tk_rqstp->rq_xprt,
1912 task->tk_rqstp->rq_connect_cookie);
1913 if (RPC_IS_SOFTCONN(task))
1914 break;
1915 /* retry with existing socket, after a delay */
1916 rpc_delay(task, 3*HZ);
1917 /* fall through */
1918 case -EAGAIN:
1919 /* Check for timeouts before looping back to call_bind */
1920 case -ETIMEDOUT:
1921 task->tk_action = call_timeout;
1922 return;
1923 case 0:
1924 clnt->cl_stats->netreconn++;
1925 task->tk_action = call_transmit;
1926 return;
1927 }
1928 rpc_exit(task, status);
1929}
1930
1931/*
1932 * 5. Transmit the RPC request, and wait for reply
1933 */
1934static void
1935call_transmit(struct rpc_task *task)
1936{
1937 int is_retrans = RPC_WAS_SENT(task);
1938
1939 dprint_status(task);
1940
1941 task->tk_action = call_status;
1942 if (task->tk_status < 0)
1943 return;
1944 if (!xprt_prepare_transmit(task))
1945 return;
1946 task->tk_action = call_transmit_status;
1947 /* Encode here so that rpcsec_gss can use correct sequence number. */
1948 if (rpc_task_need_encode(task)) {
1949 rpc_xdr_encode(task);
1950 /* Did the encode result in an error condition? */
1951 if (task->tk_status != 0) {
1952 /* Was the error nonfatal? */
1953 if (task->tk_status == -EAGAIN)
1954 rpc_delay(task, HZ >> 4);
1955 else
1956 rpc_exit(task, task->tk_status);
1957 return;
1958 }
1959 }
1960 xprt_transmit(task);
1961 if (task->tk_status < 0)
1962 return;
1963 if (is_retrans)
1964 task->tk_client->cl_stats->rpcretrans++;
1965 /*
1966 * On success, ensure that we call xprt_end_transmit() before sleeping
1967 * in order to allow access to the socket to other RPC requests.
1968 */
1969 call_transmit_status(task);
1970 if (rpc_reply_expected(task))
1971 return;
1972 task->tk_action = rpc_exit_task;
1973 rpc_wake_up_queued_task(&task->tk_rqstp->rq_xprt->pending, task);
1974}
1975
1976/*
1977 * 5a. Handle cleanup after a transmission
1978 */
1979static void
1980call_transmit_status(struct rpc_task *task)
1981{
1982 task->tk_action = call_status;
1983
1984 /*
1985 * Common case: success. Force the compiler to put this
1986 * test first.
1987 */
1988 if (task->tk_status == 0) {
1989 xprt_end_transmit(task);
1990 rpc_task_force_reencode(task);
1991 return;
1992 }
1993
1994 switch (task->tk_status) {
1995 case -EAGAIN:
1996 case -ENOBUFS:
1997 break;
1998 default:
1999 dprint_status(task);
2000 xprt_end_transmit(task);
2001 rpc_task_force_reencode(task);
2002 break;
2003 /*
2004 * Special cases: if we've been waiting on the
2005 * socket's write_space() callback, or if the
2006 * socket just returned a connection error,
2007 * then hold onto the transport lock.
2008 */
2009 case -ECONNREFUSED:
2010 case -EHOSTDOWN:
2011 case -ENETDOWN:
2012 case -EHOSTUNREACH:
2013 case -ENETUNREACH:
2014 case -EPERM:
2015 if (RPC_IS_SOFTCONN(task)) {
2016 xprt_end_transmit(task);
2017 if (!task->tk_msg.rpc_proc->p_proc)
2018 trace_xprt_ping(task->tk_xprt,
2019 task->tk_status);
2020 rpc_exit(task, task->tk_status);
2021 break;
2022 }
2023 /* fall through */
2024 case -ECONNRESET:
2025 case -ECONNABORTED:
2026 case -EADDRINUSE:
2027 case -ENOTCONN:
2028 case -EPIPE:
2029 rpc_task_force_reencode(task);
2030 }
2031}
2032
2033#if defined(CONFIG_SUNRPC_BACKCHANNEL)
2034/*
2035 * 5b. Send the backchannel RPC reply. On error, drop the reply. In
2036 * addition, disconnect on connectivity errors.
2037 */
2038static void
2039call_bc_transmit(struct rpc_task *task)
2040{
2041 struct rpc_rqst *req = task->tk_rqstp;
2042
2043 if (!xprt_prepare_transmit(task))
2044 goto out_retry;
2045
2046 if (task->tk_status < 0) {
2047 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2048 "error: %d\n", task->tk_status);
2049 goto out_done;
2050 }
2051 if (req->rq_connect_cookie != req->rq_xprt->connect_cookie)
2052 req->rq_bytes_sent = 0;
2053
2054 xprt_transmit(task);
2055
2056 if (task->tk_status == -EAGAIN)
2057 goto out_nospace;
2058
2059 xprt_end_transmit(task);
2060 dprint_status(task);
2061 switch (task->tk_status) {
2062 case 0:
2063 /* Success */
2064 case -ENETDOWN:
2065 case -EHOSTDOWN:
2066 case -EHOSTUNREACH:
2067 case -ENETUNREACH:
2068 case -ECONNRESET:
2069 case -ECONNREFUSED:
2070 case -EADDRINUSE:
2071 case -ENOTCONN:
2072 case -EPIPE:
2073 break;
2074 case -ETIMEDOUT:
2075 /*
2076 * Problem reaching the server. Disconnect and let the
2077 * forechannel reestablish the connection. The server will
2078 * have to retransmit the backchannel request and we'll
2079 * reprocess it. Since these ops are idempotent, there's no
2080 * need to cache our reply at this time.
2081 */
2082 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2083 "error: %d\n", task->tk_status);
2084 xprt_conditional_disconnect(req->rq_xprt,
2085 req->rq_connect_cookie);
2086 break;
2087 default:
2088 /*
2089 * We were unable to reply and will have to drop the
2090 * request. The server should reconnect and retransmit.
2091 */
2092 WARN_ON_ONCE(task->tk_status == -EAGAIN);
2093 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2094 "error: %d\n", task->tk_status);
2095 break;
2096 }
2097 rpc_wake_up_queued_task(&req->rq_xprt->pending, task);
2098out_done:
2099 task->tk_action = rpc_exit_task;
2100 return;
2101out_nospace:
2102 req->rq_connect_cookie = req->rq_xprt->connect_cookie;
2103out_retry:
2104 task->tk_status = 0;
2105}
2106#endif /* CONFIG_SUNRPC_BACKCHANNEL */
2107
2108/*
2109 * 6. Sort out the RPC call status
2110 */
2111static void
2112call_status(struct rpc_task *task)
2113{
2114 struct rpc_clnt *clnt = task->tk_client;
2115 struct rpc_rqst *req = task->tk_rqstp;
2116 int status;
2117
2118 if (!task->tk_msg.rpc_proc->p_proc)
2119 trace_xprt_ping(task->tk_xprt, task->tk_status);
2120
2121 if (req->rq_reply_bytes_recvd > 0 && !req->rq_bytes_sent)
2122 task->tk_status = req->rq_reply_bytes_recvd;
2123
2124 dprint_status(task);
2125
2126 status = task->tk_status;
2127 if (status >= 0) {
2128 task->tk_action = call_decode;
2129 return;
2130 }
2131
2132 trace_rpc_call_status(task);
2133 task->tk_status = 0;
2134 switch(status) {
2135 case -EHOSTDOWN:
2136 case -ENETDOWN:
2137 case -EHOSTUNREACH:
2138 case -ENETUNREACH:
2139 case -EPERM:
2140 if (RPC_IS_SOFTCONN(task)) {
2141 rpc_exit(task, status);
2142 break;
2143 }
2144 /*
2145 * Delay any retries for 3 seconds, then handle as if it
2146 * were a timeout.
2147 */
2148 rpc_delay(task, 3*HZ);
2149 /* fall through */
2150 case -ETIMEDOUT:
2151 task->tk_action = call_timeout;
2152 break;
2153 case -ECONNREFUSED:
2154 case -ECONNRESET:
2155 case -ECONNABORTED:
2156 rpc_force_rebind(clnt);
2157 /* fall through */
2158 case -EADDRINUSE:
2159 rpc_delay(task, 3*HZ);
2160 /* fall through */
2161 case -EPIPE:
2162 case -ENOTCONN:
2163 task->tk_action = call_bind;
2164 break;
2165 case -ENOBUFS:
2166 rpc_delay(task, HZ>>2);
2167 /* fall through */
2168 case -EAGAIN:
2169 task->tk_action = call_transmit;
2170 break;
2171 case -EIO:
2172 /* shutdown or soft timeout */
2173 rpc_exit(task, status);
2174 break;
2175 default:
2176 if (clnt->cl_chatty)
2177 printk("%s: RPC call returned error %d\n",
2178 clnt->cl_program->name, -status);
2179 rpc_exit(task, status);
2180 }
2181}
2182
2183/*
2184 * 6a. Handle RPC timeout
2185 * We do not release the request slot, so we keep using the
2186 * same XID for all retransmits.
2187 */
2188static void
2189call_timeout(struct rpc_task *task)
2190{
2191 struct rpc_clnt *clnt = task->tk_client;
2192
2193 if (xprt_adjust_timeout(task->tk_rqstp) == 0) {
2194 dprintk("RPC: %5u call_timeout (minor)\n", task->tk_pid);
2195 goto retry;
2196 }
2197
2198 dprintk("RPC: %5u call_timeout (major)\n", task->tk_pid);
2199 task->tk_timeouts++;
2200
2201 if (RPC_IS_SOFTCONN(task)) {
2202 rpc_exit(task, -ETIMEDOUT);
2203 return;
2204 }
2205 if (RPC_IS_SOFT(task)) {
2206 if (clnt->cl_chatty) {
2207 printk(KERN_NOTICE "%s: server %s not responding, timed out\n",
2208 clnt->cl_program->name,
2209 task->tk_xprt->servername);
2210 }
2211 if (task->tk_flags & RPC_TASK_TIMEOUT)
2212 rpc_exit(task, -ETIMEDOUT);
2213 else
2214 rpc_exit(task, -EIO);
2215 return;
2216 }
2217
2218 if (!(task->tk_flags & RPC_CALL_MAJORSEEN)) {
2219 task->tk_flags |= RPC_CALL_MAJORSEEN;
2220 if (clnt->cl_chatty) {
2221 printk(KERN_NOTICE "%s: server %s not responding, still trying\n",
2222 clnt->cl_program->name,
2223 task->tk_xprt->servername);
2224 }
2225 }
2226 rpc_force_rebind(clnt);
2227 /*
2228 * Did our request time out due to an RPCSEC_GSS out-of-sequence
2229 * event? RFC2203 requires the server to drop all such requests.
2230 */
2231 rpcauth_invalcred(task);
2232
2233retry:
2234 task->tk_action = call_bind;
2235 task->tk_status = 0;
2236}
2237
2238/*
2239 * 7. Decode the RPC reply
2240 */
2241static void
2242call_decode(struct rpc_task *task)
2243{
2244 struct rpc_clnt *clnt = task->tk_client;
2245 struct rpc_rqst *req = task->tk_rqstp;
2246 kxdrdproc_t decode = task->tk_msg.rpc_proc->p_decode;
2247 __be32 *p;
2248
2249 dprint_status(task);
2250
2251 if (task->tk_flags & RPC_CALL_MAJORSEEN) {
2252 if (clnt->cl_chatty) {
2253 printk(KERN_NOTICE "%s: server %s OK\n",
2254 clnt->cl_program->name,
2255 task->tk_xprt->servername);
2256 }
2257 task->tk_flags &= ~RPC_CALL_MAJORSEEN;
2258 }
2259
2260 /*
2261 * Ensure that we see all writes made by xprt_complete_rqst()
2262 * before it changed req->rq_reply_bytes_recvd.
2263 */
2264 smp_rmb();
2265 req->rq_rcv_buf.len = req->rq_private_buf.len;
2266
2267 /* Check that the softirq receive buffer is valid */
2268 WARN_ON(memcmp(&req->rq_rcv_buf, &req->rq_private_buf,
2269 sizeof(req->rq_rcv_buf)) != 0);
2270
2271 if (req->rq_rcv_buf.len < 12) {
2272 if (!RPC_IS_SOFT(task)) {
2273 task->tk_action = call_bind;
2274 goto out_retry;
2275 }
2276 dprintk("RPC: %s: too small RPC reply size (%d bytes)\n",
2277 clnt->cl_program->name, task->tk_status);
2278 task->tk_action = call_timeout;
2279 goto out_retry;
2280 }
2281
2282 p = rpc_verify_header(task);
2283 if (IS_ERR(p)) {
2284 if (p == ERR_PTR(-EAGAIN))
2285 goto out_retry;
2286 return;
2287 }
2288
2289 task->tk_action = rpc_exit_task;
2290
2291 if (decode) {
2292 task->tk_status = rpcauth_unwrap_resp(task, decode, req, p,
2293 task->tk_msg.rpc_resp);
2294 }
2295 dprintk("RPC: %5u call_decode result %d\n", task->tk_pid,
2296 task->tk_status);
2297 return;
2298out_retry:
2299 task->tk_status = 0;
2300 /* Note: rpc_verify_header() may have freed the RPC slot */
2301 if (task->tk_rqstp == req) {
2302 req->rq_reply_bytes_recvd = req->rq_rcv_buf.len = 0;
2303 if (task->tk_client->cl_discrtry)
2304 xprt_conditional_disconnect(req->rq_xprt,
2305 req->rq_connect_cookie);
2306 }
2307}
2308
2309static __be32 *
2310rpc_encode_header(struct rpc_task *task)
2311{
2312 struct rpc_clnt *clnt = task->tk_client;
2313 struct rpc_rqst *req = task->tk_rqstp;
2314 __be32 *p = req->rq_svec[0].iov_base;
2315
2316 /* FIXME: check buffer size? */
2317
2318 p = xprt_skip_transport_header(req->rq_xprt, p);
2319 *p++ = req->rq_xid; /* XID */
2320 *p++ = htonl(RPC_CALL); /* CALL */
2321 *p++ = htonl(RPC_VERSION); /* RPC version */
2322 *p++ = htonl(clnt->cl_prog); /* program number */
2323 *p++ = htonl(clnt->cl_vers); /* program version */
2324 *p++ = htonl(task->tk_msg.rpc_proc->p_proc); /* procedure */
2325 p = rpcauth_marshcred(task, p);
2326 req->rq_slen = xdr_adjust_iovec(&req->rq_svec[0], p);
2327 return p;
2328}
2329
2330static __be32 *
2331rpc_verify_header(struct rpc_task *task)
2332{
2333 struct rpc_clnt *clnt = task->tk_client;
2334 struct kvec *iov = &task->tk_rqstp->rq_rcv_buf.head[0];
2335 int len = task->tk_rqstp->rq_rcv_buf.len >> 2;
2336 __be32 *p = iov->iov_base;
2337 u32 n;
2338 int error = -EACCES;
2339
2340 if ((task->tk_rqstp->rq_rcv_buf.len & 3) != 0) {
2341 /* RFC-1014 says that the representation of XDR data must be a
2342 * multiple of four bytes
2343 * - if it isn't pointer subtraction in the NFS client may give
2344 * undefined results
2345 */
2346 dprintk("RPC: %5u %s: XDR representation not a multiple of"
2347 " 4 bytes: 0x%x\n", task->tk_pid, __func__,
2348 task->tk_rqstp->rq_rcv_buf.len);
2349 error = -EIO;
2350 goto out_err;
2351 }
2352 if ((len -= 3) < 0)
2353 goto out_overflow;
2354
2355 p += 1; /* skip XID */
2356 if ((n = ntohl(*p++)) != RPC_REPLY) {
2357 dprintk("RPC: %5u %s: not an RPC reply: %x\n",
2358 task->tk_pid, __func__, n);
2359 error = -EIO;
2360 goto out_garbage;
2361 }
2362
2363 if ((n = ntohl(*p++)) != RPC_MSG_ACCEPTED) {
2364 if (--len < 0)
2365 goto out_overflow;
2366 switch ((n = ntohl(*p++))) {
2367 case RPC_AUTH_ERROR:
2368 break;
2369 case RPC_MISMATCH:
2370 dprintk("RPC: %5u %s: RPC call version mismatch!\n",
2371 task->tk_pid, __func__);
2372 error = -EPROTONOSUPPORT;
2373 goto out_err;
2374 default:
2375 dprintk("RPC: %5u %s: RPC call rejected, "
2376 "unknown error: %x\n",
2377 task->tk_pid, __func__, n);
2378 error = -EIO;
2379 goto out_err;
2380 }
2381 if (--len < 0)
2382 goto out_overflow;
2383 switch ((n = ntohl(*p++))) {
2384 case RPC_AUTH_REJECTEDCRED:
2385 case RPC_AUTH_REJECTEDVERF:
2386 case RPCSEC_GSS_CREDPROBLEM:
2387 case RPCSEC_GSS_CTXPROBLEM:
2388 if (!task->tk_cred_retry)
2389 break;
2390 task->tk_cred_retry--;
2391 dprintk("RPC: %5u %s: retry stale creds\n",
2392 task->tk_pid, __func__);
2393 rpcauth_invalcred(task);
2394 /* Ensure we obtain a new XID! */
2395 xprt_release(task);
2396 task->tk_action = call_reserve;
2397 goto out_retry;
2398 case RPC_AUTH_BADCRED:
2399 case RPC_AUTH_BADVERF:
2400 /* possibly garbled cred/verf? */
2401 if (!task->tk_garb_retry)
2402 break;
2403 task->tk_garb_retry--;
2404 dprintk("RPC: %5u %s: retry garbled creds\n",
2405 task->tk_pid, __func__);
2406 task->tk_action = call_bind;
2407 goto out_retry;
2408 case RPC_AUTH_TOOWEAK:
2409 printk(KERN_NOTICE "RPC: server %s requires stronger "
2410 "authentication.\n",
2411 task->tk_xprt->servername);
2412 break;
2413 default:
2414 dprintk("RPC: %5u %s: unknown auth error: %x\n",
2415 task->tk_pid, __func__, n);
2416 error = -EIO;
2417 }
2418 dprintk("RPC: %5u %s: call rejected %d\n",
2419 task->tk_pid, __func__, n);
2420 goto out_err;
2421 }
2422 p = rpcauth_checkverf(task, p);
2423 if (IS_ERR(p)) {
2424 error = PTR_ERR(p);
2425 dprintk("RPC: %5u %s: auth check failed with %d\n",
2426 task->tk_pid, __func__, error);
2427 goto out_garbage; /* bad verifier, retry */
2428 }
2429 len = p - (__be32 *)iov->iov_base - 1;
2430 if (len < 0)
2431 goto out_overflow;
2432 switch ((n = ntohl(*p++))) {
2433 case RPC_SUCCESS:
2434 return p;
2435 case RPC_PROG_UNAVAIL:
2436 dprintk("RPC: %5u %s: program %u is unsupported "
2437 "by server %s\n", task->tk_pid, __func__,
2438 (unsigned int)clnt->cl_prog,
2439 task->tk_xprt->servername);
2440 error = -EPFNOSUPPORT;
2441 goto out_err;
2442 case RPC_PROG_MISMATCH:
2443 dprintk("RPC: %5u %s: program %u, version %u unsupported "
2444 "by server %s\n", task->tk_pid, __func__,
2445 (unsigned int)clnt->cl_prog,
2446 (unsigned int)clnt->cl_vers,
2447 task->tk_xprt->servername);
2448 error = -EPROTONOSUPPORT;
2449 goto out_err;
2450 case RPC_PROC_UNAVAIL:
2451 dprintk("RPC: %5u %s: proc %s unsupported by program %u, "
2452 "version %u on server %s\n",
2453 task->tk_pid, __func__,
2454 rpc_proc_name(task),
2455 clnt->cl_prog, clnt->cl_vers,
2456 task->tk_xprt->servername);
2457 error = -EOPNOTSUPP;
2458 goto out_err;
2459 case RPC_GARBAGE_ARGS:
2460 dprintk("RPC: %5u %s: server saw garbage\n",
2461 task->tk_pid, __func__);
2462 break; /* retry */
2463 default:
2464 dprintk("RPC: %5u %s: server accept status: %x\n",
2465 task->tk_pid, __func__, n);
2466 /* Also retry */
2467 }
2468
2469out_garbage:
2470 clnt->cl_stats->rpcgarbage++;
2471 if (task->tk_garb_retry) {
2472 task->tk_garb_retry--;
2473 dprintk("RPC: %5u %s: retrying\n",
2474 task->tk_pid, __func__);
2475 task->tk_action = call_bind;
2476out_retry:
2477 return ERR_PTR(-EAGAIN);
2478 }
2479out_err:
2480 rpc_exit(task, error);
2481 dprintk("RPC: %5u %s: call failed with error %d\n", task->tk_pid,
2482 __func__, error);
2483 return ERR_PTR(error);
2484out_overflow:
2485 dprintk("RPC: %5u %s: server reply was truncated.\n", task->tk_pid,
2486 __func__);
2487 goto out_garbage;
2488}
2489
2490static void rpcproc_encode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2491 const void *obj)
2492{
2493}
2494
2495static int rpcproc_decode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2496 void *obj)
2497{
2498 return 0;
2499}
2500
2501static const struct rpc_procinfo rpcproc_null = {
2502 .p_encode = rpcproc_encode_null,
2503 .p_decode = rpcproc_decode_null,
2504};
2505
2506static int rpc_ping(struct rpc_clnt *clnt)
2507{
2508 struct rpc_message msg = {
2509 .rpc_proc = &rpcproc_null,
2510 };
2511 int err;
2512 msg.rpc_cred = authnull_ops.lookup_cred(NULL, NULL, 0);
2513 err = rpc_call_sync(clnt, &msg, RPC_TASK_SOFT | RPC_TASK_SOFTCONN);
2514 put_rpccred(msg.rpc_cred);
2515 return err;
2516}
2517
2518static
2519struct rpc_task *rpc_call_null_helper(struct rpc_clnt *clnt,
2520 struct rpc_xprt *xprt, struct rpc_cred *cred, int flags,
2521 const struct rpc_call_ops *ops, void *data)
2522{
2523 struct rpc_message msg = {
2524 .rpc_proc = &rpcproc_null,
2525 .rpc_cred = cred,
2526 };
2527 struct rpc_task_setup task_setup_data = {
2528 .rpc_client = clnt,
2529 .rpc_xprt = xprt,
2530 .rpc_message = &msg,
2531 .callback_ops = (ops != NULL) ? ops : &rpc_default_ops,
2532 .callback_data = data,
2533 .flags = flags,
2534 };
2535
2536 return rpc_run_task(&task_setup_data);
2537}
2538
2539struct rpc_task *rpc_call_null(struct rpc_clnt *clnt, struct rpc_cred *cred, int flags)
2540{
2541 return rpc_call_null_helper(clnt, NULL, cred, flags, NULL, NULL);
2542}
2543EXPORT_SYMBOL_GPL(rpc_call_null);
2544
2545struct rpc_cb_add_xprt_calldata {
2546 struct rpc_xprt_switch *xps;
2547 struct rpc_xprt *xprt;
2548};
2549
2550static void rpc_cb_add_xprt_done(struct rpc_task *task, void *calldata)
2551{
2552 struct rpc_cb_add_xprt_calldata *data = calldata;
2553
2554 if (task->tk_status == 0)
2555 rpc_xprt_switch_add_xprt(data->xps, data->xprt);
2556}
2557
2558static void rpc_cb_add_xprt_release(void *calldata)
2559{
2560 struct rpc_cb_add_xprt_calldata *data = calldata;
2561
2562 xprt_put(data->xprt);
2563 xprt_switch_put(data->xps);
2564 kfree(data);
2565}
2566
2567static const struct rpc_call_ops rpc_cb_add_xprt_call_ops = {
2568 .rpc_call_done = rpc_cb_add_xprt_done,
2569 .rpc_release = rpc_cb_add_xprt_release,
2570};
2571
2572/**
2573 * rpc_clnt_test_and_add_xprt - Test and add a new transport to a rpc_clnt
2574 * @clnt: pointer to struct rpc_clnt
2575 * @xps: pointer to struct rpc_xprt_switch,
2576 * @xprt: pointer struct rpc_xprt
2577 * @dummy: unused
2578 */
2579int rpc_clnt_test_and_add_xprt(struct rpc_clnt *clnt,
2580 struct rpc_xprt_switch *xps, struct rpc_xprt *xprt,
2581 void *dummy)
2582{
2583 struct rpc_cb_add_xprt_calldata *data;
2584 struct rpc_cred *cred;
2585 struct rpc_task *task;
2586
2587 data = kmalloc(sizeof(*data), GFP_NOFS);
2588 if (!data)
2589 return -ENOMEM;
2590 data->xps = xprt_switch_get(xps);
2591 data->xprt = xprt_get(xprt);
2592
2593 cred = authnull_ops.lookup_cred(NULL, NULL, 0);
2594 task = rpc_call_null_helper(clnt, xprt, cred,
2595 RPC_TASK_SOFT|RPC_TASK_SOFTCONN|RPC_TASK_ASYNC,
2596 &rpc_cb_add_xprt_call_ops, data);
2597 put_rpccred(cred);
2598 if (IS_ERR(task))
2599 return PTR_ERR(task);
2600 rpc_put_task(task);
2601 return 1;
2602}
2603EXPORT_SYMBOL_GPL(rpc_clnt_test_and_add_xprt);
2604
2605/**
2606 * rpc_clnt_setup_test_and_add_xprt()
2607 *
2608 * This is an rpc_clnt_add_xprt setup() function which returns 1 so:
2609 * 1) caller of the test function must dereference the rpc_xprt_switch
2610 * and the rpc_xprt.
2611 * 2) test function must call rpc_xprt_switch_add_xprt, usually in
2612 * the rpc_call_done routine.
2613 *
2614 * Upon success (return of 1), the test function adds the new
2615 * transport to the rpc_clnt xprt switch
2616 *
2617 * @clnt: struct rpc_clnt to get the new transport
2618 * @xps: the rpc_xprt_switch to hold the new transport
2619 * @xprt: the rpc_xprt to test
2620 * @data: a struct rpc_add_xprt_test pointer that holds the test function
2621 * and test function call data
2622 */
2623int rpc_clnt_setup_test_and_add_xprt(struct rpc_clnt *clnt,
2624 struct rpc_xprt_switch *xps,
2625 struct rpc_xprt *xprt,
2626 void *data)
2627{
2628 struct rpc_cred *cred;
2629 struct rpc_task *task;
2630 struct rpc_add_xprt_test *xtest = (struct rpc_add_xprt_test *)data;
2631 int status = -EADDRINUSE;
2632
2633 xprt = xprt_get(xprt);
2634 xprt_switch_get(xps);
2635
2636 if (rpc_xprt_switch_has_addr(xps, (struct sockaddr *)&xprt->addr))
2637 goto out_err;
2638
2639 /* Test the connection */
2640 cred = authnull_ops.lookup_cred(NULL, NULL, 0);
2641 task = rpc_call_null_helper(clnt, xprt, cred,
2642 RPC_TASK_SOFT | RPC_TASK_SOFTCONN,
2643 NULL, NULL);
2644 put_rpccred(cred);
2645 if (IS_ERR(task)) {
2646 status = PTR_ERR(task);
2647 goto out_err;
2648 }
2649 status = task->tk_status;
2650 rpc_put_task(task);
2651
2652 if (status < 0)
2653 goto out_err;
2654
2655 /* rpc_xprt_switch and rpc_xprt are deferrenced by add_xprt_test() */
2656 xtest->add_xprt_test(clnt, xprt, xtest->data);
2657
2658 /* so that rpc_clnt_add_xprt does not call rpc_xprt_switch_add_xprt */
2659 return 1;
2660out_err:
2661 xprt_put(xprt);
2662 xprt_switch_put(xps);
2663 pr_info("RPC: rpc_clnt_test_xprt failed: %d addr %s not added\n",
2664 status, xprt->address_strings[RPC_DISPLAY_ADDR]);
2665 return status;
2666}
2667EXPORT_SYMBOL_GPL(rpc_clnt_setup_test_and_add_xprt);
2668
2669/**
2670 * rpc_clnt_add_xprt - Add a new transport to a rpc_clnt
2671 * @clnt: pointer to struct rpc_clnt
2672 * @xprtargs: pointer to struct xprt_create
2673 * @setup: callback to test and/or set up the connection
2674 * @data: pointer to setup function data
2675 *
2676 * Creates a new transport using the parameters set in args and
2677 * adds it to clnt.
2678 * If ping is set, then test that connectivity succeeds before
2679 * adding the new transport.
2680 *
2681 */
2682int rpc_clnt_add_xprt(struct rpc_clnt *clnt,
2683 struct xprt_create *xprtargs,
2684 int (*setup)(struct rpc_clnt *,
2685 struct rpc_xprt_switch *,
2686 struct rpc_xprt *,
2687 void *),
2688 void *data)
2689{
2690 struct rpc_xprt_switch *xps;
2691 struct rpc_xprt *xprt;
2692 unsigned long connect_timeout;
2693 unsigned long reconnect_timeout;
2694 unsigned char resvport;
2695 int ret = 0;
2696
2697 rcu_read_lock();
2698 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
2699 xprt = xprt_iter_xprt(&clnt->cl_xpi);
2700 if (xps == NULL || xprt == NULL) {
2701 rcu_read_unlock();
2702 return -EAGAIN;
2703 }
2704 resvport = xprt->resvport;
2705 connect_timeout = xprt->connect_timeout;
2706 reconnect_timeout = xprt->max_reconnect_timeout;
2707 rcu_read_unlock();
2708
2709 xprt = xprt_create_transport(xprtargs);
2710 if (IS_ERR(xprt)) {
2711 ret = PTR_ERR(xprt);
2712 goto out_put_switch;
2713 }
2714 xprt->resvport = resvport;
2715 if (xprt->ops->set_connect_timeout != NULL)
2716 xprt->ops->set_connect_timeout(xprt,
2717 connect_timeout,
2718 reconnect_timeout);
2719
2720 rpc_xprt_switch_set_roundrobin(xps);
2721 if (setup) {
2722 ret = setup(clnt, xps, xprt, data);
2723 if (ret != 0)
2724 goto out_put_xprt;
2725 }
2726 rpc_xprt_switch_add_xprt(xps, xprt);
2727out_put_xprt:
2728 xprt_put(xprt);
2729out_put_switch:
2730 xprt_switch_put(xps);
2731 return ret;
2732}
2733EXPORT_SYMBOL_GPL(rpc_clnt_add_xprt);
2734
2735struct connect_timeout_data {
2736 unsigned long connect_timeout;
2737 unsigned long reconnect_timeout;
2738};
2739
2740static int
2741rpc_xprt_set_connect_timeout(struct rpc_clnt *clnt,
2742 struct rpc_xprt *xprt,
2743 void *data)
2744{
2745 struct connect_timeout_data *timeo = data;
2746
2747 if (xprt->ops->set_connect_timeout)
2748 xprt->ops->set_connect_timeout(xprt,
2749 timeo->connect_timeout,
2750 timeo->reconnect_timeout);
2751 return 0;
2752}
2753
2754void
2755rpc_set_connect_timeout(struct rpc_clnt *clnt,
2756 unsigned long connect_timeout,
2757 unsigned long reconnect_timeout)
2758{
2759 struct connect_timeout_data timeout = {
2760 .connect_timeout = connect_timeout,
2761 .reconnect_timeout = reconnect_timeout,
2762 };
2763 rpc_clnt_iterate_for_each_xprt(clnt,
2764 rpc_xprt_set_connect_timeout,
2765 &timeout);
2766}
2767EXPORT_SYMBOL_GPL(rpc_set_connect_timeout);
2768
2769void rpc_clnt_xprt_switch_put(struct rpc_clnt *clnt)
2770{
2771 rcu_read_lock();
2772 xprt_switch_put(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
2773 rcu_read_unlock();
2774}
2775EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_put);
2776
2777void rpc_clnt_xprt_switch_add_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
2778{
2779 rcu_read_lock();
2780 rpc_xprt_switch_add_xprt(rcu_dereference(clnt->cl_xpi.xpi_xpswitch),
2781 xprt);
2782 rcu_read_unlock();
2783}
2784EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_add_xprt);
2785
2786bool rpc_clnt_xprt_switch_has_addr(struct rpc_clnt *clnt,
2787 const struct sockaddr *sap)
2788{
2789 struct rpc_xprt_switch *xps;
2790 bool ret;
2791
2792 rcu_read_lock();
2793 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
2794 ret = rpc_xprt_switch_has_addr(xps, sap);
2795 rcu_read_unlock();
2796 return ret;
2797}
2798EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_has_addr);
2799
2800#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
2801static void rpc_show_header(void)
2802{
2803 printk(KERN_INFO "-pid- flgs status -client- --rqstp- "
2804 "-timeout ---ops--\n");
2805}
2806
2807static void rpc_show_task(const struct rpc_clnt *clnt,
2808 const struct rpc_task *task)
2809{
2810 const char *rpc_waitq = "none";
2811
2812 if (RPC_IS_QUEUED(task))
2813 rpc_waitq = rpc_qname(task->tk_waitqueue);
2814
2815 printk(KERN_INFO "%5u %04x %6d %8p %8p %8ld %8p %sv%u %s a:%ps q:%s\n",
2816 task->tk_pid, task->tk_flags, task->tk_status,
2817 clnt, task->tk_rqstp, task->tk_timeout, task->tk_ops,
2818 clnt->cl_program->name, clnt->cl_vers, rpc_proc_name(task),
2819 task->tk_action, rpc_waitq);
2820}
2821
2822void rpc_show_tasks(struct net *net)
2823{
2824 struct rpc_clnt *clnt;
2825 struct rpc_task *task;
2826 int header = 0;
2827 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
2828
2829 spin_lock(&sn->rpc_client_lock);
2830 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
2831 spin_lock(&clnt->cl_lock);
2832 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
2833 if (!header) {
2834 rpc_show_header();
2835 header++;
2836 }
2837 rpc_show_task(clnt, task);
2838 }
2839 spin_unlock(&clnt->cl_lock);
2840 }
2841 spin_unlock(&sn->rpc_client_lock);
2842}
2843#endif
2844
2845#if IS_ENABLED(CONFIG_SUNRPC_SWAP)
2846static int
2847rpc_clnt_swap_activate_callback(struct rpc_clnt *clnt,
2848 struct rpc_xprt *xprt,
2849 void *dummy)
2850{
2851 return xprt_enable_swap(xprt);
2852}
2853
2854int
2855rpc_clnt_swap_activate(struct rpc_clnt *clnt)
2856{
2857 if (atomic_inc_return(&clnt->cl_swapper) == 1)
2858 return rpc_clnt_iterate_for_each_xprt(clnt,
2859 rpc_clnt_swap_activate_callback, NULL);
2860 return 0;
2861}
2862EXPORT_SYMBOL_GPL(rpc_clnt_swap_activate);
2863
2864static int
2865rpc_clnt_swap_deactivate_callback(struct rpc_clnt *clnt,
2866 struct rpc_xprt *xprt,
2867 void *dummy)
2868{
2869 xprt_disable_swap(xprt);
2870 return 0;
2871}
2872
2873void
2874rpc_clnt_swap_deactivate(struct rpc_clnt *clnt)
2875{
2876 if (atomic_dec_if_positive(&clnt->cl_swapper) == 0)
2877 rpc_clnt_iterate_for_each_xprt(clnt,
2878 rpc_clnt_swap_deactivate_callback, NULL);
2879}
2880EXPORT_SYMBOL_GPL(rpc_clnt_swap_deactivate);
2881#endif /* CONFIG_SUNRPC_SWAP */
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * linux/net/sunrpc/clnt.c
4 *
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.
8 *
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.
16 *
17 * Copyright (C) 1992,1993 Rick Sladkey <jrs@world.std.com>
18 * Copyright (C) 1995,1996 Olaf Kirch <okir@monad.swb.de>
19 */
20
21
22#include <linux/module.h>
23#include <linux/types.h>
24#include <linux/kallsyms.h>
25#include <linux/mm.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>
32#include <linux/in.h>
33#include <linux/in6.h>
34#include <linux/un.h>
35
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>
42
43#include "sunrpc.h"
44#include "sysfs.h"
45#include "netns.h"
46
47#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
48# define RPCDBG_FACILITY RPCDBG_CALL
49#endif
50
51static DECLARE_WAIT_QUEUE_HEAD(destroy_wait);
52
53static void call_start(struct rpc_task *task);
54static void call_reserve(struct rpc_task *task);
55static void call_reserveresult(struct rpc_task *task);
56static void call_allocate(struct rpc_task *task);
57static void call_encode(struct rpc_task *task);
58static void call_decode(struct rpc_task *task);
59static void call_bind(struct rpc_task *task);
60static void call_bind_status(struct rpc_task *task);
61static void call_transmit(struct rpc_task *task);
62static void call_status(struct rpc_task *task);
63static void call_transmit_status(struct rpc_task *task);
64static void call_refresh(struct rpc_task *task);
65static void call_refreshresult(struct rpc_task *task);
66static void call_connect(struct rpc_task *task);
67static void call_connect_status(struct rpc_task *task);
68
69static int rpc_encode_header(struct rpc_task *task,
70 struct xdr_stream *xdr);
71static int rpc_decode_header(struct rpc_task *task,
72 struct xdr_stream *xdr);
73static int rpc_ping(struct rpc_clnt *clnt);
74static int rpc_ping_noreply(struct rpc_clnt *clnt);
75static void rpc_check_timeout(struct rpc_task *task);
76
77static void rpc_register_client(struct rpc_clnt *clnt)
78{
79 struct net *net = rpc_net_ns(clnt);
80 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
81
82 spin_lock(&sn->rpc_client_lock);
83 list_add(&clnt->cl_clients, &sn->all_clients);
84 spin_unlock(&sn->rpc_client_lock);
85}
86
87static void rpc_unregister_client(struct rpc_clnt *clnt)
88{
89 struct net *net = rpc_net_ns(clnt);
90 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
91
92 spin_lock(&sn->rpc_client_lock);
93 list_del(&clnt->cl_clients);
94 spin_unlock(&sn->rpc_client_lock);
95}
96
97static void __rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
98{
99 rpc_remove_client_dir(clnt);
100}
101
102static void rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
103{
104 struct net *net = rpc_net_ns(clnt);
105 struct super_block *pipefs_sb;
106
107 pipefs_sb = rpc_get_sb_net(net);
108 if (pipefs_sb) {
109 if (pipefs_sb == clnt->pipefs_sb)
110 __rpc_clnt_remove_pipedir(clnt);
111 rpc_put_sb_net(net);
112 }
113}
114
115static struct dentry *rpc_setup_pipedir_sb(struct super_block *sb,
116 struct rpc_clnt *clnt)
117{
118 static uint32_t clntid;
119 const char *dir_name = clnt->cl_program->pipe_dir_name;
120 char name[15];
121 struct dentry *dir, *dentry;
122
123 dir = rpc_d_lookup_sb(sb, dir_name);
124 if (dir == NULL) {
125 pr_info("RPC: pipefs directory doesn't exist: %s\n", dir_name);
126 return dir;
127 }
128 for (;;) {
129 snprintf(name, sizeof(name), "clnt%x", (unsigned int)clntid++);
130 name[sizeof(name) - 1] = '\0';
131 dentry = rpc_create_client_dir(dir, name, clnt);
132 if (!IS_ERR(dentry))
133 break;
134 if (dentry == ERR_PTR(-EEXIST))
135 continue;
136 printk(KERN_INFO "RPC: Couldn't create pipefs entry"
137 " %s/%s, error %ld\n",
138 dir_name, name, PTR_ERR(dentry));
139 break;
140 }
141 dput(dir);
142 return dentry;
143}
144
145static int
146rpc_setup_pipedir(struct super_block *pipefs_sb, struct rpc_clnt *clnt)
147{
148 struct dentry *dentry;
149
150 clnt->pipefs_sb = pipefs_sb;
151
152 if (clnt->cl_program->pipe_dir_name != NULL) {
153 dentry = rpc_setup_pipedir_sb(pipefs_sb, clnt);
154 if (IS_ERR(dentry))
155 return PTR_ERR(dentry);
156 }
157 return 0;
158}
159
160static int rpc_clnt_skip_event(struct rpc_clnt *clnt, unsigned long event)
161{
162 if (clnt->cl_program->pipe_dir_name == NULL)
163 return 1;
164
165 switch (event) {
166 case RPC_PIPEFS_MOUNT:
167 if (clnt->cl_pipedir_objects.pdh_dentry != NULL)
168 return 1;
169 if (refcount_read(&clnt->cl_count) == 0)
170 return 1;
171 break;
172 case RPC_PIPEFS_UMOUNT:
173 if (clnt->cl_pipedir_objects.pdh_dentry == NULL)
174 return 1;
175 break;
176 }
177 return 0;
178}
179
180static int __rpc_clnt_handle_event(struct rpc_clnt *clnt, unsigned long event,
181 struct super_block *sb)
182{
183 struct dentry *dentry;
184
185 switch (event) {
186 case RPC_PIPEFS_MOUNT:
187 dentry = rpc_setup_pipedir_sb(sb, clnt);
188 if (!dentry)
189 return -ENOENT;
190 if (IS_ERR(dentry))
191 return PTR_ERR(dentry);
192 break;
193 case RPC_PIPEFS_UMOUNT:
194 __rpc_clnt_remove_pipedir(clnt);
195 break;
196 default:
197 printk(KERN_ERR "%s: unknown event: %ld\n", __func__, event);
198 return -ENOTSUPP;
199 }
200 return 0;
201}
202
203static int __rpc_pipefs_event(struct rpc_clnt *clnt, unsigned long event,
204 struct super_block *sb)
205{
206 int error = 0;
207
208 for (;; clnt = clnt->cl_parent) {
209 if (!rpc_clnt_skip_event(clnt, event))
210 error = __rpc_clnt_handle_event(clnt, event, sb);
211 if (error || clnt == clnt->cl_parent)
212 break;
213 }
214 return error;
215}
216
217static struct rpc_clnt *rpc_get_client_for_event(struct net *net, int event)
218{
219 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
220 struct rpc_clnt *clnt;
221
222 spin_lock(&sn->rpc_client_lock);
223 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
224 if (rpc_clnt_skip_event(clnt, event))
225 continue;
226 spin_unlock(&sn->rpc_client_lock);
227 return clnt;
228 }
229 spin_unlock(&sn->rpc_client_lock);
230 return NULL;
231}
232
233static int rpc_pipefs_event(struct notifier_block *nb, unsigned long event,
234 void *ptr)
235{
236 struct super_block *sb = ptr;
237 struct rpc_clnt *clnt;
238 int error = 0;
239
240 while ((clnt = rpc_get_client_for_event(sb->s_fs_info, event))) {
241 error = __rpc_pipefs_event(clnt, event, sb);
242 if (error)
243 break;
244 }
245 return error;
246}
247
248static struct notifier_block rpc_clients_block = {
249 .notifier_call = rpc_pipefs_event,
250 .priority = SUNRPC_PIPEFS_RPC_PRIO,
251};
252
253int rpc_clients_notifier_register(void)
254{
255 return rpc_pipefs_notifier_register(&rpc_clients_block);
256}
257
258void rpc_clients_notifier_unregister(void)
259{
260 return rpc_pipefs_notifier_unregister(&rpc_clients_block);
261}
262
263static struct rpc_xprt *rpc_clnt_set_transport(struct rpc_clnt *clnt,
264 struct rpc_xprt *xprt,
265 const struct rpc_timeout *timeout)
266{
267 struct rpc_xprt *old;
268
269 spin_lock(&clnt->cl_lock);
270 old = rcu_dereference_protected(clnt->cl_xprt,
271 lockdep_is_held(&clnt->cl_lock));
272
273 if (!xprt_bound(xprt))
274 clnt->cl_autobind = 1;
275
276 clnt->cl_timeout = timeout;
277 rcu_assign_pointer(clnt->cl_xprt, xprt);
278 spin_unlock(&clnt->cl_lock);
279
280 return old;
281}
282
283static void rpc_clnt_set_nodename(struct rpc_clnt *clnt, const char *nodename)
284{
285 ssize_t copied;
286
287 copied = strscpy(clnt->cl_nodename,
288 nodename, sizeof(clnt->cl_nodename));
289
290 clnt->cl_nodelen = copied < 0
291 ? sizeof(clnt->cl_nodename) - 1
292 : copied;
293}
294
295static int rpc_client_register(struct rpc_clnt *clnt,
296 rpc_authflavor_t pseudoflavor,
297 const char *client_name)
298{
299 struct rpc_auth_create_args auth_args = {
300 .pseudoflavor = pseudoflavor,
301 .target_name = client_name,
302 };
303 struct rpc_auth *auth;
304 struct net *net = rpc_net_ns(clnt);
305 struct super_block *pipefs_sb;
306 int err;
307
308 rpc_clnt_debugfs_register(clnt);
309
310 pipefs_sb = rpc_get_sb_net(net);
311 if (pipefs_sb) {
312 err = rpc_setup_pipedir(pipefs_sb, clnt);
313 if (err)
314 goto out;
315 }
316
317 rpc_register_client(clnt);
318 if (pipefs_sb)
319 rpc_put_sb_net(net);
320
321 auth = rpcauth_create(&auth_args, clnt);
322 if (IS_ERR(auth)) {
323 dprintk("RPC: Couldn't create auth handle (flavor %u)\n",
324 pseudoflavor);
325 err = PTR_ERR(auth);
326 goto err_auth;
327 }
328 return 0;
329err_auth:
330 pipefs_sb = rpc_get_sb_net(net);
331 rpc_unregister_client(clnt);
332 __rpc_clnt_remove_pipedir(clnt);
333out:
334 if (pipefs_sb)
335 rpc_put_sb_net(net);
336 rpc_sysfs_client_destroy(clnt);
337 rpc_clnt_debugfs_unregister(clnt);
338 return err;
339}
340
341static DEFINE_IDA(rpc_clids);
342
343void rpc_cleanup_clids(void)
344{
345 ida_destroy(&rpc_clids);
346}
347
348static int rpc_alloc_clid(struct rpc_clnt *clnt)
349{
350 int clid;
351
352 clid = ida_alloc(&rpc_clids, GFP_KERNEL);
353 if (clid < 0)
354 return clid;
355 clnt->cl_clid = clid;
356 return 0;
357}
358
359static void rpc_free_clid(struct rpc_clnt *clnt)
360{
361 ida_free(&rpc_clids, clnt->cl_clid);
362}
363
364static struct rpc_clnt * rpc_new_client(const struct rpc_create_args *args,
365 struct rpc_xprt_switch *xps,
366 struct rpc_xprt *xprt,
367 struct rpc_clnt *parent)
368{
369 const struct rpc_program *program = args->program;
370 const struct rpc_version *version;
371 struct rpc_clnt *clnt = NULL;
372 const struct rpc_timeout *timeout;
373 const char *nodename = args->nodename;
374 int err;
375
376 err = rpciod_up();
377 if (err)
378 goto out_no_rpciod;
379
380 err = -EINVAL;
381 if (args->version >= program->nrvers)
382 goto out_err;
383 version = program->version[args->version];
384 if (version == NULL)
385 goto out_err;
386
387 err = -ENOMEM;
388 clnt = kzalloc(sizeof(*clnt), GFP_KERNEL);
389 if (!clnt)
390 goto out_err;
391 clnt->cl_parent = parent ? : clnt;
392 clnt->cl_xprtsec = args->xprtsec;
393
394 err = rpc_alloc_clid(clnt);
395 if (err)
396 goto out_no_clid;
397
398 clnt->cl_cred = get_cred(args->cred);
399 clnt->cl_procinfo = version->procs;
400 clnt->cl_maxproc = version->nrprocs;
401 clnt->cl_prog = args->prognumber ? : program->number;
402 clnt->cl_vers = version->number;
403 clnt->cl_stats = args->stats ? : program->stats;
404 clnt->cl_metrics = rpc_alloc_iostats(clnt);
405 rpc_init_pipe_dir_head(&clnt->cl_pipedir_objects);
406 err = -ENOMEM;
407 if (clnt->cl_metrics == NULL)
408 goto out_no_stats;
409 clnt->cl_program = program;
410 INIT_LIST_HEAD(&clnt->cl_tasks);
411 spin_lock_init(&clnt->cl_lock);
412
413 timeout = xprt->timeout;
414 if (args->timeout != NULL) {
415 memcpy(&clnt->cl_timeout_default, args->timeout,
416 sizeof(clnt->cl_timeout_default));
417 timeout = &clnt->cl_timeout_default;
418 }
419
420 rpc_clnt_set_transport(clnt, xprt, timeout);
421 xprt->main = true;
422 xprt_iter_init(&clnt->cl_xpi, xps);
423 xprt_switch_put(xps);
424
425 clnt->cl_rtt = &clnt->cl_rtt_default;
426 rpc_init_rtt(&clnt->cl_rtt_default, clnt->cl_timeout->to_initval);
427
428 refcount_set(&clnt->cl_count, 1);
429
430 if (nodename == NULL)
431 nodename = utsname()->nodename;
432 /* save the nodename */
433 rpc_clnt_set_nodename(clnt, nodename);
434
435 rpc_sysfs_client_setup(clnt, xps, rpc_net_ns(clnt));
436 err = rpc_client_register(clnt, args->authflavor, args->client_name);
437 if (err)
438 goto out_no_path;
439 if (parent)
440 refcount_inc(&parent->cl_count);
441
442 trace_rpc_clnt_new(clnt, xprt, args);
443 return clnt;
444
445out_no_path:
446 rpc_free_iostats(clnt->cl_metrics);
447out_no_stats:
448 put_cred(clnt->cl_cred);
449 rpc_free_clid(clnt);
450out_no_clid:
451 kfree(clnt);
452out_err:
453 rpciod_down();
454out_no_rpciod:
455 xprt_switch_put(xps);
456 xprt_put(xprt);
457 trace_rpc_clnt_new_err(program->name, args->servername, err);
458 return ERR_PTR(err);
459}
460
461static struct rpc_clnt *rpc_create_xprt(struct rpc_create_args *args,
462 struct rpc_xprt *xprt)
463{
464 struct rpc_clnt *clnt = NULL;
465 struct rpc_xprt_switch *xps;
466
467 if (args->bc_xprt && args->bc_xprt->xpt_bc_xps) {
468 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
469 xps = args->bc_xprt->xpt_bc_xps;
470 xprt_switch_get(xps);
471 } else {
472 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
473 if (xps == NULL) {
474 xprt_put(xprt);
475 return ERR_PTR(-ENOMEM);
476 }
477 if (xprt->bc_xprt) {
478 xprt_switch_get(xps);
479 xprt->bc_xprt->xpt_bc_xps = xps;
480 }
481 }
482 clnt = rpc_new_client(args, xps, xprt, NULL);
483 if (IS_ERR(clnt))
484 return clnt;
485
486 if (!(args->flags & RPC_CLNT_CREATE_NOPING)) {
487 int err = rpc_ping(clnt);
488 if (err != 0) {
489 rpc_shutdown_client(clnt);
490 return ERR_PTR(err);
491 }
492 } else if (args->flags & RPC_CLNT_CREATE_CONNECTED) {
493 int err = rpc_ping_noreply(clnt);
494 if (err != 0) {
495 rpc_shutdown_client(clnt);
496 return ERR_PTR(err);
497 }
498 }
499
500 clnt->cl_softrtry = 1;
501 if (args->flags & (RPC_CLNT_CREATE_HARDRTRY|RPC_CLNT_CREATE_SOFTERR)) {
502 clnt->cl_softrtry = 0;
503 if (args->flags & RPC_CLNT_CREATE_SOFTERR)
504 clnt->cl_softerr = 1;
505 }
506
507 if (args->flags & RPC_CLNT_CREATE_AUTOBIND)
508 clnt->cl_autobind = 1;
509 if (args->flags & RPC_CLNT_CREATE_NO_RETRANS_TIMEOUT)
510 clnt->cl_noretranstimeo = 1;
511 if (args->flags & RPC_CLNT_CREATE_DISCRTRY)
512 clnt->cl_discrtry = 1;
513 if (!(args->flags & RPC_CLNT_CREATE_QUIET))
514 clnt->cl_chatty = 1;
515
516 return clnt;
517}
518
519/**
520 * rpc_create - create an RPC client and transport with one call
521 * @args: rpc_clnt create argument structure
522 *
523 * Creates and initializes an RPC transport and an RPC client.
524 *
525 * It can ping the server in order to determine if it is up, and to see if
526 * it supports this program and version. RPC_CLNT_CREATE_NOPING disables
527 * this behavior so asynchronous tasks can also use rpc_create.
528 */
529struct rpc_clnt *rpc_create(struct rpc_create_args *args)
530{
531 struct rpc_xprt *xprt;
532 struct xprt_create xprtargs = {
533 .net = args->net,
534 .ident = args->protocol,
535 .srcaddr = args->saddress,
536 .dstaddr = args->address,
537 .addrlen = args->addrsize,
538 .servername = args->servername,
539 .bc_xprt = args->bc_xprt,
540 .xprtsec = args->xprtsec,
541 .connect_timeout = args->connect_timeout,
542 .reconnect_timeout = args->reconnect_timeout,
543 };
544 char servername[RPC_MAXNETNAMELEN];
545 struct rpc_clnt *clnt;
546 int i;
547
548 if (args->bc_xprt) {
549 WARN_ON_ONCE(!(args->protocol & XPRT_TRANSPORT_BC));
550 xprt = args->bc_xprt->xpt_bc_xprt;
551 if (xprt) {
552 xprt_get(xprt);
553 return rpc_create_xprt(args, xprt);
554 }
555 }
556
557 if (args->flags & RPC_CLNT_CREATE_INFINITE_SLOTS)
558 xprtargs.flags |= XPRT_CREATE_INFINITE_SLOTS;
559 if (args->flags & RPC_CLNT_CREATE_NO_IDLE_TIMEOUT)
560 xprtargs.flags |= XPRT_CREATE_NO_IDLE_TIMEOUT;
561 /*
562 * If the caller chooses not to specify a hostname, whip
563 * up a string representation of the passed-in address.
564 */
565 if (xprtargs.servername == NULL) {
566 struct sockaddr_un *sun =
567 (struct sockaddr_un *)args->address;
568 struct sockaddr_in *sin =
569 (struct sockaddr_in *)args->address;
570 struct sockaddr_in6 *sin6 =
571 (struct sockaddr_in6 *)args->address;
572
573 servername[0] = '\0';
574 switch (args->address->sa_family) {
575 case AF_LOCAL:
576 if (sun->sun_path[0])
577 snprintf(servername, sizeof(servername), "%s",
578 sun->sun_path);
579 else
580 snprintf(servername, sizeof(servername), "@%s",
581 sun->sun_path+1);
582 break;
583 case AF_INET:
584 snprintf(servername, sizeof(servername), "%pI4",
585 &sin->sin_addr.s_addr);
586 break;
587 case AF_INET6:
588 snprintf(servername, sizeof(servername), "%pI6",
589 &sin6->sin6_addr);
590 break;
591 default:
592 /* caller wants default server name, but
593 * address family isn't recognized. */
594 return ERR_PTR(-EINVAL);
595 }
596 xprtargs.servername = servername;
597 }
598
599 xprt = xprt_create_transport(&xprtargs);
600 if (IS_ERR(xprt))
601 return (struct rpc_clnt *)xprt;
602
603 /*
604 * By default, kernel RPC client connects from a reserved port.
605 * CAP_NET_BIND_SERVICE will not be set for unprivileged requesters,
606 * but it is always enabled for rpciod, which handles the connect
607 * operation.
608 */
609 xprt->resvport = 1;
610 if (args->flags & RPC_CLNT_CREATE_NONPRIVPORT)
611 xprt->resvport = 0;
612 xprt->reuseport = 0;
613 if (args->flags & RPC_CLNT_CREATE_REUSEPORT)
614 xprt->reuseport = 1;
615
616 clnt = rpc_create_xprt(args, xprt);
617 if (IS_ERR(clnt) || args->nconnect <= 1)
618 return clnt;
619
620 for (i = 0; i < args->nconnect - 1; i++) {
621 if (rpc_clnt_add_xprt(clnt, &xprtargs, NULL, NULL) < 0)
622 break;
623 }
624 return clnt;
625}
626EXPORT_SYMBOL_GPL(rpc_create);
627
628/*
629 * This function clones the RPC client structure. It allows us to share the
630 * same transport while varying parameters such as the authentication
631 * flavour.
632 */
633static struct rpc_clnt *__rpc_clone_client(struct rpc_create_args *args,
634 struct rpc_clnt *clnt)
635{
636 struct rpc_xprt_switch *xps;
637 struct rpc_xprt *xprt;
638 struct rpc_clnt *new;
639 int err;
640
641 err = -ENOMEM;
642 rcu_read_lock();
643 xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
644 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
645 rcu_read_unlock();
646 if (xprt == NULL || xps == NULL) {
647 xprt_put(xprt);
648 xprt_switch_put(xps);
649 goto out_err;
650 }
651 args->servername = xprt->servername;
652 args->nodename = clnt->cl_nodename;
653
654 new = rpc_new_client(args, xps, xprt, clnt);
655 if (IS_ERR(new))
656 return new;
657
658 /* Turn off autobind on clones */
659 new->cl_autobind = 0;
660 new->cl_softrtry = clnt->cl_softrtry;
661 new->cl_softerr = clnt->cl_softerr;
662 new->cl_noretranstimeo = clnt->cl_noretranstimeo;
663 new->cl_discrtry = clnt->cl_discrtry;
664 new->cl_chatty = clnt->cl_chatty;
665 new->cl_principal = clnt->cl_principal;
666 new->cl_max_connect = clnt->cl_max_connect;
667 return new;
668
669out_err:
670 trace_rpc_clnt_clone_err(clnt, err);
671 return ERR_PTR(err);
672}
673
674/**
675 * rpc_clone_client - Clone an RPC client structure
676 *
677 * @clnt: RPC client whose parameters are copied
678 *
679 * Returns a fresh RPC client or an ERR_PTR.
680 */
681struct rpc_clnt *rpc_clone_client(struct rpc_clnt *clnt)
682{
683 struct rpc_create_args args = {
684 .program = clnt->cl_program,
685 .prognumber = clnt->cl_prog,
686 .version = clnt->cl_vers,
687 .authflavor = clnt->cl_auth->au_flavor,
688 .cred = clnt->cl_cred,
689 .stats = clnt->cl_stats,
690 };
691 return __rpc_clone_client(&args, clnt);
692}
693EXPORT_SYMBOL_GPL(rpc_clone_client);
694
695/**
696 * rpc_clone_client_set_auth - Clone an RPC client structure and set its auth
697 *
698 * @clnt: RPC client whose parameters are copied
699 * @flavor: security flavor for new client
700 *
701 * Returns a fresh RPC client or an ERR_PTR.
702 */
703struct rpc_clnt *
704rpc_clone_client_set_auth(struct rpc_clnt *clnt, rpc_authflavor_t flavor)
705{
706 struct rpc_create_args args = {
707 .program = clnt->cl_program,
708 .prognumber = clnt->cl_prog,
709 .version = clnt->cl_vers,
710 .authflavor = flavor,
711 .cred = clnt->cl_cred,
712 .stats = clnt->cl_stats,
713 };
714 return __rpc_clone_client(&args, clnt);
715}
716EXPORT_SYMBOL_GPL(rpc_clone_client_set_auth);
717
718/**
719 * rpc_switch_client_transport: switch the RPC transport on the fly
720 * @clnt: pointer to a struct rpc_clnt
721 * @args: pointer to the new transport arguments
722 * @timeout: pointer to the new timeout parameters
723 *
724 * This function allows the caller to switch the RPC transport for the
725 * rpc_clnt structure 'clnt' to allow it to connect to a mirrored NFS
726 * server, for instance. It assumes that the caller has ensured that
727 * there are no active RPC tasks by using some form of locking.
728 *
729 * Returns zero if "clnt" is now using the new xprt. Otherwise a
730 * negative errno is returned, and "clnt" continues to use the old
731 * xprt.
732 */
733int rpc_switch_client_transport(struct rpc_clnt *clnt,
734 struct xprt_create *args,
735 const struct rpc_timeout *timeout)
736{
737 const struct rpc_timeout *old_timeo;
738 rpc_authflavor_t pseudoflavor;
739 struct rpc_xprt_switch *xps, *oldxps;
740 struct rpc_xprt *xprt, *old;
741 struct rpc_clnt *parent;
742 int err;
743
744 args->xprtsec = clnt->cl_xprtsec;
745 xprt = xprt_create_transport(args);
746 if (IS_ERR(xprt))
747 return PTR_ERR(xprt);
748
749 xps = xprt_switch_alloc(xprt, GFP_KERNEL);
750 if (xps == NULL) {
751 xprt_put(xprt);
752 return -ENOMEM;
753 }
754
755 pseudoflavor = clnt->cl_auth->au_flavor;
756
757 old_timeo = clnt->cl_timeout;
758 old = rpc_clnt_set_transport(clnt, xprt, timeout);
759 oldxps = xprt_iter_xchg_switch(&clnt->cl_xpi, xps);
760
761 rpc_unregister_client(clnt);
762 __rpc_clnt_remove_pipedir(clnt);
763 rpc_sysfs_client_destroy(clnt);
764 rpc_clnt_debugfs_unregister(clnt);
765
766 /*
767 * A new transport was created. "clnt" therefore
768 * becomes the root of a new cl_parent tree. clnt's
769 * children, if it has any, still point to the old xprt.
770 */
771 parent = clnt->cl_parent;
772 clnt->cl_parent = clnt;
773
774 /*
775 * The old rpc_auth cache cannot be re-used. GSS
776 * contexts in particular are between a single
777 * client and server.
778 */
779 err = rpc_client_register(clnt, pseudoflavor, NULL);
780 if (err)
781 goto out_revert;
782
783 synchronize_rcu();
784 if (parent != clnt)
785 rpc_release_client(parent);
786 xprt_switch_put(oldxps);
787 xprt_put(old);
788 trace_rpc_clnt_replace_xprt(clnt);
789 return 0;
790
791out_revert:
792 xps = xprt_iter_xchg_switch(&clnt->cl_xpi, oldxps);
793 rpc_clnt_set_transport(clnt, old, old_timeo);
794 clnt->cl_parent = parent;
795 rpc_client_register(clnt, pseudoflavor, NULL);
796 xprt_switch_put(xps);
797 xprt_put(xprt);
798 trace_rpc_clnt_replace_xprt_err(clnt);
799 return err;
800}
801EXPORT_SYMBOL_GPL(rpc_switch_client_transport);
802
803static struct rpc_xprt_switch *rpc_clnt_xprt_switch_get(struct rpc_clnt *clnt)
804{
805 struct rpc_xprt_switch *xps;
806
807 rcu_read_lock();
808 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
809 rcu_read_unlock();
810
811 return xps;
812}
813
814static
815int _rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi,
816 void func(struct rpc_xprt_iter *xpi, struct rpc_xprt_switch *xps))
817{
818 struct rpc_xprt_switch *xps;
819
820 xps = rpc_clnt_xprt_switch_get(clnt);
821 if (xps == NULL)
822 return -EAGAIN;
823 func(xpi, xps);
824 xprt_switch_put(xps);
825 return 0;
826}
827
828static
829int rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi)
830{
831 return _rpc_clnt_xprt_iter_init(clnt, xpi, xprt_iter_init_listall);
832}
833
834static
835int rpc_clnt_xprt_iter_offline_init(struct rpc_clnt *clnt,
836 struct rpc_xprt_iter *xpi)
837{
838 return _rpc_clnt_xprt_iter_init(clnt, xpi, xprt_iter_init_listoffline);
839}
840
841/**
842 * rpc_clnt_iterate_for_each_xprt - Apply a function to all transports
843 * @clnt: pointer to client
844 * @fn: function to apply
845 * @data: void pointer to function data
846 *
847 * Iterates through the list of RPC transports currently attached to the
848 * client and applies the function fn(clnt, xprt, data).
849 *
850 * On error, the iteration stops, and the function returns the error value.
851 */
852int rpc_clnt_iterate_for_each_xprt(struct rpc_clnt *clnt,
853 int (*fn)(struct rpc_clnt *, struct rpc_xprt *, void *),
854 void *data)
855{
856 struct rpc_xprt_iter xpi;
857 int ret;
858
859 ret = rpc_clnt_xprt_iter_init(clnt, &xpi);
860 if (ret)
861 return ret;
862 for (;;) {
863 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
864
865 if (!xprt)
866 break;
867 ret = fn(clnt, xprt, data);
868 xprt_put(xprt);
869 if (ret < 0)
870 break;
871 }
872 xprt_iter_destroy(&xpi);
873 return ret;
874}
875EXPORT_SYMBOL_GPL(rpc_clnt_iterate_for_each_xprt);
876
877/*
878 * Kill all tasks for the given client.
879 * XXX: kill their descendants as well?
880 */
881void rpc_killall_tasks(struct rpc_clnt *clnt)
882{
883 struct rpc_task *rovr;
884
885
886 if (list_empty(&clnt->cl_tasks))
887 return;
888
889 /*
890 * Spin lock all_tasks to prevent changes...
891 */
892 trace_rpc_clnt_killall(clnt);
893 spin_lock(&clnt->cl_lock);
894 list_for_each_entry(rovr, &clnt->cl_tasks, tk_task)
895 rpc_signal_task(rovr);
896 spin_unlock(&clnt->cl_lock);
897}
898EXPORT_SYMBOL_GPL(rpc_killall_tasks);
899
900/**
901 * rpc_cancel_tasks - try to cancel a set of RPC tasks
902 * @clnt: Pointer to RPC client
903 * @error: RPC task error value to set
904 * @fnmatch: Pointer to selector function
905 * @data: User data
906 *
907 * Uses @fnmatch to define a set of RPC tasks that are to be cancelled.
908 * The argument @error must be a negative error value.
909 */
910unsigned long rpc_cancel_tasks(struct rpc_clnt *clnt, int error,
911 bool (*fnmatch)(const struct rpc_task *,
912 const void *),
913 const void *data)
914{
915 struct rpc_task *task;
916 unsigned long count = 0;
917
918 if (list_empty(&clnt->cl_tasks))
919 return 0;
920 /*
921 * Spin lock all_tasks to prevent changes...
922 */
923 spin_lock(&clnt->cl_lock);
924 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
925 if (!RPC_IS_ACTIVATED(task))
926 continue;
927 if (!fnmatch(task, data))
928 continue;
929 rpc_task_try_cancel(task, error);
930 count++;
931 }
932 spin_unlock(&clnt->cl_lock);
933 return count;
934}
935EXPORT_SYMBOL_GPL(rpc_cancel_tasks);
936
937static int rpc_clnt_disconnect_xprt(struct rpc_clnt *clnt,
938 struct rpc_xprt *xprt, void *dummy)
939{
940 if (xprt_connected(xprt))
941 xprt_force_disconnect(xprt);
942 return 0;
943}
944
945void rpc_clnt_disconnect(struct rpc_clnt *clnt)
946{
947 rpc_clnt_iterate_for_each_xprt(clnt, rpc_clnt_disconnect_xprt, NULL);
948}
949EXPORT_SYMBOL_GPL(rpc_clnt_disconnect);
950
951/*
952 * Properly shut down an RPC client, terminating all outstanding
953 * requests.
954 */
955void rpc_shutdown_client(struct rpc_clnt *clnt)
956{
957 might_sleep();
958
959 trace_rpc_clnt_shutdown(clnt);
960
961 while (!list_empty(&clnt->cl_tasks)) {
962 rpc_killall_tasks(clnt);
963 wait_event_timeout(destroy_wait,
964 list_empty(&clnt->cl_tasks), 1*HZ);
965 }
966
967 rpc_release_client(clnt);
968}
969EXPORT_SYMBOL_GPL(rpc_shutdown_client);
970
971/*
972 * Free an RPC client
973 */
974static void rpc_free_client_work(struct work_struct *work)
975{
976 struct rpc_clnt *clnt = container_of(work, struct rpc_clnt, cl_work);
977
978 trace_rpc_clnt_free(clnt);
979
980 /* These might block on processes that might allocate memory,
981 * so they cannot be called in rpciod, so they are handled separately
982 * here.
983 */
984 rpc_sysfs_client_destroy(clnt);
985 rpc_clnt_debugfs_unregister(clnt);
986 rpc_free_clid(clnt);
987 rpc_clnt_remove_pipedir(clnt);
988 xprt_put(rcu_dereference_raw(clnt->cl_xprt));
989
990 kfree(clnt);
991 rpciod_down();
992}
993static struct rpc_clnt *
994rpc_free_client(struct rpc_clnt *clnt)
995{
996 struct rpc_clnt *parent = NULL;
997
998 trace_rpc_clnt_release(clnt);
999 if (clnt->cl_parent != clnt)
1000 parent = clnt->cl_parent;
1001 rpc_unregister_client(clnt);
1002 rpc_free_iostats(clnt->cl_metrics);
1003 clnt->cl_metrics = NULL;
1004 xprt_iter_destroy(&clnt->cl_xpi);
1005 put_cred(clnt->cl_cred);
1006
1007 INIT_WORK(&clnt->cl_work, rpc_free_client_work);
1008 schedule_work(&clnt->cl_work);
1009 return parent;
1010}
1011
1012/*
1013 * Free an RPC client
1014 */
1015static struct rpc_clnt *
1016rpc_free_auth(struct rpc_clnt *clnt)
1017{
1018 /*
1019 * Note: RPCSEC_GSS may need to send NULL RPC calls in order to
1020 * release remaining GSS contexts. This mechanism ensures
1021 * that it can do so safely.
1022 */
1023 if (clnt->cl_auth != NULL) {
1024 rpcauth_release(clnt->cl_auth);
1025 clnt->cl_auth = NULL;
1026 }
1027 if (refcount_dec_and_test(&clnt->cl_count))
1028 return rpc_free_client(clnt);
1029 return NULL;
1030}
1031
1032/*
1033 * Release reference to the RPC client
1034 */
1035void
1036rpc_release_client(struct rpc_clnt *clnt)
1037{
1038 do {
1039 if (list_empty(&clnt->cl_tasks))
1040 wake_up(&destroy_wait);
1041 if (refcount_dec_not_one(&clnt->cl_count))
1042 break;
1043 clnt = rpc_free_auth(clnt);
1044 } while (clnt != NULL);
1045}
1046EXPORT_SYMBOL_GPL(rpc_release_client);
1047
1048/**
1049 * rpc_bind_new_program - bind a new RPC program to an existing client
1050 * @old: old rpc_client
1051 * @program: rpc program to set
1052 * @vers: rpc program version
1053 *
1054 * Clones the rpc client and sets up a new RPC program. This is mainly
1055 * of use for enabling different RPC programs to share the same transport.
1056 * The Sun NFSv2/v3 ACL protocol can do this.
1057 */
1058struct rpc_clnt *rpc_bind_new_program(struct rpc_clnt *old,
1059 const struct rpc_program *program,
1060 u32 vers)
1061{
1062 struct rpc_create_args args = {
1063 .program = program,
1064 .prognumber = program->number,
1065 .version = vers,
1066 .authflavor = old->cl_auth->au_flavor,
1067 .cred = old->cl_cred,
1068 .stats = old->cl_stats,
1069 .timeout = old->cl_timeout,
1070 };
1071 struct rpc_clnt *clnt;
1072 int err;
1073
1074 clnt = __rpc_clone_client(&args, old);
1075 if (IS_ERR(clnt))
1076 goto out;
1077 err = rpc_ping(clnt);
1078 if (err != 0) {
1079 rpc_shutdown_client(clnt);
1080 clnt = ERR_PTR(err);
1081 }
1082out:
1083 return clnt;
1084}
1085EXPORT_SYMBOL_GPL(rpc_bind_new_program);
1086
1087struct rpc_xprt *
1088rpc_task_get_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
1089{
1090 struct rpc_xprt_switch *xps;
1091
1092 if (!xprt)
1093 return NULL;
1094 rcu_read_lock();
1095 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
1096 atomic_long_inc(&xps->xps_queuelen);
1097 rcu_read_unlock();
1098 atomic_long_inc(&xprt->queuelen);
1099
1100 return xprt;
1101}
1102
1103static void
1104rpc_task_release_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
1105{
1106 struct rpc_xprt_switch *xps;
1107
1108 atomic_long_dec(&xprt->queuelen);
1109 rcu_read_lock();
1110 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
1111 atomic_long_dec(&xps->xps_queuelen);
1112 rcu_read_unlock();
1113
1114 xprt_put(xprt);
1115}
1116
1117void rpc_task_release_transport(struct rpc_task *task)
1118{
1119 struct rpc_xprt *xprt = task->tk_xprt;
1120
1121 if (xprt) {
1122 task->tk_xprt = NULL;
1123 if (task->tk_client)
1124 rpc_task_release_xprt(task->tk_client, xprt);
1125 else
1126 xprt_put(xprt);
1127 }
1128}
1129EXPORT_SYMBOL_GPL(rpc_task_release_transport);
1130
1131void rpc_task_release_client(struct rpc_task *task)
1132{
1133 struct rpc_clnt *clnt = task->tk_client;
1134
1135 rpc_task_release_transport(task);
1136 if (clnt != NULL) {
1137 /* Remove from client task list */
1138 spin_lock(&clnt->cl_lock);
1139 list_del(&task->tk_task);
1140 spin_unlock(&clnt->cl_lock);
1141 task->tk_client = NULL;
1142
1143 rpc_release_client(clnt);
1144 }
1145}
1146
1147static struct rpc_xprt *
1148rpc_task_get_first_xprt(struct rpc_clnt *clnt)
1149{
1150 struct rpc_xprt *xprt;
1151
1152 rcu_read_lock();
1153 xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
1154 rcu_read_unlock();
1155 return rpc_task_get_xprt(clnt, xprt);
1156}
1157
1158static struct rpc_xprt *
1159rpc_task_get_next_xprt(struct rpc_clnt *clnt)
1160{
1161 return rpc_task_get_xprt(clnt, xprt_iter_get_next(&clnt->cl_xpi));
1162}
1163
1164static
1165void rpc_task_set_transport(struct rpc_task *task, struct rpc_clnt *clnt)
1166{
1167 if (task->tk_xprt) {
1168 if (!(test_bit(XPRT_OFFLINE, &task->tk_xprt->state) &&
1169 (task->tk_flags & RPC_TASK_MOVEABLE)))
1170 return;
1171 xprt_release(task);
1172 xprt_put(task->tk_xprt);
1173 }
1174 if (task->tk_flags & RPC_TASK_NO_ROUND_ROBIN)
1175 task->tk_xprt = rpc_task_get_first_xprt(clnt);
1176 else
1177 task->tk_xprt = rpc_task_get_next_xprt(clnt);
1178}
1179
1180static
1181void rpc_task_set_client(struct rpc_task *task, struct rpc_clnt *clnt)
1182{
1183 rpc_task_set_transport(task, clnt);
1184 task->tk_client = clnt;
1185 refcount_inc(&clnt->cl_count);
1186 if (clnt->cl_softrtry)
1187 task->tk_flags |= RPC_TASK_SOFT;
1188 if (clnt->cl_softerr)
1189 task->tk_flags |= RPC_TASK_TIMEOUT;
1190 if (clnt->cl_noretranstimeo)
1191 task->tk_flags |= RPC_TASK_NO_RETRANS_TIMEOUT;
1192 /* Add to the client's list of all tasks */
1193 spin_lock(&clnt->cl_lock);
1194 list_add_tail(&task->tk_task, &clnt->cl_tasks);
1195 spin_unlock(&clnt->cl_lock);
1196}
1197
1198static void
1199rpc_task_set_rpc_message(struct rpc_task *task, const struct rpc_message *msg)
1200{
1201 if (msg != NULL) {
1202 task->tk_msg.rpc_proc = msg->rpc_proc;
1203 task->tk_msg.rpc_argp = msg->rpc_argp;
1204 task->tk_msg.rpc_resp = msg->rpc_resp;
1205 task->tk_msg.rpc_cred = msg->rpc_cred;
1206 if (!(task->tk_flags & RPC_TASK_CRED_NOREF))
1207 get_cred(task->tk_msg.rpc_cred);
1208 }
1209}
1210
1211/*
1212 * Default callback for async RPC calls
1213 */
1214static void
1215rpc_default_callback(struct rpc_task *task, void *data)
1216{
1217}
1218
1219static const struct rpc_call_ops rpc_default_ops = {
1220 .rpc_call_done = rpc_default_callback,
1221};
1222
1223/**
1224 * rpc_run_task - Allocate a new RPC task, then run rpc_execute against it
1225 * @task_setup_data: pointer to task initialisation data
1226 */
1227struct rpc_task *rpc_run_task(const struct rpc_task_setup *task_setup_data)
1228{
1229 struct rpc_task *task;
1230
1231 task = rpc_new_task(task_setup_data);
1232 if (IS_ERR(task))
1233 return task;
1234
1235 if (!RPC_IS_ASYNC(task))
1236 task->tk_flags |= RPC_TASK_CRED_NOREF;
1237
1238 rpc_task_set_client(task, task_setup_data->rpc_client);
1239 rpc_task_set_rpc_message(task, task_setup_data->rpc_message);
1240
1241 if (task->tk_action == NULL)
1242 rpc_call_start(task);
1243
1244 atomic_inc(&task->tk_count);
1245 rpc_execute(task);
1246 return task;
1247}
1248EXPORT_SYMBOL_GPL(rpc_run_task);
1249
1250/**
1251 * rpc_call_sync - Perform a synchronous RPC call
1252 * @clnt: pointer to RPC client
1253 * @msg: RPC call parameters
1254 * @flags: RPC call flags
1255 */
1256int rpc_call_sync(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags)
1257{
1258 struct rpc_task *task;
1259 struct rpc_task_setup task_setup_data = {
1260 .rpc_client = clnt,
1261 .rpc_message = msg,
1262 .callback_ops = &rpc_default_ops,
1263 .flags = flags,
1264 };
1265 int status;
1266
1267 WARN_ON_ONCE(flags & RPC_TASK_ASYNC);
1268 if (flags & RPC_TASK_ASYNC) {
1269 rpc_release_calldata(task_setup_data.callback_ops,
1270 task_setup_data.callback_data);
1271 return -EINVAL;
1272 }
1273
1274 task = rpc_run_task(&task_setup_data);
1275 if (IS_ERR(task))
1276 return PTR_ERR(task);
1277 status = task->tk_status;
1278 rpc_put_task(task);
1279 return status;
1280}
1281EXPORT_SYMBOL_GPL(rpc_call_sync);
1282
1283/**
1284 * rpc_call_async - Perform an asynchronous RPC call
1285 * @clnt: pointer to RPC client
1286 * @msg: RPC call parameters
1287 * @flags: RPC call flags
1288 * @tk_ops: RPC call ops
1289 * @data: user call data
1290 */
1291int
1292rpc_call_async(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags,
1293 const struct rpc_call_ops *tk_ops, void *data)
1294{
1295 struct rpc_task *task;
1296 struct rpc_task_setup task_setup_data = {
1297 .rpc_client = clnt,
1298 .rpc_message = msg,
1299 .callback_ops = tk_ops,
1300 .callback_data = data,
1301 .flags = flags|RPC_TASK_ASYNC,
1302 };
1303
1304 task = rpc_run_task(&task_setup_data);
1305 if (IS_ERR(task))
1306 return PTR_ERR(task);
1307 rpc_put_task(task);
1308 return 0;
1309}
1310EXPORT_SYMBOL_GPL(rpc_call_async);
1311
1312#if defined(CONFIG_SUNRPC_BACKCHANNEL)
1313static void call_bc_encode(struct rpc_task *task);
1314
1315/**
1316 * rpc_run_bc_task - Allocate a new RPC task for backchannel use, then run
1317 * rpc_execute against it
1318 * @req: RPC request
1319 * @timeout: timeout values to use for this task
1320 */
1321struct rpc_task *rpc_run_bc_task(struct rpc_rqst *req,
1322 struct rpc_timeout *timeout)
1323{
1324 struct rpc_task *task;
1325 struct rpc_task_setup task_setup_data = {
1326 .callback_ops = &rpc_default_ops,
1327 .flags = RPC_TASK_SOFTCONN |
1328 RPC_TASK_NO_RETRANS_TIMEOUT,
1329 };
1330
1331 dprintk("RPC: rpc_run_bc_task req= %p\n", req);
1332 /*
1333 * Create an rpc_task to send the data
1334 */
1335 task = rpc_new_task(&task_setup_data);
1336 if (IS_ERR(task)) {
1337 xprt_free_bc_request(req);
1338 return task;
1339 }
1340
1341 xprt_init_bc_request(req, task, timeout);
1342
1343 task->tk_action = call_bc_encode;
1344 atomic_inc(&task->tk_count);
1345 WARN_ON_ONCE(atomic_read(&task->tk_count) != 2);
1346 rpc_execute(task);
1347
1348 dprintk("RPC: rpc_run_bc_task: task= %p\n", task);
1349 return task;
1350}
1351#endif /* CONFIG_SUNRPC_BACKCHANNEL */
1352
1353/**
1354 * rpc_prepare_reply_pages - Prepare to receive a reply data payload into pages
1355 * @req: RPC request to prepare
1356 * @pages: vector of struct page pointers
1357 * @base: offset in first page where receive should start, in bytes
1358 * @len: expected size of the upper layer data payload, in bytes
1359 * @hdrsize: expected size of upper layer reply header, in XDR words
1360 *
1361 */
1362void rpc_prepare_reply_pages(struct rpc_rqst *req, struct page **pages,
1363 unsigned int base, unsigned int len,
1364 unsigned int hdrsize)
1365{
1366 hdrsize += RPC_REPHDRSIZE + req->rq_cred->cr_auth->au_ralign;
1367
1368 xdr_inline_pages(&req->rq_rcv_buf, hdrsize << 2, pages, base, len);
1369 trace_rpc_xdr_reply_pages(req->rq_task, &req->rq_rcv_buf);
1370}
1371EXPORT_SYMBOL_GPL(rpc_prepare_reply_pages);
1372
1373void
1374rpc_call_start(struct rpc_task *task)
1375{
1376 task->tk_action = call_start;
1377}
1378EXPORT_SYMBOL_GPL(rpc_call_start);
1379
1380/**
1381 * rpc_peeraddr - extract remote peer address from clnt's xprt
1382 * @clnt: RPC client structure
1383 * @buf: target buffer
1384 * @bufsize: length of target buffer
1385 *
1386 * Returns the number of bytes that are actually in the stored address.
1387 */
1388size_t rpc_peeraddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t bufsize)
1389{
1390 size_t bytes;
1391 struct rpc_xprt *xprt;
1392
1393 rcu_read_lock();
1394 xprt = rcu_dereference(clnt->cl_xprt);
1395
1396 bytes = xprt->addrlen;
1397 if (bytes > bufsize)
1398 bytes = bufsize;
1399 memcpy(buf, &xprt->addr, bytes);
1400 rcu_read_unlock();
1401
1402 return bytes;
1403}
1404EXPORT_SYMBOL_GPL(rpc_peeraddr);
1405
1406/**
1407 * rpc_peeraddr2str - return remote peer address in printable format
1408 * @clnt: RPC client structure
1409 * @format: address format
1410 *
1411 * NB: the lifetime of the memory referenced by the returned pointer is
1412 * the same as the rpc_xprt itself. As long as the caller uses this
1413 * pointer, it must hold the RCU read lock.
1414 */
1415const char *rpc_peeraddr2str(struct rpc_clnt *clnt,
1416 enum rpc_display_format_t format)
1417{
1418 struct rpc_xprt *xprt;
1419
1420 xprt = rcu_dereference(clnt->cl_xprt);
1421
1422 if (xprt->address_strings[format] != NULL)
1423 return xprt->address_strings[format];
1424 else
1425 return "unprintable";
1426}
1427EXPORT_SYMBOL_GPL(rpc_peeraddr2str);
1428
1429static const struct sockaddr_in rpc_inaddr_loopback = {
1430 .sin_family = AF_INET,
1431 .sin_addr.s_addr = htonl(INADDR_ANY),
1432};
1433
1434static const struct sockaddr_in6 rpc_in6addr_loopback = {
1435 .sin6_family = AF_INET6,
1436 .sin6_addr = IN6ADDR_ANY_INIT,
1437};
1438
1439/*
1440 * Try a getsockname() on a connected datagram socket. Using a
1441 * connected datagram socket prevents leaving a socket in TIME_WAIT.
1442 * This conserves the ephemeral port number space.
1443 *
1444 * Returns zero and fills in "buf" if successful; otherwise, a
1445 * negative errno is returned.
1446 */
1447static int rpc_sockname(struct net *net, struct sockaddr *sap, size_t salen,
1448 struct sockaddr *buf)
1449{
1450 struct socket *sock;
1451 int err;
1452
1453 err = __sock_create(net, sap->sa_family,
1454 SOCK_DGRAM, IPPROTO_UDP, &sock, 1);
1455 if (err < 0) {
1456 dprintk("RPC: can't create UDP socket (%d)\n", err);
1457 goto out;
1458 }
1459
1460 switch (sap->sa_family) {
1461 case AF_INET:
1462 err = kernel_bind(sock,
1463 (struct sockaddr *)&rpc_inaddr_loopback,
1464 sizeof(rpc_inaddr_loopback));
1465 break;
1466 case AF_INET6:
1467 err = kernel_bind(sock,
1468 (struct sockaddr *)&rpc_in6addr_loopback,
1469 sizeof(rpc_in6addr_loopback));
1470 break;
1471 default:
1472 err = -EAFNOSUPPORT;
1473 goto out_release;
1474 }
1475 if (err < 0) {
1476 dprintk("RPC: can't bind UDP socket (%d)\n", err);
1477 goto out_release;
1478 }
1479
1480 err = kernel_connect(sock, sap, salen, 0);
1481 if (err < 0) {
1482 dprintk("RPC: can't connect UDP socket (%d)\n", err);
1483 goto out_release;
1484 }
1485
1486 err = kernel_getsockname(sock, buf);
1487 if (err < 0) {
1488 dprintk("RPC: getsockname failed (%d)\n", err);
1489 goto out_release;
1490 }
1491
1492 err = 0;
1493 if (buf->sa_family == AF_INET6) {
1494 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)buf;
1495 sin6->sin6_scope_id = 0;
1496 }
1497 dprintk("RPC: %s succeeded\n", __func__);
1498
1499out_release:
1500 sock_release(sock);
1501out:
1502 return err;
1503}
1504
1505/*
1506 * Scraping a connected socket failed, so we don't have a useable
1507 * local address. Fallback: generate an address that will prevent
1508 * the server from calling us back.
1509 *
1510 * Returns zero and fills in "buf" if successful; otherwise, a
1511 * negative errno is returned.
1512 */
1513static int rpc_anyaddr(int family, struct sockaddr *buf, size_t buflen)
1514{
1515 switch (family) {
1516 case AF_INET:
1517 if (buflen < sizeof(rpc_inaddr_loopback))
1518 return -EINVAL;
1519 memcpy(buf, &rpc_inaddr_loopback,
1520 sizeof(rpc_inaddr_loopback));
1521 break;
1522 case AF_INET6:
1523 if (buflen < sizeof(rpc_in6addr_loopback))
1524 return -EINVAL;
1525 memcpy(buf, &rpc_in6addr_loopback,
1526 sizeof(rpc_in6addr_loopback));
1527 break;
1528 default:
1529 dprintk("RPC: %s: address family not supported\n",
1530 __func__);
1531 return -EAFNOSUPPORT;
1532 }
1533 dprintk("RPC: %s: succeeded\n", __func__);
1534 return 0;
1535}
1536
1537/**
1538 * rpc_localaddr - discover local endpoint address for an RPC client
1539 * @clnt: RPC client structure
1540 * @buf: target buffer
1541 * @buflen: size of target buffer, in bytes
1542 *
1543 * Returns zero and fills in "buf" and "buflen" if successful;
1544 * otherwise, a negative errno is returned.
1545 *
1546 * This works even if the underlying transport is not currently connected,
1547 * or if the upper layer never previously provided a source address.
1548 *
1549 * The result of this function call is transient: multiple calls in
1550 * succession may give different results, depending on how local
1551 * networking configuration changes over time.
1552 */
1553int rpc_localaddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t buflen)
1554{
1555 struct sockaddr_storage address;
1556 struct sockaddr *sap = (struct sockaddr *)&address;
1557 struct rpc_xprt *xprt;
1558 struct net *net;
1559 size_t salen;
1560 int err;
1561
1562 rcu_read_lock();
1563 xprt = rcu_dereference(clnt->cl_xprt);
1564 salen = xprt->addrlen;
1565 memcpy(sap, &xprt->addr, salen);
1566 net = get_net(xprt->xprt_net);
1567 rcu_read_unlock();
1568
1569 rpc_set_port(sap, 0);
1570 err = rpc_sockname(net, sap, salen, buf);
1571 put_net(net);
1572 if (err != 0)
1573 /* Couldn't discover local address, return ANYADDR */
1574 return rpc_anyaddr(sap->sa_family, buf, buflen);
1575 return 0;
1576}
1577EXPORT_SYMBOL_GPL(rpc_localaddr);
1578
1579void
1580rpc_setbufsize(struct rpc_clnt *clnt, unsigned int sndsize, unsigned int rcvsize)
1581{
1582 struct rpc_xprt *xprt;
1583
1584 rcu_read_lock();
1585 xprt = rcu_dereference(clnt->cl_xprt);
1586 if (xprt->ops->set_buffer_size)
1587 xprt->ops->set_buffer_size(xprt, sndsize, rcvsize);
1588 rcu_read_unlock();
1589}
1590EXPORT_SYMBOL_GPL(rpc_setbufsize);
1591
1592/**
1593 * rpc_net_ns - Get the network namespace for this RPC client
1594 * @clnt: RPC client to query
1595 *
1596 */
1597struct net *rpc_net_ns(struct rpc_clnt *clnt)
1598{
1599 struct net *ret;
1600
1601 rcu_read_lock();
1602 ret = rcu_dereference(clnt->cl_xprt)->xprt_net;
1603 rcu_read_unlock();
1604 return ret;
1605}
1606EXPORT_SYMBOL_GPL(rpc_net_ns);
1607
1608/**
1609 * rpc_max_payload - Get maximum payload size for a transport, in bytes
1610 * @clnt: RPC client to query
1611 *
1612 * For stream transports, this is one RPC record fragment (see RFC
1613 * 1831), as we don't support multi-record requests yet. For datagram
1614 * transports, this is the size of an IP packet minus the IP, UDP, and
1615 * RPC header sizes.
1616 */
1617size_t rpc_max_payload(struct rpc_clnt *clnt)
1618{
1619 size_t ret;
1620
1621 rcu_read_lock();
1622 ret = rcu_dereference(clnt->cl_xprt)->max_payload;
1623 rcu_read_unlock();
1624 return ret;
1625}
1626EXPORT_SYMBOL_GPL(rpc_max_payload);
1627
1628/**
1629 * rpc_max_bc_payload - Get maximum backchannel payload size, in bytes
1630 * @clnt: RPC client to query
1631 */
1632size_t rpc_max_bc_payload(struct rpc_clnt *clnt)
1633{
1634 struct rpc_xprt *xprt;
1635 size_t ret;
1636
1637 rcu_read_lock();
1638 xprt = rcu_dereference(clnt->cl_xprt);
1639 ret = xprt->ops->bc_maxpayload(xprt);
1640 rcu_read_unlock();
1641 return ret;
1642}
1643EXPORT_SYMBOL_GPL(rpc_max_bc_payload);
1644
1645unsigned int rpc_num_bc_slots(struct rpc_clnt *clnt)
1646{
1647 struct rpc_xprt *xprt;
1648 unsigned int ret;
1649
1650 rcu_read_lock();
1651 xprt = rcu_dereference(clnt->cl_xprt);
1652 ret = xprt->ops->bc_num_slots(xprt);
1653 rcu_read_unlock();
1654 return ret;
1655}
1656EXPORT_SYMBOL_GPL(rpc_num_bc_slots);
1657
1658/**
1659 * rpc_force_rebind - force transport to check that remote port is unchanged
1660 * @clnt: client to rebind
1661 *
1662 */
1663void rpc_force_rebind(struct rpc_clnt *clnt)
1664{
1665 if (clnt->cl_autobind) {
1666 rcu_read_lock();
1667 xprt_clear_bound(rcu_dereference(clnt->cl_xprt));
1668 rcu_read_unlock();
1669 }
1670}
1671EXPORT_SYMBOL_GPL(rpc_force_rebind);
1672
1673static int
1674__rpc_restart_call(struct rpc_task *task, void (*action)(struct rpc_task *))
1675{
1676 task->tk_status = 0;
1677 task->tk_rpc_status = 0;
1678 task->tk_action = action;
1679 return 1;
1680}
1681
1682/*
1683 * Restart an (async) RPC call. Usually called from within the
1684 * exit handler.
1685 */
1686int
1687rpc_restart_call(struct rpc_task *task)
1688{
1689 return __rpc_restart_call(task, call_start);
1690}
1691EXPORT_SYMBOL_GPL(rpc_restart_call);
1692
1693/*
1694 * Restart an (async) RPC call from the call_prepare state.
1695 * Usually called from within the exit handler.
1696 */
1697int
1698rpc_restart_call_prepare(struct rpc_task *task)
1699{
1700 if (task->tk_ops->rpc_call_prepare != NULL)
1701 return __rpc_restart_call(task, rpc_prepare_task);
1702 return rpc_restart_call(task);
1703}
1704EXPORT_SYMBOL_GPL(rpc_restart_call_prepare);
1705
1706const char
1707*rpc_proc_name(const struct rpc_task *task)
1708{
1709 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1710
1711 if (proc) {
1712 if (proc->p_name)
1713 return proc->p_name;
1714 else
1715 return "NULL";
1716 } else
1717 return "no proc";
1718}
1719
1720static void
1721__rpc_call_rpcerror(struct rpc_task *task, int tk_status, int rpc_status)
1722{
1723 trace_rpc_call_rpcerror(task, tk_status, rpc_status);
1724 rpc_task_set_rpc_status(task, rpc_status);
1725 rpc_exit(task, tk_status);
1726}
1727
1728static void
1729rpc_call_rpcerror(struct rpc_task *task, int status)
1730{
1731 __rpc_call_rpcerror(task, status, status);
1732}
1733
1734/*
1735 * 0. Initial state
1736 *
1737 * Other FSM states can be visited zero or more times, but
1738 * this state is visited exactly once for each RPC.
1739 */
1740static void
1741call_start(struct rpc_task *task)
1742{
1743 struct rpc_clnt *clnt = task->tk_client;
1744 int idx = task->tk_msg.rpc_proc->p_statidx;
1745
1746 trace_rpc_request(task);
1747
1748 if (task->tk_client->cl_shutdown) {
1749 rpc_call_rpcerror(task, -EIO);
1750 return;
1751 }
1752
1753 /* Increment call count (version might not be valid for ping) */
1754 if (clnt->cl_program->version[clnt->cl_vers])
1755 clnt->cl_program->version[clnt->cl_vers]->counts[idx]++;
1756 clnt->cl_stats->rpccnt++;
1757 task->tk_action = call_reserve;
1758 rpc_task_set_transport(task, clnt);
1759}
1760
1761/*
1762 * 1. Reserve an RPC call slot
1763 */
1764static void
1765call_reserve(struct rpc_task *task)
1766{
1767 task->tk_status = 0;
1768 task->tk_action = call_reserveresult;
1769 xprt_reserve(task);
1770}
1771
1772static void call_retry_reserve(struct rpc_task *task);
1773
1774/*
1775 * 1b. Grok the result of xprt_reserve()
1776 */
1777static void
1778call_reserveresult(struct rpc_task *task)
1779{
1780 int status = task->tk_status;
1781
1782 /*
1783 * After a call to xprt_reserve(), we must have either
1784 * a request slot or else an error status.
1785 */
1786 task->tk_status = 0;
1787 if (status >= 0) {
1788 if (task->tk_rqstp) {
1789 task->tk_action = call_refresh;
1790 return;
1791 }
1792
1793 rpc_call_rpcerror(task, -EIO);
1794 return;
1795 }
1796
1797 switch (status) {
1798 case -ENOMEM:
1799 rpc_delay(task, HZ >> 2);
1800 fallthrough;
1801 case -EAGAIN: /* woken up; retry */
1802 task->tk_action = call_retry_reserve;
1803 return;
1804 default:
1805 rpc_call_rpcerror(task, status);
1806 }
1807}
1808
1809/*
1810 * 1c. Retry reserving an RPC call slot
1811 */
1812static void
1813call_retry_reserve(struct rpc_task *task)
1814{
1815 task->tk_status = 0;
1816 task->tk_action = call_reserveresult;
1817 xprt_retry_reserve(task);
1818}
1819
1820/*
1821 * 2. Bind and/or refresh the credentials
1822 */
1823static void
1824call_refresh(struct rpc_task *task)
1825{
1826 task->tk_action = call_refreshresult;
1827 task->tk_status = 0;
1828 task->tk_client->cl_stats->rpcauthrefresh++;
1829 rpcauth_refreshcred(task);
1830}
1831
1832/*
1833 * 2a. Process the results of a credential refresh
1834 */
1835static void
1836call_refreshresult(struct rpc_task *task)
1837{
1838 int status = task->tk_status;
1839
1840 task->tk_status = 0;
1841 task->tk_action = call_refresh;
1842 switch (status) {
1843 case 0:
1844 if (rpcauth_uptodatecred(task)) {
1845 task->tk_action = call_allocate;
1846 return;
1847 }
1848 /* Use rate-limiting and a max number of retries if refresh
1849 * had status 0 but failed to update the cred.
1850 */
1851 fallthrough;
1852 case -ETIMEDOUT:
1853 rpc_delay(task, 3*HZ);
1854 fallthrough;
1855 case -EAGAIN:
1856 status = -EACCES;
1857 fallthrough;
1858 case -EKEYEXPIRED:
1859 if (!task->tk_cred_retry)
1860 break;
1861 task->tk_cred_retry--;
1862 trace_rpc_retry_refresh_status(task);
1863 return;
1864 case -ENOMEM:
1865 rpc_delay(task, HZ >> 4);
1866 return;
1867 }
1868 trace_rpc_refresh_status(task);
1869 rpc_call_rpcerror(task, status);
1870}
1871
1872/*
1873 * 2b. Allocate the buffer. For details, see sched.c:rpc_malloc.
1874 * (Note: buffer memory is freed in xprt_release).
1875 */
1876static void
1877call_allocate(struct rpc_task *task)
1878{
1879 const struct rpc_auth *auth = task->tk_rqstp->rq_cred->cr_auth;
1880 struct rpc_rqst *req = task->tk_rqstp;
1881 struct rpc_xprt *xprt = req->rq_xprt;
1882 const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1883 int status;
1884
1885 task->tk_status = 0;
1886 task->tk_action = call_encode;
1887
1888 if (req->rq_buffer)
1889 return;
1890
1891 /*
1892 * Calculate the size (in quads) of the RPC call
1893 * and reply headers, and convert both values
1894 * to byte sizes.
1895 */
1896 req->rq_callsize = RPC_CALLHDRSIZE + (auth->au_cslack << 1) +
1897 proc->p_arglen;
1898 req->rq_callsize <<= 2;
1899 /*
1900 * Note: the reply buffer must at minimum allocate enough space
1901 * for the 'struct accepted_reply' from RFC5531.
1902 */
1903 req->rq_rcvsize = RPC_REPHDRSIZE + auth->au_rslack + \
1904 max_t(size_t, proc->p_replen, 2);
1905 req->rq_rcvsize <<= 2;
1906
1907 status = xprt->ops->buf_alloc(task);
1908 trace_rpc_buf_alloc(task, status);
1909 if (status == 0)
1910 return;
1911 if (status != -ENOMEM) {
1912 rpc_call_rpcerror(task, status);
1913 return;
1914 }
1915
1916 if (RPC_IS_ASYNC(task) || !fatal_signal_pending(current)) {
1917 task->tk_action = call_allocate;
1918 rpc_delay(task, HZ>>4);
1919 return;
1920 }
1921
1922 rpc_call_rpcerror(task, -ERESTARTSYS);
1923}
1924
1925static int
1926rpc_task_need_encode(struct rpc_task *task)
1927{
1928 return test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate) == 0 &&
1929 (!(task->tk_flags & RPC_TASK_SENT) ||
1930 !(task->tk_flags & RPC_TASK_NO_RETRANS_TIMEOUT) ||
1931 xprt_request_need_retransmit(task));
1932}
1933
1934static void
1935rpc_xdr_encode(struct rpc_task *task)
1936{
1937 struct rpc_rqst *req = task->tk_rqstp;
1938 struct xdr_stream xdr;
1939
1940 xdr_buf_init(&req->rq_snd_buf,
1941 req->rq_buffer,
1942 req->rq_callsize);
1943 xdr_buf_init(&req->rq_rcv_buf,
1944 req->rq_rbuffer,
1945 req->rq_rcvsize);
1946
1947 req->rq_reply_bytes_recvd = 0;
1948 req->rq_snd_buf.head[0].iov_len = 0;
1949 xdr_init_encode(&xdr, &req->rq_snd_buf,
1950 req->rq_snd_buf.head[0].iov_base, req);
1951 if (rpc_encode_header(task, &xdr))
1952 return;
1953
1954 task->tk_status = rpcauth_wrap_req(task, &xdr);
1955}
1956
1957/*
1958 * 3. Encode arguments of an RPC call
1959 */
1960static void
1961call_encode(struct rpc_task *task)
1962{
1963 if (!rpc_task_need_encode(task))
1964 goto out;
1965
1966 /* Dequeue task from the receive queue while we're encoding */
1967 xprt_request_dequeue_xprt(task);
1968 /* Encode here so that rpcsec_gss can use correct sequence number. */
1969 rpc_xdr_encode(task);
1970 /* Add task to reply queue before transmission to avoid races */
1971 if (task->tk_status == 0 && rpc_reply_expected(task))
1972 task->tk_status = xprt_request_enqueue_receive(task);
1973 /* Did the encode result in an error condition? */
1974 if (task->tk_status != 0) {
1975 /* Was the error nonfatal? */
1976 switch (task->tk_status) {
1977 case -EAGAIN:
1978 case -ENOMEM:
1979 rpc_delay(task, HZ >> 4);
1980 break;
1981 case -EKEYEXPIRED:
1982 if (!task->tk_cred_retry) {
1983 rpc_call_rpcerror(task, task->tk_status);
1984 } else {
1985 task->tk_action = call_refresh;
1986 task->tk_cred_retry--;
1987 trace_rpc_retry_refresh_status(task);
1988 }
1989 break;
1990 default:
1991 rpc_call_rpcerror(task, task->tk_status);
1992 }
1993 return;
1994 }
1995
1996 xprt_request_enqueue_transmit(task);
1997out:
1998 task->tk_action = call_transmit;
1999 /* Check that the connection is OK */
2000 if (!xprt_bound(task->tk_xprt))
2001 task->tk_action = call_bind;
2002 else if (!xprt_connected(task->tk_xprt))
2003 task->tk_action = call_connect;
2004}
2005
2006/*
2007 * Helpers to check if the task was already transmitted, and
2008 * to take action when that is the case.
2009 */
2010static bool
2011rpc_task_transmitted(struct rpc_task *task)
2012{
2013 return !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
2014}
2015
2016static void
2017rpc_task_handle_transmitted(struct rpc_task *task)
2018{
2019 xprt_end_transmit(task);
2020 task->tk_action = call_transmit_status;
2021}
2022
2023/*
2024 * 4. Get the server port number if not yet set
2025 */
2026static void
2027call_bind(struct rpc_task *task)
2028{
2029 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2030
2031 if (rpc_task_transmitted(task)) {
2032 rpc_task_handle_transmitted(task);
2033 return;
2034 }
2035
2036 if (xprt_bound(xprt)) {
2037 task->tk_action = call_connect;
2038 return;
2039 }
2040
2041 task->tk_action = call_bind_status;
2042 if (!xprt_prepare_transmit(task))
2043 return;
2044
2045 xprt->ops->rpcbind(task);
2046}
2047
2048/*
2049 * 4a. Sort out bind result
2050 */
2051static void
2052call_bind_status(struct rpc_task *task)
2053{
2054 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2055 int status = -EIO;
2056
2057 if (rpc_task_transmitted(task)) {
2058 rpc_task_handle_transmitted(task);
2059 return;
2060 }
2061
2062 if (task->tk_status >= 0)
2063 goto out_next;
2064 if (xprt_bound(xprt)) {
2065 task->tk_status = 0;
2066 goto out_next;
2067 }
2068
2069 switch (task->tk_status) {
2070 case -ENOMEM:
2071 rpc_delay(task, HZ >> 2);
2072 goto retry_timeout;
2073 case -EACCES:
2074 trace_rpcb_prog_unavail_err(task);
2075 /* fail immediately if this is an RPC ping */
2076 if (task->tk_msg.rpc_proc->p_proc == 0) {
2077 status = -EOPNOTSUPP;
2078 break;
2079 }
2080 rpc_delay(task, 3*HZ);
2081 goto retry_timeout;
2082 case -ENOBUFS:
2083 rpc_delay(task, HZ >> 2);
2084 goto retry_timeout;
2085 case -EAGAIN:
2086 goto retry_timeout;
2087 case -ETIMEDOUT:
2088 trace_rpcb_timeout_err(task);
2089 goto retry_timeout;
2090 case -EPFNOSUPPORT:
2091 /* server doesn't support any rpcbind version we know of */
2092 trace_rpcb_bind_version_err(task);
2093 break;
2094 case -EPROTONOSUPPORT:
2095 trace_rpcb_bind_version_err(task);
2096 goto retry_timeout;
2097 case -ECONNREFUSED: /* connection problems */
2098 case -ECONNRESET:
2099 case -ECONNABORTED:
2100 case -ENOTCONN:
2101 case -EHOSTDOWN:
2102 case -ENETDOWN:
2103 case -EHOSTUNREACH:
2104 case -ENETUNREACH:
2105 case -EPIPE:
2106 trace_rpcb_unreachable_err(task);
2107 if (!RPC_IS_SOFTCONN(task)) {
2108 rpc_delay(task, 5*HZ);
2109 goto retry_timeout;
2110 }
2111 status = task->tk_status;
2112 break;
2113 default:
2114 trace_rpcb_unrecognized_err(task);
2115 }
2116
2117 rpc_call_rpcerror(task, status);
2118 return;
2119out_next:
2120 task->tk_action = call_connect;
2121 return;
2122retry_timeout:
2123 task->tk_status = 0;
2124 task->tk_action = call_bind;
2125 rpc_check_timeout(task);
2126}
2127
2128/*
2129 * 4b. Connect to the RPC server
2130 */
2131static void
2132call_connect(struct rpc_task *task)
2133{
2134 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2135
2136 if (rpc_task_transmitted(task)) {
2137 rpc_task_handle_transmitted(task);
2138 return;
2139 }
2140
2141 if (xprt_connected(xprt)) {
2142 task->tk_action = call_transmit;
2143 return;
2144 }
2145
2146 task->tk_action = call_connect_status;
2147 if (task->tk_status < 0)
2148 return;
2149 if (task->tk_flags & RPC_TASK_NOCONNECT) {
2150 rpc_call_rpcerror(task, -ENOTCONN);
2151 return;
2152 }
2153 if (!xprt_prepare_transmit(task))
2154 return;
2155 xprt_connect(task);
2156}
2157
2158/*
2159 * 4c. Sort out connect result
2160 */
2161static void
2162call_connect_status(struct rpc_task *task)
2163{
2164 struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
2165 struct rpc_clnt *clnt = task->tk_client;
2166 int status = task->tk_status;
2167
2168 if (rpc_task_transmitted(task)) {
2169 rpc_task_handle_transmitted(task);
2170 return;
2171 }
2172
2173 trace_rpc_connect_status(task);
2174
2175 if (task->tk_status == 0) {
2176 clnt->cl_stats->netreconn++;
2177 goto out_next;
2178 }
2179 if (xprt_connected(xprt)) {
2180 task->tk_status = 0;
2181 goto out_next;
2182 }
2183
2184 task->tk_status = 0;
2185 switch (status) {
2186 case -ECONNREFUSED:
2187 case -ECONNRESET:
2188 /* A positive refusal suggests a rebind is needed. */
2189 if (RPC_IS_SOFTCONN(task))
2190 break;
2191 if (clnt->cl_autobind) {
2192 rpc_force_rebind(clnt);
2193 goto out_retry;
2194 }
2195 fallthrough;
2196 case -ECONNABORTED:
2197 case -ENETDOWN:
2198 case -ENETUNREACH:
2199 case -EHOSTUNREACH:
2200 case -EPIPE:
2201 case -EPROTO:
2202 xprt_conditional_disconnect(task->tk_rqstp->rq_xprt,
2203 task->tk_rqstp->rq_connect_cookie);
2204 if (RPC_IS_SOFTCONN(task))
2205 break;
2206 /* retry with existing socket, after a delay */
2207 rpc_delay(task, 3*HZ);
2208 fallthrough;
2209 case -EADDRINUSE:
2210 case -ENOTCONN:
2211 case -EAGAIN:
2212 case -ETIMEDOUT:
2213 if (!(task->tk_flags & RPC_TASK_NO_ROUND_ROBIN) &&
2214 (task->tk_flags & RPC_TASK_MOVEABLE) &&
2215 test_bit(XPRT_REMOVE, &xprt->state)) {
2216 struct rpc_xprt *saved = task->tk_xprt;
2217 struct rpc_xprt_switch *xps;
2218
2219 xps = rpc_clnt_xprt_switch_get(clnt);
2220 if (xps->xps_nxprts > 1) {
2221 long value;
2222
2223 xprt_release(task);
2224 value = atomic_long_dec_return(&xprt->queuelen);
2225 if (value == 0)
2226 rpc_xprt_switch_remove_xprt(xps, saved,
2227 true);
2228 xprt_put(saved);
2229 task->tk_xprt = NULL;
2230 task->tk_action = call_start;
2231 }
2232 xprt_switch_put(xps);
2233 if (!task->tk_xprt)
2234 goto out;
2235 }
2236 goto out_retry;
2237 case -ENOBUFS:
2238 rpc_delay(task, HZ >> 2);
2239 goto out_retry;
2240 }
2241 rpc_call_rpcerror(task, status);
2242 return;
2243out_next:
2244 task->tk_action = call_transmit;
2245 return;
2246out_retry:
2247 /* Check for timeouts before looping back to call_bind */
2248 task->tk_action = call_bind;
2249out:
2250 rpc_check_timeout(task);
2251}
2252
2253/*
2254 * 5. Transmit the RPC request, and wait for reply
2255 */
2256static void
2257call_transmit(struct rpc_task *task)
2258{
2259 if (rpc_task_transmitted(task)) {
2260 rpc_task_handle_transmitted(task);
2261 return;
2262 }
2263
2264 task->tk_action = call_transmit_status;
2265 if (!xprt_prepare_transmit(task))
2266 return;
2267 task->tk_status = 0;
2268 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2269 if (!xprt_connected(task->tk_xprt)) {
2270 task->tk_status = -ENOTCONN;
2271 return;
2272 }
2273 xprt_transmit(task);
2274 }
2275 xprt_end_transmit(task);
2276}
2277
2278/*
2279 * 5a. Handle cleanup after a transmission
2280 */
2281static void
2282call_transmit_status(struct rpc_task *task)
2283{
2284 task->tk_action = call_status;
2285
2286 /*
2287 * Common case: success. Force the compiler to put this
2288 * test first.
2289 */
2290 if (rpc_task_transmitted(task)) {
2291 task->tk_status = 0;
2292 xprt_request_wait_receive(task);
2293 return;
2294 }
2295
2296 switch (task->tk_status) {
2297 default:
2298 break;
2299 case -EBADMSG:
2300 task->tk_status = 0;
2301 task->tk_action = call_encode;
2302 break;
2303 /*
2304 * Special cases: if we've been waiting on the
2305 * socket's write_space() callback, or if the
2306 * socket just returned a connection error,
2307 * then hold onto the transport lock.
2308 */
2309 case -ENOMEM:
2310 case -ENOBUFS:
2311 rpc_delay(task, HZ>>2);
2312 fallthrough;
2313 case -EBADSLT:
2314 case -EAGAIN:
2315 task->tk_action = call_transmit;
2316 task->tk_status = 0;
2317 break;
2318 case -EHOSTDOWN:
2319 case -ENETDOWN:
2320 case -EHOSTUNREACH:
2321 case -ENETUNREACH:
2322 case -EPERM:
2323 break;
2324 case -ECONNREFUSED:
2325 if (RPC_IS_SOFTCONN(task)) {
2326 if (!task->tk_msg.rpc_proc->p_proc)
2327 trace_xprt_ping(task->tk_xprt,
2328 task->tk_status);
2329 rpc_call_rpcerror(task, task->tk_status);
2330 return;
2331 }
2332 fallthrough;
2333 case -ECONNRESET:
2334 case -ECONNABORTED:
2335 case -EADDRINUSE:
2336 case -ENOTCONN:
2337 case -EPIPE:
2338 task->tk_action = call_bind;
2339 task->tk_status = 0;
2340 break;
2341 }
2342 rpc_check_timeout(task);
2343}
2344
2345#if defined(CONFIG_SUNRPC_BACKCHANNEL)
2346static void call_bc_transmit(struct rpc_task *task);
2347static void call_bc_transmit_status(struct rpc_task *task);
2348
2349static void
2350call_bc_encode(struct rpc_task *task)
2351{
2352 xprt_request_enqueue_transmit(task);
2353 task->tk_action = call_bc_transmit;
2354}
2355
2356/*
2357 * 5b. Send the backchannel RPC reply. On error, drop the reply. In
2358 * addition, disconnect on connectivity errors.
2359 */
2360static void
2361call_bc_transmit(struct rpc_task *task)
2362{
2363 task->tk_action = call_bc_transmit_status;
2364 if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2365 if (!xprt_prepare_transmit(task))
2366 return;
2367 task->tk_status = 0;
2368 xprt_transmit(task);
2369 }
2370 xprt_end_transmit(task);
2371}
2372
2373static void
2374call_bc_transmit_status(struct rpc_task *task)
2375{
2376 struct rpc_rqst *req = task->tk_rqstp;
2377
2378 if (rpc_task_transmitted(task))
2379 task->tk_status = 0;
2380
2381 switch (task->tk_status) {
2382 case 0:
2383 /* Success */
2384 case -ENETDOWN:
2385 case -EHOSTDOWN:
2386 case -EHOSTUNREACH:
2387 case -ENETUNREACH:
2388 case -ECONNRESET:
2389 case -ECONNREFUSED:
2390 case -EADDRINUSE:
2391 case -ENOTCONN:
2392 case -EPIPE:
2393 break;
2394 case -ENOMEM:
2395 case -ENOBUFS:
2396 rpc_delay(task, HZ>>2);
2397 fallthrough;
2398 case -EBADSLT:
2399 case -EAGAIN:
2400 task->tk_status = 0;
2401 task->tk_action = call_bc_transmit;
2402 return;
2403 case -ETIMEDOUT:
2404 /*
2405 * Problem reaching the server. Disconnect and let the
2406 * forechannel reestablish the connection. The server will
2407 * have to retransmit the backchannel request and we'll
2408 * reprocess it. Since these ops are idempotent, there's no
2409 * need to cache our reply at this time.
2410 */
2411 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2412 "error: %d\n", task->tk_status);
2413 xprt_conditional_disconnect(req->rq_xprt,
2414 req->rq_connect_cookie);
2415 break;
2416 default:
2417 /*
2418 * We were unable to reply and will have to drop the
2419 * request. The server should reconnect and retransmit.
2420 */
2421 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2422 "error: %d\n", task->tk_status);
2423 break;
2424 }
2425 task->tk_action = rpc_exit_task;
2426}
2427#endif /* CONFIG_SUNRPC_BACKCHANNEL */
2428
2429/*
2430 * 6. Sort out the RPC call status
2431 */
2432static void
2433call_status(struct rpc_task *task)
2434{
2435 struct rpc_clnt *clnt = task->tk_client;
2436 int status;
2437
2438 if (!task->tk_msg.rpc_proc->p_proc)
2439 trace_xprt_ping(task->tk_xprt, task->tk_status);
2440
2441 status = task->tk_status;
2442 if (status >= 0) {
2443 task->tk_action = call_decode;
2444 return;
2445 }
2446
2447 trace_rpc_call_status(task);
2448 task->tk_status = 0;
2449 switch(status) {
2450 case -EHOSTDOWN:
2451 case -ENETDOWN:
2452 case -EHOSTUNREACH:
2453 case -ENETUNREACH:
2454 case -EPERM:
2455 if (RPC_IS_SOFTCONN(task))
2456 goto out_exit;
2457 /*
2458 * Delay any retries for 3 seconds, then handle as if it
2459 * were a timeout.
2460 */
2461 rpc_delay(task, 3*HZ);
2462 fallthrough;
2463 case -ETIMEDOUT:
2464 break;
2465 case -ECONNREFUSED:
2466 case -ECONNRESET:
2467 case -ECONNABORTED:
2468 case -ENOTCONN:
2469 rpc_force_rebind(clnt);
2470 break;
2471 case -EADDRINUSE:
2472 rpc_delay(task, 3*HZ);
2473 fallthrough;
2474 case -EPIPE:
2475 case -EAGAIN:
2476 break;
2477 case -ENFILE:
2478 case -ENOBUFS:
2479 case -ENOMEM:
2480 rpc_delay(task, HZ>>2);
2481 break;
2482 case -EIO:
2483 /* shutdown or soft timeout */
2484 goto out_exit;
2485 default:
2486 if (clnt->cl_chatty)
2487 printk("%s: RPC call returned error %d\n",
2488 clnt->cl_program->name, -status);
2489 goto out_exit;
2490 }
2491 task->tk_action = call_encode;
2492 rpc_check_timeout(task);
2493 return;
2494out_exit:
2495 rpc_call_rpcerror(task, status);
2496}
2497
2498static bool
2499rpc_check_connected(const struct rpc_rqst *req)
2500{
2501 /* No allocated request or transport? return true */
2502 if (!req || !req->rq_xprt)
2503 return true;
2504 return xprt_connected(req->rq_xprt);
2505}
2506
2507static void
2508rpc_check_timeout(struct rpc_task *task)
2509{
2510 struct rpc_clnt *clnt = task->tk_client;
2511
2512 if (RPC_SIGNALLED(task))
2513 return;
2514
2515 if (xprt_adjust_timeout(task->tk_rqstp) == 0)
2516 return;
2517
2518 trace_rpc_timeout_status(task);
2519 task->tk_timeouts++;
2520
2521 if (RPC_IS_SOFTCONN(task) && !rpc_check_connected(task->tk_rqstp)) {
2522 rpc_call_rpcerror(task, -ETIMEDOUT);
2523 return;
2524 }
2525
2526 if (RPC_IS_SOFT(task)) {
2527 /*
2528 * Once a "no retrans timeout" soft tasks (a.k.a NFSv4) has
2529 * been sent, it should time out only if the transport
2530 * connection gets terminally broken.
2531 */
2532 if ((task->tk_flags & RPC_TASK_NO_RETRANS_TIMEOUT) &&
2533 rpc_check_connected(task->tk_rqstp))
2534 return;
2535
2536 if (clnt->cl_chatty) {
2537 pr_notice_ratelimited(
2538 "%s: server %s not responding, timed out\n",
2539 clnt->cl_program->name,
2540 task->tk_xprt->servername);
2541 }
2542 if (task->tk_flags & RPC_TASK_TIMEOUT)
2543 rpc_call_rpcerror(task, -ETIMEDOUT);
2544 else
2545 __rpc_call_rpcerror(task, -EIO, -ETIMEDOUT);
2546 return;
2547 }
2548
2549 if (!(task->tk_flags & RPC_CALL_MAJORSEEN)) {
2550 task->tk_flags |= RPC_CALL_MAJORSEEN;
2551 if (clnt->cl_chatty) {
2552 pr_notice_ratelimited(
2553 "%s: server %s not responding, still trying\n",
2554 clnt->cl_program->name,
2555 task->tk_xprt->servername);
2556 }
2557 }
2558 rpc_force_rebind(clnt);
2559 /*
2560 * Did our request time out due to an RPCSEC_GSS out-of-sequence
2561 * event? RFC2203 requires the server to drop all such requests.
2562 */
2563 rpcauth_invalcred(task);
2564}
2565
2566/*
2567 * 7. Decode the RPC reply
2568 */
2569static void
2570call_decode(struct rpc_task *task)
2571{
2572 struct rpc_clnt *clnt = task->tk_client;
2573 struct rpc_rqst *req = task->tk_rqstp;
2574 struct xdr_stream xdr;
2575 int err;
2576
2577 if (!task->tk_msg.rpc_proc->p_decode) {
2578 task->tk_action = rpc_exit_task;
2579 return;
2580 }
2581
2582 if (task->tk_flags & RPC_CALL_MAJORSEEN) {
2583 if (clnt->cl_chatty) {
2584 pr_notice_ratelimited("%s: server %s OK\n",
2585 clnt->cl_program->name,
2586 task->tk_xprt->servername);
2587 }
2588 task->tk_flags &= ~RPC_CALL_MAJORSEEN;
2589 }
2590
2591 /*
2592 * Did we ever call xprt_complete_rqst()? If not, we should assume
2593 * the message is incomplete.
2594 */
2595 err = -EAGAIN;
2596 if (!req->rq_reply_bytes_recvd)
2597 goto out;
2598
2599 /* Ensure that we see all writes made by xprt_complete_rqst()
2600 * before it changed req->rq_reply_bytes_recvd.
2601 */
2602 smp_rmb();
2603
2604 req->rq_rcv_buf.len = req->rq_private_buf.len;
2605 trace_rpc_xdr_recvfrom(task, &req->rq_rcv_buf);
2606
2607 /* Check that the softirq receive buffer is valid */
2608 WARN_ON(memcmp(&req->rq_rcv_buf, &req->rq_private_buf,
2609 sizeof(req->rq_rcv_buf)) != 0);
2610
2611 xdr_init_decode(&xdr, &req->rq_rcv_buf,
2612 req->rq_rcv_buf.head[0].iov_base, req);
2613 err = rpc_decode_header(task, &xdr);
2614out:
2615 switch (err) {
2616 case 0:
2617 task->tk_action = rpc_exit_task;
2618 task->tk_status = rpcauth_unwrap_resp(task, &xdr);
2619 xdr_finish_decode(&xdr);
2620 return;
2621 case -EAGAIN:
2622 task->tk_status = 0;
2623 if (task->tk_client->cl_discrtry)
2624 xprt_conditional_disconnect(req->rq_xprt,
2625 req->rq_connect_cookie);
2626 task->tk_action = call_encode;
2627 rpc_check_timeout(task);
2628 break;
2629 case -EKEYREJECTED:
2630 task->tk_action = call_reserve;
2631 rpc_check_timeout(task);
2632 rpcauth_invalcred(task);
2633 /* Ensure we obtain a new XID if we retry! */
2634 xprt_release(task);
2635 }
2636}
2637
2638static int
2639rpc_encode_header(struct rpc_task *task, struct xdr_stream *xdr)
2640{
2641 struct rpc_clnt *clnt = task->tk_client;
2642 struct rpc_rqst *req = task->tk_rqstp;
2643 __be32 *p;
2644 int error;
2645
2646 error = -EMSGSIZE;
2647 p = xdr_reserve_space(xdr, RPC_CALLHDRSIZE << 2);
2648 if (!p)
2649 goto out_fail;
2650 *p++ = req->rq_xid;
2651 *p++ = rpc_call;
2652 *p++ = cpu_to_be32(RPC_VERSION);
2653 *p++ = cpu_to_be32(clnt->cl_prog);
2654 *p++ = cpu_to_be32(clnt->cl_vers);
2655 *p = cpu_to_be32(task->tk_msg.rpc_proc->p_proc);
2656
2657 error = rpcauth_marshcred(task, xdr);
2658 if (error < 0)
2659 goto out_fail;
2660 return 0;
2661out_fail:
2662 trace_rpc_bad_callhdr(task);
2663 rpc_call_rpcerror(task, error);
2664 return error;
2665}
2666
2667static noinline int
2668rpc_decode_header(struct rpc_task *task, struct xdr_stream *xdr)
2669{
2670 struct rpc_clnt *clnt = task->tk_client;
2671 int error;
2672 __be32 *p;
2673
2674 /* RFC-1014 says that the representation of XDR data must be a
2675 * multiple of four bytes
2676 * - if it isn't pointer subtraction in the NFS client may give
2677 * undefined results
2678 */
2679 if (task->tk_rqstp->rq_rcv_buf.len & 3)
2680 goto out_unparsable;
2681
2682 p = xdr_inline_decode(xdr, 3 * sizeof(*p));
2683 if (!p)
2684 goto out_unparsable;
2685 p++; /* skip XID */
2686 if (*p++ != rpc_reply)
2687 goto out_unparsable;
2688 if (*p++ != rpc_msg_accepted)
2689 goto out_msg_denied;
2690
2691 error = rpcauth_checkverf(task, xdr);
2692 if (error) {
2693 struct rpc_cred *cred = task->tk_rqstp->rq_cred;
2694
2695 if (!test_bit(RPCAUTH_CRED_UPTODATE, &cred->cr_flags)) {
2696 rpcauth_invalcred(task);
2697 if (!task->tk_cred_retry)
2698 goto out_err;
2699 task->tk_cred_retry--;
2700 trace_rpc__stale_creds(task);
2701 return -EKEYREJECTED;
2702 }
2703 goto out_verifier;
2704 }
2705
2706 p = xdr_inline_decode(xdr, sizeof(*p));
2707 if (!p)
2708 goto out_unparsable;
2709 switch (*p) {
2710 case rpc_success:
2711 return 0;
2712 case rpc_prog_unavail:
2713 trace_rpc__prog_unavail(task);
2714 error = -EPFNOSUPPORT;
2715 goto out_err;
2716 case rpc_prog_mismatch:
2717 trace_rpc__prog_mismatch(task);
2718 error = -EPROTONOSUPPORT;
2719 goto out_err;
2720 case rpc_proc_unavail:
2721 trace_rpc__proc_unavail(task);
2722 error = -EOPNOTSUPP;
2723 goto out_err;
2724 case rpc_garbage_args:
2725 case rpc_system_err:
2726 trace_rpc__garbage_args(task);
2727 error = -EIO;
2728 break;
2729 default:
2730 goto out_unparsable;
2731 }
2732
2733out_garbage:
2734 clnt->cl_stats->rpcgarbage++;
2735 if (task->tk_garb_retry) {
2736 task->tk_garb_retry--;
2737 task->tk_action = call_encode;
2738 return -EAGAIN;
2739 }
2740out_err:
2741 rpc_call_rpcerror(task, error);
2742 return error;
2743
2744out_unparsable:
2745 trace_rpc__unparsable(task);
2746 error = -EIO;
2747 goto out_garbage;
2748
2749out_verifier:
2750 trace_rpc_bad_verifier(task);
2751 switch (error) {
2752 case -EPROTONOSUPPORT:
2753 goto out_err;
2754 case -EACCES:
2755 /* Re-encode with a fresh cred */
2756 fallthrough;
2757 default:
2758 goto out_garbage;
2759 }
2760
2761out_msg_denied:
2762 error = -EACCES;
2763 p = xdr_inline_decode(xdr, sizeof(*p));
2764 if (!p)
2765 goto out_unparsable;
2766 switch (*p++) {
2767 case rpc_auth_error:
2768 break;
2769 case rpc_mismatch:
2770 trace_rpc__mismatch(task);
2771 error = -EPROTONOSUPPORT;
2772 goto out_err;
2773 default:
2774 goto out_unparsable;
2775 }
2776
2777 p = xdr_inline_decode(xdr, sizeof(*p));
2778 if (!p)
2779 goto out_unparsable;
2780 switch (*p++) {
2781 case rpc_autherr_rejectedcred:
2782 case rpc_autherr_rejectedverf:
2783 case rpcsec_gsserr_credproblem:
2784 case rpcsec_gsserr_ctxproblem:
2785 rpcauth_invalcred(task);
2786 if (!task->tk_cred_retry)
2787 break;
2788 task->tk_cred_retry--;
2789 trace_rpc__stale_creds(task);
2790 return -EKEYREJECTED;
2791 case rpc_autherr_badcred:
2792 case rpc_autherr_badverf:
2793 /* possibly garbled cred/verf? */
2794 if (!task->tk_garb_retry)
2795 break;
2796 task->tk_garb_retry--;
2797 trace_rpc__bad_creds(task);
2798 task->tk_action = call_encode;
2799 return -EAGAIN;
2800 case rpc_autherr_tooweak:
2801 trace_rpc__auth_tooweak(task);
2802 pr_warn("RPC: server %s requires stronger authentication.\n",
2803 task->tk_xprt->servername);
2804 break;
2805 default:
2806 goto out_unparsable;
2807 }
2808 goto out_err;
2809}
2810
2811static void rpcproc_encode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2812 const void *obj)
2813{
2814}
2815
2816static int rpcproc_decode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2817 void *obj)
2818{
2819 return 0;
2820}
2821
2822static const struct rpc_procinfo rpcproc_null = {
2823 .p_encode = rpcproc_encode_null,
2824 .p_decode = rpcproc_decode_null,
2825};
2826
2827static const struct rpc_procinfo rpcproc_null_noreply = {
2828 .p_encode = rpcproc_encode_null,
2829};
2830
2831static void
2832rpc_null_call_prepare(struct rpc_task *task, void *data)
2833{
2834 task->tk_flags &= ~RPC_TASK_NO_RETRANS_TIMEOUT;
2835 rpc_call_start(task);
2836}
2837
2838static const struct rpc_call_ops rpc_null_ops = {
2839 .rpc_call_prepare = rpc_null_call_prepare,
2840 .rpc_call_done = rpc_default_callback,
2841};
2842
2843static
2844struct rpc_task *rpc_call_null_helper(struct rpc_clnt *clnt,
2845 struct rpc_xprt *xprt, struct rpc_cred *cred, int flags,
2846 const struct rpc_call_ops *ops, void *data)
2847{
2848 struct rpc_message msg = {
2849 .rpc_proc = &rpcproc_null,
2850 };
2851 struct rpc_task_setup task_setup_data = {
2852 .rpc_client = clnt,
2853 .rpc_xprt = xprt,
2854 .rpc_message = &msg,
2855 .rpc_op_cred = cred,
2856 .callback_ops = ops ?: &rpc_null_ops,
2857 .callback_data = data,
2858 .flags = flags | RPC_TASK_SOFT | RPC_TASK_SOFTCONN |
2859 RPC_TASK_NULLCREDS,
2860 };
2861
2862 return rpc_run_task(&task_setup_data);
2863}
2864
2865struct rpc_task *rpc_call_null(struct rpc_clnt *clnt, struct rpc_cred *cred, int flags)
2866{
2867 return rpc_call_null_helper(clnt, NULL, cred, flags, NULL, NULL);
2868}
2869EXPORT_SYMBOL_GPL(rpc_call_null);
2870
2871static int rpc_ping(struct rpc_clnt *clnt)
2872{
2873 struct rpc_task *task;
2874 int status;
2875
2876 if (clnt->cl_auth->au_ops->ping)
2877 return clnt->cl_auth->au_ops->ping(clnt);
2878
2879 task = rpc_call_null_helper(clnt, NULL, NULL, 0, NULL, NULL);
2880 if (IS_ERR(task))
2881 return PTR_ERR(task);
2882 status = task->tk_status;
2883 rpc_put_task(task);
2884 return status;
2885}
2886
2887static int rpc_ping_noreply(struct rpc_clnt *clnt)
2888{
2889 struct rpc_message msg = {
2890 .rpc_proc = &rpcproc_null_noreply,
2891 };
2892 struct rpc_task_setup task_setup_data = {
2893 .rpc_client = clnt,
2894 .rpc_message = &msg,
2895 .callback_ops = &rpc_null_ops,
2896 .flags = RPC_TASK_SOFT | RPC_TASK_SOFTCONN | RPC_TASK_NULLCREDS,
2897 };
2898 struct rpc_task *task;
2899 int status;
2900
2901 task = rpc_run_task(&task_setup_data);
2902 if (IS_ERR(task))
2903 return PTR_ERR(task);
2904 status = task->tk_status;
2905 rpc_put_task(task);
2906 return status;
2907}
2908
2909struct rpc_cb_add_xprt_calldata {
2910 struct rpc_xprt_switch *xps;
2911 struct rpc_xprt *xprt;
2912};
2913
2914static void rpc_cb_add_xprt_done(struct rpc_task *task, void *calldata)
2915{
2916 struct rpc_cb_add_xprt_calldata *data = calldata;
2917
2918 if (task->tk_status == 0)
2919 rpc_xprt_switch_add_xprt(data->xps, data->xprt);
2920}
2921
2922static void rpc_cb_add_xprt_release(void *calldata)
2923{
2924 struct rpc_cb_add_xprt_calldata *data = calldata;
2925
2926 xprt_put(data->xprt);
2927 xprt_switch_put(data->xps);
2928 kfree(data);
2929}
2930
2931static const struct rpc_call_ops rpc_cb_add_xprt_call_ops = {
2932 .rpc_call_prepare = rpc_null_call_prepare,
2933 .rpc_call_done = rpc_cb_add_xprt_done,
2934 .rpc_release = rpc_cb_add_xprt_release,
2935};
2936
2937/**
2938 * rpc_clnt_test_and_add_xprt - Test and add a new transport to a rpc_clnt
2939 * @clnt: pointer to struct rpc_clnt
2940 * @xps: pointer to struct rpc_xprt_switch,
2941 * @xprt: pointer struct rpc_xprt
2942 * @in_max_connect: pointer to the max_connect value for the passed in xprt transport
2943 */
2944int rpc_clnt_test_and_add_xprt(struct rpc_clnt *clnt,
2945 struct rpc_xprt_switch *xps, struct rpc_xprt *xprt,
2946 void *in_max_connect)
2947{
2948 struct rpc_cb_add_xprt_calldata *data;
2949 struct rpc_task *task;
2950 int max_connect = clnt->cl_max_connect;
2951
2952 if (in_max_connect)
2953 max_connect = *(int *)in_max_connect;
2954 if (xps->xps_nunique_destaddr_xprts + 1 > max_connect) {
2955 rcu_read_lock();
2956 pr_warn("SUNRPC: reached max allowed number (%d) did not add "
2957 "transport to server: %s\n", max_connect,
2958 rpc_peeraddr2str(clnt, RPC_DISPLAY_ADDR));
2959 rcu_read_unlock();
2960 return -EINVAL;
2961 }
2962
2963 data = kmalloc(sizeof(*data), GFP_KERNEL);
2964 if (!data)
2965 return -ENOMEM;
2966 data->xps = xprt_switch_get(xps);
2967 data->xprt = xprt_get(xprt);
2968 if (rpc_xprt_switch_has_addr(data->xps, (struct sockaddr *)&xprt->addr)) {
2969 rpc_cb_add_xprt_release(data);
2970 goto success;
2971 }
2972
2973 task = rpc_call_null_helper(clnt, xprt, NULL, RPC_TASK_ASYNC,
2974 &rpc_cb_add_xprt_call_ops, data);
2975 if (IS_ERR(task))
2976 return PTR_ERR(task);
2977
2978 data->xps->xps_nunique_destaddr_xprts++;
2979 rpc_put_task(task);
2980success:
2981 return 1;
2982}
2983EXPORT_SYMBOL_GPL(rpc_clnt_test_and_add_xprt);
2984
2985static int rpc_clnt_add_xprt_helper(struct rpc_clnt *clnt,
2986 struct rpc_xprt *xprt,
2987 struct rpc_add_xprt_test *data)
2988{
2989 struct rpc_task *task;
2990 int status = -EADDRINUSE;
2991
2992 /* Test the connection */
2993 task = rpc_call_null_helper(clnt, xprt, NULL, 0, NULL, NULL);
2994 if (IS_ERR(task))
2995 return PTR_ERR(task);
2996
2997 status = task->tk_status;
2998 rpc_put_task(task);
2999
3000 if (status < 0)
3001 return status;
3002
3003 /* rpc_xprt_switch and rpc_xprt are deferrenced by add_xprt_test() */
3004 data->add_xprt_test(clnt, xprt, data->data);
3005
3006 return 0;
3007}
3008
3009/**
3010 * rpc_clnt_setup_test_and_add_xprt()
3011 *
3012 * This is an rpc_clnt_add_xprt setup() function which returns 1 so:
3013 * 1) caller of the test function must dereference the rpc_xprt_switch
3014 * and the rpc_xprt.
3015 * 2) test function must call rpc_xprt_switch_add_xprt, usually in
3016 * the rpc_call_done routine.
3017 *
3018 * Upon success (return of 1), the test function adds the new
3019 * transport to the rpc_clnt xprt switch
3020 *
3021 * @clnt: struct rpc_clnt to get the new transport
3022 * @xps: the rpc_xprt_switch to hold the new transport
3023 * @xprt: the rpc_xprt to test
3024 * @data: a struct rpc_add_xprt_test pointer that holds the test function
3025 * and test function call data
3026 */
3027int rpc_clnt_setup_test_and_add_xprt(struct rpc_clnt *clnt,
3028 struct rpc_xprt_switch *xps,
3029 struct rpc_xprt *xprt,
3030 void *data)
3031{
3032 int status = -EADDRINUSE;
3033
3034 xprt = xprt_get(xprt);
3035 xprt_switch_get(xps);
3036
3037 if (rpc_xprt_switch_has_addr(xps, (struct sockaddr *)&xprt->addr))
3038 goto out_err;
3039
3040 status = rpc_clnt_add_xprt_helper(clnt, xprt, data);
3041 if (status < 0)
3042 goto out_err;
3043
3044 status = 1;
3045out_err:
3046 xprt_put(xprt);
3047 xprt_switch_put(xps);
3048 if (status < 0)
3049 pr_info("RPC: rpc_clnt_test_xprt failed: %d addr %s not "
3050 "added\n", status,
3051 xprt->address_strings[RPC_DISPLAY_ADDR]);
3052 /* so that rpc_clnt_add_xprt does not call rpc_xprt_switch_add_xprt */
3053 return status;
3054}
3055EXPORT_SYMBOL_GPL(rpc_clnt_setup_test_and_add_xprt);
3056
3057/**
3058 * rpc_clnt_add_xprt - Add a new transport to a rpc_clnt
3059 * @clnt: pointer to struct rpc_clnt
3060 * @xprtargs: pointer to struct xprt_create
3061 * @setup: callback to test and/or set up the connection
3062 * @data: pointer to setup function data
3063 *
3064 * Creates a new transport using the parameters set in args and
3065 * adds it to clnt.
3066 * If ping is set, then test that connectivity succeeds before
3067 * adding the new transport.
3068 *
3069 */
3070int rpc_clnt_add_xprt(struct rpc_clnt *clnt,
3071 struct xprt_create *xprtargs,
3072 int (*setup)(struct rpc_clnt *,
3073 struct rpc_xprt_switch *,
3074 struct rpc_xprt *,
3075 void *),
3076 void *data)
3077{
3078 struct rpc_xprt_switch *xps;
3079 struct rpc_xprt *xprt;
3080 unsigned long connect_timeout;
3081 unsigned long reconnect_timeout;
3082 unsigned char resvport, reuseport;
3083 int ret = 0, ident;
3084
3085 rcu_read_lock();
3086 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
3087 xprt = xprt_iter_xprt(&clnt->cl_xpi);
3088 if (xps == NULL || xprt == NULL) {
3089 rcu_read_unlock();
3090 xprt_switch_put(xps);
3091 return -EAGAIN;
3092 }
3093 resvport = xprt->resvport;
3094 reuseport = xprt->reuseport;
3095 connect_timeout = xprt->connect_timeout;
3096 reconnect_timeout = xprt->max_reconnect_timeout;
3097 ident = xprt->xprt_class->ident;
3098 rcu_read_unlock();
3099
3100 if (!xprtargs->ident)
3101 xprtargs->ident = ident;
3102 xprtargs->xprtsec = clnt->cl_xprtsec;
3103 xprt = xprt_create_transport(xprtargs);
3104 if (IS_ERR(xprt)) {
3105 ret = PTR_ERR(xprt);
3106 goto out_put_switch;
3107 }
3108 xprt->resvport = resvport;
3109 xprt->reuseport = reuseport;
3110
3111 if (xprtargs->connect_timeout)
3112 connect_timeout = xprtargs->connect_timeout;
3113 if (xprtargs->reconnect_timeout)
3114 reconnect_timeout = xprtargs->reconnect_timeout;
3115 if (xprt->ops->set_connect_timeout != NULL)
3116 xprt->ops->set_connect_timeout(xprt,
3117 connect_timeout,
3118 reconnect_timeout);
3119
3120 rpc_xprt_switch_set_roundrobin(xps);
3121 if (setup) {
3122 ret = setup(clnt, xps, xprt, data);
3123 if (ret != 0)
3124 goto out_put_xprt;
3125 }
3126 rpc_xprt_switch_add_xprt(xps, xprt);
3127out_put_xprt:
3128 xprt_put(xprt);
3129out_put_switch:
3130 xprt_switch_put(xps);
3131 return ret;
3132}
3133EXPORT_SYMBOL_GPL(rpc_clnt_add_xprt);
3134
3135static int rpc_xprt_probe_trunked(struct rpc_clnt *clnt,
3136 struct rpc_xprt *xprt,
3137 struct rpc_add_xprt_test *data)
3138{
3139 struct rpc_xprt *main_xprt;
3140 int status = 0;
3141
3142 xprt_get(xprt);
3143
3144 rcu_read_lock();
3145 main_xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
3146 status = rpc_cmp_addr_port((struct sockaddr *)&xprt->addr,
3147 (struct sockaddr *)&main_xprt->addr);
3148 rcu_read_unlock();
3149 xprt_put(main_xprt);
3150 if (status || !test_bit(XPRT_OFFLINE, &xprt->state))
3151 goto out;
3152
3153 status = rpc_clnt_add_xprt_helper(clnt, xprt, data);
3154out:
3155 xprt_put(xprt);
3156 return status;
3157}
3158
3159/* rpc_clnt_probe_trunked_xprt -- probe offlined transport for session trunking
3160 * @clnt rpc_clnt structure
3161 *
3162 * For each offlined transport found in the rpc_clnt structure call
3163 * the function rpc_xprt_probe_trunked() which will determine if this
3164 * transport still belongs to the trunking group.
3165 */
3166void rpc_clnt_probe_trunked_xprts(struct rpc_clnt *clnt,
3167 struct rpc_add_xprt_test *data)
3168{
3169 struct rpc_xprt_iter xpi;
3170 int ret;
3171
3172 ret = rpc_clnt_xprt_iter_offline_init(clnt, &xpi);
3173 if (ret)
3174 return;
3175 for (;;) {
3176 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
3177
3178 if (!xprt)
3179 break;
3180 ret = rpc_xprt_probe_trunked(clnt, xprt, data);
3181 xprt_put(xprt);
3182 if (ret < 0)
3183 break;
3184 xprt_iter_rewind(&xpi);
3185 }
3186 xprt_iter_destroy(&xpi);
3187}
3188EXPORT_SYMBOL_GPL(rpc_clnt_probe_trunked_xprts);
3189
3190static int rpc_xprt_offline(struct rpc_clnt *clnt,
3191 struct rpc_xprt *xprt,
3192 void *data)
3193{
3194 struct rpc_xprt *main_xprt;
3195 struct rpc_xprt_switch *xps;
3196 int err = 0;
3197
3198 xprt_get(xprt);
3199
3200 rcu_read_lock();
3201 main_xprt = xprt_get(rcu_dereference(clnt->cl_xprt));
3202 xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
3203 err = rpc_cmp_addr_port((struct sockaddr *)&xprt->addr,
3204 (struct sockaddr *)&main_xprt->addr);
3205 rcu_read_unlock();
3206 xprt_put(main_xprt);
3207 if (err)
3208 goto out;
3209
3210 if (wait_on_bit_lock(&xprt->state, XPRT_LOCKED, TASK_KILLABLE)) {
3211 err = -EINTR;
3212 goto out;
3213 }
3214 xprt_set_offline_locked(xprt, xps);
3215
3216 xprt_release_write(xprt, NULL);
3217out:
3218 xprt_put(xprt);
3219 xprt_switch_put(xps);
3220 return err;
3221}
3222
3223/* rpc_clnt_manage_trunked_xprts -- offline trunked transports
3224 * @clnt rpc_clnt structure
3225 *
3226 * For each active transport found in the rpc_clnt structure call
3227 * the function rpc_xprt_offline() which will identify trunked transports
3228 * and will mark them offline.
3229 */
3230void rpc_clnt_manage_trunked_xprts(struct rpc_clnt *clnt)
3231{
3232 rpc_clnt_iterate_for_each_xprt(clnt, rpc_xprt_offline, NULL);
3233}
3234EXPORT_SYMBOL_GPL(rpc_clnt_manage_trunked_xprts);
3235
3236struct connect_timeout_data {
3237 unsigned long connect_timeout;
3238 unsigned long reconnect_timeout;
3239};
3240
3241static int
3242rpc_xprt_set_connect_timeout(struct rpc_clnt *clnt,
3243 struct rpc_xprt *xprt,
3244 void *data)
3245{
3246 struct connect_timeout_data *timeo = data;
3247
3248 if (xprt->ops->set_connect_timeout)
3249 xprt->ops->set_connect_timeout(xprt,
3250 timeo->connect_timeout,
3251 timeo->reconnect_timeout);
3252 return 0;
3253}
3254
3255void
3256rpc_set_connect_timeout(struct rpc_clnt *clnt,
3257 unsigned long connect_timeout,
3258 unsigned long reconnect_timeout)
3259{
3260 struct connect_timeout_data timeout = {
3261 .connect_timeout = connect_timeout,
3262 .reconnect_timeout = reconnect_timeout,
3263 };
3264 rpc_clnt_iterate_for_each_xprt(clnt,
3265 rpc_xprt_set_connect_timeout,
3266 &timeout);
3267}
3268EXPORT_SYMBOL_GPL(rpc_set_connect_timeout);
3269
3270void rpc_clnt_xprt_set_online(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3271{
3272 struct rpc_xprt_switch *xps;
3273
3274 xps = rpc_clnt_xprt_switch_get(clnt);
3275 xprt_set_online_locked(xprt, xps);
3276 xprt_switch_put(xps);
3277}
3278
3279void rpc_clnt_xprt_switch_add_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3280{
3281 struct rpc_xprt_switch *xps;
3282
3283 if (rpc_clnt_xprt_switch_has_addr(clnt,
3284 (const struct sockaddr *)&xprt->addr)) {
3285 return rpc_clnt_xprt_set_online(clnt, xprt);
3286 }
3287
3288 xps = rpc_clnt_xprt_switch_get(clnt);
3289 rpc_xprt_switch_add_xprt(xps, xprt);
3290 xprt_switch_put(xps);
3291}
3292EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_add_xprt);
3293
3294void rpc_clnt_xprt_switch_remove_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
3295{
3296 struct rpc_xprt_switch *xps;
3297
3298 rcu_read_lock();
3299 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
3300 rpc_xprt_switch_remove_xprt(rcu_dereference(clnt->cl_xpi.xpi_xpswitch),
3301 xprt, 0);
3302 xps->xps_nunique_destaddr_xprts--;
3303 rcu_read_unlock();
3304}
3305EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_remove_xprt);
3306
3307bool rpc_clnt_xprt_switch_has_addr(struct rpc_clnt *clnt,
3308 const struct sockaddr *sap)
3309{
3310 struct rpc_xprt_switch *xps;
3311 bool ret;
3312
3313 rcu_read_lock();
3314 xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
3315 ret = rpc_xprt_switch_has_addr(xps, sap);
3316 rcu_read_unlock();
3317 return ret;
3318}
3319EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_has_addr);
3320
3321#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
3322static void rpc_show_header(void)
3323{
3324 printk(KERN_INFO "-pid- flgs status -client- --rqstp- "
3325 "-timeout ---ops--\n");
3326}
3327
3328static void rpc_show_task(const struct rpc_clnt *clnt,
3329 const struct rpc_task *task)
3330{
3331 const char *rpc_waitq = "none";
3332
3333 if (RPC_IS_QUEUED(task))
3334 rpc_waitq = rpc_qname(task->tk_waitqueue);
3335
3336 printk(KERN_INFO "%5u %04x %6d %8p %8p %8ld %8p %sv%u %s a:%ps q:%s\n",
3337 task->tk_pid, task->tk_flags, task->tk_status,
3338 clnt, task->tk_rqstp, rpc_task_timeout(task), task->tk_ops,
3339 clnt->cl_program->name, clnt->cl_vers, rpc_proc_name(task),
3340 task->tk_action, rpc_waitq);
3341}
3342
3343void rpc_show_tasks(struct net *net)
3344{
3345 struct rpc_clnt *clnt;
3346 struct rpc_task *task;
3347 int header = 0;
3348 struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
3349
3350 spin_lock(&sn->rpc_client_lock);
3351 list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
3352 spin_lock(&clnt->cl_lock);
3353 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
3354 if (!header) {
3355 rpc_show_header();
3356 header++;
3357 }
3358 rpc_show_task(clnt, task);
3359 }
3360 spin_unlock(&clnt->cl_lock);
3361 }
3362 spin_unlock(&sn->rpc_client_lock);
3363}
3364#endif
3365
3366#if IS_ENABLED(CONFIG_SUNRPC_SWAP)
3367static int
3368rpc_clnt_swap_activate_callback(struct rpc_clnt *clnt,
3369 struct rpc_xprt *xprt,
3370 void *dummy)
3371{
3372 return xprt_enable_swap(xprt);
3373}
3374
3375int
3376rpc_clnt_swap_activate(struct rpc_clnt *clnt)
3377{
3378 while (clnt != clnt->cl_parent)
3379 clnt = clnt->cl_parent;
3380 if (atomic_inc_return(&clnt->cl_swapper) == 1)
3381 return rpc_clnt_iterate_for_each_xprt(clnt,
3382 rpc_clnt_swap_activate_callback, NULL);
3383 return 0;
3384}
3385EXPORT_SYMBOL_GPL(rpc_clnt_swap_activate);
3386
3387static int
3388rpc_clnt_swap_deactivate_callback(struct rpc_clnt *clnt,
3389 struct rpc_xprt *xprt,
3390 void *dummy)
3391{
3392 xprt_disable_swap(xprt);
3393 return 0;
3394}
3395
3396void
3397rpc_clnt_swap_deactivate(struct rpc_clnt *clnt)
3398{
3399 while (clnt != clnt->cl_parent)
3400 clnt = clnt->cl_parent;
3401 if (atomic_dec_if_positive(&clnt->cl_swapper) == 0)
3402 rpc_clnt_iterate_for_each_xprt(clnt,
3403 rpc_clnt_swap_deactivate_callback, NULL);
3404}
3405EXPORT_SYMBOL_GPL(rpc_clnt_swap_deactivate);
3406#endif /* CONFIG_SUNRPC_SWAP */