[linux-block.git] / include / uapi / linux / fuse.h

/*
    FUSE: Filesystem in Userspace
    Copyright (C) 2001-2008  Miklos Szeredi <miklos@szeredi.hu>

    This program can be distributed under the terms of the GNU GPL.
    See the file COPYING.
*/

/*
 * This file defines the kernel interface of FUSE
 *
 * Protocol changelog:
 *
 * 7.9:
 *  - new fuse_getattr_in input argument of GETATTR
 *  - add lk_flags in fuse_lk_in
 *  - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
 *  - add blksize field to fuse_attr
 *  - add file flags field to fuse_read_in and fuse_write_in
 *
 * 7.10
 *  - add nonseekable open flag
 *
 * 7.11
 *  - add IOCTL message
 *  - add unsolicited notification support
 *  - add POLL message and NOTIFY_POLL notification
 *
 * 7.12
 *  - add umask flag to input argument of open, mknod and mkdir
 *  - add notification messages for invalidation of inodes and
 *    directory entries
 *
 * 7.13
 *  - make max number of background requests and congestion threshold
 *    tunables
 *
 * 7.14
 *  - add splice support to fuse device
 *
 * 7.15
 *  - add store notify
 *  - add retrieve notify
 *
 * 7.16
 *  - add BATCH_FORGET request
 *  - FUSE_IOCTL_UNRESTRICTED shall now return with array of 'struct
 *    fuse_ioctl_iovec' instead of ambiguous 'struct iovec'
 *  - add FUSE_IOCTL_32BIT flag
 *
 * 7.17
 *  - add FUSE_FLOCK_LOCKS and FUSE_RELEASE_FLOCK_UNLOCK
 *
 * 7.18
 *  - add FUSE_IOCTL_DIR flag
 *  - add FUSE_NOTIFY_DELETE
 *
 * 7.19
 *  - add FUSE_FALLOCATE
 *
 * 7.20
 *  - add FUSE_AUTO_INVAL_DATA
 *
 * 7.21
 *  - add FUSE_READDIRPLUS
 *  - send the requested events in POLL request
 */

#ifndef _LINUX_FUSE_H
#define _LINUX_FUSE_H

#include <linux/types.h>

/*
 * Version negotiation:
 *
 * Both the kernel and userspace send the version they support in the
 * INIT request and reply respectively.
 *
 * If the major versions match then both shall use the smallest
 * of the two minor versions for communication.
 *
 * If the kernel supports a larger major version, then userspace shall
 * reply with the major version it supports, ignore the rest of the
 * INIT message and expect a new INIT message from the kernel with a
 * matching major version.
 *
 * If the library supports a larger major version, then it shall fall
 * back to the major protocol version sent by the kernel for
 * communication and reply with that major version (and an arbitrary
 * supported minor version).
 */

/** Version number of this interface */
#define FUSE_KERNEL_VERSION 7

/** Minor version number of this interface */
#define FUSE_KERNEL_MINOR_VERSION 21

/** The node ID of the root inode */
#define FUSE_ROOT_ID 1

/* Make sure all structures are padded to 64bit boundary, so 32bit
   userspace works under 64bit kernels */

struct fuse_attr {
	__u64	ino;
	__u64	size;
	__u64	blocks;
	__u64	atime;
	__u64	mtime;
	__u64	ctime;
	__u32	atimensec;
	__u32	mtimensec;
	__u32	ctimensec;
	__u32	mode;
	__u32	nlink;
	__u32	uid;
	__u32	gid;
	__u32	rdev;
	__u32	blksize;
	__u32	padding;
};

struct fuse_kstatfs {
	__u64	blocks;
	__u64	bfree;
	__u64	bavail;
	__u64	files;
	__u64	ffree;
	__u32	bsize;
	__u32	namelen;
	__u32	frsize;
	__u32	padding;
	__u32	spare[6];
};

struct fuse_file_lock {
	__u64	start;
	__u64	end;
	__u32	type;
	__u32	pid; /* tgid */
};

/**
 * Bitmasks for fuse_setattr_in.valid
 */
#define FATTR_MODE	(1 << 0)
#define FATTR_UID	(1 << 1)
#define FATTR_GID	(1 << 2)
#define FATTR_SIZE	(1 << 3)
#define FATTR_ATIME	(1 << 4)
#define FATTR_MTIME	(1 << 5)
#define FATTR_FH	(1 << 6)
#define FATTR_ATIME_NOW	(1 << 7)
#define FATTR_MTIME_NOW	(1 << 8)
#define FATTR_LOCKOWNER	(1 << 9)

/**
 * Flags returned by the OPEN request
 *
 * FOPEN_DIRECT_IO: bypass page cache for this open file
 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
 * FOPEN_NONSEEKABLE: the file is not seekable
 */
#define FOPEN_DIRECT_IO		(1 << 0)
#define FOPEN_KEEP_CACHE	(1 << 1)
#define FOPEN_NONSEEKABLE	(1 << 2)

/**
 * INIT request/reply flags
 *
 * FUSE_ASYNC_READ: asynchronous read requests
 * FUSE_POSIX_LOCKS: remote locking for POSIX file locks
 * FUSE_FILE_OPS: kernel sends file handle for fstat, etc... (not yet supported)
 * FUSE_ATOMIC_O_TRUNC: handles the O_TRUNC open flag in the filesystem
 * FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
 * FUSE_BIG_WRITES: filesystem can handle write size larger than 4kB
 * FUSE_DONT_MASK: don't apply umask to file mode on create operations
 * FUSE_SPLICE_WRITE: kernel supports splice write on the device
 * FUSE_SPLICE_MOVE: kernel supports splice move on the device
 * FUSE_SPLICE_READ: kernel supports splice read on the device
 * FUSE_FLOCK_LOCKS: remote locking for BSD style file locks
 * FUSE_HAS_IOCTL_DIR: kernel supports ioctl on directories
 * FUSE_AUTO_INVAL_DATA: automatically invalidate cached pages
 */
