/* 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