Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v3.5.6
 
  1/* NFS filesystem cache interface
  2 *
  3 * Copyright (C) 2008 Red Hat, Inc. All Rights Reserved.
  4 * Written by David Howells (dhowells@redhat.com)
  5 *
  6 * This program is free software; you can redistribute it and/or
  7 * modify it under the terms of the GNU General Public Licence
  8 * as published by the Free Software Foundation; either version
  9 * 2 of the Licence, or (at your option) any later version.
 10 */
 11
 12#include <linux/init.h>
 13#include <linux/kernel.h>
 14#include <linux/sched.h>
 15#include <linux/mm.h>
 16#include <linux/nfs_fs.h>
 17#include <linux/nfs_fs_sb.h>
 18#include <linux/in6.h>
 19#include <linux/seq_file.h>
 20#include <linux/slab.h>
 
 
 
 
 21
 22#include "internal.h"
 23#include "iostat.h"
 24#include "fscache.h"
 
 25
 26#define NFSDBG_FACILITY		NFSDBG_FSCACHE
 27
 28static struct rb_root nfs_fscache_keys = RB_ROOT;
 29static DEFINE_SPINLOCK(nfs_fscache_keys_lock);
 
 
 
 
 
 
 
 
 30
 31/*
 32 * Get the per-client index cookie for an NFS client if the appropriate mount
 33 * flag was set
 34 * - We always try and get an index cookie for the client, but get filehandle
 35 *   cookies on a per-superblock basis, depending on the mount flags
 36 */
 37void nfs_fscache_get_client_cookie(struct nfs_client *clp)
 
 38{
 39	/* create a cache index for looking up filehandles */
 40	clp->fscache = fscache_acquire_cookie(nfs_fscache_netfs.primary_index,
 41					      &nfs_fscache_server_index_def,
 42					      clp);
 43	dfprintk(FSCACHE, "NFS: get client cookie (0x%p/0x%p)\n",
 44		 clp, clp->fscache);
 45}
 46
 47/*
 48 * Dispose of a per-client cookie
 49 */
 50void nfs_fscache_release_client_cookie(struct nfs_client *clp)
 51{
 52	dfprintk(FSCACHE, "NFS: releasing client cookie (0x%p/0x%p)\n",
 53		 clp, clp->fscache);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 54
 55	fscache_relinquish_cookie(clp->fscache, 0);
 56	clp->fscache = NULL;
 
 
 
 57}
 58
 59/*
 60 * Get the cache cookie for an NFS superblock.  We have to handle
 61 * uniquification here because the cache doesn't do it for us.
 62 *
 63 * The default uniquifier is just an empty string, but it may be overridden
 64 * either by the 'fsc=xxx' option to mount, or by inheriting it from the parent
 65 * superblock across an automount point of some nature.
 66 */
 67void nfs_fscache_get_super_cookie(struct super_block *sb, const char *uniq, int ulen)
 68{
 69	struct nfs_fscache_key *key, *xkey;
 70	struct nfs_server *nfss = NFS_SB(sb);
 71	struct rb_node **p, *parent;
 72	int diff;
 73
 74	if (!uniq) {
 75		uniq = "";
 76		ulen = 1;
 
 77	}
 78
 79	key = kzalloc(sizeof(*key) + ulen, GFP_KERNEL);
 80	if (!key)
 81		return;
 82
 83	key->nfs_client = nfss->nfs_client;
 84	key->key.super.s_flags = sb->s_flags & NFS_MS_MASK;
 85	key->key.nfs_server.flags = nfss->flags;
 86	key->key.nfs_server.rsize = nfss->rsize;
 87	key->key.nfs_server.wsize = nfss->wsize;
 88	key->key.nfs_server.acregmin = nfss->acregmin;
 89	key->key.nfs_server.acregmax = nfss->acregmax;
 90	key->key.nfs_server.acdirmin = nfss->acdirmin;
 91	key->key.nfs_server.acdirmax = nfss->acdirmax;
 92	key->key.nfs_server.fsid = nfss->fsid;
 93	key->key.rpc_auth.au_flavor = nfss->client->cl_auth->au_flavor;
 94
 95	key->key.uniq_len = ulen;
 96	memcpy(key->key.uniquifier, uniq, ulen);
 97
 98	spin_lock(&nfs_fscache_keys_lock);
 99	p = &nfs_fscache_keys.rb_node;
100	parent = NULL;
101	while (*p) {
102		parent = *p;
103		xkey = rb_entry(parent, struct nfs_fscache_key, node);
104
105		if (key->nfs_client < xkey->nfs_client)
106			goto go_left;
107		if (key->nfs_client > xkey->nfs_client)
108			goto go_right;
109
110		diff = memcmp(&key->key, &xkey->key, sizeof(key->key));
111		if (diff < 0)
112			goto go_left;
113		if (diff > 0)
114			goto go_right;
115
116		if (key->key.uniq_len == 0)
117			goto non_unique;
118		diff = memcmp(key->key.uniquifier,
119			      xkey->key.uniquifier,
120			      key->key.uniq_len);
121		if (diff < 0)
122			goto go_left;
123		if (diff > 0)
124			goto go_right;
125		goto non_unique;
126
127	go_left:
128		p = &(*p)->rb_left;
129		continue;
130	go_right:
131		p = &(*p)->rb_right;
132	}
133
134	rb_link_node(&key->node, parent, p);
135	rb_insert_color(&key->node, &nfs_fscache_keys);
136	spin_unlock(&nfs_fscache_keys_lock);
137	nfss->fscache_key = key;
138
139	/* create a cache index for looking up filehandles */
140	nfss->fscache = fscache_acquire_cookie(nfss->nfs_client->fscache,
141					       &nfs_fscache_super_index_def,
142					       nfss);
143	dfprintk(FSCACHE, "NFS: get superblock cookie (0x%p/0x%p)\n",
144		 nfss, nfss->fscache);
145	return;
 
 
 
 
 
 
146
147non_unique:
148	spin_unlock(&nfs_fscache_keys_lock);
149	kfree(key);
150	nfss->fscache_key = NULL;
151	nfss->fscache = NULL;
152	printk(KERN_WARNING "NFS:"
153	       " Cache request denied due to non-unique superblock keys\n");
154}
155
156/*
157 * release a per-superblock cookie
158 */
159void nfs_fscache_release_super_cookie(struct super_block *sb)
160{
161	struct nfs_server *nfss = NFS_SB(sb);
162
163	dfprintk(FSCACHE, "NFS: releasing superblock cookie (0x%p/0x%p)\n",
164		 nfss, nfss->fscache);
165
166	fscache_relinquish_cookie(nfss->fscache, 0);
167	nfss->fscache = NULL;
168
169	if (nfss->fscache_key) {
170		spin_lock(&nfs_fscache_keys_lock);
171		rb_erase(&nfss->fscache_key->node, &nfs_fscache_keys);
172		spin_unlock(&nfs_fscache_keys_lock);
173		kfree(nfss->fscache_key);
174		nfss->fscache_key = NULL;
175	}
176}
177
178/*
179 * Initialise the per-inode cache cookie pointer for an NFS inode.
180 */
181void nfs_fscache_init_inode_cookie(struct inode *inode)
182{
183	NFS_I(inode)->fscache = NULL;
184	if (S_ISREG(inode->i_mode))
185		set_bit(NFS_INO_FSCACHE, &NFS_I(inode)->flags);
186}
187
188/*
189 * Get the per-inode cache cookie for an NFS inode.
190 */
191static void nfs_fscache_enable_inode_cookie(struct inode *inode)
192{
193	struct super_block *sb = inode->i_sb;
194	struct nfs_inode *nfsi = NFS_I(inode);
195
196	if (nfsi->fscache || !NFS_FSCACHE(inode))
 
197		return;
198
199	if ((NFS_SB(sb)->options & NFS_OPTION_FSCACHE)) {
200		nfsi->fscache = fscache_acquire_cookie(
201			NFS_SB(sb)->fscache,
202			&nfs_fscache_inode_object_def,
203			nfsi);
204
205		dfprintk(FSCACHE, "NFS: get FH cookie (0x%p/0x%p/0x%p)\n",
206			 sb, nfsi, nfsi->fscache);
207	}
 
 
 
 
 
 
 
 
208}
209
210/*
211 * Release a per-inode cookie.
212 */
213void nfs_fscache_release_inode_cookie(struct inode *inode)
214{
215	struct nfs_inode *nfsi = NFS_I(inode);
216
217	dfprintk(FSCACHE, "NFS: clear cookie (0x%p/0x%p)\n",
218		 nfsi, nfsi->fscache);
219
220	fscache_relinquish_cookie(nfsi->fscache, 0);
221	nfsi->fscache = NULL;
222}
223
224/*
225 * Retire a per-inode cookie, destroying the data attached to it.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
226 */
227void nfs_fscache_zap_inode_cookie(struct inode *inode)
228{
229	struct nfs_inode *nfsi = NFS_I(inode);
230
231	dfprintk(FSCACHE, "NFS: zapping cookie (0x%p/0x%p)\n",
232		 nfsi, nfsi->fscache);
233
234	fscache_relinquish_cookie(nfsi->fscache, 1);
235	nfsi->fscache = NULL;
236}
237
238/*
239 * Turn off the cache with regard to a per-inode cookie if opened for writing,
240 * invalidating all the pages in the page cache relating to the associated
241 * inode to clear the per-page caching.
242 */
243static void nfs_fscache_disable_inode_cookie(struct inode *inode)
244{
245	clear_bit(NFS_INO_FSCACHE, &NFS_I(inode)->flags);
246
247	if (NFS_I(inode)->fscache) {
248		dfprintk(FSCACHE,
249			 "NFS: nfsi 0x%p turning cache off\n", NFS_I(inode));
250
251		/* Need to uncache any pages attached to this inode that
252		 * fscache knows about before turning off the cache.
253		 */
254		fscache_uncache_all_inode_pages(NFS_I(inode)->fscache, inode);
255		nfs_fscache_zap_inode_cookie(inode);
256	}
257}
 