#define FUSE_ASYNC_READ		(1 << 0)
#define FUSE_POSIX_LOCKS	(1 << 1)
#define FUSE_FILE_OPS		(1 << 2)
#define FUSE_ATOMIC_O_TRUNC	(1 << 3)
#define FUSE_EXPORT_SUPPORT	(1 << 4)
#define FUSE_BIG_WRITES		(1 << 5)
#define FUSE_DONT_MASK		(1 << 6)
#define FUSE_SPLICE_WRITE	(1 << 7)
#define FUSE_SPLICE_MOVE	(1 << 8)
#define FUSE_SPLICE_READ	(1 << 9)
#define FUSE_FLOCK_LOCKS	(1 << 10)
#define FUSE_HAS_IOCTL_DIR	(1 << 11)
#define FUSE_AUTO_INVAL_DATA	(1 << 12)
#define FUSE_DO_READDIRPLUS	(1 << 13)

/**
 * CUSE INIT request/reply flags
 *
 * CUSE_UNRESTRICTED_IOCTL:  use unrestricted ioctl
 */
#define CUSE_UNRESTRICTED_IOCTL	(1 << 0)

/**
 * Release flags
 */
#define FUSE_RELEASE_FLUSH	(1 << 0)
#define FUSE_RELEASE_FLOCK_UNLOCK	(1 << 1)

/**
 * Getattr flags
 */
#define FUSE_GETATTR_FH		(1 << 0)

/**
 * Lock flags
 */
#define FUSE_LK_FLOCK		(1 << 0)

/**
 * WRITE flags
 *
 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
 */
#define FUSE_WRITE_CACHE	(1 << 0)
#define FUSE_WRITE_LOCKOWNER	(1 << 1)

/**
 * Read flags
 */
#define FUSE_READ_LOCKOWNER	(1 << 1)

/**
 * Ioctl flags
 *
 * FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
 * FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
 * FUSE_IOCTL_RETRY: retry with new iovecs
 * FUSE_IOCTL_32BIT: 32bit ioctl
 * FUSE_IOCTL_DIR: is a directory
 *
 * FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
 */
#define FUSE_IOCTL_COMPAT	(1 << 0)
#define FUSE_IOCTL_UNRESTRICTED	(1 << 1)
#define FUSE_IOCTL_RETRY	(1 << 2)
#define FUSE_IOCTL_32BIT	(1 << 3)
#define FUSE_IOCTL_DIR		(1 << 4)

#define FUSE_IOCTL_MAX_IOV	256

/**
 * Poll flags
 *
 * FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
 */
#define FUSE_POLL_SCHEDULE_NOTIFY (1 << 0)

enum fuse_opcode {
	FUSE_LOOKUP	   = 1,
	FUSE_FORGET	   = 2,  /* no reply */
	FUSE_GETATTR	   = 3,
	FUSE_SETATTR	   = 4,
	FUSE_READLINK	   = 5,
	FUSE_SYMLINK	   = 6,
	FUSE_MKNOD	   = 8,
	FUSE_MKDIR	   = 9,
	FUSE_UNLINK	   = 10,
	FUSE_RMDIR	   = 11,
	FUSE_RENAME	   = 12,
	FUSE_LINK	   = 13,
	FUSE_OPEN	   = 14,
	FUSE_READ	   = 15,
	FUSE_WRITE	   = 16,
	FUSE_STATFS	   = 17,
	FUSE_RELEASE       = 18,
	FUSE_FSYNC         = 20,
	FUSE_SETXATTR      = 21,
	FUSE_GETXATTR      = 22,
	FUSE_LISTXATTR     = 23,
	FUSE_REMOVEXATTR   = 24,
	FUSE_FLUSH         = 25,
	FUSE_INIT          = 26,
	FUSE_OPENDIR       = 27,
	FUSE_READDIR       = 28,
	FUSE_RELEASEDIR    = 29,
	FUSE_FSYNCDIR      = 30,
	FUSE_GETLK         = 31,
	FUSE_SETLK         = 32,
	FUSE_SETLKW        = 33,
	FUSE_ACCESS        = 34,
	FUSE_CREATE        = 35,
	FUSE_INTERRUPT     = 36,
	FUSE_BMAP          = 37,
	FUSE_DESTROY       = 38,
	FUSE_IOCTL         = 39,
	FUSE_POLL          = 40,
	FUSE_NOTIFY_REPLY  = 41,
	FUSE_BATCH_FORGET  = 42,
	FUSE_FALLOCATE     = 43,
	FUSE_READDIRPLUS   = 44,

	/* CUSE specific operations */
	CUSE_INIT          = 4096,
};

enum fuse_notify_code {
	FUSE_NOTIFY_POLL   = 1,
	FUSE_NOTIFY_INVAL_INODE = 2,
	FUSE_NOTIFY_INVAL_ENTRY = 3,
	FUSE_NOTIFY_STORE = 4,
	FUSE_NOTIFY_RETRIEVE = 5,
	FUSE_NOTIFY_DELETE = 6,
	FUSE_NOTIFY_CODE_MAX,
};

/* The read buffer is required to be at least 8k, but may be much larger */
#define FUSE_MIN_READ_BUFFER 8192

#define FUSE_COMPAT_ENTRY_OUT_SIZE 120

struct fuse_entry_out {
	__u64	nodeid;		/* Inode ID */
	__u64	generation;	/* Inode generation: nodeid:gen must
				   be unique for the fs's lifetime */
	__u64	entry_valid;	/* Cache timeout for the name */
	__u64	attr_valid;	/* Cache timeout for the attributes */
	__u32	entry_valid_nsec;
	__u32	attr_valid_nsec;
	struct fuse_attr attr;
};

