Linux Audio

Check our new training course

Loading...
v3.1
 
  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,
 68				  struct nfs_clone_mount *mntdata)
 69{
 70	struct nfs_fscache_key *key, *xkey;
 71	struct nfs_server *nfss = NFS_SB(sb);
 72	struct rb_node **p, *parent;
 73	int diff, ulen;
 74
 75	if (uniq) {
 76		ulen = strlen(uniq);
 77	} else if (mntdata) {
 78		struct nfs_server *mnt_s = NFS_SB(mntdata->sb);
 79		if (mnt_s->fscache_key) {
 80			uniq = mnt_s->fscache_key->key.uniquifier;
 81			ulen = mnt_s->fscache_key->key.uniq_len;
 82		}
 83	}
 84
 
 
 85	if (!uniq) {
 86		uniq = "";
 87		ulen = 1;
 88	}
 89
 90	key = kzalloc(sizeof(*key) + ulen, GFP_KERNEL);
 91	if (!key)
 92		return;
 93
 94	key->nfs_client = nfss->nfs_client;
 95	key->key.super.s_flags = sb->s_flags & NFS_MS_MASK;
 96	key->key.nfs_server.flags = nfss->flags;
 97	key->key.nfs_server.rsize = nfss->rsize;
 98	key->key.nfs_server.wsize = nfss->wsize;
 99	key->key.nfs_server.acregmin = nfss->acregmin;
100	key->key.nfs_server.acregmax = nfss->acregmax;
101	key->key.nfs_server.acdirmin = nfss->acdirmin;
102	key->key.nfs_server.acdirmax = nfss->acdirmax;
103	key->key.nfs_server.fsid = nfss->fsid;
104	key->key.rpc_auth.au_flavor = nfss->client->cl_auth->au_flavor;
105
106	key->key.uniq_len = ulen;
107	memcpy(key->key.uniquifier, uniq, ulen);
108
109	spin_lock(&nfs_fscache_keys_lock);
110	p = &nfs_fscache_keys.rb_node;
111	parent = NULL;
112	while (*p) {
113		parent = *p;
114		xkey = rb_entry(parent, struct nfs_fscache_key, node);
115
116		if (key->nfs_client < xkey->nfs_client)
117			goto go_left;
118		if (key->nfs_client > xkey->nfs_client)
119			goto go_right;
120
121		diff = memcmp(&key->key, &xkey->key, sizeof(key->key));
122		if (diff < 0)
123			goto go_left;
124		if (diff > 0)
125			goto go_right;
126
127		if (key->key.uniq_len == 0)
128			goto non_unique;
129		diff = memcmp(key->key.uniquifier,
130			      xkey->key.uniquifier,
131			      key->key.uniq_len);
132		if (diff < 0)
133			goto go_left;
134		if (diff > 0)
135			goto go_right;
136		goto non_unique;
137
138	go_left:
139		p = &(*p)->rb_left;
140		continue;
141	go_right:
142		p = &(*p)->rb_right;
143	}
144
145	rb_link_node(&key->node, parent, p);
146	rb_insert_color(&key->node, &nfs_fscache_keys);
147	spin_unlock(&nfs_fscache_keys_lock);
148	nfss->fscache_key = key;
149
150	/* create a cache index for looking up filehandles */
151	nfss->fscache = fscache_acquire_cookie(nfss->nfs_client->fscache,
152					       &nfs_fscache_super_index_def,
153					       nfss);
 
 
 
154	dfprintk(FSCACHE, "NFS: get superblock cookie (0x%p/0x%p)\n",
155		 nfss, nfss->fscache);
156	return;
157
158non_unique:
159	spin_unlock(&nfs_fscache_keys_lock);
160	kfree(key);
161	nfss->fscache_key = NULL;
162	nfss->fscache = NULL;
163	printk(KERN_WARNING "NFS:"
164	       " Cache request denied due to non-unique superblock keys\n");
165}
166
167/*
168 * release a per-superblock cookie
169 */
170void nfs_fscache_release_super_cookie(struct super_block *sb)
171{
172	struct nfs_server *nfss = NFS_SB(sb);
173
174	dfprintk(FSCACHE, "NFS: releasing superblock cookie (0x%p/0x%p)\n",
175		 nfss, nfss->fscache);
176
177	fscache_relinquish_cookie(nfss->fscache, 0);
178	nfss->fscache = NULL;
179
180	if (nfss->fscache_key) {
181		spin_lock(&nfs_fscache_keys_lock);
182		rb_erase(&nfss->fscache_key->node, &nfs_fscache_keys);
183		spin_unlock(&nfs_fscache_keys_lock);
184		kfree(nfss->fscache_key);
185		nfss->fscache_key = NULL;
186	}
187}
188
189/*
190 * Initialise the per-inode cache cookie pointer for an NFS inode.
191 */
192void nfs_fscache_init_inode_cookie(struct inode *inode)
193{
194	NFS_I(inode)->fscache = NULL;
195	if (S_ISREG(inode->i_mode))
196		set_bit(NFS_INO_FSCACHE, &NFS_I(inode)->flags);
 
 
 
 
 
197}
198
199/*
200 * Get the per-inode cache cookie for an NFS inode.
201 */
202static void nfs_fscache_enable_inode_cookie(struct inode *inode)
203{
204	struct super_block *sb = inode->i_sb;
 
205	struct nfs_inode *nfsi = NFS_I(inode);
206
207	if (nfsi->fscache || !NFS_FSCACHE(inode))
 
208		return;
209
210	if ((NFS_SB(sb)->options & NFS_OPTION_FSCACHE)) {
211		nfsi->fscache = fscache_acquire_cookie(
212			NFS_SB(sb)->fscache,
213			&nfs_fscache_inode_object_def,
214			nfsi);
215
216		dfprintk(FSCACHE, "NFS: get FH cookie (0x%p/0x%p/0x%p)\n",
217			 sb, nfsi, nfsi->fscache);
218	}
 
 
219}
220
221/*
222 * Release a per-inode cookie.
223 */
224void nfs_fscache_release_inode_cookie(struct inode *inode)
225{
226	struct nfs_inode *nfsi = NFS_I(inode);
227
228	dfprintk(FSCACHE, "NFS: clear cookie (0x%p/0x%p)\n",
229		 nfsi, nfsi->fscache);
230
231	fscache_relinquish_cookie(nfsi->fscache, 0);
232	nfsi->fscache = NULL;
233}
234
235/*
236 * Retire a per-inode cookie, destroying the data attached to it.
237 */
238void nfs_fscache_zap_inode_cookie(struct inode *inode)
239{
 
240	struct nfs_inode *nfsi = NFS_I(inode);
 
241
242	dfprintk(FSCACHE, "NFS: zapping cookie (0x%p/0x%p)\n",
243		 nfsi, nfsi->fscache);
244
245	fscache_relinquish_cookie(nfsi->fscache, 1);
 
246	nfsi->fscache = NULL;
247}
248
249/*
250 * Turn off the cache with regard to a per-inode cookie if opened for writing,
251 * invalidating all the pages in the page cache relating to the associated
252 * inode to clear the per-page caching.
253 */
254static void nfs_fscache_disable_inode_cookie(struct inode *inode)
255{
256	clear_bit(NFS_INO_FSCACHE, &NFS_I(inode)->flags);
257
258	if (NFS_I(inode)->fscache) {
259		dfprintk(FSCACHE,
260			 "NFS: nfsi 0x%p turning cache off\n", NFS_I(inode));
261
262		/* Need to uncache any pages attached to this inode that
263		 * fscache knows about before turning off the cache.
264		 */
265		fscache_uncache_all_inode_pages(NFS_I(inode)->fscache, inode);
266		nfs_fscache_zap_inode_cookie(inode);
267	}
268}
269
270/*
271 * wait_on_bit() sleep function for uninterruptible waiting
272 */
273static int nfs_fscache_wait_bit(void *flags)
274{
275	schedule();
276	return 0;
277}
278
279/*
280 * Lock against someone else trying to also acquire or relinquish a cookie
281 */
282static inline void nfs_fscache_inode_lock(struct inode *inode)
283{
284	struct nfs_inode *nfsi = NFS_I(inode);
285
286	while (test_and_set_bit(NFS_INO_FSCACHE_LOCK, &nfsi->flags))
287		wait_on_bit(&nfsi->flags, NFS_INO_FSCACHE_LOCK,
288			    nfs_fscache_wait_bit, TASK_UNINTERRUPTIBLE);
289}
290
291/*
292 * Unlock cookie management lock
293 */
294static inline void nfs_fscache_inode_unlock(struct inode *inode)
295{
 
296	struct nfs_inode *nfsi = NFS_I(inode);
 
297
298	smp_mb__before_clear_bit();
299	clear_bit(NFS_INO_FSCACHE_LOCK, &nfsi->flags);
300	smp_mb__after_clear_bit();
301	wake_up_bit(&nfsi->flags, NFS_INO_FSCACHE_LOCK);
302}
303
304/*
305 * Decide if we should enable or disable local caching for this inode.
306 * - For now, with NFS, only regular files that are open read-only will be able
307 *   to use the cache.
308 * - May be invoked multiple times in parallel by parallel nfs_open() functions.
309 */
310void nfs_fscache_set_inode_cookie(struct inode *inode, struct file *filp)
311{
312	if (NFS_FSCACHE(inode)) {
313		nfs_fscache_inode_lock(inode);
314		if ((filp->f_flags & O_ACCMODE) != O_RDONLY)
315			nfs_fscache_disable_inode_cookie(inode);
316		else
317			nfs_fscache_enable_inode_cookie(inode);
318		nfs_fscache_inode_unlock(inode);
319	}
320}
321
322/*
323 * Replace a per-inode cookie due to revalidation detecting a file having
324 * changed on the server.
325 */
326void nfs_fscache_reset_inode_cookie(struct inode *inode)
327{
328	struct nfs_inode *nfsi = NFS_I(inode);
329	struct nfs_server *nfss = NFS_SERVER(inode);
330	struct fscache_cookie *old = nfsi->fscache;
331
332	nfs_fscache_inode_lock(inode);
333	if (nfsi->fscache) {
334		/* retire the current fscache cache and get a new one */
335		fscache_relinquish_cookie(nfsi->fscache, 1);
336
337		nfsi->fscache = fscache_acquire_cookie(
338			nfss->nfs_client->fscache,
339			&nfs_fscache_inode_object_def,
340			nfsi);
341
342		dfprintk(FSCACHE,
343			 "NFS: revalidation new cookie (0x%p/0x%p/0x%p/0x%p)\n",
344			 nfss, nfsi, old, nfsi->fscache);
 
 
 
 
 
 
 
 
345	}
346	nfs_fscache_inode_unlock(inode);
347}
 
