2021-11-26 07:32:29 -07:00
|
|
|
# SPDX-License-Identifier: GPL-2.0-only
|
|
|
|
|
|
|
|
|
|
config CACHEFILES
|
|
|
|
|
tristate "Filesystem caching on files"
|
2023-11-20 08:55:18 -07:00
|
|
|
depends on NETFS_SUPPORT && FSCACHE && BLOCK
|
2021-11-26 07:32:29 -07:00
|
|
|
help
|
|
|
|
|
This permits use of a mounted filesystem as a cache for other
|
|
|
|
|
filesystems - primarily networking filesystems - thus allowing fast
|
|
|
|
|
local disk to enhance the speed of slower devices.
|
|
|
|
|
|
|
|
|
|
See Documentation/filesystems/caching/cachefiles.rst for more
|
|
|
|
|
information.
|
|
|
|
|
|
|
|
|
|
config CACHEFILES_DEBUG
|
|
|
|
|
bool "Debug CacheFiles"
|
|
|
|
|
depends on CACHEFILES
|
|
|
|
|
help
|
|
|
|
|
This permits debugging to be dynamically enabled in the filesystem
|
|
|
|
|
caching on files module. If this is set, the debugging output may be
|
|
|
|
|
enabled by setting bits in /sys/modules/cachefiles/parameter/debug or
|
|
|
|
|
by including a debugging specifier in /etc/cachefilesd.conf.
|
2021-10-21 00:15:26 -07:00
|
|
|
|
|
|
|
|
config CACHEFILES_ERROR_INJECTION
|
|
|
|
|
bool "Provide error injection for cachefiles"
|
|
|
|
|
depends on CACHEFILES && SYSCTL
|
|
|
|
|
help
|
|
|
|
|
This permits error injection to be enabled in cachefiles whilst a
|
|
|
|
|
cache is in service.
|
cachefiles: notify the user daemon when looking up cookie
Fscache/CacheFiles used to serve as a local cache for a remote
networking fs. A new on-demand read mode will be introduced for
CacheFiles, which can boost the scenario where on-demand read semantics
are needed, e.g. container image distribution.
The essential difference between these two modes is seen when a cache
miss occurs: In the original mode, the netfs will fetch the data from
the remote server and then write it to the cache file; in on-demand
read mode, fetching the data and writing it into the cache is delegated
to a user daemon.
As the first step, notify the user daemon when looking up cookie. In
this case, an anonymous fd is sent to the user daemon, through which the
user daemon can write the fetched data to the cache file. Since the user
daemon may move the anonymous fd around, e.g. through dup(), an object
ID uniquely identifying the cache file is also attached.
Also add one advisory flag (FSCACHE_ADV_WANT_CACHE_SIZE) suggesting that
the cache file size shall be retrieved at runtime. This helps the
scenario where one cache file contains multiple netfs files, e.g. for
the purpose of deduplication. In this case, netfs itself has no idea the
size of the cache file, whilst the user daemon should give the hint on
it.
Signed-off-by: Jeffle Xu <jefflexu@linux.alibaba.com>
Link: https://lore.kernel.org/r/20220509074028.74954-3-jefflexu@linux.alibaba.com
Acked-by: David Howells <dhowells@redhat.com>
Signed-off-by: Gao Xiang <hsiangkao@linux.alibaba.com>
2022-04-25 05:21:24 -07:00
|
|
|
|
|
|
|
|
config CACHEFILES_ONDEMAND
|
|
|
|
|
bool "Support for on-demand read"
|
|
|
|
|
depends on CACHEFILES
|
|
|
|
|
default n
|
|
|
|
|
help
|
|
|
|
|
This permits userspace to enable the cachefiles on-demand read mode.
|
|
|
|
|
In this mode, when a cache miss occurs, responsibility for fetching
|
|
|
|
|
the data lies with the cachefiles backend instead of with the netfs
|
|
|
|
|
and is delegated to userspace.
|
|
|
|
|
|
|
|
|
|
If unsure, say N.
|