struct fuse_forget_in {
	__u64	nlookup;
};

struct fuse_forget_one {
	__u64	nodeid;
	__u64	nlookup;
};

struct fuse_batch_forget_in {
	__u32	count;
	__u32	dummy;
};

struct fuse_getattr_in {
	__u32	getattr_flags;
	__u32	dummy;
	__u64	fh;
};

#define FUSE_COMPAT_ATTR_OUT_SIZE 96

struct fuse_attr_out {
	__u64	attr_valid;	/* Cache timeout for the attributes */
	__u32	attr_valid_nsec;
	__u32	dummy;
	struct fuse_attr attr;
};

#define FUSE_COMPAT_MKNOD_IN_SIZE 8

struct fuse_mknod_in {
	__u32	mode;
	__u32	rdev;
	__u32	umask;
	__u32	padding;
};

struct fuse_mkdir_in {
	__u32	mode;
	__u32	umask;
};

struct fuse_rename_in {
	__u64	newdir;
};

struct fuse_link_in {
	__u64	oldnodeid;
};

struct fuse_setattr_in {
	__u32	valid;
	__u32	padding;
	__u64	fh;
	__u64	size;
	__u64	lock_owner;
	__u64	atime;
	__u64	mtime;
	__u64	unused2;
	__u32	atimensec;
	__u32	mtimensec;
	__u32	unused3;
	__u32	mode;
	__u32	unused4;
	__u32	uid;
	__u32	gid;
	__u32	unused5;
};

struct fuse_open_in {
	__u32	flags;
	__u32	unused;
};

struct fuse_create_in {
	__u32	flags;
	__u32	mode;
	__u32	umask;
	__u32	padding;
};

struct fuse_open_out {
	__u64	fh;
	__u32	open_flags;
	__u32	padding;
};

struct fuse_release_in {
	__u64	fh;
	__u32	flags;
	__u32	release_flags;
	__u64	lock_owner;
};

struct fuse_flush_in {
	__u64	fh;
	__u32	unused;
	__u32	padding;
	__u64	lock_owner;
};

struct fuse_read_in {
	__u64	fh;
	__u64	offset;
	__u32	size;
	__u32	read_flags;
	__u64	lock_owner;
	__u32	flags;
	__u32	padding;
};

#define FUSE_COMPAT_WRITE_IN_SIZE 24

struct fuse_write_in {
	__u64	fh;
	__u64	offset;
	__u32	size;
	__u32	write_flags;
	__u64	lock_owner;
	__u32	flags;
	__u32	padding;
};

struct fuse_write_out {
	__u32	size;
	__u32	padding;
};

#define FUSE_COMPAT_STATFS_SIZE 48

struct fuse_statfs_out {
	struct fuse_kstatfs st;
};

struct fuse_fsync_in {
	__u64	fh;
	__u32	fsync_flags;
	__u32	padding;
};

struct fuse_setxattr_in {
	__u32	size;
	__u32	flags;
};

struct fuse_getxattr_in {
	__u32	size;
	__u32	padding;
};

struct fuse_getxattr_out {
	__u32	size;
	__u32	padding;
};

struct fuse_lk_in {
	__u64	fh;
	__u64	owner;
	struct fuse_file_lock lk;
	__u32	lk_flags;
	__u32	padding;
};

struct fuse_lk_out {
	struct fuse_file_lock lk;
};

struct fuse_access_in {
	__u32	mask;
	__u32	padding;
};

struct fuse_init_in {
	__u32	major;
	__u32	minor;
	__u32	max_readahead;
	__u32	flags;
};

struct fuse_init_out {
	__u32	major;
	__u32	minor;
	__u32	max_readahead;
	__u32	flags;
	__u16   max_background;
	__u16   congestion_threshold;
	__u32	max_write;
};

#define CUSE_INIT_INFO_MAX 4096

struct cuse_init_in {
	__u32	major;
	__u32	minor;
	__u32	unused;
	__u32	flags;
};

struct cuse_init_out {
	__u32	major;
	__u32	minor;
	__u32	unused;
	__u32	flags;
	__u32	max_read;
	__u32	max_write;
	__u32	dev_major;		/* chardev major */
	__u32	dev_minor;		/* chardev minor */
	__u32	spare[10];
};

struct fuse_interrupt_in {
	__u64	unique;
};

struct fuse_bmap_in {
	__u64	block;
	__u32	blocksize;
	__u32	padding;
};

struct fuse_bmap_out {
	__u64	block;
};

struct fuse_ioctl_in {
	__u64	fh;
	__u32	flags;
	__u32	cmd;
	__u64	arg;
	__u32	in_size;
	__u32	out_size;
};

struct fuse_ioctl_iovec {
	__u64	base;
	__u64	len;
};

struct fuse_ioctl_out {
	__s32	result;
	__u32	flags;
	__u32	in_iovs;
	__u32	out_iovs;
};

struct fuse_poll_in {
	__u64	fh;
	__u64	kh;
	__u32	flags;
	__u32   events;
};

struct fuse_poll_out {
	__u32	revents;
	__u32	padding;
};

struct fuse_notify_poll_wakeup_out {
	__u64	kh;
};

struct fuse_fallocate_in {
	__u64	fh;
	__u64	offset;
	__u64	length;
	__u32	mode;
	__u32	padding;
};

struct fuse_in_header {
	__u32	len;
	__u32	opcode;
	__u64	unique;
	__u64	nodeid;
	__u32	uid;
	__u32	gid;
	__u32	pid;
	__u32	padding;
};

struct fuse_out_header {
	__u32	len;
	__s32	error;
	__u64	unique;
};

struct fuse_dirent {
	__u64	ino;
	__u64	off;
	__u32	namelen;
	__u32	type;
	char name[];
};