348
349/*
350 * Release the caching state associated with a page, if the page isn't busy
351 * interacting with the cache.
352 * - Returns true (can release page) or false (page busy).
353 */
354int nfs_fscache_release_page(struct page *page, gfp_t gfp)
355{
356	if (PageFsCache(page)) {
357		struct nfs_inode *nfsi = NFS_I(page->mapping->host);
358		struct fscache_cookie *cookie = nfsi->fscache;
359
360		BUG_ON(!cookie);
361		dfprintk(FSCACHE, "NFS: fscache releasepage (0x%p/0x%p/0x%p)\n",
362			 cookie, page, nfsi);
363
364		if (!fscache_maybe_release_page(cookie, page, gfp))
365			return 0;
366
367		nfs_add_fscache_stats(page->mapping->host,
368				      NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
369	}
370
371	return 1;
372}
373
374/*
375 * Release the caching state associated with a page if undergoing complete page
376 * invalidation.
377 */
378void __nfs_fscache_invalidate_page(struct page *page, struct inode *inode)
379{
380	struct nfs_inode *nfsi = NFS_I(inode);
381	struct fscache_cookie *cookie = nfsi->fscache;
382
383	BUG_ON(!cookie);
384
385	dfprintk(FSCACHE, "NFS: fscache invalidatepage (0x%p/0x%p/0x%p)\n",
386		 cookie, page, nfsi);
387
388	fscache_wait_on_page_write(cookie, page);
389
390	BUG_ON(!PageLocked(page));
391	fscache_uncache_page(cookie, page);
392	nfs_add_fscache_stats(page->mapping->host,
393			      NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
394}
395
396/*
397 * Handle completion of a page being read from the cache.
398 * - Called in process (keventd) context.
399 */
400static void nfs_readpage_from_fscache_complete(struct page *page,
401					       void *context,
402					       int error)
403{
404	dfprintk(FSCACHE,
405		 "NFS: readpage_from_fscache_complete (0x%p/0x%p/%d)\n",
406		 page, context, error);
407
408	/* if the read completes with an error, we just unlock the page and let
409	 * the VM reissue the readpage */
410	if (!error) {
 
 
411		SetPageUptodate(page);
412		unlock_page(page);
413	} else {
414		error = nfs_readpage_async(context, page->mapping->host, page);
415		if (error)
416			unlock_page(page);
417	}
418}
419
420/*
421 * Retrieve a page from fscache
422 */
423int __nfs_readpage_from_fscache(struct nfs_open_context *ctx,
424				struct inode *inode, struct page *page)
425{
426	int ret;
427
428	dfprintk(FSCACHE,
429		 "NFS: readpage_from_fscache(fsc:%p/p:%p(i:%lx f:%lx)/0x%p)\n",
430		 NFS_I(inode)->fscache, page, page->index, page->flags, inode);
 
 
 
 
 
431
432	ret = fscache_read_or_alloc_page(NFS_I(inode)->fscache,
433					 page,
434					 nfs_readpage_from_fscache_complete,
435					 ctx,
436					 GFP_KERNEL);
437
438	switch (ret) {
439	case 0: /* read BIO submitted (page in fscache) */
440		dfprintk(FSCACHE,
441			 "NFS:    readpage_from_fscache: BIO submitted\n");
442		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK, 1);
443		return ret;
444
445	case -ENOBUFS: /* inode not in cache */
446	case -ENODATA: /* page not in cache */
447		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL, 1);
448		dfprintk(FSCACHE,
449			 "NFS:    readpage_from_fscache %d\n", ret);
450		return 1;
451
452	default:
453		dfprintk(FSCACHE, "NFS:    readpage_from_fscache %d\n", ret);
454		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL, 1);
455	}
456	return ret;
457}
458
459/*
460 * Retrieve a set of pages from fscache
461 */
462int __nfs_readpages_from_fscache(struct nfs_open_context *ctx,
463				 struct inode *inode,
464				 struct address_space *mapping,
465				 struct list_head *pages,
466				 unsigned *nr_pages)
467{
468	unsigned npages = *nr_pages;
469	int ret;
470
471	dfprintk(FSCACHE, "NFS: nfs_getpages_from_fscache (0x%p/%u/0x%p)\n",
472		 NFS_I(inode)->fscache, npages, inode);
473
474	ret = fscache_read_or_alloc_pages(NFS_I(inode)->fscache,
475					  mapping, pages, nr_pages,
476					  nfs_readpage_from_fscache_complete,
477					  ctx,
478					  mapping_gfp_mask(mapping));
479	if (*nr_pages < npages)
480		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK,
481				      npages);
482	if (*nr_pages > 0)
483		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL,
484				      *nr_pages);
485
486	switch (ret) {
487	case 0: /* read submitted to the cache for all pages */
488		BUG_ON(!list_empty(pages));
489		BUG_ON(*nr_pages != 0);
490		dfprintk(FSCACHE,
491			 "NFS: nfs_getpages_from_fscache: submitted\n");
492
493		return ret;
494
495	case -ENOBUFS: /* some pages aren't cached and can't be */
496	case -ENODATA: /* some pages aren't cached */
497		dfprintk(FSCACHE,
498			 "NFS: nfs_getpages_from_fscache: no page: %d\n", ret);
499		return 1;
500
501	default:
502		dfprintk(FSCACHE,
503			 "NFS: nfs_getpages_from_fscache: ret  %d\n", ret);
504	}
505
506	return ret;
507}
508
509/*
510 * Store a newly fetched page in fscache
511 * - PG_fscache must be set on the page
512 */
513void __nfs_readpage_to_fscache(struct inode *inode, struct page *page, int sync)
514{
515	int ret;
516
517	dfprintk(FSCACHE,
518		 "NFS: readpage_to_fscache(fsc:%p/p:%p(i:%lx f:%lx)/%d)\n",
519		 NFS_I(inode)->fscache, page, page->index, page->flags, sync);
520
521	ret = fscache_write_page(NFS_I(inode)->fscache, page, GFP_KERNEL);
 
522	dfprintk(FSCACHE,
523		 "NFS:     readpage_to_fscache: p:%p(i:%lu f:%lx) ret %d\n",
524		 page, page->index, page->flags, ret);
525
526	if (ret != 0) {
527		fscache_uncache_page(NFS_I(inode)->fscache, page);
528		nfs_add_fscache_stats(inode,
529				      NFSIOS_FSCACHE_PAGES_WRITTEN_FAIL, 1);
530		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_UNCACHED, 1);
531	} else {
532		nfs_add_fscache_stats(inode,
533				      NFSIOS_FSCACHE_PAGES_WRITTEN_OK, 1);
534	}
535}
v5.14.15
  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
 19#include "internal.h"
 20#include "iostat.h"
 21#include "fscache.h"
 22
 23#define NFSDBG_FACILITY		NFSDBG_FSCACHE
 24
 25static struct rb_root nfs_fscache_keys = RB_ROOT;
 26static DEFINE_SPINLOCK(nfs_fscache_keys_lock);
 27
 28/*
 29 * Layout of the key for an NFS server cache object.
 30 */
 31struct nfs_server_key {
 32	struct {
 33		uint16_t	nfsversion;		/* NFS protocol version */
 34		uint32_t	minorversion;		/* NFSv4 minor version */
 35		uint16_t	family;			/* address family */
 36		__be16		port;			/* IP port */
 37	} hdr;
 38	union {
 39		struct in_addr	ipv4_addr;	/* IPv4 address */
 40		struct in6_addr ipv6_addr;	/* IPv6 address */
 41	};
 42} __packed;
 43
 44/*
 45 * Get the per-client index cookie for an NFS client if the appropriate mount
 46 * flag was set
 47 * - We always try and get an index cookie for the client, but get filehandle
 48 *   cookies on a per-superblock basis, depending on the mount flags
 49 */
 50void nfs_fscache_get_client_cookie(struct nfs_client *clp)
 51{
 52	const struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) &clp->cl_addr;
 53	const struct sockaddr_in *sin = (struct sockaddr_in *) &clp->cl_addr;
 54	struct nfs_server_key key;
 55	uint16_t len = sizeof(key.hdr);
 56
 57	memset(&key, 0, sizeof(key));
 58	key.hdr.nfsversion = clp->rpc_ops->version;
 59	key.hdr.minorversion = clp->cl_minorversion;
 60	key.hdr.family = clp->cl_addr.ss_family;
 61
 62	switch (clp->cl_addr.ss_family) {
 63	case AF_INET:
 64		key.hdr.port = sin->sin_port;
 65		key.ipv4_addr = sin->sin_addr;
 66		len += sizeof(key.ipv4_addr);
 67		break;
 68
 69	case AF_INET6:
 70		key.hdr.port = sin6->sin6_port;
 71		key.ipv6_addr = sin6->sin6_addr;
 72		len += sizeof(key.ipv6_addr);
 73		break;
 74
 75	default:
 76		printk(KERN_WARNING "NFS: Unknown network family '%d'\n",
 77		       clp->cl_addr.ss_family);
 78		clp->fscache = NULL;
 79		return;
 80	}
 81
 82	/* create a cache index for looking up filehandles */
 83	clp->fscache = fscache_acquire_cookie(nfs_fscache_netfs.primary_index,
 84					      &nfs_fscache_server_index_def,
 85					      &key, len,
 86					      NULL, 0,
 87					      clp, 0, true);
 88	dfprintk(FSCACHE, "NFS: get client cookie (0x%p/0x%p)\n",
 89		 clp, clp->fscache);
 90}
 91
 92/*
 93 * Dispose of a per-client cookie
 94 */
 95void nfs_fscache_release_client_cookie(struct nfs_client *clp)
 96{
 97	dfprintk(FSCACHE, "NFS: releasing client cookie (0x%p/0x%p)\n",
 98		 clp, clp->fscache);
 99
100	fscache_relinquish_cookie(clp->fscache, NULL, false);
101	clp->fscache = NULL;
102}
103
104/*
105 * Get the cache cookie for an NFS superblock.  We have to handle
106 * uniquification here because the cache doesn't do it for us.
107 *
108 * The default uniquifier is just an empty string, but it may be overridden
109 * either by the 'fsc=xxx' option to mount, or by inheriting it from the parent
110 * superblock across an automount point of some nature.
111 */
112void nfs_fscache_get_super_cookie(struct super_block *sb, const char *uniq, int ulen)
 
