ec8f24b7faaf3 (Thomas Gleixner 2019-05-19 13:07:45 +0100 1) # SPDX-License-Identifier: GPL-2.0-only
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 2)
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 3) config FSCACHE
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 4) tristate "General filesystem local caching manager"
26aaeffcafe6c (David Howells 2021-02-22 11:39:47 +0000 5) select NETFS_SUPPORT
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 6) help
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 7) This option enables a generic filesystem caching manager that can be
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 8) used by various network and other filesystems to cache data locally.
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 9) Different sorts of caches can be plugged in, depending on the
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 10) resources available.
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 11)
fd299b2a7339a (Mauro Carvalho Chehab 2020-04-27 23:16:54 +0200 12) See Documentation/filesystems/caching/fscache.rst for more information.
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 13)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 14) config FSCACHE_STATS
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 15) bool "Gather statistical information on local caching"
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 16) depends on FSCACHE && PROC_FS
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 17) help
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 18) This option causes statistical information to be gathered on local
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 19) caching and exported through file:
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 20)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 21) /proc/fs/fscache/stats
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 22)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 23) The gathering of statistics adds a certain amount of overhead to
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 24) execution as there are a quite a few stats gathered, and on a
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 25) multi-CPU system these may be on cachelines that keep bouncing
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 26) between CPUs. On the other hand, the stats are very useful for
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 27) debugging purposes. Saying 'Y' here is recommended.
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 28)
fd299b2a7339a (Mauro Carvalho Chehab 2020-04-27 23:16:54 +0200 29) See Documentation/filesystems/caching/fscache.rst for more information.
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 30)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 31) config FSCACHE_HISTOGRAM
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 32) bool "Gather latency information on local caching"
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 33) depends on FSCACHE && PROC_FS
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 34) help
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 35) This option causes latency information to be gathered on local
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 36) caching and exported through file:
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 37)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 38) /proc/fs/fscache/histogram
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 39)
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 40) The generation of this histogram adds a certain amount of overhead to
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 41) execution as there are a number of points at which data is gathered,
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 42) and on a multi-CPU system these may be on cachelines that keep
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 43) bouncing between CPUs. On the other hand, the histogram may be
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 44) useful for debugging purposes. Saying 'N' here is recommended.
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 45)
fd299b2a7339a (Mauro Carvalho Chehab 2020-04-27 23:16:54 +0200 46) See Documentation/filesystems/caching/fscache.rst for more information.
7394daa8c61df (David Howells 2009-04-03 16:42:37 +0100 47)
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 48) config FSCACHE_DEBUG
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 49) bool "Debug FS-Cache"
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 50) depends on FSCACHE
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 51) help
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 52) This permits debugging to be dynamically enabled in the local caching
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 53) management module. If this is set, the debugging output may be
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 54) enabled by setting bits in /sys/modules/fscache/parameter/debug.
06b3db1b9bccd (David Howells 2009-04-03 16:42:36 +0100 55)
fd299b2a7339a (Mauro Carvalho Chehab 2020-04-27 23:16:54 +0200 56) See Documentation/filesystems/caching/fscache.rst for more information.
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 57)
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 58) config FSCACHE_OBJECT_LIST
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 59) bool "Maintain global object list for debugging purposes"
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 60) depends on FSCACHE && PROC_FS
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 61) help
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 62) Maintain a global list of active fscache objects that can be
4fbf4291aa159 (David Howells 2009-11-19 18:11:04 +0000 63) retrieved through /proc/fs/fscache/objects for debugging purposes