#define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
#define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
#define FUSE_DIRENT_SIZE(d) \
	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)

struct fuse_direntplus {
	struct fuse_entry_out entry_out;
	struct fuse_dirent dirent;
};

#define FUSE_NAME_OFFSET_DIRENTPLUS \
	offsetof(struct fuse_direntplus, dirent.name)
#define FUSE_DIRENTPLUS_SIZE(d) \
	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET_DIRENTPLUS + (d)->dirent.namelen)

struct fuse_notify_inval_inode_out {
	__u64	ino;
	__s64	off;
	__s64	len;
};

struct fuse_notify_inval_entry_out {
	__u64	parent;
	__u32	namelen;
	__u32	padding;
};

struct fuse_notify_delete_out {
	__u64	parent;
	__u64	child;
	__u32	namelen;
	__u32	padding;
};

struct fuse_notify_store_out {
	__u64	nodeid;
	__u64	offset;
	__u32	size;
	__u32	padding;
};

struct fuse_notify_retrieve_out {
	__u64	notify_unique;
	__u64	nodeid;
	__u64	offset;
	__u32	size;
	__u32	padding;
};

/* Matches the size of fuse_write_in */
struct fuse_notify_retrieve_in {
	__u64	dummy1;
	__u64	offset;
	__u32	size;
	__u32	dummy2;
	__u64	dummy3;
	__u64	dummy4;
};

#endif /* _LINUX_FUSE_H */
Commit	Line	Data
d8a5ba45 MS	1	/*
d8a5ba45 MS	2	FUSE: Filesystem in Userspace
1f55ed06	3	Copyright (C) 2001-2008 Miklos Szeredi <miklos@szeredi.hu>
d8a5ba45 MS	4
	5	This program can be distributed under the terms of the GNU GPL.
	6	See the file COPYING.
	7	*/
	8
c79e322f MS	9	/*
	10	* This file defines the kernel interface of FUSE
	11	*
	12	* Protocol changelog:
	13	*
	14	* 7.9:
	15	* - new fuse_getattr_in input argument of GETATTR
a9ff4f87	16	* - add lk_flags in fuse_lk_in
f3332114	17	* - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
0e9663ee	18	* - add blksize field to fuse_attr
a6643094	19	* - add file flags field to fuse_read_in and fuse_write_in
a7c1b990 TH	20	*
	21	* 7.10
	22	* - add nonseekable open flag
1f55ed06 MS	23	*
	24	* 7.11
	25	* - add IOCTL message
	26	* - add unsolicited notification support
	27	* - add POLL message and NOTIFY_POLL notification
e0a43ddc MS	28	*
	29	* 7.12
	30	* - add umask flag to input argument of open, mknod and mkdir
3b463ae0 JM	31	* - add notification messages for invalidation of inodes and
3b463ae0 JM	32	* directory entries
7a6d3c8b CH	33	*
	34	* 7.13
	35	* - make max number of background requests and congestion threshold
	36	* tunables
dd3bb14f MS	37	*
	38	* 7.14
	39	* - add splice support to fuse device
a1d75f25 MS	40	*
	41	* 7.15
	42	* - add store notify
2d45ba38	43	* - add retrieve notify
02c048b9 MS	44	*
	45	* 7.16
	46	* - add BATCH_FORGET request
1baa26b2 MS	47	* - FUSE_IOCTL_UNRESTRICTED shall now return with array of 'struct
	48	* fuse_ioctl_iovec' instead of ambiguous 'struct iovec'
	49	* - add FUSE_IOCTL_32BIT flag
37fb3a30 MS	50	*
	51	* 7.17
	52	* - add FUSE_FLOCK_LOCKS and FUSE_RELEASE_FLOCK_UNLOCK
b18da0c5 MS	53	*
	54	* 7.18
	55	* - add FUSE_IOCTL_DIR flag
451d0f59	56	* - add FUSE_NOTIFY_DELETE
05ba1f08 AP	57	*
	58	* 7.19
	59	* - add FUSE_FALLOCATE
72d0d248 BF	60	*
	61	* 7.20
	62	* - add FUSE_AUTO_INVAL_DATA
23c153e5 MS	63	*
	64	* 7.21
	65	* - add FUSE_READDIRPLUS
0415d291	66	* - send the requested events in POLL request
c79e322f	67	*/
d8a5ba45	68
29d434b3 TH	69	#ifndef _LINUX_FUSE_H
	70	#define _LINUX_FUSE_H
	71
1f55ed06	72	#include <linux/types.h>
d8a5ba45	73
37d217f0 MS	74	/*
	75	* Version negotiation:
	76	*
	77	* Both the kernel and userspace send the version they support in the
	78	* INIT request and reply respectively.
	79	*
	80	* If the major versions match then both shall use the smallest
	81	* of the two minor versions for communication.
	82	*
	83	* If the kernel supports a larger major version, then userspace shall
	84	* reply with the major version it supports, ignore the rest of the
	85	* INIT message and expect a new INIT message from the kernel with a
	86	* matching major version.
	87	*
	88	* If the library supports a larger major version, then it shall fall
	89	* back to the major protocol version sent by the kernel for
	90	* communication and reply with that major version (and an arbitrary
	91	* supported minor version).
	92	*/
	93
d8a5ba45	94	/** Version number of this interface */
9e6268db	95	#define FUSE_KERNEL_VERSION 7
d8a5ba45 MS	96
d8a5ba45 MS	97	/** Minor version number of this interface */
23c153e5	98	#define FUSE_KERNEL_MINOR_VERSION 21
d8a5ba45 MS	99
	100	/** The node ID of the root inode */
	101	#define FUSE_ROOT_ID 1
	102
