1 // SPDX-License-Identifier: GPL-2.0
3 * linux/fs/nfs/callback.c
5 * Copyright (C) 2004 Trond Myklebust
7 * NFSv4 callback handling
10 #include <linux/completion.h>
12 #include <linux/module.h>
13 #include <linux/sched/signal.h>
14 #include <linux/sunrpc/svc.h>
15 #include <linux/sunrpc/svcsock.h>
16 #include <linux/nfs_fs.h>
17 #include <linux/errno.h>
18 #include <linux/mutex.h>
19 #include <linux/freezer.h>
20 #include <linux/kthread.h>
21 #include <linux/sunrpc/svcauth_gss.h>
22 #include <linux/sunrpc/bc_xprt.h>
24 #include <net/inet_sock.h>
31 #define NFSDBG_FACILITY NFSDBG_CALLBACK
33 struct nfs_callback_data {
35 struct svc_serv *serv;
38 static struct nfs_callback_data nfs_callback_info[NFS4_MAX_MINOR_VERSION + 1];
39 static DEFINE_MUTEX(nfs_callback_mutex);
40 static struct svc_program nfs4_callback_program;
42 static int nfs4_callback_up_net(struct svc_serv *serv, struct net *net)
45 struct nfs_net *nn = net_generic(net, nfs_net_id);
47 ret = svc_create_xprt(serv, "tcp", net, PF_INET,
48 nfs_callback_set_tcpport, SVC_SOCK_ANONYMOUS);
51 nn->nfs_callback_tcpport = ret;
52 dprintk("NFS: Callback listener port = %u (af %u, net %x)\n",
53 nn->nfs_callback_tcpport, PF_INET, net->ns.inum);
55 ret = svc_create_xprt(serv, "tcp", net, PF_INET6,
56 nfs_callback_set_tcpport, SVC_SOCK_ANONYMOUS);
58 nn->nfs_callback_tcpport6 = ret;
59 dprintk("NFS: Callback listener port = %u (af %u, net %x\n",
60 nn->nfs_callback_tcpport6, PF_INET6, net->ns.inum);
61 } else if (ret != -EAFNOSUPPORT)
66 return (ret) ? ret : -ENOMEM;
70 * This is the NFSv4 callback kernel thread.
73 nfs4_callback_svc(void *vrqstp)
76 struct svc_rqst *rqstp = vrqstp;
80 while (!kthread_freezable_should_stop(NULL)) {
82 if (signal_pending(current))
83 flush_signals(current);
85 * Listen for a request on the socket
87 err = svc_recv(rqstp, MAX_SCHEDULE_TIMEOUT);
88 if (err == -EAGAIN || err == -EINTR)
92 svc_exit_thread(rqstp);
93 module_put_and_exit(0);
97 #if defined(CONFIG_NFS_V4_1)
99 * The callback service for NFSv4.1 callbacks
102 nfs41_callback_svc(void *vrqstp)
104 struct svc_rqst *rqstp = vrqstp;
105 struct svc_serv *serv = rqstp->rq_server;
106 struct rpc_rqst *req;
112 while (!kthread_freezable_should_stop(NULL)) {
114 if (signal_pending(current))
115 flush_signals(current);
117 prepare_to_wait(&serv->sv_cb_waitq, &wq, TASK_INTERRUPTIBLE);
118 spin_lock_bh(&serv->sv_cb_lock);
119 if (!list_empty(&serv->sv_cb_list)) {
120 req = list_first_entry(&serv->sv_cb_list,
121 struct rpc_rqst, rq_bc_list);
122 list_del(&req->rq_bc_list);
123 spin_unlock_bh(&serv->sv_cb_lock);
124 finish_wait(&serv->sv_cb_waitq, &wq);
125 dprintk("Invoking bc_svc_process()\n");
126 error = bc_svc_process(serv, req, rqstp);
127 dprintk("bc_svc_process() returned w/ error code= %d\n",
130 spin_unlock_bh(&serv->sv_cb_lock);
131 if (!kthread_should_stop())
133 finish_wait(&serv->sv_cb_waitq, &wq);
136 svc_exit_thread(rqstp);
137 module_put_and_exit(0);
141 static inline void nfs_callback_bc_serv(u32 minorversion, struct rpc_xprt *xprt,
142 struct svc_serv *serv)
146 * Save the svc_serv in the transport so that it can
147 * be referenced when the session backchannel is initialized
149 xprt->bc_serv = serv;
152 static inline void nfs_callback_bc_serv(u32 minorversion, struct rpc_xprt *xprt,
153 struct svc_serv *serv)
156 #endif /* CONFIG_NFS_V4_1 */
158 static int nfs_callback_start_svc(int minorversion, struct rpc_xprt *xprt,
159 struct svc_serv *serv)
161 int nrservs = nfs_callback_nr_threads;
164 nfs_callback_bc_serv(minorversion, xprt, serv);
166 if (nrservs < NFS4_MIN_NR_CALLBACK_THREADS)
167 nrservs = NFS4_MIN_NR_CALLBACK_THREADS;
169 if (serv->sv_nrthreads-1 == nrservs)
172 ret = serv->sv_ops->svo_setup(serv, NULL, nrservs);
174 serv->sv_ops->svo_setup(serv, NULL, 0);
177 dprintk("nfs_callback_up: service started\n");
181 static void nfs_callback_down_net(u32 minorversion, struct svc_serv *serv, struct net *net)
183 struct nfs_net *nn = net_generic(net, nfs_net_id);
185 if (--nn->cb_users[minorversion])
188 dprintk("NFS: destroy per-net callback data; net=%x\n", net->ns.inum);
189 svc_shutdown_net(serv, net);
192 static int nfs_callback_up_net(int minorversion, struct svc_serv *serv,
193 struct net *net, struct rpc_xprt *xprt)
195 struct nfs_net *nn = net_generic(net, nfs_net_id);
198 if (nn->cb_users[minorversion]++)
201 dprintk("NFS: create per-net callback data; net=%x\n", net->ns.inum);
203 ret = svc_bind(serv, net);
205 printk(KERN_WARNING "NFS: bind callback service failed\n");
209 ret = -EPROTONOSUPPORT;
210 if (!IS_ENABLED(CONFIG_NFS_V4_1) || minorversion == 0)
211 ret = nfs4_callback_up_net(serv, net);
212 else if (xprt->ops->bc_up)
213 ret = xprt->ops->bc_up(serv, net);
216 printk(KERN_ERR "NFS: callback service start failed\n");
222 svc_rpcb_cleanup(serv, net);
224 nn->cb_users[minorversion]--;
225 dprintk("NFS: Couldn't create callback socket: err = %d; "
226 "net = %x\n", ret, net->ns.inum);
230 static const struct svc_serv_ops nfs40_cb_sv_ops = {
231 .svo_function = nfs4_callback_svc,
232 .svo_enqueue_xprt = svc_xprt_do_enqueue,
233 .svo_setup = svc_set_num_threads_sync,
234 .svo_module = THIS_MODULE,
236 #if defined(CONFIG_NFS_V4_1)
237 static const struct svc_serv_ops nfs41_cb_sv_ops = {
238 .svo_function = nfs41_callback_svc,
239 .svo_enqueue_xprt = svc_xprt_do_enqueue,
240 .svo_setup = svc_set_num_threads_sync,
241 .svo_module = THIS_MODULE,
244 static const struct svc_serv_ops *nfs4_cb_sv_ops[] = {
245 [0] = &nfs40_cb_sv_ops,
246 [1] = &nfs41_cb_sv_ops,
249 static const struct svc_serv_ops *nfs4_cb_sv_ops[] = {
250 [0] = &nfs40_cb_sv_ops,
255 static struct svc_serv *nfs_callback_create_svc(int minorversion)
257 struct nfs_callback_data *cb_info = &nfs_callback_info[minorversion];
258 const struct svc_serv_ops *sv_ops;
259 struct svc_serv *serv;
262 * Check whether we're already up and running.
266 * Note: increase service usage, because later in case of error
267 * svc_destroy() will be called.
269 svc_get(cb_info->serv);
270 return cb_info->serv;
273 switch (minorversion) {
275 sv_ops = nfs4_cb_sv_ops[0];
278 sv_ops = nfs4_cb_sv_ops[1];
282 return ERR_PTR(-ENOTSUPP);
285 * Sanity check: if there's no task,
286 * we should be the first user ...
289 printk(KERN_WARNING "nfs_callback_create_svc: no kthread, %d users??\n",
292 serv = svc_create_pooled(&nfs4_callback_program, NFS4_CALLBACK_BUFSIZE, sv_ops);
294 printk(KERN_ERR "nfs_callback_create_svc: create service failed\n");
295 return ERR_PTR(-ENOMEM);
297 cb_info->serv = serv;
298 /* As there is only one thread we need to over-ride the
299 * default maximum of 80 connections
301 serv->sv_maxconn = 1024;
302 dprintk("nfs_callback_create_svc: service created\n");
307 * Bring up the callback thread if it is not already up.
309 int nfs_callback_up(u32 minorversion, struct rpc_xprt *xprt)
311 struct svc_serv *serv;
312 struct nfs_callback_data *cb_info = &nfs_callback_info[minorversion];
314 struct net *net = xprt->xprt_net;
316 mutex_lock(&nfs_callback_mutex);
318 serv = nfs_callback_create_svc(minorversion);
324 ret = nfs_callback_up_net(minorversion, serv, net, xprt);
328 ret = nfs_callback_start_svc(minorversion, xprt, serv);
334 * svc_create creates the svc_serv with sv_nrthreads == 1, and then
335 * svc_prepare_thread increments that. So we need to call svc_destroy
336 * on both success and failure so that the refcount is 1 when the
341 cb_info->serv = NULL;
344 mutex_unlock(&nfs_callback_mutex);
348 nfs_callback_down_net(minorversion, serv, net);
349 dprintk("NFS: Couldn't create server thread; err = %d\n", ret);
354 * Kill the callback thread if it's no longer being used.
356 void nfs_callback_down(int minorversion, struct net *net)
358 struct nfs_callback_data *cb_info = &nfs_callback_info[minorversion];
359 struct svc_serv *serv;
361 mutex_lock(&nfs_callback_mutex);
362 serv = cb_info->serv;
363 nfs_callback_down_net(minorversion, serv, net);
365 if (cb_info->users == 0) {
367 serv->sv_ops->svo_setup(serv, NULL, 0);
369 dprintk("nfs_callback_down: service destroyed\n");
370 cb_info->serv = NULL;
372 mutex_unlock(&nfs_callback_mutex);
375 /* Boolean check of RPC_AUTH_GSS principal */
377 check_gss_callback_principal(struct nfs_client *clp, struct svc_rqst *rqstp)
379 char *p = rqstp->rq_cred.cr_principal;
381 if (rqstp->rq_authop->flavour != RPC_AUTH_GSS)
384 /* No RPC_AUTH_GSS on NFSv4.1 back channel yet */
385 if (clp->cl_minorversion != 0)
388 * It might just be a normal user principal, in which case
389 * userspace won't bother to tell us the name at all.
395 * Did we get the acceptor from userland during the SETCLIENID
398 if (clp->cl_acceptor)
399 return !strcmp(p, clp->cl_acceptor);
402 * Otherwise try to verify it using the cl_hostname. Note that this
403 * doesn't work if a non-canonical hostname was used in the devname.
406 /* Expect a GSS_C_NT_HOSTBASED_NAME like "nfs@serverhostname" */
408 if (memcmp(p, "nfs@", 4) != 0)
411 if (strcmp(p, clp->cl_hostname) != 0)
417 * pg_authenticate method for nfsv4 callback threads.
419 * The authflavor has been negotiated, so an incorrect flavor is a server
420 * bug. Deny packets with incorrect authflavor.
422 * All other checking done after NFS decoding where the nfs_client can be
423 * found in nfs4_callback_compound
425 static int nfs_callback_authenticate(struct svc_rqst *rqstp)
427 switch (rqstp->rq_authop->flavour) {
429 if (rqstp->rq_proc != CB_NULL)
433 /* No RPC_AUTH_GSS support yet in NFSv4.1 */
434 if (svc_is_backchannel(rqstp))
441 * Define NFS4 callback program
443 static const struct svc_version *nfs4_callback_version[] = {
444 [1] = &nfs4_callback_version1,
445 [4] = &nfs4_callback_version4,
448 static struct svc_stat nfs4_callback_stats;
450 static struct svc_program nfs4_callback_program = {
451 .pg_prog = NFS4_CALLBACK, /* RPC service number */
452 .pg_nvers = ARRAY_SIZE(nfs4_callback_version), /* Number of entries */
453 .pg_vers = nfs4_callback_version, /* version table */
454 .pg_name = "NFSv4 callback", /* service name */
455 .pg_class = "nfs", /* authentication class */
456 .pg_stats = &nfs4_callback_stats,
457 .pg_authenticate = nfs_callback_authenticate,