1 // SPDX-License-Identifier: GPL-2.0
3 * linux/fs/lockd/host.c
5 * Management for NLM peer hosts. The nlm_host struct is shared
6 * between client and server implementation. The only reason to
7 * do so is to reduce code bloat.
9 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
12 #include <linux/types.h>
13 #include <linux/slab.h>
15 #include <linux/in6.h>
16 #include <linux/sunrpc/clnt.h>
17 #include <linux/sunrpc/addr.h>
18 #include <linux/sunrpc/svc.h>
19 #include <linux/lockd/lockd.h>
20 #include <linux/mutex.h>
22 #include <linux/sunrpc/svc_xprt.h>
28 #define NLMDBG_FACILITY NLMDBG_HOSTCACHE
29 #define NLM_HOST_NRHASH 32
30 #define NLM_HOST_REBIND (60 * HZ)
31 #define NLM_HOST_EXPIRE (300 * HZ)
32 #define NLM_HOST_COLLECT (120 * HZ)
34 static struct hlist_head nlm_server_hosts[NLM_HOST_NRHASH];
35 static struct hlist_head nlm_client_hosts[NLM_HOST_NRHASH];
37 #define for_each_host(host, chain, table) \
38 for ((chain) = (table); \
39 (chain) < (table) + NLM_HOST_NRHASH; ++(chain)) \
40 hlist_for_each_entry((host), (chain), h_hash)
42 #define for_each_host_safe(host, next, chain, table) \
43 for ((chain) = (table); \
44 (chain) < (table) + NLM_HOST_NRHASH; ++(chain)) \
45 hlist_for_each_entry_safe((host), (next), \
48 static unsigned long nrhosts;
49 static DEFINE_MUTEX(nlm_host_mutex);
51 static void nlm_gc_hosts(struct net *net);
53 struct nlm_lookup_host_info {
54 const int server; /* search for server|client */
55 const struct sockaddr *sap; /* address to search for */
56 const size_t salen; /* it's length */
57 const unsigned short protocol; /* transport to search for*/
58 const u32 version; /* NLM version to search for */
59 const char *hostname; /* remote's hostname */
60 const size_t hostname_len; /* it's length */
61 const int noresvport; /* use non-priv port */
62 struct net *net; /* network namespace to bind */
63 const struct cred *cred;
67 * Hash function must work well on big- and little-endian platforms
69 static unsigned int __nlm_hash32(const __be32 n)
71 unsigned int hash = (__force u32)n ^ ((__force u32)n >> 16);
72 return hash ^ (hash >> 8);
75 static unsigned int __nlm_hash_addr4(const struct sockaddr *sap)
77 const struct sockaddr_in *sin = (struct sockaddr_in *)sap;
78 return __nlm_hash32(sin->sin_addr.s_addr);
81 static unsigned int __nlm_hash_addr6(const struct sockaddr *sap)
83 const struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)sap;
84 const struct in6_addr addr = sin6->sin6_addr;
85 return __nlm_hash32(addr.s6_addr32[0]) ^
86 __nlm_hash32(addr.s6_addr32[1]) ^
87 __nlm_hash32(addr.s6_addr32[2]) ^
88 __nlm_hash32(addr.s6_addr32[3]);
91 static unsigned int nlm_hash_address(const struct sockaddr *sap)
95 switch (sap->sa_family) {
97 hash = __nlm_hash_addr4(sap);
100 hash = __nlm_hash_addr6(sap);
105 return hash & (NLM_HOST_NRHASH - 1);
109 * Allocate and initialize an nlm_host. Common to both client and server.
111 static struct nlm_host *nlm_alloc_host(struct nlm_lookup_host_info *ni,
112 struct nsm_handle *nsm)
114 struct nlm_host *host = NULL;
115 unsigned long now = jiffies;
118 refcount_inc(&nsm->sm_count);
121 nsm = nsm_get_handle(ni->net, ni->sap, ni->salen,
122 ni->hostname, ni->hostname_len);
123 if (unlikely(nsm == NULL)) {
124 dprintk("lockd: %s failed; no nsm handle\n",
130 host = kmalloc(sizeof(*host), GFP_KERNEL);
131 if (unlikely(host == NULL)) {
132 dprintk("lockd: %s failed; no memory\n", __func__);
137 memcpy(nlm_addr(host), ni->sap, ni->salen);
138 host->h_addrlen = ni->salen;
139 rpc_set_port(nlm_addr(host), 0);
140 host->h_srcaddrlen = 0;
142 host->h_rpcclnt = NULL;
143 host->h_name = nsm->sm_name;
144 host->h_version = ni->version;
145 host->h_proto = ni->protocol;
146 host->h_reclaiming = 0;
147 host->h_server = ni->server;
148 host->h_noresvport = ni->noresvport;
150 init_waitqueue_head(&host->h_gracewait);
151 init_rwsem(&host->h_rwsem);
153 host->h_nsmstate = 0;
154 host->h_pidcount = 0;
155 refcount_set(&host->h_count, 1);
156 mutex_init(&host->h_mutex);
157 host->h_nextrebind = now + NLM_HOST_REBIND;
158 host->h_expires = now + NLM_HOST_EXPIRE;
159 INIT_LIST_HEAD(&host->h_lockowners);
160 spin_lock_init(&host->h_lock);
161 INIT_LIST_HEAD(&host->h_granted);
162 INIT_LIST_HEAD(&host->h_reclaim);
163 host->h_nsmhandle = nsm;
164 host->h_addrbuf = nsm->sm_addrbuf;
166 host->h_cred = get_cred(ni->cred);
167 strscpy(host->nodename, utsname()->nodename, sizeof(host->nodename));
174 * Destroy an nlm_host and free associated resources
176 * Caller must hold nlm_host_mutex.
178 static void nlm_destroy_host_locked(struct nlm_host *host)
180 struct rpc_clnt *clnt;
181 struct lockd_net *ln = net_generic(host->net, lockd_net_id);
183 dprintk("lockd: destroy host %s\n", host->h_name);
185 hlist_del_init(&host->h_hash);
188 nsm_release(host->h_nsmhandle);
190 clnt = host->h_rpcclnt;
192 rpc_shutdown_client(clnt);
193 put_cred(host->h_cred);
201 * nlmclnt_lookup_host - Find an NLM host handle matching a remote server
202 * @sap: network address of server
203 * @salen: length of server address
204 * @protocol: transport protocol to use
205 * @version: NLM protocol version
206 * @hostname: '\0'-terminated hostname of server
207 * @noresvport: 1 if non-privileged port should be used
208 * @net: pointer to net namespace
209 * @cred: pointer to cred
211 * Returns an nlm_host structure that matches the passed-in
212 * [server address, transport protocol, NLM version, server hostname].
213 * If one doesn't already exist in the host cache, a new handle is
214 * created and returned.
216 struct nlm_host *nlmclnt_lookup_host(const struct sockaddr *sap,
218 const unsigned short protocol,
220 const char *hostname,
223 const struct cred *cred)
225 struct nlm_lookup_host_info ni = {
229 .protocol = protocol,
231 .hostname = hostname,
232 .hostname_len = strlen(hostname),
233 .noresvport = noresvport,
237 struct hlist_head *chain;
238 struct nlm_host *host;
239 struct nsm_handle *nsm = NULL;
240 struct lockd_net *ln = net_generic(net, lockd_net_id);
242 dprintk("lockd: %s(host='%s', vers=%u, proto=%s)\n", __func__,
243 (hostname ? hostname : "<none>"), version,
244 (protocol == IPPROTO_UDP ? "udp" : "tcp"));
246 mutex_lock(&nlm_host_mutex);
248 chain = &nlm_client_hosts[nlm_hash_address(sap)];
249 hlist_for_each_entry(host, chain, h_hash) {
250 if (host->net != net)
252 if (!rpc_cmp_addr(nlm_addr(host), sap))
255 /* Same address. Share an NSM handle if we already have one */
257 nsm = host->h_nsmhandle;
259 if (host->h_proto != protocol)
261 if (host->h_version != version)
265 dprintk("lockd: %s found host %s (%s)\n", __func__,
266 host->h_name, host->h_addrbuf);
270 host = nlm_alloc_host(&ni, nsm);
271 if (unlikely(host == NULL))
274 hlist_add_head(&host->h_hash, chain);
278 dprintk("lockd: %s created host %s (%s)\n", __func__,
279 host->h_name, host->h_addrbuf);
282 mutex_unlock(&nlm_host_mutex);
287 * nlmclnt_release_host - release client nlm_host
288 * @host: nlm_host to release
291 void nlmclnt_release_host(struct nlm_host *host)
296 dprintk("lockd: release client host %s\n", host->h_name);
298 WARN_ON_ONCE(host->h_server);
300 if (refcount_dec_and_mutex_lock(&host->h_count, &nlm_host_mutex)) {
301 WARN_ON_ONCE(!list_empty(&host->h_lockowners));
302 WARN_ON_ONCE(!list_empty(&host->h_granted));
303 WARN_ON_ONCE(!list_empty(&host->h_reclaim));
305 nlm_destroy_host_locked(host);
306 mutex_unlock(&nlm_host_mutex);
311 * nlmsvc_lookup_host - Find an NLM host handle matching a remote client
312 * @rqstp: incoming NLM request
313 * @hostname: name of client host
314 * @hostname_len: length of client hostname
316 * Returns an nlm_host structure that matches the [client address,
317 * transport protocol, NLM version, client hostname] of the passed-in
318 * NLM request. If one doesn't already exist in the host cache, a
319 * new handle is created and returned.
321 * Before possibly creating a new nlm_host, construct a sockaddr
322 * for a specific source address in case the local system has
323 * multiple network addresses. The family of the address in
324 * rq_daddr is guaranteed to be the same as the family of the
325 * address in rq_addr, so it's safe to use the same family for
326 * the source address.
328 struct nlm_host *nlmsvc_lookup_host(const struct svc_rqst *rqstp,
329 const char *hostname,
330 const size_t hostname_len)
332 struct hlist_head *chain;
333 struct nlm_host *host = NULL;
334 struct nsm_handle *nsm = NULL;
335 struct sockaddr *src_sap = svc_daddr(rqstp);
336 size_t src_len = rqstp->rq_daddrlen;
337 struct net *net = SVC_NET(rqstp);
338 struct nlm_lookup_host_info ni = {
340 .sap = svc_addr(rqstp),
341 .salen = rqstp->rq_addrlen,
342 .protocol = rqstp->rq_prot,
343 .version = rqstp->rq_vers,
344 .hostname = hostname,
345 .hostname_len = hostname_len,
348 struct lockd_net *ln = net_generic(net, lockd_net_id);
350 dprintk("lockd: %s(host='%.*s', vers=%u, proto=%s)\n", __func__,
351 (int)hostname_len, hostname, rqstp->rq_vers,
352 (rqstp->rq_prot == IPPROTO_UDP ? "udp" : "tcp"));
354 mutex_lock(&nlm_host_mutex);
356 if (time_after_eq(jiffies, ln->next_gc))
359 chain = &nlm_server_hosts[nlm_hash_address(ni.sap)];
360 hlist_for_each_entry(host, chain, h_hash) {
361 if (host->net != net)
363 if (!rpc_cmp_addr(nlm_addr(host), ni.sap))
366 /* Same address. Share an NSM handle if we already have one */
368 nsm = host->h_nsmhandle;
370 if (host->h_proto != ni.protocol)
372 if (host->h_version != ni.version)
374 if (!rpc_cmp_addr(nlm_srcaddr(host), src_sap))
377 /* Move to head of hash chain. */
378 hlist_del(&host->h_hash);
379 hlist_add_head(&host->h_hash, chain);
382 dprintk("lockd: %s found host %s (%s)\n",
383 __func__, host->h_name, host->h_addrbuf);
387 host = nlm_alloc_host(&ni, nsm);
388 if (unlikely(host == NULL))
391 memcpy(nlm_srcaddr(host), src_sap, src_len);
392 host->h_srcaddrlen = src_len;
393 hlist_add_head(&host->h_hash, chain);
397 refcount_inc(&host->h_count);
399 dprintk("lockd: %s created host %s (%s)\n",
400 __func__, host->h_name, host->h_addrbuf);
403 mutex_unlock(&nlm_host_mutex);
408 * nlmsvc_release_host - release server nlm_host
409 * @host: nlm_host to release
411 * Host is destroyed later in nlm_gc_host().
413 void nlmsvc_release_host(struct nlm_host *host)
418 dprintk("lockd: release server host %s\n", host->h_name);
420 WARN_ON_ONCE(!host->h_server);
421 refcount_dec(&host->h_count);
425 * Create the NLM RPC client for an NLM peer
428 nlm_bind_host(struct nlm_host *host)
430 struct rpc_clnt *clnt;
432 dprintk("lockd: nlm_bind_host %s (%s)\n",
433 host->h_name, host->h_addrbuf);
435 /* Lock host handle */
436 mutex_lock(&host->h_mutex);
438 /* If we've already created an RPC client, check whether
439 * RPC rebind is required
441 if ((clnt = host->h_rpcclnt) != NULL) {
442 nlm_rebind_host(host);
444 unsigned long increment = nlmsvc_timeout;
445 struct rpc_timeout timeparms = {
446 .to_initval = increment,
447 .to_increment = increment,
448 .to_maxval = increment * 6UL,
451 struct rpc_create_args args = {
453 .protocol = host->h_proto,
454 .address = nlm_addr(host),
455 .addrsize = host->h_addrlen,
456 .timeout = &timeparms,
457 .servername = host->h_name,
458 .program = &nlm_program,
459 .version = host->h_version,
460 .authflavor = RPC_AUTH_UNIX,
461 .flags = (RPC_CLNT_CREATE_NOPING |
462 RPC_CLNT_CREATE_AUTOBIND |
463 RPC_CLNT_CREATE_REUSEPORT),
464 .cred = host->h_cred,
468 * lockd retries server side blocks automatically so we want
469 * those to be soft RPC calls. Client side calls need to be
473 args.flags |= RPC_CLNT_CREATE_HARDRTRY;
474 if (host->h_noresvport)
475 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
476 if (host->h_srcaddrlen)
477 args.saddress = nlm_srcaddr(host);
479 clnt = rpc_create(&args);
481 host->h_rpcclnt = clnt;
483 printk("lockd: couldn't create RPC handle for %s\n", host->h_name);
488 mutex_unlock(&host->h_mutex);
493 * nlm_rebind_host - If needed, force a portmap lookup of the peer's lockd port
494 * @host: NLM host handle for peer
496 * This is not needed when using a connection-oriented protocol, such as TCP.
497 * The existing autobind mechanism is sufficient to force a rebind when
498 * required, e.g. on connection state transitions.
501 nlm_rebind_host(struct nlm_host *host)
503 if (host->h_proto != IPPROTO_UDP)
506 if (host->h_rpcclnt && time_after_eq(jiffies, host->h_nextrebind)) {
507 rpc_force_rebind(host->h_rpcclnt);
508 host->h_nextrebind = jiffies + NLM_HOST_REBIND;
513 * Increment NLM host count
515 struct nlm_host * nlm_get_host(struct nlm_host *host)
518 dprintk("lockd: get host %s\n", host->h_name);
519 refcount_inc(&host->h_count);
520 host->h_expires = jiffies + NLM_HOST_EXPIRE;
525 static struct nlm_host *next_host_state(struct hlist_head *cache,
526 struct nsm_handle *nsm,
527 const struct nlm_reboot *info)
529 struct nlm_host *host;
530 struct hlist_head *chain;
532 mutex_lock(&nlm_host_mutex);
533 for_each_host(host, chain, cache) {
534 if (host->h_nsmhandle == nsm
535 && host->h_nsmstate != info->state) {
536 host->h_nsmstate = info->state;
540 mutex_unlock(&nlm_host_mutex);
545 mutex_unlock(&nlm_host_mutex);
550 * nlm_host_rebooted - Release all resources held by rebooted host
551 * @net: network namespace
552 * @info: pointer to decoded results of NLM_SM_NOTIFY call
554 * We were notified that the specified host has rebooted. Release
555 * all resources held by that peer.
557 void nlm_host_rebooted(const struct net *net, const struct nlm_reboot *info)
559 struct nsm_handle *nsm;
560 struct nlm_host *host;
562 nsm = nsm_reboot_lookup(net, info);
563 if (unlikely(nsm == NULL))
566 /* Mark all hosts tied to this NSM state as having rebooted.
567 * We run the loop repeatedly, because we drop the host table
569 * To avoid processing a host several times, we match the nsmstate.
571 while ((host = next_host_state(nlm_server_hosts, nsm, info)) != NULL) {
572 nlmsvc_free_host_resources(host);
573 nlmsvc_release_host(host);
575 while ((host = next_host_state(nlm_client_hosts, nsm, info)) != NULL) {
576 nlmclnt_recovery(host);
577 nlmclnt_release_host(host);
583 static void nlm_complain_hosts(struct net *net)
585 struct hlist_head *chain;
586 struct nlm_host *host;
589 struct lockd_net *ln = net_generic(net, lockd_net_id);
591 if (ln->nrhosts == 0)
593 pr_warn("lockd: couldn't shutdown host module for net %x!\n",
595 dprintk("lockd: %lu hosts left in net %x:\n", ln->nrhosts,
600 printk(KERN_WARNING "lockd: couldn't shutdown host module!\n");
601 dprintk("lockd: %lu hosts left:\n", nrhosts);
604 for_each_host(host, chain, nlm_server_hosts) {
605 if (net && host->net != net)
607 dprintk(" %s (cnt %d use %d exp %ld net %x)\n",
608 host->h_name, refcount_read(&host->h_count),
609 host->h_inuse, host->h_expires, host->net->ns.inum);
614 nlm_shutdown_hosts_net(struct net *net)
616 struct hlist_head *chain;
617 struct nlm_host *host;
619 mutex_lock(&nlm_host_mutex);
621 /* First, make all hosts eligible for gc */
622 dprintk("lockd: nuking all hosts in net %x...\n",
623 net ? net->ns.inum : 0);
624 for_each_host(host, chain, nlm_server_hosts) {
625 if (net && host->net != net)
627 host->h_expires = jiffies - 1;
628 if (host->h_rpcclnt) {
629 rpc_shutdown_client(host->h_rpcclnt);
630 host->h_rpcclnt = NULL;
632 nlmsvc_free_host_resources(host);
635 /* Then, perform a garbage collection pass */
637 nlm_complain_hosts(net);
638 mutex_unlock(&nlm_host_mutex);
642 * Shut down the hosts module.
643 * Note that this routine is called only at server shutdown time.
646 nlm_shutdown_hosts(void)
648 dprintk("lockd: shutting down host module\n");
649 nlm_shutdown_hosts_net(NULL);
653 * Garbage collect any unused NLM hosts.
654 * This GC combines reference counting for async operations with
655 * mark & sweep for resources held by remote clients.
658 nlm_gc_hosts(struct net *net)
660 struct hlist_head *chain;
661 struct hlist_node *next;
662 struct nlm_host *host;
664 dprintk("lockd: host garbage collection for net %x\n",
665 net ? net->ns.inum : 0);
666 for_each_host(host, chain, nlm_server_hosts) {
667 if (net && host->net != net)
672 /* Mark all hosts that hold locks, blocks or shares */
673 nlmsvc_mark_resources(net);
675 for_each_host_safe(host, next, chain, nlm_server_hosts) {
676 if (net && host->net != net)
678 if (host->h_inuse || time_before(jiffies, host->h_expires)) {
679 dprintk("nlm_gc_hosts skipping %s "
680 "(cnt %d use %d exp %ld net %x)\n",
681 host->h_name, refcount_read(&host->h_count),
682 host->h_inuse, host->h_expires,
686 if (refcount_dec_if_one(&host->h_count))
687 nlm_destroy_host_locked(host);
691 struct lockd_net *ln = net_generic(net, lockd_net_id);
693 ln->next_gc = jiffies + NLM_HOST_COLLECT;