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