113{
114	struct nfs_fscache_key *key, *xkey;
115	struct nfs_server *nfss = NFS_SB(sb);
116	struct rb_node **p, *parent;
117	int diff;
 
 
 
 
 
 
 
 
 
 
118
119	nfss->fscache_key = NULL;
120	nfss->fscache = NULL;
121	if (!uniq) {
122		uniq = "";
123		ulen = 1;
124	}
125
126	key = kzalloc(sizeof(*key) + ulen, GFP_KERNEL);
127	if (!key)
128		return;
129
130	key->nfs_client = nfss->nfs_client;
131	key->key.super.s_flags = sb->s_flags & NFS_SB_MASK;
132	key->key.nfs_server.flags = nfss->flags;
133	key->key.nfs_server.rsize = nfss->rsize;
134	key->key.nfs_server.wsize = nfss->wsize;
135	key->key.nfs_server.acregmin = nfss->acregmin;
136	key->key.nfs_server.acregmax = nfss->acregmax;
137	key->key.nfs_server.acdirmin = nfss->acdirmin;
138	key->key.nfs_server.acdirmax = nfss->acdirmax;
139	key->key.nfs_server.fsid = nfss->fsid;
140	key->key.rpc_auth.au_flavor = nfss->client->cl_auth->au_flavor;
141
142	key->key.uniq_len = ulen;
143	memcpy(key->key.uniquifier, uniq, ulen);
144
145	spin_lock(&nfs_fscache_keys_lock);
146	p = &nfs_fscache_keys.rb_node;
147	parent = NULL;
148	while (*p) {
149		parent = *p;
150		xkey = rb_entry(parent, struct nfs_fscache_key, node);
151
152		if (key->nfs_client < xkey->nfs_client)
153			goto go_left;
154		if (key->nfs_client > xkey->nfs_client)
155			goto go_right;
156
157		diff = memcmp(&key->key, &xkey->key, sizeof(key->key));
158		if (diff < 0)
159			goto go_left;
160		if (diff > 0)
161			goto go_right;
162
163		if (key->key.uniq_len == 0)
164			goto non_unique;
165		diff = memcmp(key->key.uniquifier,
166			      xkey->key.uniquifier,
167			      key->key.uniq_len);
168		if (diff < 0)
169			goto go_left;
170		if (diff > 0)
171			goto go_right;
172		goto non_unique;
173
174	go_left:
175		p = &(*p)->rb_left;
176		continue;
177	go_right:
178		p = &(*p)->rb_right;
179	}
180
181	rb_link_node(&key->node, parent, p);
182	rb_insert_color(&key->node, &nfs_fscache_keys);
183	spin_unlock(&nfs_fscache_keys_lock);
184	nfss->fscache_key = key;
185
186	/* create a cache index for looking up filehandles */
187	nfss->fscache = fscache_acquire_cookie(nfss->nfs_client->fscache,
188					       &nfs_fscache_super_index_def,
189					       &key->key,
190					       sizeof(key->key) + ulen,
191					       NULL, 0,
192					       nfss, 0, true);
193	dfprintk(FSCACHE, "NFS: get superblock cookie (0x%p/0x%p)\n",
194		 nfss, nfss->fscache);
195	return;
196
197non_unique:
198	spin_unlock(&nfs_fscache_keys_lock);
199	kfree(key);
200	nfss->fscache_key = NULL;
201	nfss->fscache = NULL;
202	printk(KERN_WARNING "NFS:"
203	       " Cache request denied due to non-unique superblock keys\n");
204}
205
206/*
207 * release a per-superblock cookie
208 */
209void nfs_fscache_release_super_cookie(struct super_block *sb)
210{
211	struct nfs_server *nfss = NFS_SB(sb);
212
213	dfprintk(FSCACHE, "NFS: releasing superblock cookie (0x%p/0x%p)\n",
214		 nfss, nfss->fscache);
215
216	fscache_relinquish_cookie(nfss->fscache, NULL, false);
217	nfss->fscache = NULL;
218
219	if (nfss->fscache_key) {
220		spin_lock(&nfs_fscache_keys_lock);
221		rb_erase(&nfss->fscache_key->node, &nfs_fscache_keys);
222		spin_unlock(&nfs_fscache_keys_lock);
223		kfree(nfss->fscache_key);
224		nfss->fscache_key = NULL;
225	}
226}
227
228static void nfs_fscache_update_auxdata(struct nfs_fscache_inode_auxdata *auxdata,
229				  struct nfs_inode *nfsi)
 
 
230{
231	memset(auxdata, 0, sizeof(*auxdata));
232	auxdata->mtime_sec  = nfsi->vfs_inode.i_mtime.tv_sec;
233	auxdata->mtime_nsec = nfsi->vfs_inode.i_mtime.tv_nsec;
234	auxdata->ctime_sec  = nfsi->vfs_inode.i_ctime.tv_sec;
235	auxdata->ctime_nsec = nfsi->vfs_inode.i_ctime.tv_nsec;
236
237	if (NFS_SERVER(&nfsi->vfs_inode)->nfs_client->rpc_ops->version == 4)
238		auxdata->change_attr = inode_peek_iversion_raw(&nfsi->vfs_inode);
239}
240
241/*
242 * Initialise the per-inode cache cookie pointer for an NFS inode.
243 */
244void nfs_fscache_init_inode(struct inode *inode)
245{
246	struct nfs_fscache_inode_auxdata auxdata;
247	struct nfs_server *nfss = NFS_SERVER(inode);
248	struct nfs_inode *nfsi = NFS_I(inode);
249
250	nfsi->fscache = NULL;
251	if (!(nfss->fscache && S_ISREG(inode->i_mode)))
252		return;
253
254	nfs_fscache_update_auxdata(&auxdata, nfsi);
 
 
 
 
255
256	nfsi->fscache = fscache_acquire_cookie(NFS_SB(inode->i_sb)->fscache,
257					       &nfs_fscache_inode_object_def,
258					       nfsi->fh.data, nfsi->fh.size,
259					       &auxdata, sizeof(auxdata),
260					       nfsi, nfsi->vfs_inode.i_size, false);
261}
262
263/*
264 * Release a per-inode cookie.
265 */
266void nfs_fscache_clear_inode(struct inode *inode)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
267{
268	struct nfs_fscache_inode_auxdata auxdata;
269	struct nfs_inode *nfsi = NFS_I(inode);
270	struct fscache_cookie *cookie = nfs_i_fscache(inode);
271
272	dfprintk(FSCACHE, "NFS: clear cookie (0x%p/0x%p)\n", nfsi, cookie);
 
273
274	nfs_fscache_update_auxdata(&auxdata, nfsi);
275	fscache_relinquish_cookie(cookie, &auxdata, false);
276	nfsi->fscache = NULL;
277}
278
279static bool nfs_fscache_can_enable(void *data)
 
 
 
 
 