06663267 MS	103	/* Make sure all structures are padded to 64bit boundary, so 32bit
	104	userspace works under 64bit kernels */
	105
d8a5ba45 MS	106	struct fuse_attr {
	107	__u64 ino;
	108	__u64 size;
	109	__u64 blocks;
	110	__u64 atime;
	111	__u64 mtime;
	112	__u64 ctime;
	113	__u32 atimensec;
	114	__u32 mtimensec;
	115	__u32 ctimensec;
	116	__u32 mode;
	117	__u32 nlink;
	118	__u32 uid;
	119	__u32 gid;
	120	__u32 rdev;
0e9663ee MS	121	__u32 blksize;
0e9663ee MS	122	__u32 padding;
d8a5ba45 MS	123	};
d8a5ba45 MS	124
e5e5558e MS	125	struct fuse_kstatfs {
	126	__u64 blocks;
	127	__u64 bfree;
	128	__u64 bavail;
	129	__u64 files;
	130	__u64 ffree;
	131	__u32 bsize;
	132	__u32 namelen;
de5f1202 MS	133	__u32 frsize;
	134	__u32 padding;
	135	__u32 spare[6];
e5e5558e MS	136	};
e5e5558e MS	137
71421259 MS	138	struct fuse_file_lock {
	139	__u64 start;
	140	__u64 end;
	141	__u32 type;
	142	__u32 pid; /* tgid */
	143	};
	144
9cd68455 MS	145	/**
	146	* Bitmasks for fuse_setattr_in.valid
	147	*/
9e6268db MS	148	#define FATTR_MODE (1 << 0)
	149	#define FATTR_UID (1 << 1)
	150	#define FATTR_GID (1 << 2)
	151	#define FATTR_SIZE (1 << 3)
	152	#define FATTR_ATIME (1 << 4)
	153	#define FATTR_MTIME (1 << 5)
befc649c	154	#define FATTR_FH (1 << 6)
17637cba MS	155	#define FATTR_ATIME_NOW (1 << 7)
17637cba MS	156	#define FATTR_MTIME_NOW (1 << 8)
f3332114	157	#define FATTR_LOCKOWNER (1 << 9)
9e6268db	158
45323fb7 MS	159	/**
	160	* Flags returned by the OPEN request
	161	*
	162	* FOPEN_DIRECT_IO: bypass page cache for this open file
	163	* FOPEN_KEEP_CACHE: don't invalidate the data cache on open
a7c1b990	164	* FOPEN_NONSEEKABLE: the file is not seekable
45323fb7 MS	165	*/
	166	#define FOPEN_DIRECT_IO (1 << 0)
	167	#define FOPEN_KEEP_CACHE (1 << 1)
a7c1b990	168	#define FOPEN_NONSEEKABLE (1 << 2)
45323fb7	169
9cd68455 MS	170	/**
9cd68455 MS	171	* INIT request/reply flags
33670fa2	172	*
f3840dc0	173	* FUSE_ASYNC_READ: asynchronous read requests
37fb3a30	174	* FUSE_POSIX_LOCKS: remote locking for POSIX file locks
f3840dc0 MS	175	* FUSE_FILE_OPS: kernel sends file handle for fstat, etc... (not yet supported)
f3840dc0 MS	176	* FUSE_ATOMIC_O_TRUNC: handles the O_TRUNC open flag in the filesystem
33670fa2	177	* FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
f3840dc0	178	* FUSE_BIG_WRITES: filesystem can handle write size larger than 4kB
e0a43ddc	179	* FUSE_DONT_MASK: don't apply umask to file mode on create operations
69fe05c9 MS	180	* FUSE_SPLICE_WRITE: kernel supports splice write on the device
	181	* FUSE_SPLICE_MOVE: kernel supports splice move on the device
	182	* FUSE_SPLICE_READ: kernel supports splice read on the device
37fb3a30	183	* FUSE_FLOCK_LOCKS: remote locking for BSD style file locks
69fe05c9	184	* FUSE_HAS_IOCTL_DIR: kernel supports ioctl on directories
72d0d248	185	* FUSE_AUTO_INVAL_DATA: automatically invalidate cached pages
9cd68455 MS	186	*/
9cd68455 MS	187	#define FUSE_ASYNC_READ (1 << 0)
71421259	188	#define FUSE_POSIX_LOCKS (1 << 1)
c79e322f	189	#define FUSE_FILE_OPS (1 << 2)
6ff958ed	190	#define FUSE_ATOMIC_O_TRUNC (1 << 3)
33670fa2	191	#define FUSE_EXPORT_SUPPORT (1 << 4)
78bb6cb9	192	#define FUSE_BIG_WRITES (1 << 5)
e0a43ddc	193	#define FUSE_DONT_MASK (1 << 6)
69fe05c9 MS	194	#define FUSE_SPLICE_WRITE (1 << 7)
	195	#define FUSE_SPLICE_MOVE (1 << 8)
	196	#define FUSE_SPLICE_READ (1 << 9)
37fb3a30	197	#define FUSE_FLOCK_LOCKS (1 << 10)
69fe05c9	198	#define FUSE_HAS_IOCTL_DIR (1 << 11)
72d0d248	199	#define FUSE_AUTO_INVAL_DATA (1 << 12)
0b05b183	200	#define FUSE_DO_READDIRPLUS (1 << 13)
9cd68455	201
151060ac TH	202	/**
	203	* CUSE INIT request/reply flags
	204	*
	205	* CUSE_UNRESTRICTED_IOCTL: use unrestricted ioctl
	206	*/
	207	#define CUSE_UNRESTRICTED_IOCTL (1 << 0)
	208
e9168c18 MS	209	/**
	210	* Release flags
	211	*/
	212	#define FUSE_RELEASE_FLUSH (1 << 0)
