1 /* client.c: NFS client sharing and management code
3 * Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
4 * Written by David Howells (dhowells@redhat.com)
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
13 #include <linux/module.h>
14 #include <linux/init.h>
15 #include <linux/sched.h>
16 #include <linux/time.h>
17 #include <linux/kernel.h>
19 #include <linux/string.h>
20 #include <linux/stat.h>
21 #include <linux/errno.h>
22 #include <linux/unistd.h>
23 #include <linux/sunrpc/clnt.h>
24 #include <linux/sunrpc/stats.h>
25 #include <linux/sunrpc/metrics.h>
26 #include <linux/sunrpc/xprtsock.h>
27 #include <linux/sunrpc/xprtrdma.h>
28 #include <linux/nfs_fs.h>
29 #include <linux/nfs_mount.h>
30 #include <linux/nfs4_mount.h>
31 #include <linux/lockd/bind.h>
32 #include <linux/seq_file.h>
33 #include <linux/mount.h>
34 #include <linux/nfs_idmap.h>
35 #include <linux/vfs.h>
36 #include <linux/inet.h>
37 #include <linux/in6.h>
39 #include <linux/nfs_xdr.h>
40 #include <linux/sunrpc/bc_xprt.h>
42 #include <asm/system.h>
46 #include "delegation.h"
51 #define NFSDBG_FACILITY NFSDBG_CLIENT
53 static DEFINE_SPINLOCK(nfs_client_lock);
54 static LIST_HEAD(nfs_client_list);
55 static LIST_HEAD(nfs_volume_list);
56 static DECLARE_WAIT_QUEUE_HEAD(nfs_client_active_wq);
61 static struct rpc_version *nfs_version[5] = {
71 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",
80 struct rpc_stat nfs_rpcstat = {
81 .program = &nfs_program
85 #ifdef CONFIG_NFS_V3_ACL
86 static struct rpc_stat nfsacl_rpcstat = { &nfsacl_program };
87 static struct rpc_version * nfsacl_version[] = {
88 [3] = &nfsacl_version3,
91 struct rpc_program nfsacl_program = {
93 .number = NFS_ACL_PROGRAM,
94 .nrvers = ARRAY_SIZE(nfsacl_version),
95 .version = nfsacl_version,
96 .stats = &nfsacl_rpcstat,
98 #endif /* CONFIG_NFS_V3_ACL */
100 struct nfs_client_initdata {
101 const char *hostname;
102 const struct sockaddr *addr;
104 const struct nfs_rpc_ops *rpc_ops;
110 * Allocate a shared client record
112 * Since these are allocated/deallocated very rarely, we don't
113 * bother putting them in a slab cache...
115 static struct nfs_client *nfs_alloc_client(const struct nfs_client_initdata *cl_init)
117 struct nfs_client *clp;
118 struct rpc_cred *cred;
120 if ((clp = kzalloc(sizeof(*clp), GFP_KERNEL)) == NULL)
123 clp->rpc_ops = cl_init->rpc_ops;
125 atomic_set(&clp->cl_count, 1);
126 clp->cl_cons_state = NFS_CS_INITING;
128 memcpy(&clp->cl_addr, cl_init->addr, cl_init->addrlen);
129 clp->cl_addrlen = cl_init->addrlen;
131 if (cl_init->hostname) {
132 clp->cl_hostname = kstrdup(cl_init->hostname, GFP_KERNEL);
133 if (!clp->cl_hostname)
137 INIT_LIST_HEAD(&clp->cl_superblocks);
138 clp->cl_rpcclient = ERR_PTR(-EINVAL);
140 clp->cl_proto = cl_init->proto;
143 INIT_LIST_HEAD(&clp->cl_delegations);
144 spin_lock_init(&clp->cl_lock);
145 INIT_DELAYED_WORK(&clp->cl_renewd, nfs4_renew_state);
146 rpc_init_wait_queue(&clp->cl_rpcwaitq, "NFS client");
147 clp->cl_boot_time = CURRENT_TIME;
148 clp->cl_state = 1 << NFS4CLNT_LEASE_EXPIRED;
149 clp->cl_minorversion = cl_init->minorversion;
151 cred = rpc_lookup_machine_cred();
153 clp->cl_machine_cred = cred;
155 nfs_fscache_get_client_cookie(clp);
165 static void nfs4_shutdown_client(struct nfs_client *clp)
168 if (__test_and_clear_bit(NFS_CS_RENEWD, &clp->cl_res_state))
169 nfs4_kill_renewd(clp);
170 BUG_ON(!RB_EMPTY_ROOT(&clp->cl_state_owners));
171 if (__test_and_clear_bit(NFS_CS_IDMAP, &clp->cl_res_state))
172 nfs_idmap_delete(clp);
174 rpc_destroy_wait_queue(&clp->cl_rpcwaitq);
179 * Destroy the NFS4 callback service
181 static void nfs4_destroy_callback(struct nfs_client *clp)
184 if (__test_and_clear_bit(NFS_CS_CALLBACK, &clp->cl_res_state))
185 nfs_callback_down(clp->cl_minorversion);
186 #endif /* CONFIG_NFS_V4 */
190 * Clears/puts all minor version specific parts from an nfs_client struct
191 * reverting it to minorversion 0.
193 static void nfs4_clear_client_minor_version(struct nfs_client *clp)
195 #ifdef CONFIG_NFS_V4_1
196 if (nfs4_has_session(clp)) {
197 nfs4_destroy_session(clp->cl_session);
198 clp->cl_session = NULL;
201 clp->cl_call_sync = _nfs4_call_sync;
202 #endif /* CONFIG_NFS_V4_1 */
204 nfs4_destroy_callback(clp);
208 * Destroy a shared client record
210 static void nfs_free_client(struct nfs_client *clp)
212 dprintk("--> nfs_free_client(%u)\n", clp->rpc_ops->version);
214 nfs4_clear_client_minor_version(clp);
215 nfs4_shutdown_client(clp);
217 nfs_fscache_release_client_cookie(clp);
219 /* -EIO all pending I/O */
220 if (!IS_ERR(clp->cl_rpcclient))
221 rpc_shutdown_client(clp->cl_rpcclient);
223 if (clp->cl_machine_cred != NULL)
224 put_rpccred(clp->cl_machine_cred);
226 kfree(clp->cl_hostname);
229 dprintk("<-- nfs_free_client()\n");
233 * Release a reference to a shared client record
235 void nfs_put_client(struct nfs_client *clp)
240 dprintk("--> nfs_put_client({%d})\n", atomic_read(&clp->cl_count));
242 if (atomic_dec_and_lock(&clp->cl_count, &nfs_client_lock)) {
243 list_del(&clp->cl_share_link);
244 spin_unlock(&nfs_client_lock);
246 BUG_ON(!list_empty(&clp->cl_superblocks));
248 nfs_free_client(clp);
252 #if defined(CONFIG_IPV6) || defined(CONFIG_IPV6_MODULE)
254 * Test if two ip6 socket addresses refer to the same socket by
255 * comparing relevant fields. The padding bytes specifically, are not
256 * compared. sin6_flowinfo is not compared because it only affects QoS
257 * and sin6_scope_id is only compared if the address is "link local"
258 * because "link local" addresses need only be unique to a specific
259 * link. Conversely, ordinary unicast addresses might have different
262 * The caller should ensure both socket addresses are AF_INET6.
264 static int nfs_sockaddr_match_ipaddr6(const struct sockaddr *sa1,
265 const struct sockaddr *sa2)
267 const struct sockaddr_in6 *sin1 = (const struct sockaddr_in6 *)sa1;
268 const struct sockaddr_in6 *sin2 = (const struct sockaddr_in6 *)sa2;
270 if (ipv6_addr_scope(&sin1->sin6_addr) == IPV6_ADDR_SCOPE_LINKLOCAL &&
271 sin1->sin6_scope_id != sin2->sin6_scope_id)
274 return ipv6_addr_equal(&sin1->sin6_addr, &sin1->sin6_addr);
276 #else /* !defined(CONFIG_IPV6) && !defined(CONFIG_IPV6_MODULE) */
277 static int nfs_sockaddr_match_ipaddr6(const struct sockaddr *sa1,
278 const struct sockaddr *sa2)
285 * Test if two ip4 socket addresses refer to the same socket, by
286 * comparing relevant fields. The padding bytes specifically, are
289 * The caller should ensure both socket addresses are AF_INET.
291 static int nfs_sockaddr_match_ipaddr4(const struct sockaddr *sa1,
292 const struct sockaddr *sa2)
294 const struct sockaddr_in *sin1 = (const struct sockaddr_in *)sa1;
295 const struct sockaddr_in *sin2 = (const struct sockaddr_in *)sa2;
297 return sin1->sin_addr.s_addr == sin2->sin_addr.s_addr;
300 static int nfs_sockaddr_cmp_ip6(const struct sockaddr *sa1,
301 const struct sockaddr *sa2)
303 const struct sockaddr_in6 *sin1 = (const struct sockaddr_in6 *)sa1;
304 const struct sockaddr_in6 *sin2 = (const struct sockaddr_in6 *)sa2;
306 return nfs_sockaddr_match_ipaddr6(sa1, sa2) &&
307 (sin1->sin6_port == sin2->sin6_port);
310 static int nfs_sockaddr_cmp_ip4(const struct sockaddr *sa1,
311 const struct sockaddr *sa2)
313 const struct sockaddr_in *sin1 = (const struct sockaddr_in *)sa1;
314 const struct sockaddr_in *sin2 = (const struct sockaddr_in *)sa2;
316 return nfs_sockaddr_match_ipaddr4(sa1, sa2) &&
317 (sin1->sin_port == sin2->sin_port);
321 * Test if two socket addresses represent the same actual socket,
322 * by comparing (only) relevant fields, excluding the port number.
324 static int nfs_sockaddr_match_ipaddr(const struct sockaddr *sa1,
325 const struct sockaddr *sa2)
327 if (sa1->sa_family != sa2->sa_family)
330 switch (sa1->sa_family) {
332 return nfs_sockaddr_match_ipaddr4(sa1, sa2);
334 return nfs_sockaddr_match_ipaddr6(sa1, sa2);
340 * Test if two socket addresses represent the same actual socket,
341 * by comparing (only) relevant fields, including the port number.
343 static int nfs_sockaddr_cmp(const struct sockaddr *sa1,
344 const struct sockaddr *sa2)
346 if (sa1->sa_family != sa2->sa_family)
349 switch (sa1->sa_family) {
351 return nfs_sockaddr_cmp_ip4(sa1, sa2);
353 return nfs_sockaddr_cmp_ip6(sa1, sa2);
359 * Find a client by IP address and protocol version
360 * - returns NULL if no such client
362 struct nfs_client *nfs_find_client(const struct sockaddr *addr, u32 nfsversion)
364 struct nfs_client *clp;
366 spin_lock(&nfs_client_lock);
367 list_for_each_entry(clp, &nfs_client_list, cl_share_link) {
368 struct sockaddr *clap = (struct sockaddr *)&clp->cl_addr;
370 /* Don't match clients that failed to initialise properly */
371 if (!(clp->cl_cons_state == NFS_CS_READY ||
372 clp->cl_cons_state == NFS_CS_SESSION_INITING))
375 /* Different NFS versions cannot share the same nfs_client */
376 if (clp->rpc_ops->version != nfsversion)
379 /* Match only the IP address, not the port number */
380 if (!nfs_sockaddr_match_ipaddr(addr, clap))
383 atomic_inc(&clp->cl_count);
384 spin_unlock(&nfs_client_lock);
387 spin_unlock(&nfs_client_lock);
392 * Find a client by IP address and protocol version
393 * - returns NULL if no such client
395 struct nfs_client *nfs_find_client_next(struct nfs_client *clp)
397 struct sockaddr *sap = (struct sockaddr *)&clp->cl_addr;
398 u32 nfsvers = clp->rpc_ops->version;
400 spin_lock(&nfs_client_lock);
401 list_for_each_entry_continue(clp, &nfs_client_list, cl_share_link) {
402 struct sockaddr *clap = (struct sockaddr *)&clp->cl_addr;
404 /* Don't match clients that failed to initialise properly */
405 if (clp->cl_cons_state != NFS_CS_READY)
408 /* Different NFS versions cannot share the same nfs_client */
409 if (clp->rpc_ops->version != nfsvers)
412 /* Match only the IP address, not the port number */
413 if (!nfs_sockaddr_match_ipaddr(sap, clap))
416 atomic_inc(&clp->cl_count);
417 spin_unlock(&nfs_client_lock);
420 spin_unlock(&nfs_client_lock);
425 * Find an nfs_client on the list that matches the initialisation data
428 static struct nfs_client *nfs_match_client(const struct nfs_client_initdata *data)
430 struct nfs_client *clp;
431 const struct sockaddr *sap = data->addr;
433 list_for_each_entry(clp, &nfs_client_list, cl_share_link) {
434 const struct sockaddr *clap = (struct sockaddr *)&clp->cl_addr;
435 /* Don't match clients that failed to initialise properly */
436 if (clp->cl_cons_state < 0)
439 /* Different NFS versions cannot share the same nfs_client */
440 if (clp->rpc_ops != data->rpc_ops)
443 if (clp->cl_proto != data->proto)
445 /* Match nfsv4 minorversion */
446 if (clp->cl_minorversion != data->minorversion)
448 /* Match the full socket address */
449 if (!nfs_sockaddr_cmp(sap, clap))
452 atomic_inc(&clp->cl_count);
459 * Look up a client by IP address and protocol version
460 * - creates a new record if one doesn't yet exist
462 static struct nfs_client *nfs_get_client(const struct nfs_client_initdata *cl_init)
464 struct nfs_client *clp, *new = NULL;
467 dprintk("--> nfs_get_client(%s,v%u)\n",
468 cl_init->hostname ?: "", cl_init->rpc_ops->version);
470 /* see if the client already exists */
472 spin_lock(&nfs_client_lock);
474 clp = nfs_match_client(cl_init);
480 spin_unlock(&nfs_client_lock);
482 new = nfs_alloc_client(cl_init);
485 return ERR_PTR(-ENOMEM);
487 /* install a new client and return with it unready */
490 list_add(&clp->cl_share_link, &nfs_client_list);
491 spin_unlock(&nfs_client_lock);
492 dprintk("--> nfs_get_client() = %p [new]\n", clp);
495 /* found an existing client
496 * - make sure it's ready before returning
499 spin_unlock(&nfs_client_lock);
502 nfs_free_client(new);
504 error = wait_event_killable(nfs_client_active_wq,
505 clp->cl_cons_state < NFS_CS_INITING);
508 return ERR_PTR(-ERESTARTSYS);
511 if (clp->cl_cons_state < NFS_CS_READY) {
512 error = clp->cl_cons_state;
514 return ERR_PTR(error);
517 BUG_ON(clp->cl_cons_state != NFS_CS_READY);
519 dprintk("--> nfs_get_client() = %p [share]\n", clp);
524 * Mark a server as ready or failed
526 void nfs_mark_client_ready(struct nfs_client *clp, int state)
528 clp->cl_cons_state = state;
529 wake_up_all(&nfs_client_active_wq);
533 * With sessions, the client is not marked ready until after a
534 * successful EXCHANGE_ID and CREATE_SESSION.
536 * Map errors cl_cons_state errors to EPROTONOSUPPORT to indicate
537 * other versions of NFS can be tried.
539 int nfs4_check_client_ready(struct nfs_client *clp)
541 if (!nfs4_has_session(clp))
543 if (clp->cl_cons_state < NFS_CS_READY)
544 return -EPROTONOSUPPORT;
549 * Initialise the timeout values for a connection
551 static void nfs_init_timeout_values(struct rpc_timeout *to, int proto,
552 unsigned int timeo, unsigned int retrans)
554 to->to_initval = timeo * HZ / 10;
555 to->to_retries = retrans;
558 case XPRT_TRANSPORT_TCP:
559 case XPRT_TRANSPORT_RDMA:
560 if (to->to_retries == 0)
561 to->to_retries = NFS_DEF_TCP_RETRANS;
562 if (to->to_initval == 0)
563 to->to_initval = NFS_DEF_TCP_TIMEO * HZ / 10;
564 if (to->to_initval > NFS_MAX_TCP_TIMEOUT)
565 to->to_initval = NFS_MAX_TCP_TIMEOUT;
566 to->to_increment = to->to_initval;
567 to->to_maxval = to->to_initval + (to->to_increment * to->to_retries);
568 if (to->to_maxval > NFS_MAX_TCP_TIMEOUT)
569 to->to_maxval = NFS_MAX_TCP_TIMEOUT;
570 if (to->to_maxval < to->to_initval)
571 to->to_maxval = to->to_initval;
572 to->to_exponential = 0;
574 case XPRT_TRANSPORT_UDP:
575 if (to->to_retries == 0)
576 to->to_retries = NFS_DEF_UDP_RETRANS;
578 to->to_initval = NFS_DEF_UDP_TIMEO * HZ / 10;
579 if (to->to_initval > NFS_MAX_UDP_TIMEOUT)
580 to->to_initval = NFS_MAX_UDP_TIMEOUT;
581 to->to_maxval = NFS_MAX_UDP_TIMEOUT;
582 to->to_exponential = 1;
590 * Create an RPC client handle
592 static int nfs_create_rpc_client(struct nfs_client *clp,
593 const struct rpc_timeout *timeparms,
594 rpc_authflavor_t flavor,
595 int discrtry, int noresvport)
597 struct rpc_clnt *clnt = NULL;
598 struct rpc_create_args args = {
599 .protocol = clp->cl_proto,
600 .address = (struct sockaddr *)&clp->cl_addr,
601 .addrsize = clp->cl_addrlen,
602 .timeout = timeparms,
603 .servername = clp->cl_hostname,
604 .program = &nfs_program,
605 .version = clp->rpc_ops->version,
606 .authflavor = flavor,
610 args.flags |= RPC_CLNT_CREATE_DISCRTRY;
612 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
614 if (!IS_ERR(clp->cl_rpcclient))
617 clnt = rpc_create(&args);
619 dprintk("%s: cannot create RPC client. Error = %ld\n",
620 __func__, PTR_ERR(clnt));
621 return PTR_ERR(clnt);
624 clp->cl_rpcclient = clnt;
629 * Version 2 or 3 client destruction
631 static void nfs_destroy_server(struct nfs_server *server)
633 if (!(server->flags & NFS_MOUNT_NONLM))
634 nlmclnt_done(server->nlm_host);
638 * Version 2 or 3 lockd setup
640 static int nfs_start_lockd(struct nfs_server *server)
642 struct nlm_host *host;
643 struct nfs_client *clp = server->nfs_client;
644 struct nlmclnt_initdata nlm_init = {
645 .hostname = clp->cl_hostname,
646 .address = (struct sockaddr *)&clp->cl_addr,
647 .addrlen = clp->cl_addrlen,
648 .protocol = server->flags & NFS_MOUNT_TCP ?
649 IPPROTO_TCP : IPPROTO_UDP,
650 .nfs_version = clp->rpc_ops->version,
651 .noresvport = server->flags & NFS_MOUNT_NORESVPORT ?
655 if (nlm_init.nfs_version > 3)
657 if (server->flags & NFS_MOUNT_NONLM)
660 host = nlmclnt_init(&nlm_init);
662 return PTR_ERR(host);
664 server->nlm_host = host;
665 server->destroy = nfs_destroy_server;
670 * Initialise an NFSv3 ACL client connection
672 #ifdef CONFIG_NFS_V3_ACL
673 static void nfs_init_server_aclclient(struct nfs_server *server)
675 if (server->nfs_client->rpc_ops->version != 3)
677 if (server->flags & NFS_MOUNT_NOACL)
680 server->client_acl = rpc_bind_new_program(server->client, &nfsacl_program, 3);
681 if (IS_ERR(server->client_acl))
684 /* No errors! Assume that Sun nfsacls are supported */
685 server->caps |= NFS_CAP_ACLS;
689 server->caps &= ~NFS_CAP_ACLS;
692 static inline void nfs_init_server_aclclient(struct nfs_server *server)
694 server->flags &= ~NFS_MOUNT_NOACL;
695 server->caps &= ~NFS_CAP_ACLS;
700 * Create a general RPC client
702 static int nfs_init_server_rpcclient(struct nfs_server *server,
703 const struct rpc_timeout *timeo,
704 rpc_authflavor_t pseudoflavour)
706 struct nfs_client *clp = server->nfs_client;
708 server->client = rpc_clone_client(clp->cl_rpcclient);
709 if (IS_ERR(server->client)) {
710 dprintk("%s: couldn't create rpc_client!\n", __func__);
711 return PTR_ERR(server->client);
714 memcpy(&server->client->cl_timeout_default,
716 sizeof(server->client->cl_timeout_default));
717 server->client->cl_timeout = &server->client->cl_timeout_default;
719 if (pseudoflavour != clp->cl_rpcclient->cl_auth->au_flavor) {
720 struct rpc_auth *auth;
722 auth = rpcauth_create(pseudoflavour, server->client);
724 dprintk("%s: couldn't create credcache!\n", __func__);
725 return PTR_ERR(auth);
728 server->client->cl_softrtry = 0;
729 if (server->flags & NFS_MOUNT_SOFT)
730 server->client->cl_softrtry = 1;
736 * Initialise an NFS2 or NFS3 client
738 static int nfs_init_client(struct nfs_client *clp,
739 const struct rpc_timeout *timeparms,
740 const struct nfs_parsed_mount_data *data)
744 if (clp->cl_cons_state == NFS_CS_READY) {
745 /* the client is already initialised */
746 dprintk("<-- nfs_init_client() = 0 [already %p]\n", clp);
751 * Create a client RPC handle for doing FSSTAT with UNIX auth only
752 * - RFC 2623, sec 2.3.2
754 error = nfs_create_rpc_client(clp, timeparms, RPC_AUTH_UNIX,
755 0, data->flags & NFS_MOUNT_NORESVPORT);
758 nfs_mark_client_ready(clp, NFS_CS_READY);
762 nfs_mark_client_ready(clp, error);
763 dprintk("<-- nfs_init_client() = xerror %d\n", error);
768 * Create a version 2 or 3 client
770 static int nfs_init_server(struct nfs_server *server,
771 const struct nfs_parsed_mount_data *data)
773 struct nfs_client_initdata cl_init = {
774 .hostname = data->nfs_server.hostname,
775 .addr = (const struct sockaddr *)&data->nfs_server.address,
776 .addrlen = data->nfs_server.addrlen,
777 .rpc_ops = &nfs_v2_clientops,
778 .proto = data->nfs_server.protocol,
780 struct rpc_timeout timeparms;
781 struct nfs_client *clp;
784 dprintk("--> nfs_init_server()\n");
787 if (data->flags & NFS_MOUNT_VER3)
788 cl_init.rpc_ops = &nfs_v3_clientops;
791 /* Allocate or find a client reference we can use */
792 clp = nfs_get_client(&cl_init);
794 dprintk("<-- nfs_init_server() = error %ld\n", PTR_ERR(clp));
798 nfs_init_timeout_values(&timeparms, data->nfs_server.protocol,
799 data->timeo, data->retrans);
800 error = nfs_init_client(clp, &timeparms, data);
804 server->nfs_client = clp;
806 /* Initialise the client representation from the mount data */
807 server->flags = data->flags;
808 server->options = data->options;
811 server->rsize = nfs_block_size(data->rsize, NULL);
813 server->wsize = nfs_block_size(data->wsize, NULL);
815 server->acregmin = data->acregmin * HZ;
816 server->acregmax = data->acregmax * HZ;
817 server->acdirmin = data->acdirmin * HZ;
818 server->acdirmax = data->acdirmax * HZ;
820 /* Start lockd here, before we might error out */
821 error = nfs_start_lockd(server);
825 server->port = data->nfs_server.port;
827 error = nfs_init_server_rpcclient(server, &timeparms, data->auth_flavors[0]);
831 /* Preserve the values of mount_server-related mount options */
832 if (data->mount_server.addrlen) {
833 memcpy(&server->mountd_address, &data->mount_server.address,
834 data->mount_server.addrlen);
835 server->mountd_addrlen = data->mount_server.addrlen;
837 server->mountd_version = data->mount_server.version;
838 server->mountd_port = data->mount_server.port;
839 server->mountd_protocol = data->mount_server.protocol;
841 server->namelen = data->namlen;
842 /* Create a client RPC handle for the NFSv3 ACL management interface */
843 nfs_init_server_aclclient(server);
844 dprintk("<-- nfs_init_server() = 0 [new %p]\n", clp);
848 server->nfs_client = NULL;
850 dprintk("<-- nfs_init_server() = xerror %d\n", error);
855 * Load up the server record from information gained in an fsinfo record
857 static void nfs_server_set_fsinfo(struct nfs_server *server, struct nfs_fsinfo *fsinfo)
859 unsigned long max_rpc_payload;
861 /* Work out a lot of parameters */
862 if (server->rsize == 0)
863 server->rsize = nfs_block_size(fsinfo->rtpref, NULL);
864 if (server->wsize == 0)
865 server->wsize = nfs_block_size(fsinfo->wtpref, NULL);
867 if (fsinfo->rtmax >= 512 && server->rsize > fsinfo->rtmax)
868 server->rsize = nfs_block_size(fsinfo->rtmax, NULL);
869 if (fsinfo->wtmax >= 512 && server->wsize > fsinfo->wtmax)
870 server->wsize = nfs_block_size(fsinfo->wtmax, NULL);
872 max_rpc_payload = nfs_block_size(rpc_max_payload(server->client), NULL);
873 if (server->rsize > max_rpc_payload)
874 server->rsize = max_rpc_payload;
875 if (server->rsize > NFS_MAX_FILE_IO_SIZE)
876 server->rsize = NFS_MAX_FILE_IO_SIZE;
877 server->rpages = (server->rsize + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
879 server->backing_dev_info.ra_pages = server->rpages * NFS_MAX_READAHEAD;
881 if (server->wsize > max_rpc_payload)
882 server->wsize = max_rpc_payload;
883 if (server->wsize > NFS_MAX_FILE_IO_SIZE)
884 server->wsize = NFS_MAX_FILE_IO_SIZE;
885 server->wpages = (server->wsize + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
886 server->wtmult = nfs_block_bits(fsinfo->wtmult, NULL);
888 server->dtsize = nfs_block_size(fsinfo->dtpref, NULL);
889 if (server->dtsize > PAGE_CACHE_SIZE)
890 server->dtsize = PAGE_CACHE_SIZE;
891 if (server->dtsize > server->rsize)
892 server->dtsize = server->rsize;
894 if (server->flags & NFS_MOUNT_NOAC) {
895 server->acregmin = server->acregmax = 0;
896 server->acdirmin = server->acdirmax = 0;
899 server->maxfilesize = fsinfo->maxfilesize;
901 /* We're airborne Set socket buffersize */
902 rpc_setbufsize(server->client, server->wsize + 100, server->rsize + 100);
906 * Probe filesystem information, including the FSID on v2/v3
908 static int nfs_probe_fsinfo(struct nfs_server *server, struct nfs_fh *mntfh, struct nfs_fattr *fattr)
910 struct nfs_fsinfo fsinfo;
911 struct nfs_client *clp = server->nfs_client;
914 dprintk("--> nfs_probe_fsinfo()\n");
916 if (clp->rpc_ops->set_capabilities != NULL) {
917 error = clp->rpc_ops->set_capabilities(server, mntfh);
922 fsinfo.fattr = fattr;
923 nfs_fattr_init(fattr);
924 error = clp->rpc_ops->fsinfo(server, mntfh, &fsinfo);
928 nfs_server_set_fsinfo(server, &fsinfo);
929 error = bdi_init(&server->backing_dev_info);
934 /* Get some general file system info */
935 if (server->namelen == 0) {
936 struct nfs_pathconf pathinfo;
938 pathinfo.fattr = fattr;
939 nfs_fattr_init(fattr);
941 if (clp->rpc_ops->pathconf(server, mntfh, &pathinfo) >= 0)
942 server->namelen = pathinfo.max_namelen;
945 dprintk("<-- nfs_probe_fsinfo() = 0\n");
949 dprintk("nfs_probe_fsinfo: error = %d\n", -error);
954 * Copy useful information when duplicating a server record
956 static void nfs_server_copy_userdata(struct nfs_server *target, struct nfs_server *source)
958 target->flags = source->flags;
959 target->acregmin = source->acregmin;
960 target->acregmax = source->acregmax;
961 target->acdirmin = source->acdirmin;
962 target->acdirmax = source->acdirmax;
963 target->caps = source->caps;
967 * Allocate and initialise a server record
969 static struct nfs_server *nfs_alloc_server(void)
971 struct nfs_server *server;
973 server = kzalloc(sizeof(struct nfs_server), GFP_KERNEL);
977 server->client = server->client_acl = ERR_PTR(-EINVAL);
979 /* Zero out the NFS state stuff */
980 INIT_LIST_HEAD(&server->client_link);
981 INIT_LIST_HEAD(&server->master_link);
983 atomic_set(&server->active, 0);
985 server->io_stats = nfs_alloc_iostats();
986 if (!server->io_stats) {
995 * Free up a server record
997 void nfs_free_server(struct nfs_server *server)
999 dprintk("--> nfs_free_server()\n");
1001 spin_lock(&nfs_client_lock);
1002 list_del(&server->client_link);
1003 list_del(&server->master_link);
1004 spin_unlock(&nfs_client_lock);
1006 if (server->destroy != NULL)
1007 server->destroy(server);
1009 if (!IS_ERR(server->client_acl))
1010 rpc_shutdown_client(server->client_acl);
1011 if (!IS_ERR(server->client))
1012 rpc_shutdown_client(server->client);
1014 nfs_put_client(server->nfs_client);
1016 nfs_free_iostats(server->io_stats);
1017 bdi_destroy(&server->backing_dev_info);
1019 nfs_release_automount_timer();
1020 dprintk("<-- nfs_free_server()\n");
1024 * Create a version 2 or 3 volume record
1025 * - keyed on server and FSID
1027 struct nfs_server *nfs_create_server(const struct nfs_parsed_mount_data *data,
1028 struct nfs_fh *mntfh)
1030 struct nfs_server *server;
1031 struct nfs_fattr fattr;
1034 server = nfs_alloc_server();
1036 return ERR_PTR(-ENOMEM);
1038 /* Get a client representation */
1039 error = nfs_init_server(server, data);
1043 BUG_ON(!server->nfs_client);
1044 BUG_ON(!server->nfs_client->rpc_ops);
1045 BUG_ON(!server->nfs_client->rpc_ops->file_inode_ops);
1047 /* Probe the root fh to retrieve its FSID */
1048 error = nfs_probe_fsinfo(server, mntfh, &fattr);
1051 if (server->nfs_client->rpc_ops->version == 3) {
1052 if (server->namelen == 0 || server->namelen > NFS3_MAXNAMLEN)
1053 server->namelen = NFS3_MAXNAMLEN;
1054 if (!(data->flags & NFS_MOUNT_NORDIRPLUS))
1055 server->caps |= NFS_CAP_READDIRPLUS;
1057 if (server->namelen == 0 || server->namelen > NFS2_MAXNAMLEN)
1058 server->namelen = NFS2_MAXNAMLEN;
1061 if (!(fattr.valid & NFS_ATTR_FATTR)) {
1062 error = server->nfs_client->rpc_ops->getattr(server, mntfh, &fattr);
1064 dprintk("nfs_create_server: getattr error = %d\n", -error);
1068 memcpy(&server->fsid, &fattr.fsid, sizeof(server->fsid));
1070 dprintk("Server FSID: %llx:%llx\n",
1071 (unsigned long long) server->fsid.major,
1072 (unsigned long long) server->fsid.minor);
1074 BUG_ON(!server->nfs_client);
1075 BUG_ON(!server->nfs_client->rpc_ops);
1076 BUG_ON(!server->nfs_client->rpc_ops->file_inode_ops);
1078 spin_lock(&nfs_client_lock);
1079 list_add_tail(&server->client_link, &server->nfs_client->cl_superblocks);
1080 list_add_tail(&server->master_link, &nfs_volume_list);
1081 spin_unlock(&nfs_client_lock);
1083 server->mount_time = jiffies;
1087 nfs_free_server(server);
1088 return ERR_PTR(error);
1091 #ifdef CONFIG_NFS_V4
1093 * Initialize the NFS4 callback service
1095 static int nfs4_init_callback(struct nfs_client *clp)
1099 if (clp->rpc_ops->version == 4) {
1100 if (nfs4_has_session(clp)) {
1101 error = xprt_setup_backchannel(
1102 clp->cl_rpcclient->cl_xprt,
1103 NFS41_BC_MIN_CALLBACKS);
1108 error = nfs_callback_up(clp->cl_minorversion,
1109 clp->cl_rpcclient->cl_xprt);
1111 dprintk("%s: failed to start callback. Error = %d\n",
1115 __set_bit(NFS_CS_CALLBACK, &clp->cl_res_state);
1121 * Initialize the minor version specific parts of an NFS4 client record
1123 static int nfs4_init_client_minor_version(struct nfs_client *clp)
1125 clp->cl_call_sync = _nfs4_call_sync;
1127 #if defined(CONFIG_NFS_V4_1)
1128 if (clp->cl_minorversion) {
1129 struct nfs4_session *session = NULL;
1131 * Create the session and mark it expired.
1132 * When a SEQUENCE operation encounters the expired session
1133 * it will do session recovery to initialize it.
1135 session = nfs4_alloc_session(clp);
1139 clp->cl_session = session;
1140 clp->cl_call_sync = _nfs4_call_sync_session;
1142 #endif /* CONFIG_NFS_V4_1 */
1144 return nfs4_init_callback(clp);
1148 * Initialise an NFS4 client record
1150 static int nfs4_init_client(struct nfs_client *clp,
1151 const struct rpc_timeout *timeparms,
1152 const char *ip_addr,
1153 rpc_authflavor_t authflavour,
1158 if (clp->cl_cons_state == NFS_CS_READY) {
1159 /* the client is initialised already */
1160 dprintk("<-- nfs4_init_client() = 0 [already %p]\n", clp);
1164 /* Check NFS protocol revision and initialize RPC op vector */
1165 clp->rpc_ops = &nfs_v4_clientops;
1167 error = nfs_create_rpc_client(clp, timeparms, authflavour,
1168 1, flags & NFS_MOUNT_NORESVPORT);
1171 memcpy(clp->cl_ipaddr, ip_addr, sizeof(clp->cl_ipaddr));
1173 error = nfs_idmap_new(clp);
1175 dprintk("%s: failed to create idmapper. Error = %d\n",
1179 __set_bit(NFS_CS_IDMAP, &clp->cl_res_state);
1181 error = nfs4_init_client_minor_version(clp);
1185 if (!nfs4_has_session(clp))
1186 nfs_mark_client_ready(clp, NFS_CS_READY);
1190 nfs_mark_client_ready(clp, error);
1191 dprintk("<-- nfs4_init_client() = xerror %d\n", error);
1196 * Set up an NFS4 client
1198 static int nfs4_set_client(struct nfs_server *server,
1199 const char *hostname,
1200 const struct sockaddr *addr,
1201 const size_t addrlen,
1202 const char *ip_addr,
1203 rpc_authflavor_t authflavour,
1204 int proto, const struct rpc_timeout *timeparms,
1207 struct nfs_client_initdata cl_init = {
1208 .hostname = hostname,
1211 .rpc_ops = &nfs_v4_clientops,
1213 .minorversion = minorversion,
1215 struct nfs_client *clp;
1218 dprintk("--> nfs4_set_client()\n");
1220 /* Allocate or find a client reference we can use */
1221 clp = nfs_get_client(&cl_init);
1223 error = PTR_ERR(clp);
1226 error = nfs4_init_client(clp, timeparms, ip_addr, authflavour,
1231 server->nfs_client = clp;
1232 dprintk("<-- nfs4_set_client() = 0 [new %p]\n", clp);
1236 nfs_put_client(clp);
1238 dprintk("<-- nfs4_set_client() = xerror %d\n", error);
1243 * Initialize a session.
1244 * Note: save the mount rsize and wsize for create_server negotiation.
1246 static void nfs4_init_session(struct nfs_client *clp,
1247 unsigned int wsize, unsigned int rsize)
1249 #if defined(CONFIG_NFS_V4_1)
1250 if (nfs4_has_session(clp)) {
1251 clp->cl_session->fc_attrs.max_rqst_sz = wsize;
1252 clp->cl_session->fc_attrs.max_resp_sz = rsize;
1254 #endif /* CONFIG_NFS_V4_1 */
1258 * Session has been established, and the client marked ready.
1259 * Set the mount rsize and wsize with negotiated fore channel
1260 * attributes which will be bound checked in nfs_server_set_fsinfo.
1262 static void nfs4_session_set_rwsize(struct nfs_server *server)
1264 #ifdef CONFIG_NFS_V4_1
1265 if (!nfs4_has_session(server->nfs_client))
1267 server->rsize = server->nfs_client->cl_session->fc_attrs.max_resp_sz;
1268 server->wsize = server->nfs_client->cl_session->fc_attrs.max_rqst_sz;
1269 #endif /* CONFIG_NFS_V4_1 */
1273 * Create a version 4 volume record
1275 static int nfs4_init_server(struct nfs_server *server,
1276 const struct nfs_parsed_mount_data *data)
1278 struct rpc_timeout timeparms;
1281 dprintk("--> nfs4_init_server()\n");
1283 nfs_init_timeout_values(&timeparms, data->nfs_server.protocol,
1284 data->timeo, data->retrans);
1286 /* Initialise the client representation from the mount data */
1287 server->flags = data->flags;
1288 server->caps |= NFS_CAP_ATOMIC_OPEN;
1289 server->options = data->options;
1291 /* Get a client record */
1292 error = nfs4_set_client(server,
1293 data->nfs_server.hostname,
1294 (const struct sockaddr *)&data->nfs_server.address,
1295 data->nfs_server.addrlen,
1296 data->client_address,
1297 data->auth_flavors[0],
1298 data->nfs_server.protocol,
1300 data->minorversion);
1305 server->rsize = nfs_block_size(data->rsize, NULL);
1307 server->wsize = nfs_block_size(data->wsize, NULL);
1309 server->acregmin = data->acregmin * HZ;
1310 server->acregmax = data->acregmax * HZ;
1311 server->acdirmin = data->acdirmin * HZ;
1312 server->acdirmax = data->acdirmax * HZ;
1314 server->port = data->nfs_server.port;
1316 error = nfs_init_server_rpcclient(server, &timeparms, data->auth_flavors[0]);
1320 dprintk("<-- nfs4_init_server() = %d\n", error);
1325 * Create a version 4 volume record
1326 * - keyed on server and FSID
1328 struct nfs_server *nfs4_create_server(const struct nfs_parsed_mount_data *data,
1329 struct nfs_fh *mntfh)
1331 struct nfs_fattr fattr;
1332 struct nfs_server *server;
1335 dprintk("--> nfs4_create_server()\n");
1337 server = nfs_alloc_server();
1339 return ERR_PTR(-ENOMEM);
1341 /* set up the general RPC client */
1342 error = nfs4_init_server(server, data);
1346 BUG_ON(!server->nfs_client);
1347 BUG_ON(!server->nfs_client->rpc_ops);
1348 BUG_ON(!server->nfs_client->rpc_ops->file_inode_ops);
1350 nfs4_init_session(server->nfs_client, server->wsize, server->rsize);
1352 /* Probe the root fh to retrieve its FSID */
1353 error = nfs4_path_walk(server, mntfh, data->nfs_server.export_path);
1357 dprintk("Server FSID: %llx:%llx\n",
1358 (unsigned long long) server->fsid.major,
1359 (unsigned long long) server->fsid.minor);
1360 dprintk("Mount FH: %d\n", mntfh->size);
1362 nfs4_session_set_rwsize(server);
1364 error = nfs_probe_fsinfo(server, mntfh, &fattr);
1368 if (server->namelen == 0 || server->namelen > NFS4_MAXNAMLEN)
1369 server->namelen = NFS4_MAXNAMLEN;
1371 BUG_ON(!server->nfs_client);
1372 BUG_ON(!server->nfs_client->rpc_ops);
1373 BUG_ON(!server->nfs_client->rpc_ops->file_inode_ops);
1375 spin_lock(&nfs_client_lock);
1376 list_add_tail(&server->client_link, &server->nfs_client->cl_superblocks);
1377 list_add_tail(&server->master_link, &nfs_volume_list);
1378 spin_unlock(&nfs_client_lock);
1380 server->mount_time = jiffies;
1381 dprintk("<-- nfs4_create_server() = %p\n", server);
1385 nfs_free_server(server);
1386 dprintk("<-- nfs4_create_server() = error %d\n", error);
1387 return ERR_PTR(error);
1391 * Create an NFS4 referral server record
1393 struct nfs_server *nfs4_create_referral_server(struct nfs_clone_mount *data,
1394 struct nfs_fh *mntfh)
1396 struct nfs_client *parent_client;
1397 struct nfs_server *server, *parent_server;
1398 struct nfs_fattr fattr;
1401 dprintk("--> nfs4_create_referral_server()\n");
1403 server = nfs_alloc_server();
1405 return ERR_PTR(-ENOMEM);
1407 parent_server = NFS_SB(data->sb);
1408 parent_client = parent_server->nfs_client;
1410 /* Initialise the client representation from the parent server */
1411 nfs_server_copy_userdata(server, parent_server);
1412 server->caps |= NFS_CAP_ATOMIC_OPEN;
1414 /* Get a client representation.
1415 * Note: NFSv4 always uses TCP, */
1416 error = nfs4_set_client(server, data->hostname,
1419 parent_client->cl_ipaddr,
1421 parent_server->client->cl_xprt->prot,
1422 parent_server->client->cl_timeout,
1423 parent_client->cl_minorversion);
1427 error = nfs_init_server_rpcclient(server, parent_server->client->cl_timeout, data->authflavor);
1431 BUG_ON(!server->nfs_client);
1432 BUG_ON(!server->nfs_client->rpc_ops);
1433 BUG_ON(!server->nfs_client->rpc_ops->file_inode_ops);
1435 /* Probe the root fh to retrieve its FSID and filehandle */
1436 error = nfs4_path_walk(server, mntfh, data->mnt_path);
1440 /* probe the filesystem info for this server filesystem */
1441 error = nfs_probe_fsinfo(server, mntfh, &fattr);
1445 if (server->namelen == 0 || server->namelen > NFS4_MAXNAMLEN)
1446 server->namelen = NFS4_MAXNAMLEN;
1448 dprintk("Referral FSID: %llx:%llx\n",
1449 (unsigned long long) server->fsid.major,
1450 (unsigned long long) server->fsid.minor);
1452 spin_lock(&nfs_client_lock);
1453 list_add_tail(&server->client_link, &server->nfs_client->cl_superblocks);
1454 list_add_tail(&server->master_link, &nfs_volume_list);
1455 spin_unlock(&nfs_client_lock);
1457 server->mount_time = jiffies;
1459 dprintk("<-- nfs_create_referral_server() = %p\n", server);
1463 nfs_free_server(server);
1464 dprintk("<-- nfs4_create_referral_server() = error %d\n", error);
1465 return ERR_PTR(error);
1468 #endif /* CONFIG_NFS_V4 */
1471 * Clone an NFS2, NFS3 or NFS4 server record
1473 struct nfs_server *nfs_clone_server(struct nfs_server *source,
1475 struct nfs_fattr *fattr)
1477 struct nfs_server *server;
1478 struct nfs_fattr fattr_fsinfo;
1481 dprintk("--> nfs_clone_server(,%llx:%llx,)\n",
1482 (unsigned long long) fattr->fsid.major,
1483 (unsigned long long) fattr->fsid.minor);
1485 server = nfs_alloc_server();
1487 return ERR_PTR(-ENOMEM);
1489 /* Copy data from the source */
1490 server->nfs_client = source->nfs_client;
1491 atomic_inc(&server->nfs_client->cl_count);
1492 nfs_server_copy_userdata(server, source);
1494 server->fsid = fattr->fsid;
1496 error = nfs_init_server_rpcclient(server,
1497 source->client->cl_timeout,
1498 source->client->cl_auth->au_flavor);
1500 goto out_free_server;
1501 if (!IS_ERR(source->client_acl))
1502 nfs_init_server_aclclient(server);
1504 /* probe the filesystem info for this server filesystem */
1505 error = nfs_probe_fsinfo(server, fh, &fattr_fsinfo);
1507 goto out_free_server;
1509 if (server->namelen == 0 || server->namelen > NFS4_MAXNAMLEN)
1510 server->namelen = NFS4_MAXNAMLEN;
1512 dprintk("Cloned FSID: %llx:%llx\n",
1513 (unsigned long long) server->fsid.major,
1514 (unsigned long long) server->fsid.minor);
1516 error = nfs_start_lockd(server);
1518 goto out_free_server;
1520 spin_lock(&nfs_client_lock);
1521 list_add_tail(&server->client_link, &server->nfs_client->cl_superblocks);
1522 list_add_tail(&server->master_link, &nfs_volume_list);
1523 spin_unlock(&nfs_client_lock);
1525 server->mount_time = jiffies;
1527 dprintk("<-- nfs_clone_server() = %p\n", server);
1531 nfs_free_server(server);
1532 dprintk("<-- nfs_clone_server() = error %d\n", error);
1533 return ERR_PTR(error);
1536 #ifdef CONFIG_PROC_FS
1537 static struct proc_dir_entry *proc_fs_nfs;
1539 static int nfs_server_list_open(struct inode *inode, struct file *file);
1540 static void *nfs_server_list_start(struct seq_file *p, loff_t *pos);
1541 static void *nfs_server_list_next(struct seq_file *p, void *v, loff_t *pos);
1542 static void nfs_server_list_stop(struct seq_file *p, void *v);
1543 static int nfs_server_list_show(struct seq_file *m, void *v);
1545 static struct seq_operations nfs_server_list_ops = {
1546 .start = nfs_server_list_start,
1547 .next = nfs_server_list_next,
1548 .stop = nfs_server_list_stop,
1549 .show = nfs_server_list_show,
1552 static const struct file_operations nfs_server_list_fops = {
1553 .open = nfs_server_list_open,
1555 .llseek = seq_lseek,
1556 .release = seq_release,
1557 .owner = THIS_MODULE,
1560 static int nfs_volume_list_open(struct inode *inode, struct file *file);
1561 static void *nfs_volume_list_start(struct seq_file *p, loff_t *pos);
1562 static void *nfs_volume_list_next(struct seq_file *p, void *v, loff_t *pos);
1563 static void nfs_volume_list_stop(struct seq_file *p, void *v);
1564 static int nfs_volume_list_show(struct seq_file *m, void *v);
1566 static struct seq_operations nfs_volume_list_ops = {
1567 .start = nfs_volume_list_start,
1568 .next = nfs_volume_list_next,
1569 .stop = nfs_volume_list_stop,
1570 .show = nfs_volume_list_show,
1573 static const struct file_operations nfs_volume_list_fops = {
1574 .open = nfs_volume_list_open,
1576 .llseek = seq_lseek,
1577 .release = seq_release,
1578 .owner = THIS_MODULE,
1582 * open "/proc/fs/nfsfs/servers" which provides a summary of servers with which
1585 static int nfs_server_list_open(struct inode *inode, struct file *file)
1590 ret = seq_open(file, &nfs_server_list_ops);
1594 m = file->private_data;
1595 m->private = PDE(inode)->data;
1601 * set up the iterator to start reading from the server list and return the first item
1603 static void *nfs_server_list_start(struct seq_file *m, loff_t *_pos)
1605 /* lock the list against modification */
1606 spin_lock(&nfs_client_lock);
1607 return seq_list_start_head(&nfs_client_list, *_pos);
1611 * move to next server
1613 static void *nfs_server_list_next(struct seq_file *p, void *v, loff_t *pos)
1615 return seq_list_next(v, &nfs_client_list, pos);
1619 * clean up after reading from the transports list
1621 static void nfs_server_list_stop(struct seq_file *p, void *v)
1623 spin_unlock(&nfs_client_lock);
1627 * display a header line followed by a load of call lines
1629 static int nfs_server_list_show(struct seq_file *m, void *v)
1631 struct nfs_client *clp;
1633 /* display header on line 1 */
1634 if (v == &nfs_client_list) {
1635 seq_puts(m, "NV SERVER PORT USE HOSTNAME\n");
1639 /* display one transport per line on subsequent lines */
1640 clp = list_entry(v, struct nfs_client, cl_share_link);
1642 seq_printf(m, "v%u %s %s %3d %s\n",
1643 clp->rpc_ops->version,
1644 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_ADDR),
1645 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_PORT),
1646 atomic_read(&clp->cl_count),
1653 * open "/proc/fs/nfsfs/volumes" which provides a summary of extant volumes
1655 static int nfs_volume_list_open(struct inode *inode, struct file *file)
1660 ret = seq_open(file, &nfs_volume_list_ops);
1664 m = file->private_data;
1665 m->private = PDE(inode)->data;
1671 * set up the iterator to start reading from the volume list and return the first item
1673 static void *nfs_volume_list_start(struct seq_file *m, loff_t *_pos)
1675 /* lock the list against modification */
1676 spin_lock(&nfs_client_lock);
1677 return seq_list_start_head(&nfs_volume_list, *_pos);
1681 * move to next volume
1683 static void *nfs_volume_list_next(struct seq_file *p, void *v, loff_t *pos)
1685 return seq_list_next(v, &nfs_volume_list, pos);
1689 * clean up after reading from the transports list
1691 static void nfs_volume_list_stop(struct seq_file *p, void *v)
1693 spin_unlock(&nfs_client_lock);
1697 * display a header line followed by a load of call lines
1699 static int nfs_volume_list_show(struct seq_file *m, void *v)
1701 struct nfs_server *server;
1702 struct nfs_client *clp;
1703 char dev[8], fsid[17];
1705 /* display header on line 1 */
1706 if (v == &nfs_volume_list) {
1707 seq_puts(m, "NV SERVER PORT DEV FSID FSC\n");
1710 /* display one transport per line on subsequent lines */
1711 server = list_entry(v, struct nfs_server, master_link);
1712 clp = server->nfs_client;
1714 snprintf(dev, 8, "%u:%u",
1715 MAJOR(server->s_dev), MINOR(server->s_dev));
1717 snprintf(fsid, 17, "%llx:%llx",
1718 (unsigned long long) server->fsid.major,
1719 (unsigned long long) server->fsid.minor);
1721 seq_printf(m, "v%u %s %s %-7s %-17s %s\n",
1722 clp->rpc_ops->version,
1723 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_ADDR),
1724 rpc_peeraddr2str(clp->cl_rpcclient, RPC_DISPLAY_HEX_PORT),
1727 nfs_server_fscache_state(server));
1733 * initialise the /proc/fs/nfsfs/ directory
1735 int __init nfs_fs_proc_init(void)
1737 struct proc_dir_entry *p;
1739 proc_fs_nfs = proc_mkdir("fs/nfsfs", NULL);
1743 /* a file of servers with which we're dealing */
1744 p = proc_create("servers", S_IFREG|S_IRUGO,
1745 proc_fs_nfs, &nfs_server_list_fops);
1749 /* a file of volumes that we have mounted */
1750 p = proc_create("volumes", S_IFREG|S_IRUGO,
1751 proc_fs_nfs, &nfs_volume_list_fops);
1757 remove_proc_entry("servers", proc_fs_nfs);
1759 remove_proc_entry("fs/nfsfs", NULL);
1765 * clean up the /proc/fs/nfsfs/ directory
1767 void nfs_fs_proc_exit(void)
1769 remove_proc_entry("volumes", proc_fs_nfs);
1770 remove_proc_entry("servers", proc_fs_nfs);
1771 remove_proc_entry("fs/nfsfs", NULL);
1774 #endif /* CONFIG_PROC_FS */