2 FUSE: Filesystem in Userspace
3 Copyright (C) 2001-2008 Miklos Szeredi <miklos@szeredi.hu>
5 This program can be distributed under the terms of the GNU GPL.
10 * This file defines the kernel interface of FUSE
15 * - new fuse_getattr_in input argument of GETATTR
16 * - add lk_flags in fuse_lk_in
17 * - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
18 * - add blksize field to fuse_attr
19 * - add file flags field to fuse_read_in and fuse_write_in
22 * - add nonseekable open flag
26 * - add unsolicited notification support
27 * - add POLL message and NOTIFY_POLL notification
30 * - add umask flag to input argument of open, mknod and mkdir
36 #include <linux/types.h>
38 /** Version number of this interface */
39 #define FUSE_KERNEL_VERSION 7
41 /** Minor version number of this interface */
42 #define FUSE_KERNEL_MINOR_VERSION 12
44 /** The node ID of the root inode */
45 #define FUSE_ROOT_ID 1
47 /* Make sure all structures are padded to 64bit boundary, so 32bit
48 userspace works under 64bit kernels */
82 struct fuse_file_lock {
90 * Bitmasks for fuse_setattr_in.valid
92 #define FATTR_MODE (1 << 0)
93 #define FATTR_UID (1 << 1)
94 #define FATTR_GID (1 << 2)
95 #define FATTR_SIZE (1 << 3)
96 #define FATTR_ATIME (1 << 4)
97 #define FATTR_MTIME (1 << 5)
98 #define FATTR_FH (1 << 6)
99 #define FATTR_ATIME_NOW (1 << 7)
100 #define FATTR_MTIME_NOW (1 << 8)
101 #define FATTR_LOCKOWNER (1 << 9)
104 * Flags returned by the OPEN request
106 * FOPEN_DIRECT_IO: bypass page cache for this open file
107 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
108 * FOPEN_NONSEEKABLE: the file is not seekable
110 #define FOPEN_DIRECT_IO (1 << 0)
111 #define FOPEN_KEEP_CACHE (1 << 1)
112 #define FOPEN_NONSEEKABLE (1 << 2)
115 * INIT request/reply flags
117 * FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
118 * FUSE_DONT_MASK: don't apply umask to file mode on create operations
120 #define FUSE_ASYNC_READ (1 << 0)
121 #define FUSE_POSIX_LOCKS (1 << 1)
122 #define FUSE_FILE_OPS (1 << 2)
123 #define FUSE_ATOMIC_O_TRUNC (1 << 3)
124 #define FUSE_EXPORT_SUPPORT (1 << 4)
125 #define FUSE_BIG_WRITES (1 << 5)
126 #define FUSE_DONT_MASK (1 << 6)
129 * CUSE INIT request/reply flags
131 * CUSE_UNRESTRICTED_IOCTL: use unrestricted ioctl
133 #define CUSE_UNRESTRICTED_IOCTL (1 << 0)
138 #define FUSE_RELEASE_FLUSH (1 << 0)
143 #define FUSE_GETATTR_FH (1 << 0)
148 #define FUSE_LK_FLOCK (1 << 0)
153 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
154 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
156 #define FUSE_WRITE_CACHE (1 << 0)
157 #define FUSE_WRITE_LOCKOWNER (1 << 1)
162 #define FUSE_READ_LOCKOWNER (1 << 1)
167 * FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
168 * FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
169 * FUSE_IOCTL_RETRY: retry with new iovecs
171 * FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
173 #define FUSE_IOCTL_COMPAT (1 << 0)
174 #define FUSE_IOCTL_UNRESTRICTED (1 << 1)
175 #define FUSE_IOCTL_RETRY (1 << 2)
177 #define FUSE_IOCTL_MAX_IOV 256
182 * FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
184 #define FUSE_POLL_SCHEDULE_NOTIFY (1 << 0)
188 FUSE_FORGET = 2, /* no reply */
208 FUSE_REMOVEXATTR = 24,
213 FUSE_RELEASEDIR = 29,
226 /* CUSE specific operations */
230 enum fuse_notify_code {
231 FUSE_NOTIFY_POLL = 1,
232 FUSE_NOTIFY_CODE_MAX,
235 /* The read buffer is required to be at least 8k, but may be much larger */
236 #define FUSE_MIN_READ_BUFFER 8192
238 #define FUSE_COMPAT_ENTRY_OUT_SIZE 120
240 struct fuse_entry_out {
241 __u64 nodeid; /* Inode ID */
242 __u64 generation; /* Inode generation: nodeid:gen must
243 be unique for the fs's lifetime */
244 __u64 entry_valid; /* Cache timeout for the name */
245 __u64 attr_valid; /* Cache timeout for the attributes */
246 __u32 entry_valid_nsec;
247 __u32 attr_valid_nsec;
248 struct fuse_attr attr;
251 struct fuse_forget_in {
255 struct fuse_getattr_in {
261 #define FUSE_COMPAT_ATTR_OUT_SIZE 96
263 struct fuse_attr_out {
264 __u64 attr_valid; /* Cache timeout for the attributes */
265 __u32 attr_valid_nsec;
267 struct fuse_attr attr;
270 #define FUSE_COMPAT_MKNOD_IN_SIZE 8
272 struct fuse_mknod_in {
279 struct fuse_mkdir_in {
284 struct fuse_rename_in {
288 struct fuse_link_in {
292 struct fuse_setattr_in {
311 struct fuse_open_in {
316 struct fuse_create_in {
323 struct fuse_open_out {
329 struct fuse_release_in {
336 struct fuse_flush_in {
343 struct fuse_read_in {
353 #define FUSE_COMPAT_WRITE_IN_SIZE 24
355 struct fuse_write_in {
365 struct fuse_write_out {
370 #define FUSE_COMPAT_STATFS_SIZE 48
372 struct fuse_statfs_out {
373 struct fuse_kstatfs st;
376 struct fuse_fsync_in {
382 struct fuse_setxattr_in {
387 struct fuse_getxattr_in {
392 struct fuse_getxattr_out {
400 struct fuse_file_lock lk;
406 struct fuse_file_lock lk;
409 struct fuse_access_in {
414 struct fuse_init_in {
421 struct fuse_init_out {
430 #define CUSE_INIT_INFO_MAX 4096
432 struct cuse_init_in {
439 struct cuse_init_out {
446 __u32 dev_major; /* chardev major */
447 __u32 dev_minor; /* chardev minor */
451 struct fuse_interrupt_in {
455 struct fuse_bmap_in {
461 struct fuse_bmap_out {
465 struct fuse_ioctl_in {
474 struct fuse_ioctl_out {
481 struct fuse_poll_in {
488 struct fuse_poll_out {
493 struct fuse_notify_poll_wakeup_out {
497 struct fuse_in_header {
508 struct fuse_out_header {
522 #define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
523 #define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
524 #define FUSE_DIRENT_SIZE(d) \
525 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
527 #endif /* _LINUX_FUSE_H */