37fb3a30	213	#define FUSE_RELEASE_FLOCK_UNLOCK (1 << 1)
e9168c18	214
c79e322f MS	215	/**
	216	* Getattr flags
	217	*/
	218	#define FUSE_GETATTR_FH (1 << 0)
	219
a9ff4f87 MS	220	/**
	221	* Lock flags
	222	*/
	223	#define FUSE_LK_FLOCK (1 << 0)
	224
b25e82e5 MS	225	/**
	226	* WRITE flags
	227	*
	228	* FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
f3332114	229	* FUSE_WRITE_LOCKOWNER: lock_owner field is valid
b25e82e5 MS	230	*/
b25e82e5 MS	231	#define FUSE_WRITE_CACHE (1 << 0)
f3332114 MS	232	#define FUSE_WRITE_LOCKOWNER (1 << 1)
	233
	234	/**
	235	* Read flags
	236	*/
	237	#define FUSE_READ_LOCKOWNER (1 << 1)
b25e82e5	238
59efec7b TH	239	/**
	240	* Ioctl flags
	241	*
	242	* FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
	243	* FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
	244	* FUSE_IOCTL_RETRY: retry with new iovecs
1baa26b2	245	* FUSE_IOCTL_32BIT: 32bit ioctl
b18da0c5	246	* FUSE_IOCTL_DIR: is a directory
59efec7b TH	247	*
	248	* FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
	249	*/
	250	#define FUSE_IOCTL_COMPAT (1 << 0)
	251	#define FUSE_IOCTL_UNRESTRICTED (1 << 1)
	252	#define FUSE_IOCTL_RETRY (1 << 2)
1baa26b2	253	#define FUSE_IOCTL_32BIT (1 << 3)
b18da0c5	254	#define FUSE_IOCTL_DIR (1 << 4)
59efec7b TH	255
	256	#define FUSE_IOCTL_MAX_IOV 256
	257
95668a69 TH	258	/**
	259	* Poll flags
	260	*
	261	* FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
	262	*/
	263	#define FUSE_POLL_SCHEDULE_NOTIFY (1 << 0)
	264
334f485d	265	enum fuse_opcode {
e5e5558e MS	266	FUSE_LOOKUP = 1,
	267	FUSE_FORGET = 2, /* no reply */
	268	FUSE_GETATTR = 3,
9e6268db	269	FUSE_SETATTR = 4,
e5e5558e	270	FUSE_READLINK = 5,
9e6268db	271	FUSE_SYMLINK = 6,
9e6268db MS	272	FUSE_MKNOD = 8,
	273	FUSE_MKDIR = 9,
	274	FUSE_UNLINK = 10,
	275	FUSE_RMDIR = 11,
	276	FUSE_RENAME = 12,
	277	FUSE_LINK = 13,
b6aeaded MS	278	FUSE_OPEN = 14,
	279	FUSE_READ = 15,
	280	FUSE_WRITE = 16,
e5e5558e	281	FUSE_STATFS = 17,
b6aeaded MS	282	FUSE_RELEASE = 18,
b6aeaded MS	283	FUSE_FSYNC = 20,
92a8780e MS	284	FUSE_SETXATTR = 21,
	285	FUSE_GETXATTR = 22,
	286	FUSE_LISTXATTR = 23,
	287	FUSE_REMOVEXATTR = 24,
b6aeaded	288	FUSE_FLUSH = 25,
04730fef MS	289	FUSE_INIT = 26,
	290	FUSE_OPENDIR = 27,
	291	FUSE_READDIR = 28,
82547981	292	FUSE_RELEASEDIR = 29,
31d40d74	293	FUSE_FSYNCDIR = 30,
71421259 MS	294	FUSE_GETLK = 31,
	295	FUSE_SETLK = 32,
	296	FUSE_SETLKW = 33,
fd72faac	297	FUSE_ACCESS = 34,
a4d27e75 MS	298	FUSE_CREATE = 35,
a4d27e75 MS	299	FUSE_INTERRUPT = 36,
b2d2272f	300	FUSE_BMAP = 37,
0ec7ca41	301	FUSE_DESTROY = 38,
59efec7b	302	FUSE_IOCTL = 39,
95668a69	303	FUSE_POLL = 40,
2d45ba38	304	FUSE_NOTIFY_REPLY = 41,
02c048b9	305	FUSE_BATCH_FORGET = 42,
05ba1f08	306	FUSE_FALLOCATE = 43,
0b05b183	307	FUSE_READDIRPLUS = 44,
151060ac TH	308
	309	/* CUSE specific operations */
	310	CUSE_INIT = 4096,
334f485d MS	311	};
334f485d MS	312
8599396b	313	enum fuse_notify_code {
95668a69	314	FUSE_NOTIFY_POLL = 1,
3b463ae0 JM	315	FUSE_NOTIFY_INVAL_INODE = 2,
3b463ae0 JM	316	FUSE_NOTIFY_INVAL_ENTRY = 3,
a1d75f25	317	FUSE_NOTIFY_STORE = 4,
2d45ba38	318	FUSE_NOTIFY_RETRIEVE = 5,
451d0f59	319	FUSE_NOTIFY_DELETE = 6,
8599396b TH	320	FUSE_NOTIFY_CODE_MAX,
	321	};
	322