280{
281	struct inode *inode = data;
282
283	return !inode_is_open_for_write(inode);
 
 
 
 
 
 
 
 
 
284}
285
286/*
287 * Enable or disable caching for a file that is being opened as appropriate.
288 * The cookie is allocated when the inode is initialised, but is not enabled at
289 * that time.  Enablement is deferred to file-open time to avoid stat() and
290 * access() thrashing the cache.
291 *
292 * For now, with NFS, only regular files that are open read-only will be able
293 * to use the cache.
294 *
295 * We enable the cache for an inode if we open it read-only and it isn't
296 * currently open for writing.  We disable the cache if the inode is open
297 * write-only.
298 *
299 * The caller uses the file struct to pin i_writecount on the inode before
300 * calling us when a file is opened for writing, so we can make use of that.
301 *
302 * Note that this may be invoked multiple times in parallel by parallel
303 * nfs_open() functions.
 
 
 
 
 
304 */
305void nfs_fscache_open_file(struct inode *inode, struct file *filp)
306{
307	struct nfs_fscache_inode_auxdata auxdata;
308	struct nfs_inode *nfsi = NFS_I(inode);
309	struct fscache_cookie *cookie = nfs_i_fscache(inode);
310
311	if (!fscache_cookie_valid(cookie))
312		return;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
313
314	nfs_fscache_update_auxdata(&auxdata, nfsi);
 
 
 
 
 
 
 
 
315
316	if (inode_is_open_for_write(inode)) {
317		dfprintk(FSCACHE, "NFS: nfsi 0x%p disabling cache\n", nfsi);
318		clear_bit(NFS_INO_FSCACHE, &nfsi->flags);
319		fscache_disable_cookie(cookie, &auxdata, true);
320		fscache_uncache_all_inode_pages(cookie, inode);
321	} else {
322		dfprintk(FSCACHE, "NFS: nfsi 0x%p enabling cache\n", nfsi);
323		fscache_enable_cookie(cookie, &auxdata, nfsi->vfs_inode.i_size,
324				      nfs_fscache_can_enable, inode);
325		if (fscache_cookie_enabled(cookie))
326			set_bit(NFS_INO_FSCACHE, &NFS_I(inode)->flags);
327	}
 
328}
329EXPORT_SYMBOL_GPL(nfs_fscache_open_file);
330
331/*
332 * Release the caching state associated with a page, if the page isn't busy
333 * interacting with the cache.
334 * - Returns true (can release page) or false (page busy).
335 */
336int nfs_fscache_release_page(struct page *page, gfp_t gfp)
337{
338	if (PageFsCache(page)) {
339		struct fscache_cookie *cookie = nfs_i_fscache(page->mapping->host);
 
340
341		BUG_ON(!cookie);
342		dfprintk(FSCACHE, "NFS: fscache releasepage (0x%p/0x%p/0x%p)\n",
343			 cookie, page, NFS_I(page->mapping->host));
344
345		if (!fscache_maybe_release_page(cookie, page, gfp))
346			return 0;
347
348		nfs_inc_fscache_stats(page->mapping->host,
349				      NFSIOS_FSCACHE_PAGES_UNCACHED);
350	}
351
352	return 1;
353}
354
355/*
356 * Release the caching state associated with a page if undergoing complete page
357 * invalidation.
358 */
359void __nfs_fscache_invalidate_page(struct page *page, struct inode *inode)
360{
361	struct fscache_cookie *cookie = nfs_i_fscache(inode);
 
362
363	BUG_ON(!cookie);
364
365	dfprintk(FSCACHE, "NFS: fscache invalidatepage (0x%p/0x%p/0x%p)\n",
366		 cookie, page, NFS_I(inode));
367
368	fscache_wait_on_page_write(cookie, page);
369
370	BUG_ON(!PageLocked(page));
371	fscache_uncache_page(cookie, page);
372	nfs_inc_fscache_stats(page->mapping->host,
373			      NFSIOS_FSCACHE_PAGES_UNCACHED);
374}
375
376/*
377 * Handle completion of a page being read from the cache.
378 * - Called in process (keventd) context.
379 */
380static void nfs_readpage_from_fscache_complete(struct page *page,
381					       void *context,
382					       int error)
383{
384	dfprintk(FSCACHE,
385		 "NFS: readpage_from_fscache_complete (0x%p/0x%p/%d)\n",
386		 page, context, error);
387
388	/*
389	 * If the read completes with an error, mark the page with PG_checked,
390	 * unlock the page, and let the VM reissue the readpage.
391	 */
392	if (!error)
393		SetPageUptodate(page);
394	else
395		SetPageChecked(page);
396	unlock_page(page);
 
 
 
397}
398
399/*
400 * Retrieve a page from fscache
401 */
402int __nfs_readpage_from_fscache(struct nfs_open_context *ctx,
403				struct inode *inode, struct page *page)
404{
405	int ret;
406
407	dfprintk(FSCACHE,
408		 "NFS: readpage_from_fscache(fsc:%p/p:%p(i:%lx f:%lx)/0x%p)\n",
409		 nfs_i_fscache(inode), page, page->index, page->flags, inode);
410
411	if (PageChecked(page)) {
412		ClearPageChecked(page);
413		return 1;
414	}
415
416	ret = fscache_read_or_alloc_page(nfs_i_fscache(inode),
417					 page,
418					 nfs_readpage_from_fscache_complete,
419					 ctx,
420					 GFP_KERNEL);
421
422	switch (ret) {
423	case 0: /* read BIO submitted (page in fscache) */
424		dfprintk(FSCACHE,
425			 "NFS:    readpage_from_fscache: BIO submitted\n");
426		nfs_inc_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK);
427		return ret;
428
429	case -ENOBUFS: /* inode not in cache */
430	case -ENODATA: /* page not in cache */
431		nfs_inc_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL);
432		dfprintk(FSCACHE,
433			 "NFS:    readpage_from_fscache %d\n", ret);
434		return 1;
435
436	default:
437		dfprintk(FSCACHE, "NFS:    readpage_from_fscache %d\n", ret);
438		nfs_inc_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL);
439	}
440	return ret;
441}
442
443/*
444 * Retrieve a set of pages from fscache
445 */
446int __nfs_readpages_from_fscache(struct nfs_open_context *ctx,
447				 struct inode *inode,
448				 struct address_space *mapping,
449				 struct list_head *pages,
450				 unsigned *nr_pages)
451{
452	unsigned npages = *nr_pages;
453	int ret;
454
455	dfprintk(FSCACHE, "NFS: nfs_getpages_from_fscache (0x%p/%u/0x%p)\n",
456		 nfs_i_fscache(inode), npages, inode);
457
458	ret = fscache_read_or_alloc_pages(nfs_i_fscache(inode),
459					  mapping, pages, nr_pages,
460					  nfs_readpage_from_fscache_complete,
461					  ctx,
462					  mapping_gfp_mask(mapping));
463	if (*nr_pages < npages)
464		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_OK,
465				      npages);
466	if (*nr_pages > 0)
467		nfs_add_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_READ_FAIL,
468				      *nr_pages);
469
470	switch (ret) {
471	case 0: /* read submitted to the cache for all pages */
472		BUG_ON(!list_empty(pages));
473		BUG_ON(*nr_pages != 0);
474		dfprintk(FSCACHE,
475			 "NFS: nfs_getpages_from_fscache: submitted\n");
476
477		return ret;
478
479	case -ENOBUFS: /* some pages aren't cached and can't be */
480	case -ENODATA: /* some pages aren't cached */
481		dfprintk(FSCACHE,
482			 "NFS: nfs_getpages_from_fscache: no page: %d\n", ret);
483		return 1;
484
485	default:
486		dfprintk(FSCACHE,
487			 "NFS: nfs_getpages_from_fscache: ret  %d\n", ret);
488	}
489
490	return ret;
491}
492
493/*
494 * Store a newly fetched page in fscache
495 * - PG_fscache must be set on the page
496 */
497void __nfs_readpage_to_fscache(struct inode *inode, struct page *page, int sync)
498{
499	int ret;
500
501	dfprintk(FSCACHE,
502		 "NFS: readpage_to_fscache(fsc:%p/p:%p(i:%lx f:%lx)/%d)\n",
503		 nfs_i_fscache(inode), page, page->index, page->flags, sync);
504
505	ret = fscache_write_page(nfs_i_fscache(inode), page,
506				 inode->i_size, GFP_KERNEL);
507	dfprintk(FSCACHE,
508		 "NFS:     readpage_to_fscache: p:%p(i:%lu f:%lx) ret %d\n",
509		 page, page->index, page->flags, ret);
510
511	if (ret != 0) {
512		fscache_uncache_page(nfs_i_fscache(inode), page);
513		nfs_inc_fscache_stats(inode,
514				      NFSIOS_FSCACHE_PAGES_WRITTEN_FAIL);
515		nfs_inc_fscache_stats(inode, NFSIOS_FSCACHE_PAGES_UNCACHED);
516	} else {
517		nfs_inc_fscache_stats(inode,
518				      NFSIOS_FSCACHE_PAGES_WRITTEN_OK);
519	}
520}