mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-28 20:02:17 +00:00
![Jeffle Xu](/assets/img/avatar_default.png)
Implement the data plane of on-demand read mode. The early implementation [1] place the entry to cachefiles_ondemand_read() in fscache_read(). However, fscache_read() can only detect if the requested file range is fully cache miss, whilst we need to notify the user daemon as long as there's a hole inside the requested file range. Thus the entry is now placed in cachefiles_prepare_read(). When working in on-demand read mode, once a hole detected, the read routine will send a READ request to the user daemon. The user daemon needs to fetch the data and write it to the cache file. After sending the READ request, the read routine will hang there, until the READ request is handled by the user daemon. Then it will retry to read from the same file range. If no progress encountered, the read routine will fail then. A new NETFS_SREQ_ONDEMAND flag is introduced to indicate that on-demand read should be done when a cache miss encountered. [1] https://lore.kernel.org/all/20220406075612.60298-6-jefflexu@linux.alibaba.com/ #v8 Signed-off-by: Jeffle Xu <jefflexu@linux.alibaba.com> Acked-by: David Howells <dhowells@redhat.com> Link: https://lore.kernel.org/r/20220425122143.56815-6-jefflexu@linux.alibaba.com Signed-off-by: Gao Xiang <hsiangkao@linux.alibaba.com>
68 lines
1.6 KiB
C
68 lines
1.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef _LINUX_CACHEFILES_H
|
|
#define _LINUX_CACHEFILES_H
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/ioctl.h>
|
|
|
|
/*
|
|
* Fscache ensures that the maximum length of cookie key is 255. The volume key
|
|
* is controlled by netfs, and generally no bigger than 255.
|
|
*/
|
|
#define CACHEFILES_MSG_MAX_SIZE 1024
|
|
|
|
enum cachefiles_opcode {
|
|
CACHEFILES_OP_OPEN,
|
|
CACHEFILES_OP_CLOSE,
|
|
CACHEFILES_OP_READ,
|
|
};
|
|
|
|
/*
|
|
* Message Header
|
|
*
|
|
* @msg_id a unique ID identifying this message
|
|
* @opcode message type, CACHEFILE_OP_*
|
|
* @len message length, including message header and following data
|
|
* @object_id a unique ID identifying a cache file
|
|
* @data message type specific payload
|
|
*/
|
|
struct cachefiles_msg {
|
|
__u32 msg_id;
|
|
__u32 opcode;
|
|
__u32 len;
|
|
__u32 object_id;
|
|
__u8 data[];
|
|
};
|
|
|
|
/*
|
|
* @data contains the volume_key followed directly by the cookie_key. volume_key
|
|
* is a NUL-terminated string; @volume_key_size indicates the size of the volume
|
|
* key in bytes. cookie_key is binary data, which is netfs specific;
|
|
* @cookie_key_size indicates the size of the cookie key in bytes.
|
|
*
|
|
* @fd identifies an anon_fd referring to the cache file.
|
|
*/
|
|
struct cachefiles_open {
|
|
__u32 volume_key_size;
|
|
__u32 cookie_key_size;
|
|
__u32 fd;
|
|
__u32 flags;
|
|
__u8 data[];
|
|
};
|
|
|
|
/*
|
|
* @off indicates the starting offset of the requested file range
|
|
* @len indicates the length of the requested file range
|
|
*/
|
|
struct cachefiles_read {
|
|
__u64 off;
|
|
__u64 len;
|
|
};
|
|
|
|
/*
|
|
* Reply for READ request
|
|
* @arg for this ioctl is the @id field of READ request.
|
|
*/
|
|
#define CACHEFILES_IOC_READ_COMPLETE _IOW(0x98, 1, int)
|
|
|
|
#endif
|