1d3d752b MS	323	/* The read buffer is required to be at least 8k, but may be much larger */
1d3d752b MS	324	#define FUSE_MIN_READ_BUFFER 8192
e5e5558e	325
0e9663ee MS	326	#define FUSE_COMPAT_ENTRY_OUT_SIZE 120
0e9663ee MS	327
e5e5558e MS	328	struct fuse_entry_out {
	329	__u64 nodeid; /* Inode ID */
	330	__u64 generation; /* Inode generation: nodeid:gen must
	331	be unique for the fs's lifetime */
	332	__u64 entry_valid; /* Cache timeout for the name */
	333	__u64 attr_valid; /* Cache timeout for the attributes */
	334	__u32 entry_valid_nsec;
	335	__u32 attr_valid_nsec;
	336	struct fuse_attr attr;
	337	};
	338
	339	struct fuse_forget_in {
9e6268db	340	__u64 nlookup;
e5e5558e MS	341	};
e5e5558e MS	342
02c048b9 MS	343	struct fuse_forget_one {
	344	__u64 nodeid;
	345	__u64 nlookup;
	346	};
	347
	348	struct fuse_batch_forget_in {
	349	__u32 count;
	350	__u32 dummy;
	351	};
	352
c79e322f MS	353	struct fuse_getattr_in {
	354	__u32 getattr_flags;
	355	__u32 dummy;
	356	__u64 fh;
	357	};
	358
0e9663ee MS	359	#define FUSE_COMPAT_ATTR_OUT_SIZE 96
0e9663ee MS	360
e5e5558e MS	361	struct fuse_attr_out {
	362	__u64 attr_valid; /* Cache timeout for the attributes */
	363	__u32 attr_valid_nsec;
	364	__u32 dummy;
	365	struct fuse_attr attr;
	366	};
	367
e0a43ddc MS	368	#define FUSE_COMPAT_MKNOD_IN_SIZE 8
e0a43ddc MS	369
9e6268db MS	370	struct fuse_mknod_in {
	371	__u32 mode;
	372	__u32 rdev;
e0a43ddc MS	373	__u32 umask;
e0a43ddc MS	374	__u32 padding;
9e6268db MS	375	};
	376
	377	struct fuse_mkdir_in {
	378	__u32 mode;
e0a43ddc	379	__u32 umask;
9e6268db MS	380	};
	381
	382	struct fuse_rename_in {
	383	__u64 newdir;
	384	};
	385
	386	struct fuse_link_in {
	387	__u64 oldnodeid;
	388	};
	389
	390	struct fuse_setattr_in {
	391	__u32 valid;
06663267	392	__u32 padding;
befc649c MS	393	__u64 fh;
befc649c MS	394	__u64 size;
f3332114	395	__u64 lock_owner;
befc649c MS	396	__u64 atime;
	397	__u64 mtime;
	398	__u64 unused2;
	399	__u32 atimensec;
	400	__u32 mtimensec;
	401	__u32 unused3;
	402	__u32 mode;
	403	__u32 unused4;
	404	__u32 uid;
	405	__u32 gid;
	406	__u32 unused5;
9e6268db MS	407	};
9e6268db MS	408
b6aeaded	409	struct fuse_open_in {
e0a43ddc MS	410	__u32 flags;
	411	__u32 unused;
	412	};
	413
	414	struct fuse_create_in {
b6aeaded	415	__u32 flags;
fd72faac	416	__u32 mode;
e0a43ddc MS	417	__u32 umask;
e0a43ddc MS	418	__u32 padding;
b6aeaded MS	419	};
	420
	421	struct fuse_open_out {
	422	__u64 fh;
	423	__u32 open_flags;
06663267	424	__u32 padding;
b6aeaded MS	425	};
	426
	427	struct fuse_release_in {
	428	__u64 fh;
	429	__u32 flags;
e9168c18 MS	430	__u32 release_flags;
e9168c18 MS	431	__u64 lock_owner;
b6aeaded MS	432	};
	433
	434	struct fuse_flush_in {
	435	__u64 fh;
e9168c18	436	__u32 unused;
06663267	437	__u32 padding;
71421259	438	__u64 lock_owner;
b6aeaded MS	439	};
	440
	441	struct fuse_read_in {
	442	__u64 fh;
	443	__u64 offset;
	444	__u32 size;
f3332114 MS	445	__u32 read_flags;
f3332114 MS	446	__u64 lock_owner;
a6643094 MS	447	__u32 flags;
a6643094 MS	448	__u32 padding;
b6aeaded MS	449	};
b6aeaded MS	450
f3332114 MS	451	#define FUSE_COMPAT_WRITE_IN_SIZE 24
f3332114 MS	452
b6aeaded MS	453	struct fuse_write_in {
	454	__u64 fh;
	455	__u64 offset;
	456	__u32 size;
	457	__u32 write_flags;
f3332114	458	__u64 lock_owner;
a6643094 MS	459	__u32 flags;
a6643094 MS	460	__u32 padding;
b6aeaded MS	461	};
	462
	463	struct fuse_write_out {
	464	__u32 size;
06663267	465	__u32 padding;
b6aeaded MS	466	};
b6aeaded MS	467
de5f1202 MS	468	#define FUSE_COMPAT_STATFS_SIZE 48
de5f1202 MS	469
e5e5558e MS	470	struct fuse_statfs_out {
	471	struct fuse_kstatfs st;
	472	};
	473
b6aeaded MS	474	struct fuse_fsync_in {
	475	__u64 fh;
	476	__u32 fsync_flags;
06663267	477	__u32 padding;
b6aeaded MS	478	};
b6aeaded MS	479
92a8780e MS	480	struct fuse_setxattr_in {
	481	__u32 size;
	482	__u32 flags;
	483	};
	484
	485	struct fuse_getxattr_in {
	486	__u32 size;
06663267	487	__u32 padding;
92a8780e MS	488	};
	489
	490	struct fuse_getxattr_out {
	491	__u32 size;
06663267	492	__u32 padding;
92a8780e MS	493	};
92a8780e MS	494
71421259 MS	495	struct fuse_lk_in {
	496	__u64 fh;
	497	__u64 owner;
	498	struct fuse_file_lock lk;
a9ff4f87 MS	499	__u32 lk_flags;
a9ff4f87 MS	500	__u32 padding;
71421259 MS	501	};
	502
	503	struct fuse_lk_out {
	504	struct fuse_file_lock lk;
	505	};
	506