258
259/*
260 * wait_on_bit() sleep function for uninterruptible waiting
261 */
262static int nfs_fscache_wait_bit(void *flags)
263{
264	schedule();
265	return 0;
 
 
 
 
266}
267
268/*
269 * Lock against someone else trying to also acquire or relinquish a cookie
270 */
271static inline void nfs_fscache_inode_lock(struct inode *inode)
272{
273	struct nfs_inode *nfsi = NFS_I(inode);
 
274
275	while (test_and_set_bit(NFS_INO_FSCACHE_LOCK, &nfsi->flags))
276		wait_on_bit(&nfsi->flags, NFS_INO_FSCACHE_LOCK,
277			    nfs_fscache_wait_bit, TASK_UNINTERRUPTIBLE);
278}
279
280/*
281 * Unlock cookie management lock
282 */
283static inline void nfs_fscache_inode_unlock(struct inode *inode)
284{
285	struct nfs_inode *nfsi = NFS_I(inode);
 
 
 
286
287	smp_mb__before_clear_bit();
288	clear_bit(NFS_INO_FSCACHE_LOCK, &nfsi->flags);
289	smp_mb__after_clear_bit();
290	wake_up_bit(&nfsi->flags, NFS_INO_FSCACHE_LOCK);
291}
292
293/*
294 * Decide if we should enable or disable local caching for this inode.
295 * - For now, with NFS, only regular files that are open read-only will be able
296 *   to use the cache.
297 * - May be invoked multiple times in parallel by parallel nfs_open() functions.
298 */
299void nfs_fscache_set_inode_cookie(struct inode *inode, struct file *filp)
300{
301	if (NFS_FSCACHE(inode)) {
302		nfs_fscache_inode_lock(inode);
303		if ((filp->f_flags & O_ACCMODE) != O_RDONLY)
304			nfs_fscache_disable_inode_cookie(inode);
305		else
306			nfs_fscache_enable_inode_cookie(inode);
307		nfs_fscache_inode_unlock(inode);
308	}
309}
310
311/*
312 * Replace a per-inode cookie due to revalidation detecting a file having
313 * changed on the server.
314 */
315void nfs_fscache_reset_inode_cookie(struct inode *inode)
316{
317	struct nfs_inode *nfsi = NFS_I(inode);
318	struct nfs_server *nfss = NFS_SERVER(inode);
319	NFS_IFDEBUG(struct fscache_cookie *old = nfsi->fscache);
320
321	nfs_fscache_inode_lock(inode);
322	if (nfsi->fscache) {
323		/* retire the current fscache cache and get a new one */
324		fscache_relinquish_cookie(nfsi->fscache, 1);
325
326		nfsi->fscache = fscache_acquire_cookie(
327			nfss->nfs_client->fscache,
328			&nfs_fscache_inode_object_def,
329			nfsi);
330
331		dfprintk(FSCACHE,
332			 "NFS: revalidation new cookie (0x%p/0x%p/0x%p/0x%p)\n",
333			 nfss, nfsi, old, nfsi->fscache);
334	}
335	nfs_fscache_inode_unlock(inode);
336}
337
338/*
339 * Release the caching state associated with a page, if the page isn't busy
340 * interacting with the cache.
341 * - Returns true (can release page) or false (page busy).
342 */
343int nfs_fscache_release_page(struct page *page, gfp_t gfp)
344{
345	if (PageFsCache(page)) {
346		struct nfs_inode *nfsi = NFS_I(page->mapping->host);
347		struct fscache_cookie *cookie = nfsi->fscache;
348
349		BUG_ON(!cookie);
350		dfprintk(FSCACHE, "NFS: fscache releasepage (0x%p/0x%p/0x%p)\n",
351			 cookie, page, nfsi);
352
353		if (!fscache_maybe_release_page(cookie, page, gfp))
354			return 0;
355
356		nfs_add_fscache_stats(page->mapping->host,
357				      NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
358	}
359
360	return 1;
 
 
 
 
 
361}
362
363/*
364 * Release the caching state associated with a page if undergoing complete page
365 * invalidation.
366 */
367void __nfs_fscache_invalidate_page(struct page *page, struct inode *inode)
368{
369	struct nfs_inode *nfsi = NFS_I(inode);
370	struct fscache_cookie *cookie = nfsi->fscache;
 
 
 
 
 
 
371
372	BUG_ON(!cookie);
 
373
374	dfprintk(FSCACHE, "NFS: fscache invalidatepage (0x%p/0x%p/0x%p)\n",
375		 cookie, page, nfsi);
376
377	fscache_wait_on_page_write(cookie, page);
 
 
378
379	BUG_ON(!PageLocked(page));
380	fscache_uncache_page(cookie, page);
381	nfs_add_fscache_stats(page->mapping->host,
382			      NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
383}
384
385/*
386 * Handle completion of a page being read from the cache.
387 * - Called in process (keventd) context.
388 */
389static void nfs_readpage_from_fscache_complete(struct page *page,
390					       void *context,
391					       int error)
392{
393	dfprintk(FSCACHE,
394		 "NFS: readpage_from_fscache_complete (0x%p/0x%p/%d)\n",
395		 page, context, error);
396
397	/* if the read completes with an error, we just unlock the page and let
398	 * the VM reissue the readpage */
399	if (!error) {
400		SetPageUptodate(page);
401		unlock_page(page);
402	} else {
403		error = nfs_readpage_async(context, page->mapping->host, page);
404		if (error)
405			unlock_page(page);
406	}
 
 
 
407}
408
409/*
410 * Retrieve a page from fscache
411 */
412int __nfs_readpage_from_fscache(struct nfs_open_context *ctx,
413				struct inode *inode, struct page *page)
414{
415	int ret;
416
417	dfprintk(FSCACHE,
418		 "NFS: readpage_from_fscache(fsc:%p/p:%p(i:%lx f:%lx)/0x%p)\n",
419		 NFS_I(inode)->fscache, page, page->index, page->flags, inode);
420
421	ret = fscache_read_or_alloc_page(NFS_I(inode)->fscache,
422					 page,
423					 nfs_readpage_from_fscache_complete,
424					 ctx,
425					 GFP_KERNEL);
426
427	switch (ret) {
428	case 0: /* read BIO submitted (page in fscache) */
429		dfprintk(FSCACHE,
430			 "NFS:    readpage_from_fscache: BIO submitted\n");
431		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK, 1);
432		return ret;
433
434	case -ENOBUFS: /* inode not in cache */
435	case -ENODATA: /* page not in cache */
436		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL, 1);
437		dfprintk(FSCACHE,
438			 "NFS:    readpage_from_fscache %d\n", ret);
439		return 1;
440
441	default:
442		dfprintk(FSCACHE, "NFS:    readpage_from_fscache %d\n", ret);
443		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL, 1);
444	}
445	return ret;
446}
447
448/*
449 * Retrieve a set of pages from fscache
450 */
451int __nfs_readpages_from_fscache(struct nfs_open_context *ctx,
452				 struct inode *inode,
453				 struct address_space *mapping,
454				 struct list_head *pages,
455				 unsigned *nr_pages)
456{
457	unsigned npages = *nr_pages;
458	int ret;
459
460	dfprintk(FSCACHE, "NFS: nfs_getpages_from_fscache (0x%p/%u/0x%p)\n",
461		 NFS_I(inode)->fscache, npages, inode);
462
463	ret = fscache_read_or_alloc_pages(NFS_I(inode)->fscache,
464					  mapping, pages, nr_pages,
465					  nfs_readpage_from_fscache_complete,
466					  ctx,
467					  mapping_gfp_mask(mapping));
468	if (*nr_pages < npages)
469		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK,
470				      npages);
471	if (*nr_pages > 0)
472		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL,
473				      *nr_pages);
474
475	switch (ret) {
476	case 0: /* read submitted to the cache for all pages */
477		BUG_ON(!list_empty(pages));
478		BUG_ON(*nr_pages != 0);
479		dfprintk(FSCACHE,
480			 "NFS: nfs_getpages_from_fscache: submitted\n");
481
482		return ret;
483
484	case -ENOBUFS: /* some pages aren't cached and can't be */
485	case -ENODATA: /* some pages aren't cached */
486		dfprintk(FSCACHE,
487			 "NFS: nfs_getpages_from_fscache: no page: %d\n", ret);
488		return 1;
489
490	default:
491		dfprintk(FSCACHE,
492			 "NFS: nfs_getpages_from_fscache: ret  %d\n", ret);
493	}
 
