1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* client.c: NFS client sharing and management code
4 * Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
9 #include <linux/module.h>
10 #include <linux/init.h>
11 #include <linux/sched.h>
12 #include <linux/time.h>
13 #include <linux/kernel.h>
15 #include <linux/string.h>
16 #include <linux/stat.h>
17 #include <linux/errno.h>
18 #include <linux/unistd.h>
19 #include <linux/sunrpc/addr.h>
20 #include <linux/sunrpc/clnt.h>
21 #include <linux/sunrpc/stats.h>
22 #include <linux/sunrpc/metrics.h>
23 #include <linux/sunrpc/xprtsock.h>
24 #include <linux/sunrpc/xprtrdma.h>
25 #include <linux/nfs_fs.h>
26 #include <linux/nfs_mount.h>
27 #include <linux/nfs4_mount.h>
28 #include <linux/lockd/bind.h>
29 #include <linux/seq_file.h>
30 #include <linux/mount.h>
31 #include <linux/vfs.h>
32 #include <linux/inet.h>
33 #include <linux/in6.h>
34 #include <linux/slab.h>
35 #include <linux/idr.h>
37 #include <linux/nfs_xdr.h>
38 #include <linux/sunrpc/bc_xprt.h>
39 #include <linux/nsproxy.h>
40 #include <linux/pid_namespace.h>
45 #include "delegation.h"
55 #define NFSDBG_FACILITY NFSDBG_CLIENT
57 static DECLARE_WAIT_QUEUE_HEAD(nfs_client_active_wq);
58 static DEFINE_SPINLOCK(nfs_version_lock);
59 static DEFINE_MUTEX(nfs_version_mutex);
60 static LIST_HEAD(nfs_versions);
65 static const struct rpc_version *nfs_version[5] = {
71 const struct rpc_program nfs_program = {
73 .number = NFS_PROGRAM,
74 .nrvers = ARRAY_SIZE(nfs_version),
75 .version = nfs_version,
76 .stats = &nfs_rpcstat,
77 .pipe_dir_name = NFS_PIPE_DIRNAME,
80 struct rpc_stat nfs_rpcstat = {
81 .program = &nfs_program
84 static struct nfs_subversion *find_nfs_version(unsigned int version)
86 struct nfs_subversion *nfs;
87 spin_lock(&nfs_version_lock);
89 list_for_each_entry(nfs, &nfs_versions, list) {
90 if (nfs->rpc_ops->version == version) {
91 spin_unlock(&nfs_version_lock);
96 spin_unlock(&nfs_version_lock);
97 return ERR_PTR(-EPROTONOSUPPORT);
100 struct nfs_subversion *get_nfs_version(unsigned int version)
102 struct nfs_subversion *nfs = find_nfs_version(version);
105 mutex_lock(&nfs_version_mutex);
106 request_module("nfsv%d", version);
107 nfs = find_nfs_version(version);
108 mutex_unlock(&nfs_version_mutex);
111 if (!IS_ERR(nfs) && !try_module_get(nfs->owner))
112 return ERR_PTR(-EAGAIN);
116 void put_nfs_version(struct nfs_subversion *nfs)
118 module_put(nfs->owner);
121 void register_nfs_version(struct nfs_subversion *nfs)
123 spin_lock(&nfs_version_lock);
125 list_add(&nfs->list, &nfs_versions);
126 nfs_version[nfs->rpc_ops->version] = nfs->rpc_vers;
128 spin_unlock(&nfs_version_lock);
130 EXPORT_SYMBOL_GPL(register_nfs_version);
132 void unregister_nfs_version(struct nfs_subversion *nfs)
134 spin_lock(&nfs_version_lock);
136 nfs_version[nfs->rpc_ops->version] = NULL;
137 list_del(&nfs->list);
139 spin_unlock(&nfs_version_lock);
141 EXPORT_SYMBOL_GPL(unregister_nfs_version);
144 * Allocate a shared client record
146 * Since these are allocated/deallocated very rarely, we don't
147 * bother putting them in a slab cache...
149 struct nfs_client *nfs_alloc_client(const struct nfs_client_initdata *cl_init)
151 struct nfs_client *clp;
154 if ((clp = kzalloc(sizeof(*clp), GFP_KERNEL)) == NULL)
157 clp->cl_minorversion = cl_init->minorversion;
158 clp->cl_nfs_mod = cl_init->nfs_mod;
159 if (!try_module_get(clp->cl_nfs_mod->owner))
162 clp->rpc_ops = clp->cl_nfs_mod->rpc_ops;
164 refcount_set(&clp->cl_count, 1);
165 clp->cl_cons_state = NFS_CS_INITING;
167 memcpy(&clp->cl_addr, cl_init->addr, cl_init->addrlen);
168 clp->cl_addrlen = cl_init->addrlen;
170 if (cl_init->hostname) {
172 clp->cl_hostname = kstrdup(cl_init->hostname, GFP_KERNEL);
173 if (!clp->cl_hostname)
177 INIT_LIST_HEAD(&clp->cl_superblocks);
178 clp->cl_rpcclient = ERR_PTR(-EINVAL);
180 clp->cl_flags = cl_init->init_flags;
181 clp->cl_proto = cl_init->proto;
182 clp->cl_nconnect = cl_init->nconnect;
183 clp->cl_max_connect = cl_init->max_connect ? cl_init->max_connect : 1;
184 clp->cl_net = get_net(cl_init->net);
186 clp->cl_principal = "*";
187 clp->cl_xprtsec = cl_init->xprtsec;
191 put_nfs_version(clp->cl_nfs_mod);
197 EXPORT_SYMBOL_GPL(nfs_alloc_client);
199 #if IS_ENABLED(CONFIG_NFS_V4)
200 static void nfs_cleanup_cb_ident_idr(struct net *net)
202 struct nfs_net *nn = net_generic(net, nfs_net_id);
204 idr_destroy(&nn->cb_ident_idr);
207 /* nfs_client_lock held */
208 static void nfs_cb_idr_remove_locked(struct nfs_client *clp)
210 struct nfs_net *nn = net_generic(clp->cl_net, nfs_net_id);
212 if (clp->cl_cb_ident)
213 idr_remove(&nn->cb_ident_idr, clp->cl_cb_ident);
216 static void pnfs_init_server(struct nfs_server *server)
218 rpc_init_wait_queue(&server->roc_rpcwaitq, "pNFS ROC");
222 static void nfs_cleanup_cb_ident_idr(struct net *net)
226 static void nfs_cb_idr_remove_locked(struct nfs_client *clp)
230 static void pnfs_init_server(struct nfs_server *server)
234 #endif /* CONFIG_NFS_V4 */
237 * Destroy a shared client record
239 void nfs_free_client(struct nfs_client *clp)
241 /* -EIO all pending I/O */
242 if (!IS_ERR(clp->cl_rpcclient))
243 rpc_shutdown_client(clp->cl_rpcclient);
245 put_net(clp->cl_net);
246 put_nfs_version(clp->cl_nfs_mod);
247 kfree(clp->cl_hostname);
248 kfree(clp->cl_acceptor);
251 EXPORT_SYMBOL_GPL(nfs_free_client);
254 * Release a reference to a shared client record
256 void nfs_put_client(struct nfs_client *clp)
263 nn = net_generic(clp->cl_net, nfs_net_id);
265 if (refcount_dec_and_lock(&clp->cl_count, &nn->nfs_client_lock)) {
266 list_del(&clp->cl_share_link);
267 nfs_cb_idr_remove_locked(clp);
268 spin_unlock(&nn->nfs_client_lock);
270 WARN_ON_ONCE(!list_empty(&clp->cl_superblocks));
272 clp->rpc_ops->free_client(clp);
275 EXPORT_SYMBOL_GPL(nfs_put_client);
278 * Find an nfs_client on the list that matches the initialisation data
281 static struct nfs_client *nfs_match_client(const struct nfs_client_initdata *data)
283 struct nfs_client *clp;
284 const struct sockaddr *sap = (struct sockaddr *)data->addr;
285 struct nfs_net *nn = net_generic(data->net, nfs_net_id);
289 list_for_each_entry(clp, &nn->nfs_client_list, cl_share_link) {
290 const struct sockaddr *clap = (struct sockaddr *)&clp->cl_addr;
291 /* Don't match clients that failed to initialise properly */
292 if (clp->cl_cons_state < 0)
295 /* If a client is still initializing then we need to wait */
296 if (clp->cl_cons_state > NFS_CS_READY) {
297 refcount_inc(&clp->cl_count);
298 spin_unlock(&nn->nfs_client_lock);
299 error = nfs_wait_client_init_complete(clp);
301 spin_lock(&nn->nfs_client_lock);
303 return ERR_PTR(error);
307 /* Different NFS versions cannot share the same nfs_client */
308 if (clp->rpc_ops != data->nfs_mod->rpc_ops)
311 if (clp->cl_proto != data->proto)
313 /* Match nfsv4 minorversion */
314 if (clp->cl_minorversion != data->minorversion)
317 /* Match request for a dedicated DS */
318 if (test_bit(NFS_CS_DS, &data->init_flags) !=
319 test_bit(NFS_CS_DS, &clp->cl_flags))
322 /* Match the full socket address */
323 if (!rpc_cmp_addr_port(sap, clap))
324 /* Match all xprt_switch full socket addresses */
325 if (IS_ERR(clp->cl_rpcclient) ||
326 !rpc_clnt_xprt_switch_has_addr(clp->cl_rpcclient,
330 /* Match the xprt security policy */
331 if (clp->cl_xprtsec.policy != data->xprtsec.policy)
334 refcount_inc(&clp->cl_count);
341 * Return true if @clp is done initializing, false if still working on it.
343 * Use nfs_client_init_status to check if it was successful.
345 bool nfs_client_init_is_complete(const struct nfs_client *clp)
347 return clp->cl_cons_state <= NFS_CS_READY;
349 EXPORT_SYMBOL_GPL(nfs_client_init_is_complete);
352 * Return 0 if @clp was successfully initialized, -errno otherwise.
354 * This must be called *after* nfs_client_init_is_complete() returns true,
355 * otherwise it will pop WARN_ON_ONCE and return -EINVAL
357 int nfs_client_init_status(const struct nfs_client *clp)
359 /* called without checking nfs_client_init_is_complete */
360 if (clp->cl_cons_state > NFS_CS_READY) {
364 return clp->cl_cons_state;
366 EXPORT_SYMBOL_GPL(nfs_client_init_status);
368 int nfs_wait_client_init_complete(const struct nfs_client *clp)
370 return wait_event_killable(nfs_client_active_wq,
371 nfs_client_init_is_complete(clp));
373 EXPORT_SYMBOL_GPL(nfs_wait_client_init_complete);
376 * Found an existing client. Make sure it's ready before returning.
378 static struct nfs_client *
379 nfs_found_client(const struct nfs_client_initdata *cl_init,
380 struct nfs_client *clp)
384 error = nfs_wait_client_init_complete(clp);
387 return ERR_PTR(-ERESTARTSYS);
390 if (clp->cl_cons_state < NFS_CS_READY) {
391 error = clp->cl_cons_state;
393 return ERR_PTR(error);
401 * Look up a client by IP address and protocol version
402 * - creates a new record if one doesn't yet exist
404 struct nfs_client *nfs_get_client(const struct nfs_client_initdata *cl_init)
406 struct nfs_client *clp, *new = NULL;
407 struct nfs_net *nn = net_generic(cl_init->net, nfs_net_id);
408 const struct nfs_rpc_ops *rpc_ops = cl_init->nfs_mod->rpc_ops;
410 if (cl_init->hostname == NULL) {
412 return ERR_PTR(-EINVAL);
415 /* see if the client already exists */
417 spin_lock(&nn->nfs_client_lock);
419 clp = nfs_match_client(cl_init);
421 spin_unlock(&nn->nfs_client_lock);
423 new->rpc_ops->free_client(new);
426 return nfs_found_client(cl_init, clp);
429 list_add_tail(&new->cl_share_link,
430 &nn->nfs_client_list);
431 spin_unlock(&nn->nfs_client_lock);
432 return rpc_ops->init_client(new, cl_init);
435 spin_unlock(&nn->nfs_client_lock);
437 new = rpc_ops->alloc_client(cl_init);
438 } while (!IS_ERR(new));
442 EXPORT_SYMBOL_GPL(nfs_get_client);
445 * Mark a server as ready or failed
447 void nfs_mark_client_ready(struct nfs_client *clp, int state)
450 clp->cl_cons_state = state;
451 wake_up_all(&nfs_client_active_wq);
453 EXPORT_SYMBOL_GPL(nfs_mark_client_ready);
456 * Initialise the timeout values for a connection
458 void nfs_init_timeout_values(struct rpc_timeout *to, int proto,
459 int timeo, int retrans)
461 to->to_initval = timeo * HZ / 10;
462 to->to_retries = retrans;
465 case XPRT_TRANSPORT_TCP:
466 case XPRT_TRANSPORT_TCP_TLS:
467 case XPRT_TRANSPORT_RDMA:
468 if (retrans == NFS_UNSPEC_RETRANS)
469 to->to_retries = NFS_DEF_TCP_RETRANS;
470 if (timeo == NFS_UNSPEC_TIMEO || to->to_initval == 0)
471 to->to_initval = NFS_DEF_TCP_TIMEO * HZ / 10;
472 if (to->to_initval > NFS_MAX_TCP_TIMEOUT)
473 to->to_initval = NFS_MAX_TCP_TIMEOUT;
474 to->to_increment = to->to_initval;
475 to->to_maxval = to->to_initval + (to->to_increment * to->to_retries);
476 if (to->to_maxval > NFS_MAX_TCP_TIMEOUT)
477 to->to_maxval = NFS_MAX_TCP_TIMEOUT;
478 if (to->to_maxval < to->to_initval)
479 to->to_maxval = to->to_initval;
480 to->to_exponential = 0;
482 case XPRT_TRANSPORT_UDP:
483 if (retrans == NFS_UNSPEC_RETRANS)
484 to->to_retries = NFS_DEF_UDP_RETRANS;
485 if (timeo == NFS_UNSPEC_TIMEO || to->to_initval == 0)
486 to->to_initval = NFS_DEF_UDP_TIMEO * HZ / 10;
487 if (to->to_initval > NFS_MAX_UDP_TIMEOUT)
488 to->to_initval = NFS_MAX_UDP_TIMEOUT;
489 to->to_maxval = NFS_MAX_UDP_TIMEOUT;
490 to->to_exponential = 1;
496 EXPORT_SYMBOL_GPL(nfs_init_timeout_values);
499 * Create an RPC client handle
501 int nfs_create_rpc_client(struct nfs_client *clp,
502 const struct nfs_client_initdata *cl_init,
503 rpc_authflavor_t flavor)
505 struct rpc_clnt *clnt = NULL;
506 struct rpc_create_args args = {
508 .protocol = clp->cl_proto,
509 .nconnect = clp->cl_nconnect,
510 .address = (struct sockaddr *)&clp->cl_addr,
511 .addrsize = clp->cl_addrlen,
512 .timeout = cl_init->timeparms,
513 .servername = clp->cl_hostname,
514 .nodename = cl_init->nodename,
515 .program = &nfs_program,
516 .version = clp->rpc_ops->version,
517 .authflavor = flavor,
518 .cred = cl_init->cred,
519 .xprtsec = cl_init->xprtsec,
520 .connect_timeout = cl_init->connect_timeout,
521 .reconnect_timeout = cl_init->reconnect_timeout,
524 if (test_bit(NFS_CS_DISCRTRY, &clp->cl_flags))
525 args.flags |= RPC_CLNT_CREATE_DISCRTRY;
526 if (test_bit(NFS_CS_NO_RETRANS_TIMEOUT, &clp->cl_flags))
527 args.flags |= RPC_CLNT_CREATE_NO_RETRANS_TIMEOUT;
528 if (test_bit(NFS_CS_NORESVPORT, &clp->cl_flags))
529 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
530 if (test_bit(NFS_CS_INFINITE_SLOTS, &clp->cl_flags))
531 args.flags |= RPC_CLNT_CREATE_INFINITE_SLOTS;
532 if (test_bit(NFS_CS_NOPING, &clp->cl_flags))
533 args.flags |= RPC_CLNT_CREATE_NOPING;
534 if (test_bit(NFS_CS_REUSEPORT, &clp->cl_flags))
535 args.flags |= RPC_CLNT_CREATE_REUSEPORT;
537 if (!IS_ERR(clp->cl_rpcclient))
540 clnt = rpc_create(&args);
542 dprintk("%s: cannot create RPC client. Error = %ld\n",
543 __func__, PTR_ERR(clnt));
544 return PTR_ERR(clnt);
547 clnt->cl_principal = clp->cl_principal;
548 clp->cl_rpcclient = clnt;
549 clnt->cl_max_connect = clp->cl_max_connect;
552 EXPORT_SYMBOL_GPL(nfs_create_rpc_client);
555 * Version 2 or 3 client destruction
557 static void nfs_destroy_server(struct nfs_server *server)
559 if (server->nlm_host)
560 nlmclnt_done(server->nlm_host);
564 * Version 2 or 3 lockd setup
566 static int nfs_start_lockd(struct nfs_server *server)
568 struct nlm_host *host;
569 struct nfs_client *clp = server->nfs_client;
570 struct nlmclnt_initdata nlm_init = {
571 .hostname = clp->cl_hostname,
572 .address = (struct sockaddr *)&clp->cl_addr,
573 .addrlen = clp->cl_addrlen,
574 .nfs_version = clp->rpc_ops->version,
575 .noresvport = server->flags & NFS_MOUNT_NORESVPORT ?
578 .nlmclnt_ops = clp->cl_nfs_mod->rpc_ops->nlmclnt_ops,
579 .cred = server->cred,
582 if (nlm_init.nfs_version > 3)
584 if ((server->flags & NFS_MOUNT_LOCAL_FLOCK) &&
585 (server->flags & NFS_MOUNT_LOCAL_FCNTL))
588 switch (clp->cl_proto) {
590 nlm_init.protocol = IPPROTO_TCP;
592 #ifndef CONFIG_NFS_DISABLE_UDP_SUPPORT
593 case XPRT_TRANSPORT_UDP:
594 nlm_init.protocol = IPPROTO_UDP;
598 host = nlmclnt_init(&nlm_init);
600 return PTR_ERR(host);
602 server->nlm_host = host;
603 server->destroy = nfs_destroy_server;
604 nfs_sysfs_link_rpc_client(server, nlmclnt_rpc_clnt(host), NULL);
609 * Create a general RPC client
611 int nfs_init_server_rpcclient(struct nfs_server *server,
612 const struct rpc_timeout *timeo,
613 rpc_authflavor_t pseudoflavour)
615 struct nfs_client *clp = server->nfs_client;
617 server->client = rpc_clone_client_set_auth(clp->cl_rpcclient,
619 if (IS_ERR(server->client)) {
620 dprintk("%s: couldn't create rpc_client!\n", __func__);
621 return PTR_ERR(server->client);
624 memcpy(&server->client->cl_timeout_default,
626 sizeof(server->client->cl_timeout_default));
627 server->client->cl_timeout = &server->client->cl_timeout_default;
628 server->client->cl_softrtry = 0;
629 if (server->flags & NFS_MOUNT_SOFTERR)
630 server->client->cl_softerr = 1;
631 if (server->flags & NFS_MOUNT_SOFT)
632 server->client->cl_softrtry = 1;
634 nfs_sysfs_link_rpc_client(server, server->client, NULL);
637 EXPORT_SYMBOL_GPL(nfs_init_server_rpcclient);
640 * nfs_init_client - Initialise an NFS2 or NFS3 client
642 * @clp: nfs_client to initialise
643 * @cl_init: Initialisation parameters
645 * Returns pointer to an NFS client, or an ERR_PTR value.
647 struct nfs_client *nfs_init_client(struct nfs_client *clp,
648 const struct nfs_client_initdata *cl_init)
652 /* the client is already initialised */
653 if (clp->cl_cons_state == NFS_CS_READY)
657 * Create a client RPC handle for doing FSSTAT with UNIX auth only
658 * - RFC 2623, sec 2.3.2
660 error = nfs_create_rpc_client(clp, cl_init, RPC_AUTH_UNIX);
661 nfs_mark_client_ready(clp, error == 0 ? NFS_CS_READY : error);
664 clp = ERR_PTR(error);
668 EXPORT_SYMBOL_GPL(nfs_init_client);
671 * Create a version 2 or 3 client
673 static int nfs_init_server(struct nfs_server *server,
674 const struct fs_context *fc)
676 const struct nfs_fs_context *ctx = nfs_fc2context(fc);
677 struct rpc_timeout timeparms;
678 struct nfs_client_initdata cl_init = {
679 .hostname = ctx->nfs_server.hostname,
680 .addr = &ctx->nfs_server._address,
681 .addrlen = ctx->nfs_server.addrlen,
682 .nfs_mod = ctx->nfs_mod,
683 .proto = ctx->nfs_server.protocol,
685 .timeparms = &timeparms,
686 .cred = server->cred,
687 .nconnect = ctx->nfs_server.nconnect,
688 .init_flags = (1UL << NFS_CS_REUSEPORT),
689 .xprtsec = ctx->xprtsec,
691 struct nfs_client *clp;
694 nfs_init_timeout_values(&timeparms, ctx->nfs_server.protocol,
695 ctx->timeo, ctx->retrans);
696 if (ctx->flags & NFS_MOUNT_NORESVPORT)
697 set_bit(NFS_CS_NORESVPORT, &cl_init.init_flags);
699 /* Allocate or find a client reference we can use */
700 clp = nfs_get_client(&cl_init);
704 server->nfs_client = clp;
705 nfs_sysfs_add_server(server);
706 nfs_sysfs_link_rpc_client(server, clp->cl_rpcclient, "_state");
708 /* Initialise the client representation from the mount data */
709 server->flags = ctx->flags;
710 server->options = ctx->options;
711 server->caps |= NFS_CAP_HARDLINKS | NFS_CAP_SYMLINKS;
713 switch (clp->rpc_ops->version) {
715 server->fattr_valid = NFS_ATTR_FATTR_V2;
718 server->fattr_valid = NFS_ATTR_FATTR_V3;
721 server->fattr_valid = NFS_ATTR_FATTR_V4;
725 server->rsize = nfs_io_size(ctx->rsize, clp->cl_proto);
727 server->wsize = nfs_io_size(ctx->wsize, clp->cl_proto);
729 server->acregmin = ctx->acregmin * HZ;
730 server->acregmax = ctx->acregmax * HZ;
731 server->acdirmin = ctx->acdirmin * HZ;
732 server->acdirmax = ctx->acdirmax * HZ;
734 /* Start lockd here, before we might error out */
735 error = nfs_start_lockd(server);
739 server->port = ctx->nfs_server.port;
740 server->auth_info = ctx->auth_info;
742 error = nfs_init_server_rpcclient(server, &timeparms,
743 ctx->selected_flavor);
747 /* Preserve the values of mount_server-related mount options */
748 if (ctx->mount_server.addrlen) {
749 memcpy(&server->mountd_address, &ctx->mount_server.address,
750 ctx->mount_server.addrlen);
751 server->mountd_addrlen = ctx->mount_server.addrlen;
753 server->mountd_version = ctx->mount_server.version;
754 server->mountd_port = ctx->mount_server.port;
755 server->mountd_protocol = ctx->mount_server.protocol;
757 server->namelen = ctx->namlen;
761 server->nfs_client = NULL;
767 * Load up the server record from information gained in an fsinfo record
769 static void nfs_server_set_fsinfo(struct nfs_server *server,
770 struct nfs_fsinfo *fsinfo)
772 struct nfs_client *clp = server->nfs_client;
773 unsigned long max_rpc_payload, raw_max_rpc_payload;
775 /* Work out a lot of parameters */
776 if (server->rsize == 0)
777 server->rsize = nfs_io_size(fsinfo->rtpref, clp->cl_proto);
778 if (server->wsize == 0)
779 server->wsize = nfs_io_size(fsinfo->wtpref, clp->cl_proto);
781 if (fsinfo->rtmax >= 512 && server->rsize > fsinfo->rtmax)
782 server->rsize = nfs_io_size(fsinfo->rtmax, clp->cl_proto);
783 if (fsinfo->wtmax >= 512 && server->wsize > fsinfo->wtmax)
784 server->wsize = nfs_io_size(fsinfo->wtmax, clp->cl_proto);
786 raw_max_rpc_payload = rpc_max_payload(server->client);
787 max_rpc_payload = nfs_block_size(raw_max_rpc_payload, NULL);
789 if (server->rsize > max_rpc_payload)
790 server->rsize = max_rpc_payload;
791 if (server->rsize > NFS_MAX_FILE_IO_SIZE)
792 server->rsize = NFS_MAX_FILE_IO_SIZE;
793 server->rpages = (server->rsize + PAGE_SIZE - 1) >> PAGE_SHIFT;
795 if (server->wsize > max_rpc_payload)
796 server->wsize = max_rpc_payload;
797 if (server->wsize > NFS_MAX_FILE_IO_SIZE)
798 server->wsize = NFS_MAX_FILE_IO_SIZE;
799 server->wpages = (server->wsize + PAGE_SIZE - 1) >> PAGE_SHIFT;
801 server->wtmult = nfs_block_bits(fsinfo->wtmult, NULL);
803 server->dtsize = nfs_block_size(fsinfo->dtpref, NULL);
804 if (server->dtsize > NFS_MAX_FILE_IO_SIZE)
805 server->dtsize = NFS_MAX_FILE_IO_SIZE;
806 if (server->dtsize > server->rsize)
807 server->dtsize = server->rsize;
809 if (server->flags & NFS_MOUNT_NOAC) {
810 server->acregmin = server->acregmax = 0;
811 server->acdirmin = server->acdirmax = 0;
814 server->maxfilesize = fsinfo->maxfilesize;
816 server->time_delta = fsinfo->time_delta;
817 server->change_attr_type = fsinfo->change_attr_type;
819 server->clone_blksize = fsinfo->clone_blksize;
820 /* We're airborne Set socket buffersize */
821 rpc_setbufsize(server->client, server->wsize + 100, server->rsize + 100);
823 #ifdef CONFIG_NFS_V4_2
825 * Defaults until limited by the session parameters.
827 server->gxasize = min_t(unsigned int, raw_max_rpc_payload,
829 server->sxasize = min_t(unsigned int, raw_max_rpc_payload,
831 server->lxasize = min_t(unsigned int, raw_max_rpc_payload,
832 nfs42_listxattr_xdrsize(XATTR_LIST_MAX));
834 if (fsinfo->xattr_support)
835 server->caps |= NFS_CAP_XATTR;
840 * Probe filesystem information, including the FSID on v2/v3
842 static int nfs_probe_fsinfo(struct nfs_server *server, struct nfs_fh *mntfh, struct nfs_fattr *fattr)
844 struct nfs_fsinfo fsinfo;
845 struct nfs_client *clp = server->nfs_client;
848 if (clp->rpc_ops->set_capabilities != NULL) {
849 error = clp->rpc_ops->set_capabilities(server, mntfh);
854 fsinfo.fattr = fattr;
855 fsinfo.nlayouttypes = 0;
856 memset(fsinfo.layouttype, 0, sizeof(fsinfo.layouttype));
857 error = clp->rpc_ops->fsinfo(server, mntfh, &fsinfo);
861 nfs_server_set_fsinfo(server, &fsinfo);
863 /* Get some general file system info */
864 if (server->namelen == 0) {
865 struct nfs_pathconf pathinfo;
867 pathinfo.fattr = fattr;
868 nfs_fattr_init(fattr);
870 if (clp->rpc_ops->pathconf(server, mntfh, &pathinfo) >= 0)
871 server->namelen = pathinfo.max_namelen;
874 if (clp->rpc_ops->discover_trunking != NULL &&
875 (server->caps & NFS_CAP_FS_LOCATIONS &&
876 (server->flags & NFS_MOUNT_TRUNK_DISCOVERY))) {
877 error = clp->rpc_ops->discover_trunking(server, mntfh);
886 * Grab the destination's particulars, including lease expiry time.
888 * Returns zero if probe succeeded and retrieved FSID matches the FSID
891 int nfs_probe_server(struct nfs_server *server, struct nfs_fh *mntfh)
893 struct nfs_fattr *fattr;
896 fattr = nfs_alloc_fattr();
900 /* Sanity: the probe won't work if the destination server
901 * does not recognize the migrated FH. */
902 error = nfs_probe_fsinfo(server, mntfh, fattr);
904 nfs_free_fattr(fattr);
907 EXPORT_SYMBOL_GPL(nfs_probe_server);
910 * Copy useful information when duplicating a server record
912 void nfs_server_copy_userdata(struct nfs_server *target, struct nfs_server *source)
914 target->flags = source->flags;
915 target->rsize = source->rsize;
916 target->wsize = source->wsize;
917 target->acregmin = source->acregmin;
918 target->acregmax = source->acregmax;
919 target->acdirmin = source->acdirmin;
920 target->acdirmax = source->acdirmax;
921 target->caps = source->caps;
922 target->options = source->options;
923 target->auth_info = source->auth_info;
924 target->port = source->port;
926 EXPORT_SYMBOL_GPL(nfs_server_copy_userdata);
928 void nfs_server_insert_lists(struct nfs_server *server)
930 struct nfs_client *clp = server->nfs_client;
931 struct nfs_net *nn = net_generic(clp->cl_net, nfs_net_id);
933 spin_lock(&nn->nfs_client_lock);
934 list_add_tail_rcu(&server->client_link, &clp->cl_superblocks);
935 list_add_tail(&server->master_link, &nn->nfs_volume_list);
936 clear_bit(NFS_CS_STOP_RENEW, &clp->cl_res_state);
937 spin_unlock(&nn->nfs_client_lock);
940 EXPORT_SYMBOL_GPL(nfs_server_insert_lists);
942 void nfs_server_remove_lists(struct nfs_server *server)
944 struct nfs_client *clp = server->nfs_client;
949 nn = net_generic(clp->cl_net, nfs_net_id);
950 spin_lock(&nn->nfs_client_lock);
951 list_del_rcu(&server->client_link);
952 if (list_empty(&clp->cl_superblocks))
953 set_bit(NFS_CS_STOP_RENEW, &clp->cl_res_state);
954 list_del(&server->master_link);
955 spin_unlock(&nn->nfs_client_lock);
959 EXPORT_SYMBOL_GPL(nfs_server_remove_lists);
961 static DEFINE_IDA(s_sysfs_ids);
964 * Allocate and initialise a server record
966 struct nfs_server *nfs_alloc_server(void)
968 struct nfs_server *server;
970 server = kzalloc(sizeof(struct nfs_server), GFP_KERNEL);
974 server->s_sysfs_id = ida_alloc(&s_sysfs_ids, GFP_KERNEL);
975 if (server->s_sysfs_id < 0) {
980 server->client = server->client_acl = ERR_PTR(-EINVAL);
982 /* Zero out the NFS state stuff */
983 INIT_LIST_HEAD(&server->client_link);
984 INIT_LIST_HEAD(&server->master_link);
985 INIT_LIST_HEAD(&server->delegations);
986 INIT_LIST_HEAD(&server->layouts);
987 INIT_LIST_HEAD(&server->state_owners_lru);
988 INIT_LIST_HEAD(&server->ss_copies);
990 atomic_set(&server->active, 0);
992 server->io_stats = nfs_alloc_iostats();
993 if (!server->io_stats) {
998 server->change_attr_type = NFS4_CHANGE_TYPE_IS_UNDEFINED;
1000 ida_init(&server->openowner_id);
1001 ida_init(&server->lockowner_id);
1002 pnfs_init_server(server);
1003 rpc_init_wait_queue(&server->uoc_rpcwaitq, "NFS UOC");
1007 EXPORT_SYMBOL_GPL(nfs_alloc_server);
1010 * Free up a server record
1012 void nfs_free_server(struct nfs_server *server)
1014 nfs_server_remove_lists(server);
1016 if (server->destroy != NULL)
1017 server->destroy(server);
1019 if (!IS_ERR(server->client_acl))
1020 rpc_shutdown_client(server->client_acl);
1021 if (!IS_ERR(server->client))
1022 rpc_shutdown_client(server->client);
1024 nfs_put_client(server->nfs_client);
1026 if (server->kobj.state_initialized) {
1027 nfs_sysfs_remove_server(server);
1028 kobject_put(&server->kobj);
1030 ida_free(&s_sysfs_ids, server->s_sysfs_id);
1032 ida_destroy(&server->lockowner_id);
1033 ida_destroy(&server->openowner_id);
1034 nfs_free_iostats(server->io_stats);
1035 put_cred(server->cred);
1037 nfs_release_automount_timer();
1039 EXPORT_SYMBOL_GPL(nfs_free_server);
1042 * Create a version 2 or 3 volume record
1043 * - keyed on server and FSID
1045 struct nfs_server *nfs_create_server(struct fs_context *fc)
1047 struct nfs_fs_context *ctx = nfs_fc2context(fc);
1048 struct nfs_server *server;
1049 struct nfs_fattr *fattr;
1052 server = nfs_alloc_server();
1054 return ERR_PTR(-ENOMEM);
1056 server->cred = get_cred(fc->cred);
1059 fattr = nfs_alloc_fattr();
1063 /* Get a client representation */
1064 error = nfs_init_server(server, fc);
1068 /* Probe the root fh to retrieve its FSID */
1069 error = nfs_probe_fsinfo(server, ctx->mntfh, fattr);
1072 if (server->nfs_client->rpc_ops->version == 3) {
1073 if (server->namelen == 0 || server->namelen > NFS3_MAXNAMLEN)
1074 server->namelen = NFS3_MAXNAMLEN;
1075 if (!(ctx->flags & NFS_MOUNT_NORDIRPLUS))
1076 server->caps |= NFS_CAP_READDIRPLUS;
1078 if (server->namelen == 0 || server->namelen > NFS2_MAXNAMLEN)
1079 server->namelen = NFS2_MAXNAMLEN;
1082 if (!(fattr->valid & NFS_ATTR_FATTR)) {
1083 error = ctx->nfs_mod->rpc_ops->getattr(server, ctx->mntfh,
1086 dprintk("nfs_create_server: getattr error = %d\n", -error);
1090 memcpy(&server->fsid, &fattr->fsid, sizeof(server->fsid));
1092 dprintk("Server FSID: %llx:%llx\n",
1093 (unsigned long long) server->fsid.major,
1094 (unsigned long long) server->fsid.minor);
1096 nfs_server_insert_lists(server);
1097 server->mount_time = jiffies;
1098 nfs_free_fattr(fattr);
1102 nfs_free_fattr(fattr);
1103 nfs_free_server(server);
1104 return ERR_PTR(error);
1106 EXPORT_SYMBOL_GPL(nfs_create_server);
1109 * Clone an NFS2, NFS3 or NFS4 server record
1111 struct nfs_server *nfs_clone_server(struct nfs_server *source,
1113 struct nfs_fattr *fattr,
1114 rpc_authflavor_t flavor)
1116 struct nfs_server *server;
1119 server = nfs_alloc_server();
1121 return ERR_PTR(-ENOMEM);
1123 server->cred = get_cred(source->cred);
1125 /* Copy data from the source */
1126 server->nfs_client = source->nfs_client;
1127 server->destroy = source->destroy;
1128 refcount_inc(&server->nfs_client->cl_count);
1129 nfs_server_copy_userdata(server, source);
1131 server->fsid = fattr->fsid;
1133 nfs_sysfs_add_server(server);
1135 nfs_sysfs_link_rpc_client(server,
1136 server->nfs_client->cl_rpcclient, "_state");
1138 error = nfs_init_server_rpcclient(server,
1139 source->client->cl_timeout,
1142 goto out_free_server;
1144 /* probe the filesystem info for this server filesystem */
1145 error = nfs_probe_server(server, fh);
1147 goto out_free_server;
1149 if (server->namelen == 0 || server->namelen > NFS4_MAXNAMLEN)
1150 server->namelen = NFS4_MAXNAMLEN;
1152 error = nfs_start_lockd(server);
1154 goto out_free_server;
1156 nfs_server_insert_lists(server);
1157 server->mount_time = jiffies;
1162 nfs_free_server(server);
1163 return ERR_PTR(error);
1165 EXPORT_SYMBOL_GPL(nfs_clone_server);
1167 void nfs_clients_init(struct net *net)
1169 struct nfs_net *nn = net_generic(net, nfs_net_id);
1171 INIT_LIST_HEAD(&nn->nfs_client_list);
1172 INIT_LIST_HEAD(&nn->nfs_volume_list);
1173 #if IS_ENABLED(CONFIG_NFS_V4)
1174 idr_init(&nn->cb_ident_idr);
1176 spin_lock_init(&nn->nfs_client_lock);
1177 nn->boot_time = ktime_get_real();
1179 nfs_netns_sysfs_setup(nn, net);
1182 void nfs_clients_exit(struct net *net)
1184 struct nfs_net *nn = net_generic(net, nfs_net_id);
1186 nfs_netns_sysfs_destroy(nn);
1187 nfs_cleanup_cb_ident_idr(net);
1188 WARN_ON_ONCE(!list_empty(&nn->nfs_client_list));
1189 WARN_ON_ONCE(!list_empty(&nn->nfs_volume_list));
1192 #ifdef CONFIG_PROC_FS
1193 static void *nfs_server_list_start(struct seq_file *p, loff_t *pos);
1194 static void *nfs_server_list_next(struct seq_file *p, void *v, loff_t *pos);
1195 static void nfs_server_list_stop(struct seq_file *p, void *v);
1196 static int nfs_server_list_show(struct seq_file *m, void *v);
1198 static const struct seq_operations nfs_server_list_ops = {
1199 .start = nfs_server_list_start,
1200 .next = nfs_server_list_next,
1201 .stop = nfs_server_list_stop,
1202 .show = nfs_server_list_show,
1205 static void *nfs_volume_list_start(struct seq_file *p, loff_t *pos);
1206 static void *nfs_volume_list_next(struct seq_file *p, void *v, loff_t *pos);
1207 static void nfs_volume_list_stop(struct seq_file *p, void *v);
1208 static int nfs_volume_list_show(struct seq_file *m, void *v);
1210 static const struct seq_operations nfs_volume_list_ops = {
1211 .start = nfs_volume_list_start,
1212 .next = nfs_volume_list_next,
1213 .stop = nfs_volume_list_stop,
1214 .show = nfs_volume_list_show,
1218 * set up the iterator to start reading from the server list and return the first item
1220 static void *nfs_server_list_start(struct seq_file *m, loff_t *_pos)
1221 __acquires(&nn->nfs_client_lock)
1223 struct nfs_net *nn = net_generic(seq_file_net(m), nfs_net_id);
1225 /* lock the list against modification */
1226 spin_lock(&nn->nfs_client_lock);
1227 return seq_list_start_head(&nn->nfs_client_list, *_pos);
1231 * move to next server
1233 static void *nfs_server_list_next(struct seq_file *p, void *v, loff_t *pos)
1235 struct nfs_net *nn = net_generic(seq_file_net(p), nfs_net_id);
1237 return seq_list_next(v, &nn->nfs_client_list, pos);
1241 * clean up after reading from the transports list
1243 static void nfs_server_list_stop(struct seq_file *p, void *v)
1244 __releases(&nn->nfs_client_lock)
1246 struct nfs_net *nn = net_generic(seq_file_net(p), nfs_net_id);
1248 spin_unlock(&nn->nfs_client_lock);
1252 * display a header line followed by a load of call lines
1254 static int nfs_server_list_show(struct seq_file *m, void *v)
1256 struct nfs_client *clp;
1257 struct nfs_net *nn = net_generic(seq_file_net(m), nfs_net_id);
1259 /* display header on line 1 */
1260 if (v == &nn->nfs_client_list) {
1261 seq_puts(m, "NV SERVER PORT USE HOSTNAME\n");
1265 /* display one transport per line on subsequent lines */
1266 clp = list_entry(v, struct nfs_client, cl_share_link);
1268 /* Check if the client is initialized */
1269 if (clp->cl_cons_state != NFS_CS_READY)
1273 seq_printf(m, "v%u %s %s %3d %s\n",
1274 clp->rpc_ops->version,
1275 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_ADDR),
1276 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_PORT),
1277 refcount_read(&clp->cl_count),
1285 * set up the iterator to start reading from the volume list and return the first item
1287 static void *nfs_volume_list_start(struct seq_file *m, loff_t *_pos)
1288 __acquires(&nn->nfs_client_lock)
1290 struct nfs_net *nn = net_generic(seq_file_net(m), nfs_net_id);
1292 /* lock the list against modification */
1293 spin_lock(&nn->nfs_client_lock);
1294 return seq_list_start_head(&nn->nfs_volume_list, *_pos);
1298 * move to next volume
1300 static void *nfs_volume_list_next(struct seq_file *p, void *v, loff_t *pos)
1302 struct nfs_net *nn = net_generic(seq_file_net(p), nfs_net_id);
1304 return seq_list_next(v, &nn->nfs_volume_list, pos);
1308 * clean up after reading from the transports list
1310 static void nfs_volume_list_stop(struct seq_file *p, void *v)
1311 __releases(&nn->nfs_client_lock)
1313 struct nfs_net *nn = net_generic(seq_file_net(p), nfs_net_id);
1315 spin_unlock(&nn->nfs_client_lock);
1319 * display a header line followed by a load of call lines
1321 static int nfs_volume_list_show(struct seq_file *m, void *v)
1323 struct nfs_server *server;
1324 struct nfs_client *clp;
1325 char dev[13]; // 8 for 2^24, 1 for ':', 3 for 2^8, 1 for '\0'
1326 char fsid[34]; // 2 * 16 for %llx, 1 for ':', 1 for '\0'
1327 struct nfs_net *nn = net_generic(seq_file_net(m), nfs_net_id);
1329 /* display header on line 1 */
1330 if (v == &nn->nfs_volume_list) {
1331 seq_puts(m, "NV SERVER PORT DEV FSID"
1335 /* display one transport per line on subsequent lines */
1336 server = list_entry(v, struct nfs_server, master_link);
1337 clp = server->nfs_client;
1339 snprintf(dev, sizeof(dev), "%u:%u",
1340 MAJOR(server->s_dev), MINOR(server->s_dev));
1342 snprintf(fsid, sizeof(fsid), "%llx:%llx",
1343 (unsigned long long) server->fsid.major,
1344 (unsigned long long) server->fsid.minor);
1347 seq_printf(m, "v%u %s %s %-12s %-33s %s\n",
1348 clp->rpc_ops->version,
1349 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_ADDR),
1350 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_PORT),
1353 nfs_server_fscache_state(server));
1359 int nfs_fs_proc_net_init(struct net *net)
1361 struct nfs_net *nn = net_generic(net, nfs_net_id);
1362 struct proc_dir_entry *p;
1364 nn->proc_nfsfs = proc_net_mkdir(net, "nfsfs", net->proc_net);
1365 if (!nn->proc_nfsfs)
1368 /* a file of servers with which we're dealing */
1369 p = proc_create_net("servers", S_IFREG|S_IRUGO, nn->proc_nfsfs,
1370 &nfs_server_list_ops, sizeof(struct seq_net_private));
1374 /* a file of volumes that we have mounted */
1375 p = proc_create_net("volumes", S_IFREG|S_IRUGO, nn->proc_nfsfs,
1376 &nfs_volume_list_ops, sizeof(struct seq_net_private));
1382 remove_proc_subtree("nfsfs", net->proc_net);
1387 void nfs_fs_proc_net_exit(struct net *net)
1389 remove_proc_subtree("nfsfs", net->proc_net);
1393 * initialise the /proc/fs/nfsfs/ directory
1395 int __init nfs_fs_proc_init(void)
1397 if (!proc_mkdir("fs/nfsfs", NULL))
1400 /* a file of servers with which we're dealing */
1401 if (!proc_symlink("fs/nfsfs/servers", NULL, "../../net/nfsfs/servers"))
1404 /* a file of volumes that we have mounted */
1405 if (!proc_symlink("fs/nfsfs/volumes", NULL, "../../net/nfsfs/volumes"))
1410 remove_proc_subtree("fs/nfsfs", NULL);
1416 * clean up the /proc/fs/nfsfs/ directory
1418 void nfs_fs_proc_exit(void)
1420 remove_proc_subtree("fs/nfsfs", NULL);
1421 ida_destroy(&s_sysfs_ids);
1424 #endif /* CONFIG_PROC_FS */