1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * linux/fs/nfs/cache_lib.c
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Helper routines for the NFS client caches
6*4882a593Smuzhiyun *
7*4882a593Smuzhiyun * Copyright (c) 2009 Trond Myklebust <Trond.Myklebust@netapp.com>
8*4882a593Smuzhiyun */
9*4882a593Smuzhiyun #include <linux/kmod.h>
10*4882a593Smuzhiyun #include <linux/module.h>
11*4882a593Smuzhiyun #include <linux/moduleparam.h>
12*4882a593Smuzhiyun #include <linux/mount.h>
13*4882a593Smuzhiyun #include <linux/namei.h>
14*4882a593Smuzhiyun #include <linux/slab.h>
15*4882a593Smuzhiyun #include <linux/sunrpc/cache.h>
16*4882a593Smuzhiyun #include <linux/sunrpc/rpc_pipe_fs.h>
17*4882a593Smuzhiyun #include <net/net_namespace.h>
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun #include "cache_lib.h"
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun #define NFS_CACHE_UPCALL_PATHLEN 256
22*4882a593Smuzhiyun #define NFS_CACHE_UPCALL_TIMEOUT 15
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun static char nfs_cache_getent_prog[NFS_CACHE_UPCALL_PATHLEN] =
25*4882a593Smuzhiyun "/sbin/nfs_cache_getent";
26*4882a593Smuzhiyun static unsigned long nfs_cache_getent_timeout = NFS_CACHE_UPCALL_TIMEOUT;
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun module_param_string(cache_getent, nfs_cache_getent_prog,
29*4882a593Smuzhiyun sizeof(nfs_cache_getent_prog), 0600);
30*4882a593Smuzhiyun MODULE_PARM_DESC(cache_getent, "Path to the client cache upcall program");
31*4882a593Smuzhiyun module_param_named(cache_getent_timeout, nfs_cache_getent_timeout, ulong, 0600);
32*4882a593Smuzhiyun MODULE_PARM_DESC(cache_getent_timeout, "Timeout (in seconds) after which "
33*4882a593Smuzhiyun "the cache upcall is assumed to have failed");
34*4882a593Smuzhiyun
nfs_cache_upcall(struct cache_detail * cd,char * entry_name)35*4882a593Smuzhiyun int nfs_cache_upcall(struct cache_detail *cd, char *entry_name)
36*4882a593Smuzhiyun {
37*4882a593Smuzhiyun static char *envp[] = { "HOME=/",
38*4882a593Smuzhiyun "TERM=linux",
39*4882a593Smuzhiyun "PATH=/sbin:/usr/sbin:/bin:/usr/bin",
40*4882a593Smuzhiyun NULL
41*4882a593Smuzhiyun };
42*4882a593Smuzhiyun char *argv[] = {
43*4882a593Smuzhiyun nfs_cache_getent_prog,
44*4882a593Smuzhiyun cd->name,
45*4882a593Smuzhiyun entry_name,
46*4882a593Smuzhiyun NULL
47*4882a593Smuzhiyun };
48*4882a593Smuzhiyun int ret = -EACCES;
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun if (nfs_cache_getent_prog[0] == '\0')
51*4882a593Smuzhiyun goto out;
52*4882a593Smuzhiyun ret = call_usermodehelper(argv[0], argv, envp, UMH_WAIT_EXEC);
53*4882a593Smuzhiyun /*
54*4882a593Smuzhiyun * Disable the upcall mechanism if we're getting an ENOENT or
55*4882a593Smuzhiyun * EACCES error. The admin can re-enable it on the fly by using
56*4882a593Smuzhiyun * sysfs to set the 'cache_getent' parameter once the problem
57*4882a593Smuzhiyun * has been fixed.
58*4882a593Smuzhiyun */
59*4882a593Smuzhiyun if (ret == -ENOENT || ret == -EACCES)
60*4882a593Smuzhiyun nfs_cache_getent_prog[0] = '\0';
61*4882a593Smuzhiyun out:
62*4882a593Smuzhiyun return ret > 0 ? 0 : ret;
63*4882a593Smuzhiyun }
64*4882a593Smuzhiyun
65*4882a593Smuzhiyun /*
66*4882a593Smuzhiyun * Deferred request handling
67*4882a593Smuzhiyun */
nfs_cache_defer_req_put(struct nfs_cache_defer_req * dreq)68*4882a593Smuzhiyun void nfs_cache_defer_req_put(struct nfs_cache_defer_req *dreq)
69*4882a593Smuzhiyun {
70*4882a593Smuzhiyun if (refcount_dec_and_test(&dreq->count))
71*4882a593Smuzhiyun kfree(dreq);
72*4882a593Smuzhiyun }
73*4882a593Smuzhiyun
nfs_dns_cache_revisit(struct cache_deferred_req * d,int toomany)74*4882a593Smuzhiyun static void nfs_dns_cache_revisit(struct cache_deferred_req *d, int toomany)
75*4882a593Smuzhiyun {
76*4882a593Smuzhiyun struct nfs_cache_defer_req *dreq;
77*4882a593Smuzhiyun
78*4882a593Smuzhiyun dreq = container_of(d, struct nfs_cache_defer_req, deferred_req);
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun complete(&dreq->completion);
81*4882a593Smuzhiyun nfs_cache_defer_req_put(dreq);
82*4882a593Smuzhiyun }
83*4882a593Smuzhiyun
nfs_dns_cache_defer(struct cache_req * req)84*4882a593Smuzhiyun static struct cache_deferred_req *nfs_dns_cache_defer(struct cache_req *req)
85*4882a593Smuzhiyun {
86*4882a593Smuzhiyun struct nfs_cache_defer_req *dreq;
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun dreq = container_of(req, struct nfs_cache_defer_req, req);
89*4882a593Smuzhiyun dreq->deferred_req.revisit = nfs_dns_cache_revisit;
90*4882a593Smuzhiyun refcount_inc(&dreq->count);
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun return &dreq->deferred_req;
93*4882a593Smuzhiyun }
94*4882a593Smuzhiyun
nfs_cache_defer_req_alloc(void)95*4882a593Smuzhiyun struct nfs_cache_defer_req *nfs_cache_defer_req_alloc(void)
96*4882a593Smuzhiyun {
97*4882a593Smuzhiyun struct nfs_cache_defer_req *dreq;
98*4882a593Smuzhiyun
99*4882a593Smuzhiyun dreq = kzalloc(sizeof(*dreq), GFP_KERNEL);
100*4882a593Smuzhiyun if (dreq) {
101*4882a593Smuzhiyun init_completion(&dreq->completion);
102*4882a593Smuzhiyun refcount_set(&dreq->count, 1);
103*4882a593Smuzhiyun dreq->req.defer = nfs_dns_cache_defer;
104*4882a593Smuzhiyun }
105*4882a593Smuzhiyun return dreq;
106*4882a593Smuzhiyun }
107*4882a593Smuzhiyun
nfs_cache_wait_for_upcall(struct nfs_cache_defer_req * dreq)108*4882a593Smuzhiyun int nfs_cache_wait_for_upcall(struct nfs_cache_defer_req *dreq)
109*4882a593Smuzhiyun {
110*4882a593Smuzhiyun if (wait_for_completion_timeout(&dreq->completion,
111*4882a593Smuzhiyun nfs_cache_getent_timeout * HZ) == 0)
112*4882a593Smuzhiyun return -ETIMEDOUT;
113*4882a593Smuzhiyun return 0;
114*4882a593Smuzhiyun }
115*4882a593Smuzhiyun
nfs_cache_register_sb(struct super_block * sb,struct cache_detail * cd)116*4882a593Smuzhiyun int nfs_cache_register_sb(struct super_block *sb, struct cache_detail *cd)
117*4882a593Smuzhiyun {
118*4882a593Smuzhiyun int ret;
119*4882a593Smuzhiyun struct dentry *dir;
120*4882a593Smuzhiyun
121*4882a593Smuzhiyun dir = rpc_d_lookup_sb(sb, "cache");
122*4882a593Smuzhiyun ret = sunrpc_cache_register_pipefs(dir, cd->name, 0600, cd);
123*4882a593Smuzhiyun dput(dir);
124*4882a593Smuzhiyun return ret;
125*4882a593Smuzhiyun }
126*4882a593Smuzhiyun
nfs_cache_register_net(struct net * net,struct cache_detail * cd)127*4882a593Smuzhiyun int nfs_cache_register_net(struct net *net, struct cache_detail *cd)
128*4882a593Smuzhiyun {
129*4882a593Smuzhiyun struct super_block *pipefs_sb;
130*4882a593Smuzhiyun int ret = 0;
131*4882a593Smuzhiyun
132*4882a593Smuzhiyun sunrpc_init_cache_detail(cd);
133*4882a593Smuzhiyun pipefs_sb = rpc_get_sb_net(net);
134*4882a593Smuzhiyun if (pipefs_sb) {
135*4882a593Smuzhiyun ret = nfs_cache_register_sb(pipefs_sb, cd);
136*4882a593Smuzhiyun rpc_put_sb_net(net);
137*4882a593Smuzhiyun if (ret)
138*4882a593Smuzhiyun sunrpc_destroy_cache_detail(cd);
139*4882a593Smuzhiyun }
140*4882a593Smuzhiyun return ret;
141*4882a593Smuzhiyun }
142*4882a593Smuzhiyun
nfs_cache_unregister_sb(struct super_block * sb,struct cache_detail * cd)143*4882a593Smuzhiyun void nfs_cache_unregister_sb(struct super_block *sb, struct cache_detail *cd)
144*4882a593Smuzhiyun {
145*4882a593Smuzhiyun sunrpc_cache_unregister_pipefs(cd);
146*4882a593Smuzhiyun }
147*4882a593Smuzhiyun
nfs_cache_unregister_net(struct net * net,struct cache_detail * cd)148*4882a593Smuzhiyun void nfs_cache_unregister_net(struct net *net, struct cache_detail *cd)
149*4882a593Smuzhiyun {
150*4882a593Smuzhiyun struct super_block *pipefs_sb;
151*4882a593Smuzhiyun
152*4882a593Smuzhiyun pipefs_sb = rpc_get_sb_net(net);
153*4882a593Smuzhiyun if (pipefs_sb) {
154*4882a593Smuzhiyun nfs_cache_unregister_sb(pipefs_sb, cd);
155*4882a593Smuzhiyun rpc_put_sb_net(net);
156*4882a593Smuzhiyun }
157*4882a593Smuzhiyun sunrpc_destroy_cache_detail(cd);
158*4882a593Smuzhiyun }
159