494
495	return ret;
496}
497
498/*
499 * Store a newly fetched page in fscache
500 * - PG_fscache must be set on the page
501 */
502void __nfs_readpage_to_fscache(struct inode *inode, struct page *page, int sync)
503{
504	int ret;
 
505
506	dfprintk(FSCACHE,
507		 "NFS: readpage_to_fscache(fsc:%p/p:%p(i:%lx f:%lx)/%d)\n",
508		 NFS_I(inode)->fscache, page, page->index, page->flags, sync);
509
510	ret = fscache_write_page(NFS_I(inode)->fscache, page, GFP_KERNEL);
511	dfprintk(FSCACHE,
512		 "NFS:     readpage_to_fscache: p:%p(i:%lu f:%lx) ret %d\n",
513		 page, page->index, page->flags, ret);
514
515	if (ret != 0) {
516		fscache_uncache_page(NFS_I(inode)->fscache, page);
517		nfs_add_fscache_stats(inode,
518				      NFSIOS_FSCACHE_PAGES_WRITTEN_FAIL, 1);
519		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
520	} else {
521		nfs_add_fscache_stats(inode,
522				      NFSIOS_FSCACHE_PAGES_WRITTEN_OK, 1);
523	}
524}
 
 
 
v6.13.7
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/* NFS filesystem cache interface
  3 *
  4 * Copyright (C) 2008 Red Hat, Inc. All Rights Reserved.
  5 * Written by David Howells (dhowells@redhat.com)
 
 
 
 
 
  6 */
  7
  8#include <linux/init.h>
  9#include <linux/kernel.h>
 10#include <linux/sched.h>
 11#include <linux/mm.h>
 12#include <linux/nfs_fs.h>
 13#include <linux/nfs_fs_sb.h>
 14#include <linux/in6.h>
 15#include <linux/seq_file.h>
 16#include <linux/slab.h>
 17#include <linux/iversion.h>
 18#include <linux/xarray.h>
 19#include <linux/fscache.h>
 20#include <linux/netfs.h>
 21
 22#include "internal.h"
 23#include "iostat.h"
 24#include "fscache.h"
 25#include "nfstrace.h"
 26
 27#define NFS_MAX_KEY_LEN 1000
 28
 29static bool nfs_append_int(char *key, int *_len, unsigned long long x)
 30{
 31	if (*_len > NFS_MAX_KEY_LEN)
 32		return false;
 33	if (x == 0)
 34		key[(*_len)++] = ',';
 35	else
 36		*_len += sprintf(key + *_len, ",%llx", x);
 37	return true;
 38}
 39
 40/*
 41 * Get the per-client index cookie for an NFS client if the appropriate mount
 42 * flag was set
 43 * - We always try and get an index cookie for the client, but get filehandle
 44 *   cookies on a per-superblock basis, depending on the mount flags
 45 */
 46static bool nfs_fscache_get_client_key(struct nfs_client *clp,
 47				       char *key, int *_len)
 48{
 49	const struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) &clp->cl_addr;
 50	const struct sockaddr_in *sin = (struct sockaddr_in *) &clp->cl_addr;
 
 
 
 
 
 51
 52	*_len += snprintf(key + *_len, NFS_MAX_KEY_LEN - *_len,
 53			  ",%u.%u,%x",
 54			  clp->rpc_ops->version,
 55			  clp->cl_minorversion,
 56			  clp->cl_addr.ss_family);
 57
 58	switch (clp->cl_addr.ss_family) {
 59	case AF_INET:
 60		if (!nfs_append_int(key, _len, sin->sin_port) ||
 61		    !nfs_append_int(key, _len, sin->sin_addr.s_addr))
 62			return false;
 63		return true;
 64
 65	case AF_INET6:
 66		if (!nfs_append_int(key, _len, sin6->sin6_port) ||
 67		    !nfs_append_int(key, _len, sin6->sin6_addr.s6_addr32[0]) ||
 68		    !nfs_append_int(key, _len, sin6->sin6_addr.s6_addr32[1]) ||
 69		    !nfs_append_int(key, _len, sin6->sin6_addr.s6_addr32[2]) ||
 70		    !nfs_append_int(key, _len, sin6->sin6_addr.s6_addr32[3]))
 71			return false;
 72		return true;
 73
 74	default:
 75		printk(KERN_WARNING "NFS: Unknown network family '%d'\n",
 76		       clp->cl_addr.ss_family);
 77		return false;
 78	}
 79}
 80
 81/*
 82 * Get the cache cookie for an NFS superblock.
 
 83 *
 84 * The default uniquifier is just an empty string, but it may be overridden
 85 * either by the 'fsc=xxx' option to mount, or by inheriting it from the parent
 86 * superblock across an automount point of some nature.
 87 */
 88int nfs_fscache_get_super_cookie(struct super_block *sb, const char *uniq, int ulen)
 89{
 90	struct fscache_volume *vcookie;
 91	struct nfs_server *nfss = NFS_SB(sb);
 92	unsigned int len = 3;
 93	char *key;
 94
 95	if (uniq) {
 96		nfss->fscache_uniq = kmemdup_nul(uniq, ulen, GFP_KERNEL);
 97		if (!nfss->fscache_uniq)
 98			return -ENOMEM;
 99	}
100
101	key = kmalloc(NFS_MAX_KEY_LEN + 24, GFP_KERNEL);
102	if (!key)
103		return -ENOMEM;
104
105	memcpy(key, "nfs", 3);
106	if (!nfs_fscache_get_client_key(nfss->nfs_client, key, &len) ||
107	    !nfs_append_int(key, &len, nfss->fsid.major) ||
108	    !nfs_append_int(key, &len, nfss->fsid.minor) ||
109	    !nfs_append_int(key, &len, sb->s_flags & NFS_SB_MASK) ||
110	    !nfs_append_int(key, &len, nfss->flags) ||
111	    !nfs_append_int(key, &len, nfss->rsize) ||
112	    !nfs_append_int(key, &len, nfss->wsize) ||
113	    !nfs_append_int(key, &len, nfss->acregmin) ||
114	    !nfs_append_int(key, &len, nfss->acregmax) ||
115	    !nfs_append_int(key, &len, nfss->acdirmin) ||
116	    !nfs_append_int(key, &len, nfss->acdirmax) ||
117	    !nfs_append_int(key, &len, nfss->client->cl_auth->au_flavor))
118		goto out;
119
120	if (ulen > 0) {
121		if (ulen > NFS_MAX_KEY_LEN - len)
122			goto out;
123		key[len++] = ',';
124		memcpy(key + len, uniq, ulen);
125		len += ulen;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
126	}
127	key[len] = 0;
 
 
 
 
128
129	/* create a cache index for looking up filehandles */
130	vcookie = fscache_acquire_volume(key,
131					 NULL, /* preferred_cache */
132					 NULL, 0 /* coherency_data */);
133	if (IS_ERR(vcookie)) {
134		if (vcookie != ERR_PTR(-EBUSY)) {
135			kfree(key);
136			return PTR_ERR(vcookie);
137		}
138		pr_err("NFS: Cache volume key already in use (%s)\n", key);
139		vcookie = NULL;
140	}
141	nfss->fscache = vcookie;
142
143out:
 
144	kfree(key);
145	return 0;
 
 
 
146}
147
148/*
149 * release a per-superblock cookie
150 */
151void nfs_fscache_release_super_cookie(struct super_block *sb)
152{
153	struct nfs_server *nfss = NFS_SB(sb);
154
155	fscache_relinquish_volume(nfss->fscache, NULL, false);
 
 
 
156	nfss->fscache = NULL;
157	kfree(nfss->fscache_uniq);
 
 
 
 
 
 
 
158}
159
160/*
161 * Initialise the per-inode cache cookie pointer for an NFS inode.
162 */
163void nfs_fscache_init_inode(struct inode *inode)
164{
165	struct nfs_fscache_inode_auxdata auxdata;
166	struct nfs_server *nfss = NFS_SERVER(inode);
 
 
 
 
 
 
 
 
 
167	struct nfs_inode *nfsi = NFS_I(inode);
168
169	netfs_inode(inode)->cache = NULL;
170	if (!(nfss->fscache && S_ISREG(inode->i_mode)))
171		return;
172
173	nfs_fscache_update_auxdata(&auxdata, inode);
 
 
 
 
174
175	netfs_inode(inode)->cache = fscache_acquire_cookie(
176					       nfss->fscache,
177					       0,
178					       nfsi->fh.data, /* index_key */
179					       nfsi->fh.size,
180					       &auxdata,      /* aux_data */
181					       sizeof(auxdata),
182					       i_size_read(inode));
183
184	if (netfs_inode(inode)->cache)
185		mapping_set_release_always(inode->i_mapping);
186}
187
188/*
189 * Release a per-inode cookie.
190 */
191void nfs_fscache_clear_inode(struct inode *inode)
192{
193	fscache_relinquish_cookie(netfs_i_cookie(netfs_inode(inode)), false);
194	netfs_inode(inode)->cache = NULL;
 
 
 
 
 
195}
196
197/*
198 * Enable or disable caching for a file that is being opened as appropriate.
199 * The cookie is allocated when the inode is initialised, but is not enabled at
200 * that time.  Enablement is deferred to file-open time to avoid stat() and
201 * access() thrashing the cache.
202 *
203 * For now, with NFS, only regular files that are open read-only will be able
204 * to use the cache.
205 *
206 * We enable the cache for an inode if we open it read-only and it isn't
207 * currently open for writing.  We disable the cache if the inode is open
208 * write-only.
209 *
210 * The caller uses the file struct to pin i_writecount on the inode before
211 * calling us when a file is opened for writing, so we can make use of that.
212 *
213 * Note that this may be invoked multiple times in parallel by parallel
214 * nfs_open() functions.
215 */
216void nfs_fscache_open_file(struct inode *inode, struct file *filp)
217{
218	struct nfs_fscache_inode_auxdata auxdata;
219	struct fscache_cookie *cookie = netfs_i_cookie(netfs_inode(inode));
220	bool open_for_write = inode_is_open_for_write(inode);
 
221
222	if (!fscache_cookie_valid(cookie))
223		return;
 
 
 
 
 
 
 
 
 
 
224
225	fscache_use_cookie(cookie, open_for_write);
226	if (open_for_write) {
227		nfs_fscache_update_auxdata(&auxdata, inode);
228		fscache_invalidate(cookie, &auxdata, i_size_read(inode),
229				   FSCACHE_INVAL_DIO_WRITE);
 
 
 
 
230	}
231}
232EXPORT_SYMBOL_GPL(nfs_fscache_open_file);
233
234void nfs_fscache_release_file(struct inode *inode, struct file *filp)
 
 
 
