^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 CACHEFILES
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) tristate "Filesystem caching on files"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) depends on FSCACHE && BLOCK
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) This permits use of a mounted filesystem as a cache for other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) filesystems - primarily networking filesystems - thus allowing fast
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) local disk to enhance the speed of slower devices.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) See Documentation/filesystems/caching/cachefiles.rst for more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) config CACHEFILES_DEBUG
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) bool "Debug CacheFiles"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) depends on CACHEFILES
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) This permits debugging to be dynamically enabled in the filesystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) caching on files module. If this is set, the debugging output may be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) enabled by setting bits in /sys/modules/cachefiles/parameter/debug or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) by including a debugging specifier in /etc/cachefilesd.conf.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) config CACHEFILES_HISTOGRAM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) bool "Gather latency information on CacheFiles"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) depends on CACHEFILES && PROC_FS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) This option causes latency information to be gathered on CacheFiles
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) operation and exported through file:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) /proc/fs/cachefiles/histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) The generation of this histogram adds a certain amount of overhead to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) execution as there are a number of points at which data is gathered,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) and on a multi-CPU system these may be on cachelines that keep
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) bouncing between CPUs. On the other hand, the histogram may be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) useful for debugging purposes. Saying 'N' here is recommended.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) See Documentation/filesystems/caching/cachefiles.rst for more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) information.