31d40d74 MS	507	struct fuse_access_in {
	508	__u32 mask;
	509	__u32 padding;
	510	};
	511
3ec870d5	512	struct fuse_init_in {
334f485d MS	513	__u32 major;
334f485d MS	514	__u32 minor;
9cd68455 MS	515	__u32 max_readahead;
9cd68455 MS	516	__u32 flags;
334f485d MS	517	};
334f485d MS	518
3ec870d5 MS	519	struct fuse_init_out {
	520	__u32 major;
	521	__u32 minor;
9cd68455 MS	522	__u32 max_readahead;
9cd68455 MS	523	__u32 flags;
7a6d3c8b CH	524	__u16 max_background;
7a6d3c8b CH	525	__u16 congestion_threshold;
3ec870d5 MS	526	__u32 max_write;
	527	};
	528
151060ac TH	529	#define CUSE_INIT_INFO_MAX 4096
	530
	531	struct cuse_init_in {
	532	__u32 major;
	533	__u32 minor;
	534	__u32 unused;
	535	__u32 flags;
	536	};
	537
	538	struct cuse_init_out {
	539	__u32 major;
	540	__u32 minor;
	541	__u32 unused;
	542	__u32 flags;
	543	__u32 max_read;
	544	__u32 max_write;
	545	__u32 dev_major; /* chardev major */
	546	__u32 dev_minor; /* chardev minor */
	547	__u32 spare[10];
	548	};
	549
a4d27e75 MS	550	struct fuse_interrupt_in {
	551	__u64 unique;
	552	};
	553
b2d2272f MS	554	struct fuse_bmap_in {
	555	__u64 block;
	556	__u32 blocksize;
	557	__u32 padding;
	558	};
	559
	560	struct fuse_bmap_out {
	561	__u64 block;
	562	};
	563
59efec7b TH	564	struct fuse_ioctl_in {
	565	__u64 fh;
	566	__u32 flags;
	567	__u32 cmd;
	568	__u64 arg;
	569	__u32 in_size;
	570	__u32 out_size;
	571	};
	572
1baa26b2 MS	573	struct fuse_ioctl_iovec {
	574	__u64 base;
	575	__u64 len;
	576	};
	577
59efec7b TH	578	struct fuse_ioctl_out {
	579	__s32 result;
	580	__u32 flags;
	581	__u32 in_iovs;
	582	__u32 out_iovs;
	583	};
	584
95668a69 TH	585	struct fuse_poll_in {
	586	__u64 fh;
	587	__u64 kh;
	588	__u32 flags;
0415d291	589	__u32 events;
95668a69 TH	590	};
	591
	592	struct fuse_poll_out {
	593	__u32 revents;
	594	__u32 padding;
	595	};
	596
	597	struct fuse_notify_poll_wakeup_out {
	598	__u64 kh;
	599	};
	600
05ba1f08 AP	601	struct fuse_fallocate_in {
	602	__u64 fh;
	603	__u64 offset;
	604	__u64 length;
	605	__u32 mode;
	606	__u32 padding;
	607	};
	608
334f485d MS	609	struct fuse_in_header {
	610	__u32 len;
	611	__u32 opcode;
	612	__u64 unique;
	613	__u64 nodeid;
	614	__u32 uid;
	615	__u32 gid;
	616	__u32 pid;
06663267	617	__u32 padding;
334f485d MS	618	};
	619
	620	struct fuse_out_header {
	621	__u32 len;
	622	__s32 error;
	623	__u64 unique;
	624	};
	625
e5e5558e MS	626	struct fuse_dirent {
	627	__u64 ino;
	628	__u64 off;
	629	__u32 namelen;
	630	__u32 type;
c628ee67	631	char name[];
e5e5558e MS	632	};
e5e5558e MS	633
21f3da95	634	#define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
e5e5558e MS	635	#define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
	636	#define FUSE_DIRENT_SIZE(d) \
	637	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
29d434b3	638
0b05b183 AA	639	struct fuse_direntplus {
	640	struct fuse_entry_out entry_out;
	641	struct fuse_dirent dirent;
	642	};
	643
	644	#define FUSE_NAME_OFFSET_DIRENTPLUS \
	645	offsetof(struct fuse_direntplus, dirent.name)
	646	#define FUSE_DIRENTPLUS_SIZE(d) \
	647	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET_DIRENTPLUS + (d)->dirent.namelen)
	648
3b463ae0 JM	649	struct fuse_notify_inval_inode_out {
	650	__u64 ino;
	651	__s64 off;
	652	__s64 len;
	653	};
	654
	655	struct fuse_notify_inval_entry_out {
	656	__u64 parent;
	657	__u32 namelen;
	658	__u32 padding;
	659	};
	660
451d0f59 JM	661	struct fuse_notify_delete_out {
	662	__u64 parent;
	663	__u64 child;
	664	__u32 namelen;
	665	__u32 padding;
	666	};
	667
a1d75f25 MS	668	struct fuse_notify_store_out {
	669	__u64 nodeid;
	670	__u64 offset;
	671	__u32 size;
	672	__u32 padding;
	673	};
	674
2d45ba38 MS	675	struct fuse_notify_retrieve_out {
	676	__u64 notify_unique;
	677	__u64 nodeid;
	678	__u64 offset;
	679	__u32 size;
	680	__u32 padding;
	681	};
	682
	683	/* Matches the size of fuse_write_in */
	684	struct fuse_notify_retrieve_in {
	685	__u64 dummy1;
	686	__u64 offset;
	687	__u32 size;
	688	__u32 dummy2;
	689	__u64 dummy3;
	690	__u64 dummy4;
	691	};
	692
29d434b3	693	#endif /* _LINUX_FUSE_H */