235{
236	struct nfs_fscache_inode_auxdata auxdata;
237	struct fscache_cookie *cookie = netfs_i_cookie(netfs_inode(inode));
238	loff_t i_size = i_size_read(inode);
239
240	nfs_fscache_update_auxdata(&auxdata, inode);
241	fscache_unuse_cookie(cookie, &auxdata, &i_size);
242}
243
244int nfs_netfs_read_folio(struct file *file, struct folio *folio)
 
 
 
245{
246	if (!netfs_inode(folio_inode(folio))->cache)
247		return -ENOBUFS;
248
249	return netfs_read_folio(file, folio);
 
 
250}
251
252int nfs_netfs_readahead(struct readahead_control *ractl)
 
 
 
253{
254	struct inode *inode = ractl->mapping->host;
255
256	if (!netfs_inode(inode)->cache)
257		return -ENOBUFS;
258
259	netfs_readahead(ractl);
260	return 0;
 
 
261}
262
263static atomic_t nfs_netfs_debug_id;
264static int nfs_netfs_init_request(struct netfs_io_request *rreq, struct file *file)
 
 
 
 
 
265{
266	if (!file) {
267		if (WARN_ON_ONCE(rreq->origin != NETFS_PGPRIV2_COPY_TO_CACHE))
268			return -EIO;
269		return 0;
 
 
 
270	}
 
271
272	rreq->netfs_priv = get_nfs_open_context(nfs_file_open_context(file));
273	rreq->debug_id = atomic_inc_return(&nfs_netfs_debug_id);
274	/* [DEPRECATED] Use PG_private_2 to mark folio being written to the cache. */
275	__set_bit(NETFS_RREQ_USE_PGPRIV2, &rreq->flags);
276	rreq->io_streams[0].sreq_max_len = NFS_SB(rreq->inode->i_sb)->rsize;
 
 
 
 
277
278	return 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
279}
280
281static void nfs_netfs_free_request(struct netfs_io_request *rreq)
 
 
 
 
 
