4216fe33204a8e3f2634cae5ed2329335b1885da
[linux-2.6-microblaze.git] / net / sunrpc / clnt.c
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
57 static DECLARE_WAIT_QUEUE_HEAD(destroy_wait);
58
59
60 static void     call_start(struct rpc_task *task);
61 static void     call_reserve(struct rpc_task *task);
62 static void     call_reserveresult(struct rpc_task *task);
63 static void     call_allocate(struct rpc_task *task);
64 static void     call_encode(struct rpc_task *task);
65 static void     call_decode(struct rpc_task *task);
66 static void     call_bind(struct rpc_task *task);
67 static void     call_bind_status(struct rpc_task *task);
68 static void     call_transmit(struct rpc_task *task);
69 static void     call_status(struct rpc_task *task);
70 static void     call_transmit_status(struct rpc_task *task);
71 static void     call_refresh(struct rpc_task *task);
72 static void     call_refreshresult(struct rpc_task *task);
73 static void     call_connect(struct rpc_task *task);
74 static void     call_connect_status(struct rpc_task *task);
75
76 static int      rpc_encode_header(struct rpc_task *task,
77                                   struct xdr_stream *xdr);
78 static int      rpc_decode_header(struct rpc_task *task,
79                                   struct xdr_stream *xdr);
80 static int      rpc_ping(struct rpc_clnt *clnt);
81 static void     rpc_check_timeout(struct rpc_task *task);
82
83 static 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
93 static 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
103 static void __rpc_clnt_remove_pipedir(struct rpc_clnt *clnt)
104 {
105         rpc_remove_client_dir(clnt);
106 }
107
108 static 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
120 static 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
150 static int
151 rpc_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
163 static 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
183 static 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
206 static 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
220 static 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
236 static 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
251 static struct notifier_block rpc_clients_block = {
252         .notifier_call  = rpc_pipefs_event,
253         .priority       = SUNRPC_PIPEFS_RPC_PRIO,
254 };
255
256 int rpc_clients_notifier_register(void)
257 {
258         return rpc_pipefs_notifier_register(&rpc_clients_block);
259 }
260
261 void rpc_clients_notifier_unregister(void)
262 {
263         return rpc_pipefs_notifier_unregister(&rpc_clients_block);
264 }
265
266 static 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
286 static 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
292 static 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;
326 err_auth:
327         pipefs_sb = rpc_get_sb_net(net);
328         rpc_unregister_client(clnt);
329         __rpc_clnt_remove_pipedir(clnt);
330 out:
331         if (pipefs_sb)
332                 rpc_put_sb_net(net);
333         rpc_clnt_debugfs_unregister(clnt);
334         return err;
335 }
336
337 static DEFINE_IDA(rpc_clids);
338
339 void rpc_cleanup_clids(void)
340 {
341         ida_destroy(&rpc_clids);
342 }
343
344 static 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
355 static void rpc_free_clid(struct rpc_clnt *clnt)
356 {
357         ida_simple_remove(&rpc_clids, clnt->cl_clid);
358 }
359
360 static 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
439 out_no_path:
440         rpc_free_iostats(clnt->cl_metrics);
441 out_no_stats:
442         rpc_free_clid(clnt);
443 out_no_clid:
444         kfree(clnt);
445 out_err:
446         rpciod_down();
447 out_no_rpciod:
448         xprt_switch_put(xps);
449         xprt_put(xprt);
450         return ERR_PTR(err);
451 }
452
453 static 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  */
512 struct 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 }
589 EXPORT_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  */
596 static 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         new->cl_principal = clnt->cl_principal;
630         return new;
631
632 out_err:
633         dprintk("RPC:       %s: returned error %d\n", __func__, err);
634         return ERR_PTR(err);
635 }
636
637 /**
638  * rpc_clone_client - Clone an RPC client structure
639  *
640  * @clnt: RPC client whose parameters are copied
641  *
642  * Returns a fresh RPC client or an ERR_PTR.
643  */
644 struct rpc_clnt *rpc_clone_client(struct rpc_clnt *clnt)
645 {
646         struct rpc_create_args args = {
647                 .program        = clnt->cl_program,
648                 .prognumber     = clnt->cl_prog,
649                 .version        = clnt->cl_vers,
650                 .authflavor     = clnt->cl_auth->au_flavor,
651         };
652         return __rpc_clone_client(&args, clnt);
653 }
654 EXPORT_SYMBOL_GPL(rpc_clone_client);
655
656 /**
657  * rpc_clone_client_set_auth - Clone an RPC client structure and set its auth
658  *
659  * @clnt: RPC client whose parameters are copied
660  * @flavor: security flavor for new client
661  *
662  * Returns a fresh RPC client or an ERR_PTR.
663  */
664 struct rpc_clnt *
665 rpc_clone_client_set_auth(struct rpc_clnt *clnt, rpc_authflavor_t flavor)
666 {
667         struct rpc_create_args args = {
668                 .program        = clnt->cl_program,
669                 .prognumber     = clnt->cl_prog,
670                 .version        = clnt->cl_vers,
671                 .authflavor     = flavor,
672         };
673         return __rpc_clone_client(&args, clnt);
674 }
675 EXPORT_SYMBOL_GPL(rpc_clone_client_set_auth);
676
677 /**
678  * rpc_switch_client_transport: switch the RPC transport on the fly
679  * @clnt: pointer to a struct rpc_clnt
680  * @args: pointer to the new transport arguments
681  * @timeout: pointer to the new timeout parameters
682  *
683  * This function allows the caller to switch the RPC transport for the
684  * rpc_clnt structure 'clnt' to allow it to connect to a mirrored NFS
685  * server, for instance.  It assumes that the caller has ensured that
686  * there are no active RPC tasks by using some form of locking.
687  *
688  * Returns zero if "clnt" is now using the new xprt.  Otherwise a
689  * negative errno is returned, and "clnt" continues to use the old
690  * xprt.
691  */
692 int rpc_switch_client_transport(struct rpc_clnt *clnt,
693                 struct xprt_create *args,
694                 const struct rpc_timeout *timeout)
695 {
696         const struct rpc_timeout *old_timeo;
697         rpc_authflavor_t pseudoflavor;
698         struct rpc_xprt_switch *xps, *oldxps;
699         struct rpc_xprt *xprt, *old;
700         struct rpc_clnt *parent;
701         int err;
702
703         xprt = xprt_create_transport(args);
704         if (IS_ERR(xprt)) {
705                 dprintk("RPC:       failed to create new xprt for clnt %p\n",
706                         clnt);
707                 return PTR_ERR(xprt);
708         }
709
710         xps = xprt_switch_alloc(xprt, GFP_KERNEL);
711         if (xps == NULL) {
712                 xprt_put(xprt);
713                 return -ENOMEM;
714         }
715
716         pseudoflavor = clnt->cl_auth->au_flavor;
717
718         old_timeo = clnt->cl_timeout;
719         old = rpc_clnt_set_transport(clnt, xprt, timeout);
720         oldxps = xprt_iter_xchg_switch(&clnt->cl_xpi, xps);
721
722         rpc_unregister_client(clnt);
723         __rpc_clnt_remove_pipedir(clnt);
724         rpc_clnt_debugfs_unregister(clnt);
725
726         /*
727          * A new transport was created.  "clnt" therefore
728          * becomes the root of a new cl_parent tree.  clnt's
729          * children, if it has any, still point to the old xprt.
730          */
731         parent = clnt->cl_parent;
732         clnt->cl_parent = clnt;
733
734         /*
735          * The old rpc_auth cache cannot be re-used.  GSS
736          * contexts in particular are between a single
737          * client and server.
738          */
739         err = rpc_client_register(clnt, pseudoflavor, NULL);
740         if (err)
741                 goto out_revert;
742
743         synchronize_rcu();
744         if (parent != clnt)
745                 rpc_release_client(parent);
746         xprt_switch_put(oldxps);
747         xprt_put(old);
748         dprintk("RPC:       replaced xprt for clnt %p\n", clnt);
749         return 0;
750
751 out_revert:
752         xps = xprt_iter_xchg_switch(&clnt->cl_xpi, oldxps);
753         rpc_clnt_set_transport(clnt, old, old_timeo);
754         clnt->cl_parent = parent;
755         rpc_client_register(clnt, pseudoflavor, NULL);
756         xprt_switch_put(xps);
757         xprt_put(xprt);
758         dprintk("RPC:       failed to switch xprt for clnt %p\n", clnt);
759         return err;
760 }
761 EXPORT_SYMBOL_GPL(rpc_switch_client_transport);
762
763 static
764 int rpc_clnt_xprt_iter_init(struct rpc_clnt *clnt, struct rpc_xprt_iter *xpi)
765 {
766         struct rpc_xprt_switch *xps;
767
768         rcu_read_lock();
769         xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
770         rcu_read_unlock();
771         if (xps == NULL)
772                 return -EAGAIN;
773         xprt_iter_init_listall(xpi, xps);
774         xprt_switch_put(xps);
775         return 0;
776 }
777
778 /**
779  * rpc_clnt_iterate_for_each_xprt - Apply a function to all transports
780  * @clnt: pointer to client
781  * @fn: function to apply
782  * @data: void pointer to function data
783  *
784  * Iterates through the list of RPC transports currently attached to the
785  * client and applies the function fn(clnt, xprt, data).
786  *
787  * On error, the iteration stops, and the function returns the error value.
788  */
789 int rpc_clnt_iterate_for_each_xprt(struct rpc_clnt *clnt,
790                 int (*fn)(struct rpc_clnt *, struct rpc_xprt *, void *),
791                 void *data)
792 {
793         struct rpc_xprt_iter xpi;
794         int ret;
795
796         ret = rpc_clnt_xprt_iter_init(clnt, &xpi);
797         if (ret)
798                 return ret;
799         for (;;) {
800                 struct rpc_xprt *xprt = xprt_iter_get_next(&xpi);
801
802                 if (!xprt)
803                         break;
804                 ret = fn(clnt, xprt, data);
805                 xprt_put(xprt);
806                 if (ret < 0)
807                         break;
808         }
809         xprt_iter_destroy(&xpi);
810         return ret;
811 }
812 EXPORT_SYMBOL_GPL(rpc_clnt_iterate_for_each_xprt);
813
814 /*
815  * Kill all tasks for the given client.
816  * XXX: kill their descendants as well?
817  */
818 void rpc_killall_tasks(struct rpc_clnt *clnt)
819 {
820         struct rpc_task *rovr;
821
822
823         if (list_empty(&clnt->cl_tasks))
824                 return;
825         dprintk("RPC:       killing all tasks for client %p\n", clnt);
826         /*
827          * Spin lock all_tasks to prevent changes...
828          */
829         spin_lock(&clnt->cl_lock);
830         list_for_each_entry(rovr, &clnt->cl_tasks, tk_task) {
831                 if (!RPC_IS_ACTIVATED(rovr))
832                         continue;
833                 if (!(rovr->tk_flags & RPC_TASK_KILLED)) {
834                         rovr->tk_flags |= RPC_TASK_KILLED;
835                         rpc_exit(rovr, -EIO);
836                 }
837         }
838         spin_unlock(&clnt->cl_lock);
839 }
840 EXPORT_SYMBOL_GPL(rpc_killall_tasks);
841
842 /*
843  * Properly shut down an RPC client, terminating all outstanding
844  * requests.
845  */
846 void rpc_shutdown_client(struct rpc_clnt *clnt)
847 {
848         might_sleep();
849
850         dprintk_rcu("RPC:       shutting down %s client for %s\n",
851                         clnt->cl_program->name,
852                         rcu_dereference(clnt->cl_xprt)->servername);
853
854         while (!list_empty(&clnt->cl_tasks)) {
855                 rpc_killall_tasks(clnt);
856                 wait_event_timeout(destroy_wait,
857                         list_empty(&clnt->cl_tasks), 1*HZ);
858         }
859
860         rpc_release_client(clnt);
861 }
862 EXPORT_SYMBOL_GPL(rpc_shutdown_client);
863
864 /*
865  * Free an RPC client
866  */
867 static struct rpc_clnt *
868 rpc_free_client(struct rpc_clnt *clnt)
869 {
870         struct rpc_clnt *parent = NULL;
871
872         dprintk_rcu("RPC:       destroying %s client for %s\n",
873                         clnt->cl_program->name,
874                         rcu_dereference(clnt->cl_xprt)->servername);
875         if (clnt->cl_parent != clnt)
876                 parent = clnt->cl_parent;
877         rpc_clnt_debugfs_unregister(clnt);
878         rpc_clnt_remove_pipedir(clnt);
879         rpc_unregister_client(clnt);
880         rpc_free_iostats(clnt->cl_metrics);
881         clnt->cl_metrics = NULL;
882         xprt_put(rcu_dereference_raw(clnt->cl_xprt));
883         xprt_iter_destroy(&clnt->cl_xpi);
884         rpciod_down();
885         rpc_free_clid(clnt);
886         kfree(clnt);
887         return parent;
888 }
889
890 /*
891  * Free an RPC client
892  */
893 static struct rpc_clnt *
894 rpc_free_auth(struct rpc_clnt *clnt)
895 {
896         if (clnt->cl_auth == NULL)
897                 return rpc_free_client(clnt);
898
899         /*
900          * Note: RPCSEC_GSS may need to send NULL RPC calls in order to
901          *       release remaining GSS contexts. This mechanism ensures
902          *       that it can do so safely.
903          */
904         atomic_inc(&clnt->cl_count);
905         rpcauth_release(clnt->cl_auth);
906         clnt->cl_auth = NULL;
907         if (atomic_dec_and_test(&clnt->cl_count))
908                 return rpc_free_client(clnt);
909         return NULL;
910 }
911
912 /*
913  * Release reference to the RPC client
914  */
915 void
916 rpc_release_client(struct rpc_clnt *clnt)
917 {
918         dprintk("RPC:       rpc_release_client(%p)\n", clnt);
919
920         do {
921                 if (list_empty(&clnt->cl_tasks))
922                         wake_up(&destroy_wait);
923                 if (!atomic_dec_and_test(&clnt->cl_count))
924                         break;
925                 clnt = rpc_free_auth(clnt);
926         } while (clnt != NULL);
927 }
928 EXPORT_SYMBOL_GPL(rpc_release_client);
929
930 /**
931  * rpc_bind_new_program - bind a new RPC program to an existing client
932  * @old: old rpc_client
933  * @program: rpc program to set
934  * @vers: rpc program version
935  *
936  * Clones the rpc client and sets up a new RPC program. This is mainly
937  * of use for enabling different RPC programs to share the same transport.
938  * The Sun NFSv2/v3 ACL protocol can do this.
939  */
940 struct rpc_clnt *rpc_bind_new_program(struct rpc_clnt *old,
941                                       const struct rpc_program *program,
942                                       u32 vers)
943 {
944         struct rpc_create_args args = {
945                 .program        = program,
946                 .prognumber     = program->number,
947                 .version        = vers,
948                 .authflavor     = old->cl_auth->au_flavor,
949         };
950         struct rpc_clnt *clnt;
951         int err;
952
953         clnt = __rpc_clone_client(&args, old);
954         if (IS_ERR(clnt))
955                 goto out;
956         err = rpc_ping(clnt);
957         if (err != 0) {
958                 rpc_shutdown_client(clnt);
959                 clnt = ERR_PTR(err);
960         }
961 out:
962         return clnt;
963 }
964 EXPORT_SYMBOL_GPL(rpc_bind_new_program);
965
966 void rpc_task_release_transport(struct rpc_task *task)
967 {
968         struct rpc_xprt *xprt = task->tk_xprt;
969
970         if (xprt) {
971                 task->tk_xprt = NULL;
972                 xprt_put(xprt);
973         }
974 }
975 EXPORT_SYMBOL_GPL(rpc_task_release_transport);
976
977 void rpc_task_release_client(struct rpc_task *task)
978 {
979         struct rpc_clnt *clnt = task->tk_client;
980
981         if (clnt != NULL) {
982                 /* Remove from client task list */
983                 spin_lock(&clnt->cl_lock);
984                 list_del(&task->tk_task);
985                 spin_unlock(&clnt->cl_lock);
986                 task->tk_client = NULL;
987
988                 rpc_release_client(clnt);
989         }
990         rpc_task_release_transport(task);
991 }
992
993 static
994 void rpc_task_set_transport(struct rpc_task *task, struct rpc_clnt *clnt)
995 {
996         if (!task->tk_xprt)
997                 task->tk_xprt = xprt_iter_get_next(&clnt->cl_xpi);
998 }
999
1000 static
1001 void rpc_task_set_client(struct rpc_task *task, struct rpc_clnt *clnt)
1002 {
1003
1004         if (clnt != NULL) {
1005                 rpc_task_set_transport(task, clnt);
1006                 task->tk_client = clnt;
1007                 atomic_inc(&clnt->cl_count);
1008                 if (clnt->cl_softrtry)
1009                         task->tk_flags |= RPC_TASK_SOFT;
1010                 if (clnt->cl_noretranstimeo)
1011                         task->tk_flags |= RPC_TASK_NO_RETRANS_TIMEOUT;
1012                 if (atomic_read(&clnt->cl_swapper))
1013                         task->tk_flags |= RPC_TASK_SWAPPER;
1014                 /* Add to the client's list of all tasks */
1015                 spin_lock(&clnt->cl_lock);
1016                 list_add_tail(&task->tk_task, &clnt->cl_tasks);
1017                 spin_unlock(&clnt->cl_lock);
1018         }
1019 }
1020
1021 static void
1022 rpc_task_set_rpc_message(struct rpc_task *task, const struct rpc_message *msg)
1023 {
1024         if (msg != NULL) {
1025                 task->tk_msg.rpc_proc = msg->rpc_proc;
1026                 task->tk_msg.rpc_argp = msg->rpc_argp;
1027                 task->tk_msg.rpc_resp = msg->rpc_resp;
1028                 if (msg->rpc_cred != NULL)
1029                         task->tk_msg.rpc_cred = get_cred(msg->rpc_cred);
1030         }
1031 }
1032
1033 /*
1034  * Default callback for async RPC calls
1035  */
1036 static void
1037 rpc_default_callback(struct rpc_task *task, void *data)
1038 {
1039 }
1040
1041 static const struct rpc_call_ops rpc_default_ops = {
1042         .rpc_call_done = rpc_default_callback,
1043 };
1044
1045 /**
1046  * rpc_run_task - Allocate a new RPC task, then run rpc_execute against it
1047  * @task_setup_data: pointer to task initialisation data
1048  */
1049 struct rpc_task *rpc_run_task(const struct rpc_task_setup *task_setup_data)
1050 {
1051         struct rpc_task *task;
1052
1053         task = rpc_new_task(task_setup_data);
1054
1055         rpc_task_set_client(task, task_setup_data->rpc_client);
1056         rpc_task_set_rpc_message(task, task_setup_data->rpc_message);
1057
1058         if (task->tk_action == NULL)
1059                 rpc_call_start(task);
1060
1061         atomic_inc(&task->tk_count);
1062         rpc_execute(task);
1063         return task;
1064 }
1065 EXPORT_SYMBOL_GPL(rpc_run_task);
1066
1067 /**
1068  * rpc_call_sync - Perform a synchronous RPC call
1069  * @clnt: pointer to RPC client
1070  * @msg: RPC call parameters
1071  * @flags: RPC call flags
1072  */
1073 int rpc_call_sync(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags)
1074 {
1075         struct rpc_task *task;
1076         struct rpc_task_setup task_setup_data = {
1077                 .rpc_client = clnt,
1078                 .rpc_message = msg,
1079                 .callback_ops = &rpc_default_ops,
1080                 .flags = flags,
1081         };
1082         int status;
1083
1084         WARN_ON_ONCE(flags & RPC_TASK_ASYNC);
1085         if (flags & RPC_TASK_ASYNC) {
1086                 rpc_release_calldata(task_setup_data.callback_ops,
1087                         task_setup_data.callback_data);
1088                 return -EINVAL;
1089         }
1090
1091         task = rpc_run_task(&task_setup_data);
1092         if (IS_ERR(task))
1093                 return PTR_ERR(task);
1094         status = task->tk_status;
1095         rpc_put_task(task);
1096         return status;
1097 }
1098 EXPORT_SYMBOL_GPL(rpc_call_sync);
1099
1100 /**
1101  * rpc_call_async - Perform an asynchronous RPC call
1102  * @clnt: pointer to RPC client
1103  * @msg: RPC call parameters
1104  * @flags: RPC call flags
1105  * @tk_ops: RPC call ops
1106  * @data: user call data
1107  */
1108 int
1109 rpc_call_async(struct rpc_clnt *clnt, const struct rpc_message *msg, int flags,
1110                const struct rpc_call_ops *tk_ops, void *data)
1111 {
1112         struct rpc_task *task;
1113         struct rpc_task_setup task_setup_data = {
1114                 .rpc_client = clnt,
1115                 .rpc_message = msg,
1116                 .callback_ops = tk_ops,
1117                 .callback_data = data,
1118                 .flags = flags|RPC_TASK_ASYNC,
1119         };
1120
1121         task = rpc_run_task(&task_setup_data);
1122         if (IS_ERR(task))
1123                 return PTR_ERR(task);
1124         rpc_put_task(task);
1125         return 0;
1126 }
1127 EXPORT_SYMBOL_GPL(rpc_call_async);
1128
1129 #if defined(CONFIG_SUNRPC_BACKCHANNEL)
1130 static void call_bc_encode(struct rpc_task *task);
1131
1132 /**
1133  * rpc_run_bc_task - Allocate a new RPC task for backchannel use, then run
1134  * rpc_execute against it
1135  * @req: RPC request
1136  */
1137 struct rpc_task *rpc_run_bc_task(struct rpc_rqst *req)
1138 {
1139         struct rpc_task *task;
1140         struct rpc_task_setup task_setup_data = {
1141                 .callback_ops = &rpc_default_ops,
1142                 .flags = RPC_TASK_SOFTCONN |
1143                         RPC_TASK_NO_RETRANS_TIMEOUT,
1144         };
1145
1146         dprintk("RPC: rpc_run_bc_task req= %p\n", req);
1147         /*
1148          * Create an rpc_task to send the data
1149          */
1150         task = rpc_new_task(&task_setup_data);
1151         xprt_init_bc_request(req, task);
1152
1153         task->tk_action = call_bc_encode;
1154         atomic_inc(&task->tk_count);
1155         WARN_ON_ONCE(atomic_read(&task->tk_count) != 2);
1156         rpc_execute(task);
1157
1158         dprintk("RPC: rpc_run_bc_task: task= %p\n", task);
1159         return task;
1160 }
1161 #endif /* CONFIG_SUNRPC_BACKCHANNEL */
1162
1163 /**
1164  * rpc_prepare_reply_pages - Prepare to receive a reply data payload into pages
1165  * @req: RPC request to prepare
1166  * @pages: vector of struct page pointers
1167  * @base: offset in first page where receive should start, in bytes
1168  * @len: expected size of the upper layer data payload, in bytes
1169  * @hdrsize: expected size of upper layer reply header, in XDR words
1170  *
1171  */
1172 void rpc_prepare_reply_pages(struct rpc_rqst *req, struct page **pages,
1173                              unsigned int base, unsigned int len,
1174                              unsigned int hdrsize)
1175 {
1176         /* Subtract one to force an extra word of buffer space for the
1177          * payload's XDR pad to fall into the rcv_buf's tail iovec.
1178          */
1179         hdrsize += RPC_REPHDRSIZE + req->rq_cred->cr_auth->au_ralign - 1;
1180
1181         xdr_inline_pages(&req->rq_rcv_buf, hdrsize << 2, pages, base, len);
1182         trace_rpc_reply_pages(req);
1183 }
1184 EXPORT_SYMBOL_GPL(rpc_prepare_reply_pages);
1185
1186 void
1187 rpc_call_start(struct rpc_task *task)
1188 {
1189         task->tk_action = call_start;
1190 }
1191 EXPORT_SYMBOL_GPL(rpc_call_start);
1192
1193 /**
1194  * rpc_peeraddr - extract remote peer address from clnt's xprt
1195  * @clnt: RPC client structure
1196  * @buf: target buffer
1197  * @bufsize: length of target buffer
1198  *
1199  * Returns the number of bytes that are actually in the stored address.
1200  */
1201 size_t rpc_peeraddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t bufsize)
1202 {
1203         size_t bytes;
1204         struct rpc_xprt *xprt;
1205
1206         rcu_read_lock();
1207         xprt = rcu_dereference(clnt->cl_xprt);
1208
1209         bytes = xprt->addrlen;
1210         if (bytes > bufsize)
1211                 bytes = bufsize;
1212         memcpy(buf, &xprt->addr, bytes);
1213         rcu_read_unlock();
1214
1215         return bytes;
1216 }
1217 EXPORT_SYMBOL_GPL(rpc_peeraddr);
1218
1219 /**
1220  * rpc_peeraddr2str - return remote peer address in printable format
1221  * @clnt: RPC client structure
1222  * @format: address format
1223  *
1224  * NB: the lifetime of the memory referenced by the returned pointer is
1225  * the same as the rpc_xprt itself.  As long as the caller uses this
1226  * pointer, it must hold the RCU read lock.
1227  */
1228 const char *rpc_peeraddr2str(struct rpc_clnt *clnt,
1229                              enum rpc_display_format_t format)
1230 {
1231         struct rpc_xprt *xprt;
1232
1233         xprt = rcu_dereference(clnt->cl_xprt);
1234
1235         if (xprt->address_strings[format] != NULL)
1236                 return xprt->address_strings[format];
1237         else
1238                 return "unprintable";
1239 }
1240 EXPORT_SYMBOL_GPL(rpc_peeraddr2str);
1241
1242 static const struct sockaddr_in rpc_inaddr_loopback = {
1243         .sin_family             = AF_INET,
1244         .sin_addr.s_addr        = htonl(INADDR_ANY),
1245 };
1246
1247 static const struct sockaddr_in6 rpc_in6addr_loopback = {
1248         .sin6_family            = AF_INET6,
1249         .sin6_addr              = IN6ADDR_ANY_INIT,
1250 };
1251
1252 /*
1253  * Try a getsockname() on a connected datagram socket.  Using a
1254  * connected datagram socket prevents leaving a socket in TIME_WAIT.
1255  * This conserves the ephemeral port number space.
1256  *
1257  * Returns zero and fills in "buf" if successful; otherwise, a
1258  * negative errno is returned.
1259  */
1260 static int rpc_sockname(struct net *net, struct sockaddr *sap, size_t salen,
1261                         struct sockaddr *buf)
1262 {
1263         struct socket *sock;
1264         int err;
1265
1266         err = __sock_create(net, sap->sa_family,
1267                                 SOCK_DGRAM, IPPROTO_UDP, &sock, 1);
1268         if (err < 0) {
1269                 dprintk("RPC:       can't create UDP socket (%d)\n", err);
1270                 goto out;
1271         }
1272
1273         switch (sap->sa_family) {
1274         case AF_INET:
1275                 err = kernel_bind(sock,
1276                                 (struct sockaddr *)&rpc_inaddr_loopback,
1277                                 sizeof(rpc_inaddr_loopback));
1278                 break;
1279         case AF_INET6:
1280                 err = kernel_bind(sock,
1281                                 (struct sockaddr *)&rpc_in6addr_loopback,
1282                                 sizeof(rpc_in6addr_loopback));
1283                 break;
1284         default:
1285                 err = -EAFNOSUPPORT;
1286                 goto out;
1287         }
1288         if (err < 0) {
1289                 dprintk("RPC:       can't bind UDP socket (%d)\n", err);
1290                 goto out_release;
1291         }
1292
1293         err = kernel_connect(sock, sap, salen, 0);
1294         if (err < 0) {
1295                 dprintk("RPC:       can't connect UDP socket (%d)\n", err);
1296                 goto out_release;
1297         }
1298
1299         err = kernel_getsockname(sock, buf);
1300         if (err < 0) {
1301                 dprintk("RPC:       getsockname failed (%d)\n", err);
1302                 goto out_release;
1303         }
1304
1305         err = 0;
1306         if (buf->sa_family == AF_INET6) {
1307                 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)buf;
1308                 sin6->sin6_scope_id = 0;
1309         }
1310         dprintk("RPC:       %s succeeded\n", __func__);
1311
1312 out_release:
1313         sock_release(sock);
1314 out:
1315         return err;
1316 }
1317
1318 /*
1319  * Scraping a connected socket failed, so we don't have a useable
1320  * local address.  Fallback: generate an address that will prevent
1321  * the server from calling us back.
1322  *
1323  * Returns zero and fills in "buf" if successful; otherwise, a
1324  * negative errno is returned.
1325  */
1326 static int rpc_anyaddr(int family, struct sockaddr *buf, size_t buflen)
1327 {
1328         switch (family) {
1329         case AF_INET:
1330                 if (buflen < sizeof(rpc_inaddr_loopback))
1331                         return -EINVAL;
1332                 memcpy(buf, &rpc_inaddr_loopback,
1333                                 sizeof(rpc_inaddr_loopback));
1334                 break;
1335         case AF_INET6:
1336                 if (buflen < sizeof(rpc_in6addr_loopback))
1337                         return -EINVAL;
1338                 memcpy(buf, &rpc_in6addr_loopback,
1339                                 sizeof(rpc_in6addr_loopback));
1340                 break;
1341         default:
1342                 dprintk("RPC:       %s: address family not supported\n",
1343                         __func__);
1344                 return -EAFNOSUPPORT;
1345         }
1346         dprintk("RPC:       %s: succeeded\n", __func__);
1347         return 0;
1348 }
1349
1350 /**
1351  * rpc_localaddr - discover local endpoint address for an RPC client
1352  * @clnt: RPC client structure
1353  * @buf: target buffer
1354  * @buflen: size of target buffer, in bytes
1355  *
1356  * Returns zero and fills in "buf" and "buflen" if successful;
1357  * otherwise, a negative errno is returned.
1358  *
1359  * This works even if the underlying transport is not currently connected,
1360  * or if the upper layer never previously provided a source address.
1361  *
1362  * The result of this function call is transient: multiple calls in
1363  * succession may give different results, depending on how local
1364  * networking configuration changes over time.
1365  */
1366 int rpc_localaddr(struct rpc_clnt *clnt, struct sockaddr *buf, size_t buflen)
1367 {
1368         struct sockaddr_storage address;
1369         struct sockaddr *sap = (struct sockaddr *)&address;
1370         struct rpc_xprt *xprt;
1371         struct net *net;
1372         size_t salen;
1373         int err;
1374
1375         rcu_read_lock();
1376         xprt = rcu_dereference(clnt->cl_xprt);
1377         salen = xprt->addrlen;
1378         memcpy(sap, &xprt->addr, salen);
1379         net = get_net(xprt->xprt_net);
1380         rcu_read_unlock();
1381
1382         rpc_set_port(sap, 0);
1383         err = rpc_sockname(net, sap, salen, buf);
1384         put_net(net);
1385         if (err != 0)
1386                 /* Couldn't discover local address, return ANYADDR */
1387                 return rpc_anyaddr(sap->sa_family, buf, buflen);
1388         return 0;
1389 }
1390 EXPORT_SYMBOL_GPL(rpc_localaddr);
1391
1392 void
1393 rpc_setbufsize(struct rpc_clnt *clnt, unsigned int sndsize, unsigned int rcvsize)
1394 {
1395         struct rpc_xprt *xprt;
1396
1397         rcu_read_lock();
1398         xprt = rcu_dereference(clnt->cl_xprt);
1399         if (xprt->ops->set_buffer_size)
1400                 xprt->ops->set_buffer_size(xprt, sndsize, rcvsize);
1401         rcu_read_unlock();
1402 }
1403 EXPORT_SYMBOL_GPL(rpc_setbufsize);
1404
1405 /**
1406  * rpc_net_ns - Get the network namespace for this RPC client
1407  * @clnt: RPC client to query
1408  *
1409  */
1410 struct net *rpc_net_ns(struct rpc_clnt *clnt)
1411 {
1412         struct net *ret;
1413
1414         rcu_read_lock();
1415         ret = rcu_dereference(clnt->cl_xprt)->xprt_net;
1416         rcu_read_unlock();
1417         return ret;
1418 }
1419 EXPORT_SYMBOL_GPL(rpc_net_ns);
1420
1421 /**
1422  * rpc_max_payload - Get maximum payload size for a transport, in bytes
1423  * @clnt: RPC client to query
1424  *
1425  * For stream transports, this is one RPC record fragment (see RFC
1426  * 1831), as we don't support multi-record requests yet.  For datagram
1427  * transports, this is the size of an IP packet minus the IP, UDP, and
1428  * RPC header sizes.
1429  */
1430 size_t rpc_max_payload(struct rpc_clnt *clnt)
1431 {
1432         size_t ret;
1433
1434         rcu_read_lock();
1435         ret = rcu_dereference(clnt->cl_xprt)->max_payload;
1436         rcu_read_unlock();
1437         return ret;
1438 }
1439 EXPORT_SYMBOL_GPL(rpc_max_payload);
1440
1441 /**
1442  * rpc_max_bc_payload - Get maximum backchannel payload size, in bytes
1443  * @clnt: RPC client to query
1444  */
1445 size_t rpc_max_bc_payload(struct rpc_clnt *clnt)
1446 {
1447         struct rpc_xprt *xprt;
1448         size_t ret;
1449
1450         rcu_read_lock();
1451         xprt = rcu_dereference(clnt->cl_xprt);
1452         ret = xprt->ops->bc_maxpayload(xprt);
1453         rcu_read_unlock();
1454         return ret;
1455 }
1456 EXPORT_SYMBOL_GPL(rpc_max_bc_payload);
1457
1458 /**
1459  * rpc_force_rebind - force transport to check that remote port is unchanged
1460  * @clnt: client to rebind
1461  *
1462  */
1463 void rpc_force_rebind(struct rpc_clnt *clnt)
1464 {
1465         if (clnt->cl_autobind) {
1466                 rcu_read_lock();
1467                 xprt_clear_bound(rcu_dereference(clnt->cl_xprt));
1468                 rcu_read_unlock();
1469         }
1470 }
1471 EXPORT_SYMBOL_GPL(rpc_force_rebind);
1472
1473 /*
1474  * Restart an (async) RPC call from the call_prepare state.
1475  * Usually called from within the exit handler.
1476  */
1477 int
1478 rpc_restart_call_prepare(struct rpc_task *task)
1479 {
1480         if (RPC_ASSASSINATED(task))
1481                 return 0;
1482         task->tk_action = call_start;
1483         task->tk_status = 0;
1484         if (task->tk_ops->rpc_call_prepare != NULL)
1485                 task->tk_action = rpc_prepare_task;
1486         return 1;
1487 }
1488 EXPORT_SYMBOL_GPL(rpc_restart_call_prepare);
1489
1490 /*
1491  * Restart an (async) RPC call. Usually called from within the
1492  * exit handler.
1493  */
1494 int
1495 rpc_restart_call(struct rpc_task *task)
1496 {
1497         if (RPC_ASSASSINATED(task))
1498                 return 0;
1499         task->tk_action = call_start;
1500         task->tk_status = 0;
1501         return 1;
1502 }
1503 EXPORT_SYMBOL_GPL(rpc_restart_call);
1504
1505 const char
1506 *rpc_proc_name(const struct rpc_task *task)
1507 {
1508         const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1509
1510         if (proc) {
1511                 if (proc->p_name)
1512                         return proc->p_name;
1513                 else
1514                         return "NULL";
1515         } else
1516                 return "no proc";
1517 }
1518
1519 /*
1520  * 0.  Initial state
1521  *
1522  *     Other FSM states can be visited zero or more times, but
1523  *     this state is visited exactly once for each RPC.
1524  */
1525 static void
1526 call_start(struct rpc_task *task)
1527 {
1528         struct rpc_clnt *clnt = task->tk_client;
1529         int idx = task->tk_msg.rpc_proc->p_statidx;
1530
1531         trace_rpc_request(task);
1532         dprintk("RPC: %5u call_start %s%d proc %s (%s)\n", task->tk_pid,
1533                         clnt->cl_program->name, clnt->cl_vers,
1534                         rpc_proc_name(task),
1535                         (RPC_IS_ASYNC(task) ? "async" : "sync"));
1536
1537         /* Increment call count (version might not be valid for ping) */
1538         if (clnt->cl_program->version[clnt->cl_vers])
1539                 clnt->cl_program->version[clnt->cl_vers]->counts[idx]++;
1540         clnt->cl_stats->rpccnt++;
1541         task->tk_action = call_reserve;
1542         rpc_task_set_transport(task, clnt);
1543         call_reserve(task);
1544 }
1545
1546 /*
1547  * 1.   Reserve an RPC call slot
1548  */
1549 static void
1550 call_reserve(struct rpc_task *task)
1551 {
1552         dprint_status(task);
1553
1554         task->tk_status  = 0;
1555         task->tk_action  = call_reserveresult;
1556         xprt_reserve(task);
1557         if (rpc_task_need_resched(task))
1558                 return;
1559          call_reserveresult(task);
1560 }
1561
1562 static void call_retry_reserve(struct rpc_task *task);
1563
1564 /*
1565  * 1b.  Grok the result of xprt_reserve()
1566  */
1567 static void
1568 call_reserveresult(struct rpc_task *task)
1569 {
1570         int status = task->tk_status;
1571
1572         dprint_status(task);
1573
1574         /*
1575          * After a call to xprt_reserve(), we must have either
1576          * a request slot or else an error status.
1577          */
1578         task->tk_status = 0;
1579         if (status >= 0) {
1580                 if (task->tk_rqstp) {
1581                         task->tk_action = call_refresh;
1582                         call_refresh(task);
1583                         return;
1584                 }
1585
1586                 printk(KERN_ERR "%s: status=%d, but no request slot, exiting\n",
1587                                 __func__, status);
1588                 rpc_exit(task, -EIO);
1589                 return;
1590         }
1591
1592         /*
1593          * Even though there was an error, we may have acquired
1594          * a request slot somehow.  Make sure not to leak it.
1595          */
1596         if (task->tk_rqstp) {
1597                 printk(KERN_ERR "%s: status=%d, request allocated anyway\n",
1598                                 __func__, status);
1599                 xprt_release(task);
1600         }
1601
1602         switch (status) {
1603         case -ENOMEM:
1604                 rpc_delay(task, HZ >> 2);
1605                 /* fall through */
1606         case -EAGAIN:   /* woken up; retry */
1607                 task->tk_action = call_retry_reserve;
1608                 call_retry_reserve(task);
1609                 return;
1610         case -EIO:      /* probably a shutdown */
1611                 break;
1612         default:
1613                 printk(KERN_ERR "%s: unrecognized error %d, exiting\n",
1614                                 __func__, status);
1615                 break;
1616         }
1617         rpc_exit(task, status);
1618 }
1619
1620 /*
1621  * 1c.  Retry reserving an RPC call slot
1622  */
1623 static void
1624 call_retry_reserve(struct rpc_task *task)
1625 {
1626         dprint_status(task);
1627
1628         task->tk_status  = 0;
1629         task->tk_action  = call_reserveresult;
1630         xprt_retry_reserve(task);
1631         if (rpc_task_need_resched(task))
1632                 return;
1633         call_reserveresult(task);
1634 }
1635
1636 /*
1637  * 2.   Bind and/or refresh the credentials
1638  */
1639 static void
1640 call_refresh(struct rpc_task *task)
1641 {
1642         dprint_status(task);
1643
1644         task->tk_action = call_refreshresult;
1645         task->tk_status = 0;
1646         task->tk_client->cl_stats->rpcauthrefresh++;
1647         rpcauth_refreshcred(task);
1648         if (rpc_task_need_resched(task))
1649                 return;
1650         call_refreshresult(task);
1651 }
1652
1653 /*
1654  * 2a.  Process the results of a credential refresh
1655  */
1656 static void
1657 call_refreshresult(struct rpc_task *task)
1658 {
1659         int status = task->tk_status;
1660
1661         dprint_status(task);
1662
1663         task->tk_status = 0;
1664         task->tk_action = call_refresh;
1665         switch (status) {
1666         case 0:
1667                 if (rpcauth_uptodatecred(task)) {
1668                         task->tk_action = call_allocate;
1669                         call_allocate(task);
1670                         return;
1671                 }
1672                 /* Use rate-limiting and a max number of retries if refresh
1673                  * had status 0 but failed to update the cred.
1674                  */
1675                 /* fall through */
1676         case -ETIMEDOUT:
1677                 rpc_delay(task, 3*HZ);
1678                 /* fall through */
1679         case -EAGAIN:
1680                 status = -EACCES;
1681                 /* fall through */
1682         case -EKEYEXPIRED:
1683                 if (!task->tk_cred_retry)
1684                         break;
1685                 task->tk_cred_retry--;
1686                 dprintk("RPC: %5u %s: retry refresh creds\n",
1687                                 task->tk_pid, __func__);
1688                 call_refresh(task);
1689                 return;
1690         }
1691         dprintk("RPC: %5u %s: refresh creds failed with error %d\n",
1692                                 task->tk_pid, __func__, status);
1693         rpc_exit(task, status);
1694 }
1695
1696 /*
1697  * 2b.  Allocate the buffer. For details, see sched.c:rpc_malloc.
1698  *      (Note: buffer memory is freed in xprt_release).
1699  */
1700 static void
1701 call_allocate(struct rpc_task *task)
1702 {
1703         const struct rpc_auth *auth = task->tk_rqstp->rq_cred->cr_auth;
1704         struct rpc_rqst *req = task->tk_rqstp;
1705         struct rpc_xprt *xprt = req->rq_xprt;
1706         const struct rpc_procinfo *proc = task->tk_msg.rpc_proc;
1707         int status;
1708
1709         dprint_status(task);
1710
1711         task->tk_status = 0;
1712         task->tk_action = call_encode;
1713
1714         if (req->rq_buffer) {
1715                 call_encode(task);
1716                 return;
1717         }
1718
1719         if (proc->p_proc != 0) {
1720                 BUG_ON(proc->p_arglen == 0);
1721                 if (proc->p_decode != NULL)
1722                         BUG_ON(proc->p_replen == 0);
1723         }
1724
1725         /*
1726          * Calculate the size (in quads) of the RPC call
1727          * and reply headers, and convert both values
1728          * to byte sizes.
1729          */
1730         req->rq_callsize = RPC_CALLHDRSIZE + (auth->au_cslack << 1) +
1731                            proc->p_arglen;
1732         req->rq_callsize <<= 2;
1733         req->rq_rcvsize = RPC_REPHDRSIZE + auth->au_rslack + proc->p_replen;
1734         req->rq_rcvsize <<= 2;
1735
1736         status = xprt->ops->buf_alloc(task);
1737         xprt_inject_disconnect(xprt);
1738         if (status == 0) {
1739                 if (rpc_task_need_resched(task))
1740                         return;
1741                 call_encode(task);
1742                 return;
1743         }
1744         if (status != -ENOMEM) {
1745                 rpc_exit(task, status);
1746                 return;
1747         }
1748
1749         dprintk("RPC: %5u rpc_buffer allocation failed\n", task->tk_pid);
1750
1751         if (RPC_IS_ASYNC(task) || !fatal_signal_pending(current)) {
1752                 task->tk_action = call_allocate;
1753                 rpc_delay(task, HZ>>4);
1754                 return;
1755         }
1756
1757         rpc_exit(task, -ERESTARTSYS);
1758 }
1759
1760 static int
1761 rpc_task_need_encode(struct rpc_task *task)
1762 {
1763         return test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate) == 0 &&
1764                 (!(task->tk_flags & RPC_TASK_SENT) ||
1765                  !(task->tk_flags & RPC_TASK_NO_RETRANS_TIMEOUT) ||
1766                  xprt_request_need_retransmit(task));
1767 }
1768
1769 static void
1770 rpc_xdr_encode(struct rpc_task *task)
1771 {
1772         struct rpc_rqst *req = task->tk_rqstp;
1773         struct xdr_stream xdr;
1774
1775         xdr_buf_init(&req->rq_snd_buf,
1776                      req->rq_buffer,
1777                      req->rq_callsize);
1778         xdr_buf_init(&req->rq_rcv_buf,
1779                      req->rq_rbuffer,
1780                      req->rq_rcvsize);
1781
1782         req->rq_snd_buf.head[0].iov_len = 0;
1783         xdr_init_encode(&xdr, &req->rq_snd_buf,
1784                         req->rq_snd_buf.head[0].iov_base, req);
1785         if (rpc_encode_header(task, &xdr))
1786                 return;
1787
1788         task->tk_status = rpcauth_wrap_req(task, &xdr);
1789 }
1790
1791 /*
1792  * 3.   Encode arguments of an RPC call
1793  */
1794 static void
1795 call_encode(struct rpc_task *task)
1796 {
1797         if (!rpc_task_need_encode(task))
1798                 goto out;
1799         dprint_status(task);
1800         /* Encode here so that rpcsec_gss can use correct sequence number. */
1801         rpc_xdr_encode(task);
1802         /* Did the encode result in an error condition? */
1803         if (task->tk_status != 0) {
1804                 /* Was the error nonfatal? */
1805                 switch (task->tk_status) {
1806                 case -EAGAIN:
1807                 case -ENOMEM:
1808                         rpc_delay(task, HZ >> 4);
1809                         break;
1810                 case -EKEYEXPIRED:
1811                         task->tk_action = call_refresh;
1812                         break;
1813                 default:
1814                         rpc_exit(task, task->tk_status);
1815                 }
1816                 return;
1817         } else {
1818                 xprt_request_prepare(task->tk_rqstp);
1819         }
1820
1821         /* Add task to reply queue before transmission to avoid races */
1822         if (rpc_reply_expected(task))
1823                 xprt_request_enqueue_receive(task);
1824         xprt_request_enqueue_transmit(task);
1825 out:
1826         task->tk_action = call_bind;
1827         call_bind(task);
1828 }
1829
1830 /*
1831  * Helpers to check if the task was already transmitted, and
1832  * to take action when that is the case.
1833  */
1834 static bool
1835 rpc_task_transmitted(struct rpc_task *task)
1836 {
1837         return !test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate);
1838 }
1839
1840 static void
1841 rpc_task_handle_transmitted(struct rpc_task *task)
1842 {
1843         xprt_end_transmit(task);
1844         task->tk_action = call_transmit_status;
1845         call_transmit_status(task);
1846 }
1847
1848 /*
1849  * 4.   Get the server port number if not yet set
1850  */
1851 static void
1852 call_bind(struct rpc_task *task)
1853 {
1854         struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
1855
1856         if (rpc_task_transmitted(task)) {
1857                 rpc_task_handle_transmitted(task);
1858                 return;
1859         }
1860
1861         if (xprt_bound(xprt)) {
1862                 task->tk_action = call_connect;
1863                 call_connect(task);
1864                 return;
1865         }
1866
1867         dprint_status(task);
1868
1869         task->tk_action = call_bind_status;
1870         if (!xprt_prepare_transmit(task))
1871                 return;
1872
1873         task->tk_timeout = xprt->bind_timeout;
1874         xprt->ops->rpcbind(task);
1875 }
1876
1877 /*
1878  * 4a.  Sort out bind result
1879  */
1880 static void
1881 call_bind_status(struct rpc_task *task)
1882 {
1883         int status = -EIO;
1884
1885         if (rpc_task_transmitted(task)) {
1886                 rpc_task_handle_transmitted(task);
1887                 return;
1888         }
1889
1890         if (task->tk_status >= 0) {
1891                 dprint_status(task);
1892                 task->tk_status = 0;
1893                 task->tk_action = call_connect;
1894                 call_connect(task);
1895                 return;
1896         }
1897
1898         trace_rpc_bind_status(task);
1899         switch (task->tk_status) {
1900         case -ENOMEM:
1901                 dprintk("RPC: %5u rpcbind out of memory\n", task->tk_pid);
1902                 rpc_delay(task, HZ >> 2);
1903                 goto retry_timeout;
1904         case -EACCES:
1905                 dprintk("RPC: %5u remote rpcbind: RPC program/version "
1906                                 "unavailable\n", task->tk_pid);
1907                 /* fail immediately if this is an RPC ping */
1908                 if (task->tk_msg.rpc_proc->p_proc == 0) {
1909                         status = -EOPNOTSUPP;
1910                         break;
1911                 }
1912                 if (task->tk_rebind_retry == 0)
1913                         break;
1914                 task->tk_rebind_retry--;
1915                 rpc_delay(task, 3*HZ);
1916                 goto retry_timeout;
1917         case -EAGAIN:
1918                 goto retry_timeout;
1919         case -ETIMEDOUT:
1920                 dprintk("RPC: %5u rpcbind request timed out\n",
1921                                 task->tk_pid);
1922                 goto retry_timeout;
1923         case -EPFNOSUPPORT:
1924                 /* server doesn't support any rpcbind version we know of */
1925                 dprintk("RPC: %5u unrecognized remote rpcbind service\n",
1926                                 task->tk_pid);
1927                 break;
1928         case -EPROTONOSUPPORT:
1929                 dprintk("RPC: %5u remote rpcbind version unavailable, retrying\n",
1930                                 task->tk_pid);
1931                 goto retry_timeout;
1932         case -ECONNREFUSED:             /* connection problems */
1933         case -ECONNRESET:
1934         case -ECONNABORTED:
1935         case -ENOTCONN:
1936         case -EHOSTDOWN:
1937         case -ENETDOWN:
1938         case -EHOSTUNREACH:
1939         case -ENETUNREACH:
1940         case -ENOBUFS:
1941         case -EPIPE:
1942                 dprintk("RPC: %5u remote rpcbind unreachable: %d\n",
1943                                 task->tk_pid, task->tk_status);
1944                 if (!RPC_IS_SOFTCONN(task)) {
1945                         rpc_delay(task, 5*HZ);
1946                         goto retry_timeout;
1947                 }
1948                 status = task->tk_status;
1949                 break;
1950         default:
1951                 dprintk("RPC: %5u unrecognized rpcbind error (%d)\n",
1952                                 task->tk_pid, -task->tk_status);
1953         }
1954
1955         rpc_exit(task, status);
1956         return;
1957
1958 retry_timeout:
1959         task->tk_status = 0;
1960         task->tk_action = call_bind;
1961         rpc_check_timeout(task);
1962 }
1963
1964 /*
1965  * 4b.  Connect to the RPC server
1966  */
1967 static void
1968 call_connect(struct rpc_task *task)
1969 {
1970         struct rpc_xprt *xprt = task->tk_rqstp->rq_xprt;
1971
1972         if (rpc_task_transmitted(task)) {
1973                 rpc_task_handle_transmitted(task);
1974                 return;
1975         }
1976
1977         if (xprt_connected(xprt)) {
1978                 task->tk_action = call_transmit;
1979                 call_transmit(task);
1980                 return;
1981         }
1982
1983         dprintk("RPC: %5u call_connect xprt %p %s connected\n",
1984                         task->tk_pid, xprt,
1985                         (xprt_connected(xprt) ? "is" : "is not"));
1986
1987         task->tk_action = call_connect_status;
1988         if (task->tk_status < 0)
1989                 return;
1990         if (task->tk_flags & RPC_TASK_NOCONNECT) {
1991                 rpc_exit(task, -ENOTCONN);
1992                 return;
1993         }
1994         if (!xprt_prepare_transmit(task))
1995                 return;
1996         xprt_connect(task);
1997 }
1998
1999 /*
2000  * 4c.  Sort out connect result
2001  */
2002 static void
2003 call_connect_status(struct rpc_task *task)
2004 {
2005         struct rpc_clnt *clnt = task->tk_client;
2006         int status = task->tk_status;
2007
2008         if (rpc_task_transmitted(task)) {
2009                 rpc_task_handle_transmitted(task);
2010                 return;
2011         }
2012
2013         dprint_status(task);
2014
2015         trace_rpc_connect_status(task);
2016         task->tk_status = 0;
2017         switch (status) {
2018         case -ECONNREFUSED:
2019                 /* A positive refusal suggests a rebind is needed. */
2020                 if (RPC_IS_SOFTCONN(task))
2021                         break;
2022                 if (clnt->cl_autobind) {
2023                         rpc_force_rebind(clnt);
2024                         goto out_retry;
2025                 }
2026                 /* fall through */
2027         case -ECONNRESET:
2028         case -ECONNABORTED:
2029         case -ENETDOWN:
2030         case -ENETUNREACH:
2031         case -EHOSTUNREACH:
2032         case -EADDRINUSE:
2033         case -ENOBUFS:
2034         case -EPIPE:
2035                 xprt_conditional_disconnect(task->tk_rqstp->rq_xprt,
2036                                             task->tk_rqstp->rq_connect_cookie);
2037                 if (RPC_IS_SOFTCONN(task))
2038                         break;
2039                 /* retry with existing socket, after a delay */
2040                 rpc_delay(task, 3*HZ);
2041                 /* fall through */
2042         case -ENOTCONN:
2043         case -EAGAIN:
2044         case -ETIMEDOUT:
2045                 goto out_retry;
2046         case 0:
2047                 clnt->cl_stats->netreconn++;
2048                 task->tk_action = call_transmit;
2049                 call_transmit(task);
2050                 return;
2051         }
2052         rpc_exit(task, status);
2053         return;
2054 out_retry:
2055         /* Check for timeouts before looping back to call_bind */
2056         task->tk_action = call_bind;
2057         rpc_check_timeout(task);
2058 }
2059
2060 /*
2061  * 5.   Transmit the RPC request, and wait for reply
2062  */
2063 static void
2064 call_transmit(struct rpc_task *task)
2065 {
2066         if (rpc_task_transmitted(task)) {
2067                 rpc_task_handle_transmitted(task);
2068                 return;
2069         }
2070
2071         dprint_status(task);
2072
2073         task->tk_action = call_transmit_status;
2074         if (!xprt_prepare_transmit(task))
2075                 return;
2076         task->tk_status = 0;
2077         if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2078                 if (!xprt_connected(task->tk_xprt)) {
2079                         task->tk_status = -ENOTCONN;
2080                         return;
2081                 }
2082                 xprt_transmit(task);
2083         }
2084         xprt_end_transmit(task);
2085         if (rpc_task_need_resched(task))
2086                 return;
2087         call_transmit_status(task);
2088 }
2089
2090 /*
2091  * 5a.  Handle cleanup after a transmission
2092  */
2093 static void
2094 call_transmit_status(struct rpc_task *task)
2095 {
2096         task->tk_action = call_status;
2097
2098         /*
2099          * Common case: success.  Force the compiler to put this
2100          * test first.
2101          */
2102         if (rpc_task_transmitted(task)) {
2103                 if (task->tk_status == 0)
2104                         xprt_request_wait_receive(task);
2105                 if (rpc_task_need_resched(task))
2106                         return;
2107                 call_status(task);
2108                 return;
2109         }
2110
2111         switch (task->tk_status) {
2112         default:
2113                 dprint_status(task);
2114                 break;
2115         case -EBADMSG:
2116                 task->tk_status = 0;
2117                 task->tk_action = call_encode;
2118                 break;
2119                 /*
2120                  * Special cases: if we've been waiting on the
2121                  * socket's write_space() callback, or if the
2122                  * socket just returned a connection error,
2123                  * then hold onto the transport lock.
2124                  */
2125         case -ENOBUFS:
2126                 rpc_delay(task, HZ>>2);
2127                 /* fall through */
2128         case -EBADSLT:
2129         case -EAGAIN:
2130                 task->tk_action = call_transmit;
2131                 task->tk_status = 0;
2132                 break;
2133         case -ECONNREFUSED:
2134         case -EHOSTDOWN:
2135         case -ENETDOWN:
2136         case -EHOSTUNREACH:
2137         case -ENETUNREACH:
2138         case -EPERM:
2139                 if (RPC_IS_SOFTCONN(task)) {
2140                         if (!task->tk_msg.rpc_proc->p_proc)
2141                                 trace_xprt_ping(task->tk_xprt,
2142                                                 task->tk_status);
2143                         rpc_exit(task, task->tk_status);
2144                         return;
2145                 }
2146                 /* fall through */
2147         case -ECONNRESET:
2148         case -ECONNABORTED:
2149         case -EADDRINUSE:
2150         case -ENOTCONN:
2151         case -EPIPE:
2152                 task->tk_action = call_bind;
2153                 task->tk_status = 0;
2154                 break;
2155         }
2156         rpc_check_timeout(task);
2157 }
2158
2159 #if defined(CONFIG_SUNRPC_BACKCHANNEL)
2160 static void call_bc_transmit(struct rpc_task *task);
2161 static void call_bc_transmit_status(struct rpc_task *task);
2162
2163 static void
2164 call_bc_encode(struct rpc_task *task)
2165 {
2166         xprt_request_enqueue_transmit(task);
2167         task->tk_action = call_bc_transmit;
2168         call_bc_transmit(task);
2169 }
2170
2171 /*
2172  * 5b.  Send the backchannel RPC reply.  On error, drop the reply.  In
2173  * addition, disconnect on connectivity errors.
2174  */
2175 static void
2176 call_bc_transmit(struct rpc_task *task)
2177 {
2178         task->tk_action = call_bc_transmit_status;
2179         if (test_bit(RPC_TASK_NEED_XMIT, &task->tk_runstate)) {
2180                 if (!xprt_prepare_transmit(task))
2181                         return;
2182                 task->tk_status = 0;
2183                 xprt_transmit(task);
2184         }
2185         xprt_end_transmit(task);
2186 }
2187
2188 static void
2189 call_bc_transmit_status(struct rpc_task *task)
2190 {
2191         struct rpc_rqst *req = task->tk_rqstp;
2192
2193         dprint_status(task);
2194
2195         switch (task->tk_status) {
2196         case 0:
2197                 /* Success */
2198         case -ENETDOWN:
2199         case -EHOSTDOWN:
2200         case -EHOSTUNREACH:
2201         case -ENETUNREACH:
2202         case -ECONNRESET:
2203         case -ECONNREFUSED:
2204         case -EADDRINUSE:
2205         case -ENOTCONN:
2206         case -EPIPE:
2207                 break;
2208         case -ENOBUFS:
2209                 rpc_delay(task, HZ>>2);
2210                 /* fall through */
2211         case -EBADSLT:
2212         case -EAGAIN:
2213                 task->tk_status = 0;
2214                 task->tk_action = call_bc_transmit;
2215                 return;
2216         case -ETIMEDOUT:
2217                 /*
2218                  * Problem reaching the server.  Disconnect and let the
2219                  * forechannel reestablish the connection.  The server will
2220                  * have to retransmit the backchannel request and we'll
2221                  * reprocess it.  Since these ops are idempotent, there's no
2222                  * need to cache our reply at this time.
2223                  */
2224                 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2225                         "error: %d\n", task->tk_status);
2226                 xprt_conditional_disconnect(req->rq_xprt,
2227                         req->rq_connect_cookie);
2228                 break;
2229         default:
2230                 /*
2231                  * We were unable to reply and will have to drop the
2232                  * request.  The server should reconnect and retransmit.
2233                  */
2234                 printk(KERN_NOTICE "RPC: Could not send backchannel reply "
2235                         "error: %d\n", task->tk_status);
2236                 break;
2237         }
2238         task->tk_action = rpc_exit_task;
2239 }
2240 #endif /* CONFIG_SUNRPC_BACKCHANNEL */
2241
2242 /*
2243  * 6.   Sort out the RPC call status
2244  */
2245 static void
2246 call_status(struct rpc_task *task)
2247 {
2248         struct rpc_clnt *clnt = task->tk_client;
2249         int             status;
2250
2251         if (!task->tk_msg.rpc_proc->p_proc)
2252                 trace_xprt_ping(task->tk_xprt, task->tk_status);
2253
2254         dprint_status(task);
2255
2256         status = task->tk_status;
2257         if (status >= 0) {
2258                 task->tk_action = call_decode;
2259                 call_decode(task);
2260                 return;
2261         }
2262
2263         trace_rpc_call_status(task);
2264         task->tk_status = 0;
2265         switch(status) {
2266         case -EHOSTDOWN:
2267         case -ENETDOWN:
2268         case -EHOSTUNREACH:
2269         case -ENETUNREACH:
2270         case -EPERM:
2271                 if (RPC_IS_SOFTCONN(task))
2272                         goto out_exit;
2273                 /*
2274                  * Delay any retries for 3 seconds, then handle as if it
2275                  * were a timeout.
2276                  */
2277                 rpc_delay(task, 3*HZ);
2278                 /* fall through */
2279         case -ETIMEDOUT:
2280                 break;
2281         case -ECONNREFUSED:
2282         case -ECONNRESET:
2283         case -ECONNABORTED:
2284                 rpc_force_rebind(clnt);
2285                 /* fall through */
2286         case -EADDRINUSE:
2287                 rpc_delay(task, 3*HZ);
2288                 /* fall through */
2289         case -EPIPE:
2290         case -ENOTCONN:
2291         case -EAGAIN:
2292                 break;
2293         case -EIO:
2294                 /* shutdown or soft timeout */
2295                 goto out_exit;
2296         default:
2297                 if (clnt->cl_chatty)
2298                         printk("%s: RPC call returned error %d\n",
2299                                clnt->cl_program->name, -status);
2300                 goto out_exit;
2301         }
2302         task->tk_action = call_encode;
2303         rpc_check_timeout(task);
2304         return;
2305 out_exit:
2306         rpc_exit(task, status);
2307 }
2308
2309 static void
2310 rpc_check_timeout(struct rpc_task *task)
2311 {
2312         struct rpc_clnt *clnt = task->tk_client;
2313
2314         if (xprt_adjust_timeout(task->tk_rqstp) == 0)
2315                 return;
2316
2317         dprintk("RPC: %5u call_timeout (major)\n", task->tk_pid);
2318         task->tk_timeouts++;
2319
2320         if (RPC_IS_SOFTCONN(task)) {
2321                 rpc_exit(task, -ETIMEDOUT);
2322                 return;
2323         }
2324         if (RPC_IS_SOFT(task)) {
2325                 if (clnt->cl_chatty) {
2326                         printk(KERN_NOTICE "%s: server %s not responding, timed out\n",
2327                                 clnt->cl_program->name,
2328                                 task->tk_xprt->servername);
2329                 }
2330                 if (task->tk_flags & RPC_TASK_TIMEOUT)
2331                         rpc_exit(task, -ETIMEDOUT);
2332                 else
2333                         rpc_exit(task, -EIO);
2334                 return;
2335         }
2336
2337         if (!(task->tk_flags & RPC_CALL_MAJORSEEN)) {
2338                 task->tk_flags |= RPC_CALL_MAJORSEEN;
2339                 if (clnt->cl_chatty) {
2340                         printk(KERN_NOTICE "%s: server %s not responding, still trying\n",
2341                         clnt->cl_program->name,
2342                         task->tk_xprt->servername);
2343                 }
2344         }
2345         rpc_force_rebind(clnt);
2346         /*
2347          * Did our request time out due to an RPCSEC_GSS out-of-sequence
2348          * event? RFC2203 requires the server to drop all such requests.
2349          */
2350         rpcauth_invalcred(task);
2351 }
2352
2353 /*
2354  * 7.   Decode the RPC reply
2355  */
2356 static void
2357 call_decode(struct rpc_task *task)
2358 {
2359         struct rpc_clnt *clnt = task->tk_client;
2360         struct rpc_rqst *req = task->tk_rqstp;
2361         struct xdr_stream xdr;
2362
2363         dprint_status(task);
2364
2365         if (!task->tk_msg.rpc_proc->p_decode) {
2366                 task->tk_action = rpc_exit_task;
2367                 return;
2368         }
2369
2370         if (task->tk_flags & RPC_CALL_MAJORSEEN) {
2371                 if (clnt->cl_chatty) {
2372                         printk(KERN_NOTICE "%s: server %s OK\n",
2373                                 clnt->cl_program->name,
2374                                 task->tk_xprt->servername);
2375                 }
2376                 task->tk_flags &= ~RPC_CALL_MAJORSEEN;
2377         }
2378
2379         /*
2380          * Ensure that we see all writes made by xprt_complete_rqst()
2381          * before it changed req->rq_reply_bytes_recvd.
2382          */
2383         smp_rmb();
2384         req->rq_rcv_buf.len = req->rq_private_buf.len;
2385
2386         /* Check that the softirq receive buffer is valid */
2387         WARN_ON(memcmp(&req->rq_rcv_buf, &req->rq_private_buf,
2388                                 sizeof(req->rq_rcv_buf)) != 0);
2389
2390         if (req->rq_rcv_buf.len < 12)
2391                 goto out_retry;
2392
2393         xdr_init_decode(&xdr, &req->rq_rcv_buf,
2394                         req->rq_rcv_buf.head[0].iov_base, req);
2395         switch (rpc_decode_header(task, &xdr)) {
2396         case 0:
2397                 task->tk_action = rpc_exit_task;
2398                 task->tk_status = rpcauth_unwrap_resp(task, &xdr);
2399                 dprintk("RPC: %5u %s result %d\n",
2400                         task->tk_pid, __func__, task->tk_status);
2401                 return;
2402         case -EAGAIN:
2403 out_retry:
2404                 task->tk_status = 0;
2405                 /* Note: rpc_decode_header() may have freed the RPC slot */
2406                 if (task->tk_rqstp == req) {
2407                         xdr_free_bvec(&req->rq_rcv_buf);
2408                         req->rq_reply_bytes_recvd = 0;
2409                         req->rq_rcv_buf.len = 0;
2410                         if (task->tk_client->cl_discrtry)
2411                                 xprt_conditional_disconnect(req->rq_xprt,
2412                                                             req->rq_connect_cookie);
2413                 }
2414                 task->tk_action = call_encode;
2415                 rpc_check_timeout(task);
2416         }
2417 }
2418
2419 static int
2420 rpc_encode_header(struct rpc_task *task, struct xdr_stream *xdr)
2421 {
2422         struct rpc_clnt *clnt = task->tk_client;
2423         struct rpc_rqst *req = task->tk_rqstp;
2424         __be32 *p;
2425         int error;
2426
2427         error = -EMSGSIZE;
2428         p = xdr_reserve_space(xdr, RPC_CALLHDRSIZE << 2);
2429         if (!p)
2430                 goto out_fail;
2431         *p++ = req->rq_xid;
2432         *p++ = rpc_call;
2433         *p++ = cpu_to_be32(RPC_VERSION);
2434         *p++ = cpu_to_be32(clnt->cl_prog);
2435         *p++ = cpu_to_be32(clnt->cl_vers);
2436         *p   = cpu_to_be32(task->tk_msg.rpc_proc->p_proc);
2437
2438         error = rpcauth_marshcred(task, xdr);
2439         if (error < 0)
2440                 goto out_fail;
2441         return 0;
2442 out_fail:
2443         trace_rpc_bad_callhdr(task);
2444         rpc_exit(task, error);
2445         return error;
2446 }
2447
2448 static noinline int
2449 rpc_decode_header(struct rpc_task *task, struct xdr_stream *xdr)
2450 {
2451         struct rpc_clnt *clnt = task->tk_client;
2452         int error = -EACCES;
2453         __be32 *p;
2454
2455         /* RFC-1014 says that the representation of XDR data must be a
2456          * multiple of four bytes
2457          * - if it isn't pointer subtraction in the NFS client may give
2458          *   undefined results
2459          */
2460         if (task->tk_rqstp->rq_rcv_buf.len & 3)
2461                 goto out_badlen;
2462
2463         p = xdr_inline_decode(xdr, 3 * sizeof(*p));
2464         if (!p)
2465                 goto out_unparsable;
2466         p++;    /* skip XID */
2467         if (*p++ != rpc_reply)
2468                 goto out_unparsable;
2469         if (*p++ != rpc_msg_accepted)
2470                 goto out_msg_denied;
2471
2472         error = rpcauth_checkverf(task, xdr);
2473         if (error)
2474                 goto out_verifier;
2475
2476         p = xdr_inline_decode(xdr, sizeof(*p));
2477         if (!p)
2478                 goto out_unparsable;
2479         switch (*p) {
2480         case rpc_success:
2481                 return 0;
2482         case rpc_prog_unavail:
2483                 trace_rpc__prog_unavail(task);
2484                 error = -EPFNOSUPPORT;
2485                 goto out_err;
2486         case rpc_prog_mismatch:
2487                 trace_rpc__prog_mismatch(task);
2488                 error = -EPROTONOSUPPORT;
2489                 goto out_err;
2490         case rpc_proc_unavail:
2491                 trace_rpc__proc_unavail(task);
2492                 error = -EOPNOTSUPP;
2493                 goto out_err;
2494         case rpc_garbage_args:
2495                 trace_rpc__garbage_args(task);
2496                 break;
2497         default:
2498                 trace_rpc__unparsable(task);
2499         }
2500
2501 out_garbage:
2502         clnt->cl_stats->rpcgarbage++;
2503         if (task->tk_garb_retry) {
2504                 task->tk_garb_retry--;
2505                 task->tk_action = call_encode;
2506                 return -EAGAIN;
2507         }
2508 out_err:
2509         rpc_exit(task, error);
2510         return error;
2511
2512 out_badlen:
2513         trace_rpc__unparsable(task);
2514         error = -EIO;
2515         goto out_err;
2516
2517 out_unparsable:
2518         trace_rpc__unparsable(task);
2519         error = -EIO;
2520         goto out_garbage;
2521
2522 out_verifier:
2523         trace_rpc_bad_verifier(task);
2524         goto out_garbage;
2525
2526 out_msg_denied:
2527         p = xdr_inline_decode(xdr, sizeof(*p));
2528         if (!p)
2529                 goto out_unparsable;
2530         switch (*p++) {
2531         case rpc_auth_error:
2532                 break;
2533         case rpc_mismatch:
2534                 trace_rpc__mismatch(task);
2535                 error = -EPROTONOSUPPORT;
2536                 goto out_err;
2537         default:
2538                 trace_rpc__unparsable(task);
2539                 error = -EIO;
2540                 goto out_err;
2541         }
2542
2543         p = xdr_inline_decode(xdr, sizeof(*p));
2544         if (!p)
2545                 goto out_unparsable;
2546         switch (*p++) {
2547         case rpc_autherr_rejectedcred:
2548         case rpc_autherr_rejectedverf:
2549         case rpcsec_gsserr_credproblem:
2550         case rpcsec_gsserr_ctxproblem:
2551                 if (!task->tk_cred_retry)
2552                         break;
2553                 task->tk_cred_retry--;
2554                 trace_rpc__stale_creds(task);
2555                 rpcauth_invalcred(task);
2556                 /* Ensure we obtain a new XID! */
2557                 xprt_release(task);
2558                 task->tk_action = call_reserve;
2559                 return -EAGAIN;
2560         case rpc_autherr_badcred:
2561         case rpc_autherr_badverf:
2562                 /* possibly garbled cred/verf? */
2563                 if (!task->tk_garb_retry)
2564                         break;
2565                 task->tk_garb_retry--;
2566                 trace_rpc__bad_creds(task);
2567                 task->tk_action = call_encode;
2568                 return -EAGAIN;
2569         case rpc_autherr_tooweak:
2570                 trace_rpc__auth_tooweak(task);
2571                 pr_warn("RPC: server %s requires stronger authentication.\n",
2572                         task->tk_xprt->servername);
2573                 break;
2574         default:
2575                 trace_rpc__unparsable(task);
2576                 error = -EIO;
2577         }
2578         goto out_err;
2579 }
2580
2581 static void rpcproc_encode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2582                 const void *obj)
2583 {
2584 }
2585
2586 static int rpcproc_decode_null(struct rpc_rqst *rqstp, struct xdr_stream *xdr,
2587                 void *obj)
2588 {
2589         return 0;
2590 }
2591
2592 static const struct rpc_procinfo rpcproc_null = {
2593         .p_encode = rpcproc_encode_null,
2594         .p_decode = rpcproc_decode_null,
2595 };
2596
2597 static int rpc_ping(struct rpc_clnt *clnt)
2598 {
2599         struct rpc_message msg = {
2600                 .rpc_proc = &rpcproc_null,
2601         };
2602         int err;
2603         err = rpc_call_sync(clnt, &msg, RPC_TASK_SOFT | RPC_TASK_SOFTCONN |
2604                             RPC_TASK_NULLCREDS);
2605         return err;
2606 }
2607
2608 static
2609 struct rpc_task *rpc_call_null_helper(struct rpc_clnt *clnt,
2610                 struct rpc_xprt *xprt, struct rpc_cred *cred, int flags,
2611                 const struct rpc_call_ops *ops, void *data)
2612 {
2613         struct rpc_message msg = {
2614                 .rpc_proc = &rpcproc_null,
2615         };
2616         struct rpc_task_setup task_setup_data = {
2617                 .rpc_client = clnt,
2618                 .rpc_xprt = xprt,
2619                 .rpc_message = &msg,
2620                 .rpc_op_cred = cred,
2621                 .callback_ops = (ops != NULL) ? ops : &rpc_default_ops,
2622                 .callback_data = data,
2623                 .flags = flags | RPC_TASK_NULLCREDS,
2624         };
2625
2626         return rpc_run_task(&task_setup_data);
2627 }
2628
2629 struct rpc_task *rpc_call_null(struct rpc_clnt *clnt, struct rpc_cred *cred, int flags)
2630 {
2631         return rpc_call_null_helper(clnt, NULL, cred, flags, NULL, NULL);
2632 }
2633 EXPORT_SYMBOL_GPL(rpc_call_null);
2634
2635 struct rpc_cb_add_xprt_calldata {
2636         struct rpc_xprt_switch *xps;
2637         struct rpc_xprt *xprt;
2638 };
2639
2640 static void rpc_cb_add_xprt_done(struct rpc_task *task, void *calldata)
2641 {
2642         struct rpc_cb_add_xprt_calldata *data = calldata;
2643
2644         if (task->tk_status == 0)
2645                 rpc_xprt_switch_add_xprt(data->xps, data->xprt);
2646 }
2647
2648 static void rpc_cb_add_xprt_release(void *calldata)
2649 {
2650         struct rpc_cb_add_xprt_calldata *data = calldata;
2651
2652         xprt_put(data->xprt);
2653         xprt_switch_put(data->xps);
2654         kfree(data);
2655 }
2656
2657 static const struct rpc_call_ops rpc_cb_add_xprt_call_ops = {
2658         .rpc_call_done = rpc_cb_add_xprt_done,
2659         .rpc_release = rpc_cb_add_xprt_release,
2660 };
2661
2662 /**
2663  * rpc_clnt_test_and_add_xprt - Test and add a new transport to a rpc_clnt
2664  * @clnt: pointer to struct rpc_clnt
2665  * @xps: pointer to struct rpc_xprt_switch,
2666  * @xprt: pointer struct rpc_xprt
2667  * @dummy: unused
2668  */
2669 int rpc_clnt_test_and_add_xprt(struct rpc_clnt *clnt,
2670                 struct rpc_xprt_switch *xps, struct rpc_xprt *xprt,
2671                 void *dummy)
2672 {
2673         struct rpc_cb_add_xprt_calldata *data;
2674         struct rpc_task *task;
2675
2676         data = kmalloc(sizeof(*data), GFP_NOFS);
2677         if (!data)
2678                 return -ENOMEM;
2679         data->xps = xprt_switch_get(xps);
2680         data->xprt = xprt_get(xprt);
2681
2682         task = rpc_call_null_helper(clnt, xprt, NULL,
2683                         RPC_TASK_SOFT|RPC_TASK_SOFTCONN|RPC_TASK_ASYNC|RPC_TASK_NULLCREDS,
2684                         &rpc_cb_add_xprt_call_ops, data);
2685         if (IS_ERR(task))
2686                 return PTR_ERR(task);
2687         rpc_put_task(task);
2688         return 1;
2689 }
2690 EXPORT_SYMBOL_GPL(rpc_clnt_test_and_add_xprt);
2691
2692 /**
2693  * rpc_clnt_setup_test_and_add_xprt()
2694  *
2695  * This is an rpc_clnt_add_xprt setup() function which returns 1 so:
2696  *   1) caller of the test function must dereference the rpc_xprt_switch
2697  *   and the rpc_xprt.
2698  *   2) test function must call rpc_xprt_switch_add_xprt, usually in
2699  *   the rpc_call_done routine.
2700  *
2701  * Upon success (return of 1), the test function adds the new
2702  * transport to the rpc_clnt xprt switch
2703  *
2704  * @clnt: struct rpc_clnt to get the new transport
2705  * @xps:  the rpc_xprt_switch to hold the new transport
2706  * @xprt: the rpc_xprt to test
2707  * @data: a struct rpc_add_xprt_test pointer that holds the test function
2708  *        and test function call data
2709  */
2710 int rpc_clnt_setup_test_and_add_xprt(struct rpc_clnt *clnt,
2711                                      struct rpc_xprt_switch *xps,
2712                                      struct rpc_xprt *xprt,
2713                                      void *data)
2714 {
2715         struct rpc_task *task;
2716         struct rpc_add_xprt_test *xtest = (struct rpc_add_xprt_test *)data;
2717         int status = -EADDRINUSE;
2718
2719         xprt = xprt_get(xprt);
2720         xprt_switch_get(xps);
2721
2722         if (rpc_xprt_switch_has_addr(xps, (struct sockaddr *)&xprt->addr))
2723                 goto out_err;
2724
2725         /* Test the connection */
2726         task = rpc_call_null_helper(clnt, xprt, NULL,
2727                                     RPC_TASK_SOFT | RPC_TASK_SOFTCONN | RPC_TASK_NULLCREDS,
2728                                     NULL, NULL);
2729         if (IS_ERR(task)) {
2730                 status = PTR_ERR(task);
2731                 goto out_err;
2732         }
2733         status = task->tk_status;
2734         rpc_put_task(task);
2735
2736         if (status < 0)
2737                 goto out_err;
2738
2739         /* rpc_xprt_switch and rpc_xprt are deferrenced by add_xprt_test() */
2740         xtest->add_xprt_test(clnt, xprt, xtest->data);
2741
2742         xprt_put(xprt);
2743         xprt_switch_put(xps);
2744
2745         /* so that rpc_clnt_add_xprt does not call rpc_xprt_switch_add_xprt */
2746         return 1;
2747 out_err:
2748         xprt_put(xprt);
2749         xprt_switch_put(xps);
2750         pr_info("RPC:   rpc_clnt_test_xprt failed: %d addr %s not added\n",
2751                 status, xprt->address_strings[RPC_DISPLAY_ADDR]);
2752         return status;
2753 }
2754 EXPORT_SYMBOL_GPL(rpc_clnt_setup_test_and_add_xprt);
2755
2756 /**
2757  * rpc_clnt_add_xprt - Add a new transport to a rpc_clnt
2758  * @clnt: pointer to struct rpc_clnt
2759  * @xprtargs: pointer to struct xprt_create
2760  * @setup: callback to test and/or set up the connection
2761  * @data: pointer to setup function data
2762  *
2763  * Creates a new transport using the parameters set in args and
2764  * adds it to clnt.
2765  * If ping is set, then test that connectivity succeeds before
2766  * adding the new transport.
2767  *
2768  */
2769 int rpc_clnt_add_xprt(struct rpc_clnt *clnt,
2770                 struct xprt_create *xprtargs,
2771                 int (*setup)(struct rpc_clnt *,
2772                         struct rpc_xprt_switch *,
2773                         struct rpc_xprt *,
2774                         void *),
2775                 void *data)
2776 {
2777         struct rpc_xprt_switch *xps;
2778         struct rpc_xprt *xprt;
2779         unsigned long connect_timeout;
2780         unsigned long reconnect_timeout;
2781         unsigned char resvport;
2782         int ret = 0;
2783
2784         rcu_read_lock();
2785         xps = xprt_switch_get(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
2786         xprt = xprt_iter_xprt(&clnt->cl_xpi);
2787         if (xps == NULL || xprt == NULL) {
2788                 rcu_read_unlock();
2789                 return -EAGAIN;
2790         }
2791         resvport = xprt->resvport;
2792         connect_timeout = xprt->connect_timeout;
2793         reconnect_timeout = xprt->max_reconnect_timeout;
2794         rcu_read_unlock();
2795
2796         xprt = xprt_create_transport(xprtargs);
2797         if (IS_ERR(xprt)) {
2798                 ret = PTR_ERR(xprt);
2799                 goto out_put_switch;
2800         }
2801         xprt->resvport = resvport;
2802         if (xprt->ops->set_connect_timeout != NULL)
2803                 xprt->ops->set_connect_timeout(xprt,
2804                                 connect_timeout,
2805                                 reconnect_timeout);
2806
2807         rpc_xprt_switch_set_roundrobin(xps);
2808         if (setup) {
2809                 ret = setup(clnt, xps, xprt, data);
2810                 if (ret != 0)
2811                         goto out_put_xprt;
2812         }
2813         rpc_xprt_switch_add_xprt(xps, xprt);
2814 out_put_xprt:
2815         xprt_put(xprt);
2816 out_put_switch:
2817         xprt_switch_put(xps);
2818         return ret;
2819 }
2820 EXPORT_SYMBOL_GPL(rpc_clnt_add_xprt);
2821
2822 struct connect_timeout_data {
2823         unsigned long connect_timeout;
2824         unsigned long reconnect_timeout;
2825 };
2826
2827 static int
2828 rpc_xprt_set_connect_timeout(struct rpc_clnt *clnt,
2829                 struct rpc_xprt *xprt,
2830                 void *data)
2831 {
2832         struct connect_timeout_data *timeo = data;
2833
2834         if (xprt->ops->set_connect_timeout)
2835                 xprt->ops->set_connect_timeout(xprt,
2836                                 timeo->connect_timeout,
2837                                 timeo->reconnect_timeout);
2838         return 0;
2839 }
2840
2841 void
2842 rpc_set_connect_timeout(struct rpc_clnt *clnt,
2843                 unsigned long connect_timeout,
2844                 unsigned long reconnect_timeout)
2845 {
2846         struct connect_timeout_data timeout = {
2847                 .connect_timeout = connect_timeout,
2848                 .reconnect_timeout = reconnect_timeout,
2849         };
2850         rpc_clnt_iterate_for_each_xprt(clnt,
2851                         rpc_xprt_set_connect_timeout,
2852                         &timeout);
2853 }
2854 EXPORT_SYMBOL_GPL(rpc_set_connect_timeout);
2855
2856 void rpc_clnt_xprt_switch_put(struct rpc_clnt *clnt)
2857 {
2858         rcu_read_lock();
2859         xprt_switch_put(rcu_dereference(clnt->cl_xpi.xpi_xpswitch));
2860         rcu_read_unlock();
2861 }
2862 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_put);
2863
2864 void rpc_clnt_xprt_switch_add_xprt(struct rpc_clnt *clnt, struct rpc_xprt *xprt)
2865 {
2866         rcu_read_lock();
2867         rpc_xprt_switch_add_xprt(rcu_dereference(clnt->cl_xpi.xpi_xpswitch),
2868                                  xprt);
2869         rcu_read_unlock();
2870 }
2871 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_add_xprt);
2872
2873 bool rpc_clnt_xprt_switch_has_addr(struct rpc_clnt *clnt,
2874                                    const struct sockaddr *sap)
2875 {
2876         struct rpc_xprt_switch *xps;
2877         bool ret;
2878
2879         rcu_read_lock();
2880         xps = rcu_dereference(clnt->cl_xpi.xpi_xpswitch);
2881         ret = rpc_xprt_switch_has_addr(xps, sap);
2882         rcu_read_unlock();
2883         return ret;
2884 }
2885 EXPORT_SYMBOL_GPL(rpc_clnt_xprt_switch_has_addr);
2886
2887 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
2888 static void rpc_show_header(void)
2889 {
2890         printk(KERN_INFO "-pid- flgs status -client- --rqstp- "
2891                 "-timeout ---ops--\n");
2892 }
2893
2894 static void rpc_show_task(const struct rpc_clnt *clnt,
2895                           const struct rpc_task *task)
2896 {
2897         const char *rpc_waitq = "none";
2898
2899         if (RPC_IS_QUEUED(task))
2900                 rpc_waitq = rpc_qname(task->tk_waitqueue);
2901
2902         printk(KERN_INFO "%5u %04x %6d %8p %8p %8ld %8p %sv%u %s a:%ps q:%s\n",
2903                 task->tk_pid, task->tk_flags, task->tk_status,
2904                 clnt, task->tk_rqstp, task->tk_timeout, task->tk_ops,
2905                 clnt->cl_program->name, clnt->cl_vers, rpc_proc_name(task),
2906                 task->tk_action, rpc_waitq);
2907 }
2908
2909 void rpc_show_tasks(struct net *net)
2910 {
2911         struct rpc_clnt *clnt;
2912         struct rpc_task *task;
2913         int header = 0;
2914         struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
2915
2916         spin_lock(&sn->rpc_client_lock);
2917         list_for_each_entry(clnt, &sn->all_clients, cl_clients) {
2918                 spin_lock(&clnt->cl_lock);
2919                 list_for_each_entry(task, &clnt->cl_tasks, tk_task) {
2920                         if (!header) {
2921                                 rpc_show_header();
2922                                 header++;
2923                         }
2924                         rpc_show_task(clnt, task);
2925                 }
2926                 spin_unlock(&clnt->cl_lock);
2927         }
2928         spin_unlock(&sn->rpc_client_lock);
2929 }
2930 #endif
2931
2932 #if IS_ENABLED(CONFIG_SUNRPC_SWAP)
2933 static int
2934 rpc_clnt_swap_activate_callback(struct rpc_clnt *clnt,
2935                 struct rpc_xprt *xprt,
2936                 void *dummy)
2937 {
2938         return xprt_enable_swap(xprt);
2939 }
2940
2941 int
2942 rpc_clnt_swap_activate(struct rpc_clnt *clnt)
2943 {
2944         if (atomic_inc_return(&clnt->cl_swapper) == 1)
2945                 return rpc_clnt_iterate_for_each_xprt(clnt,
2946                                 rpc_clnt_swap_activate_callback, NULL);
2947         return 0;
2948 }
2949 EXPORT_SYMBOL_GPL(rpc_clnt_swap_activate);
2950
2951 static int
2952 rpc_clnt_swap_deactivate_callback(struct rpc_clnt *clnt,
2953                 struct rpc_xprt *xprt,
2954                 void *dummy)
2955 {
2956         xprt_disable_swap(xprt);
2957         return 0;
2958 }
2959
2960 void
2961 rpc_clnt_swap_deactivate(struct rpc_clnt *clnt)
2962 {
2963         if (atomic_dec_if_positive(&clnt->cl_swapper) == 0)
2964                 rpc_clnt_iterate_for_each_xprt(clnt,
2965                                 rpc_clnt_swap_deactivate_callback, NULL);
2966 }
2967 EXPORT_SYMBOL_GPL(rpc_clnt_swap_deactivate);
2968 #endif /* CONFIG_SUNRPC_SWAP */