282{
283	if (rreq->netfs_priv)
284		put_nfs_open_context(rreq->netfs_priv);
285}
 
 
 
 
 
 
 
286
287static struct nfs_netfs_io_data *nfs_netfs_alloc(struct netfs_io_subrequest *sreq)
288{
289	struct nfs_netfs_io_data *netfs;
290
291	netfs = kzalloc(sizeof(*netfs), GFP_KERNEL_ACCOUNT);
292	if (!netfs)
293		return NULL;
294	netfs->sreq = sreq;
295	refcount_set(&netfs->refcount, 1);
296	return netfs;
297}
298
299static void nfs_netfs_issue_read(struct netfs_io_subrequest *sreq)
 
 
 
 
300{
301	struct nfs_netfs_io_data	*netfs;
302	struct nfs_pageio_descriptor	pgio;
303	struct inode *inode = sreq->rreq->inode;
304	struct nfs_open_context *ctx = sreq->rreq->netfs_priv;
305	struct page *page;
306	unsigned long idx;
307	pgoff_t start, last;
308	int err;
309
310	start = (sreq->start + sreq->transferred) >> PAGE_SHIFT;
311	last = ((sreq->start + sreq->len - sreq->transferred - 1) >> PAGE_SHIFT);
312
313	nfs_pageio_init_read(&pgio, inode, false,
314			     &nfs_async_read_completion_ops);
315
316	netfs = nfs_netfs_alloc(sreq);
317	if (!netfs)
318		return netfs_read_subreq_terminated(sreq, -ENOMEM, false);
319
320	pgio.pg_netfs = netfs; /* used in completion */
 
 
 
 
321
322	xa_for_each_range(&sreq->rreq->mapping->i_pages, idx, page, start, last) {
323		/* nfs_read_add_folio() may schedule() due to pNFS layout and other RPCs  */
324		err = nfs_read_add_folio(&pgio, ctx, page_folio(page));
325		if (err < 0) {
326			netfs->error = err;
327			goto out;
328		}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
329	}
330out:
331	nfs_pageio_complete_read(&pgio);
332	nfs_netfs_put(netfs);
333}
334
335void nfs_netfs_initiate_read(struct nfs_pgio_header *hdr)
 
 
 
 
336{
337	struct nfs_netfs_io_data        *netfs = hdr->netfs;
338
339	if (!netfs)
340		return;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
341
342	nfs_netfs_get(netfs);
 
 
 
 
343}
344
345int nfs_netfs_folio_unlock(struct folio *folio)
346{
347	struct inode *inode = folio->mapping->host;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
348
349	/*
350	 * If fscache is enabled, netfs will unlock pages.
351	 */
352	if (netfs_inode(inode)->cache)
353		return 0;
354
355	return 1;
356}
357
358void nfs_netfs_read_completion(struct nfs_pgio_header *hdr)
 
 
 
 
359{
360	struct nfs_netfs_io_data        *netfs = hdr->netfs;
361	struct netfs_io_subrequest      *sreq;
362
363	if (!netfs)
364		return;
365
366	sreq = netfs->sreq;
367	if (test_bit(NFS_IOHDR_EOF, &hdr->flags) &&
368	    sreq->rreq->origin != NETFS_DIO_READ)
369		__set_bit(NETFS_SREQ_CLEAR_TAIL, &sreq->flags);
370
371	if (hdr->error)
372		netfs->error = hdr->error;
373	else
374		atomic64_add(hdr->res.count, &netfs->transferred);
375
376	nfs_netfs_put(netfs);
377	hdr->netfs = NULL;
378}
379
380const struct netfs_request_ops nfs_netfs_ops = {
381	.init_request		= nfs_netfs_init_request,
382	.free_request		= nfs_netfs_free_request,
383	.issue_read		= nfs_netfs_issue_read,
384};