uapi/linux/fuse.h

1 /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause) */
4     Copyright (C) 2001-2008  Miklos Szeredi <miklos@szeredi.hu>
9     This -- and only this -- header file may also be distributed under
12     Copyright (C) 2001-2007 Miklos Szeredi. All rights reserved.
30     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
42  *  - add the following messages:
48  *  - add padding to messages to accommodate 32-bit servers on 64-bit kernels
51  *  - add FOPEN_DIRECT_IO and FOPEN_KEEP_CACHE flags
52  *  - add FUSE_FSYNCDIR message
55  *  - add FUSE_ACCESS message
56  *  - add FUSE_CREATE message
57  *  - add filehandle to fuse_setattr_in
60  *  - add frsize to fuse_kstatfs
61  *  - clean up request size limit checking
64  *  - add flags and max_write to fuse_init_out
67  *  - add max_readahead to fuse_init_in and fuse_init_out
70  *  - add FUSE_INTERRUPT message
71  *  - add POSIX file lock support
74  *  - add lock_owner and flags fields to fuse_release_in
75  *  - add FUSE_BMAP message
76  *  - add FUSE_DESTROY message
79  *  - new fuse_getattr_in input argument of GETATTR
80  *  - add lk_flags in fuse_lk_in
81  *  - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
82  *  - add blksize field to fuse_attr
83  *  - add file flags field to fuse_read_in and fuse_write_in
84  *  - Add ATIME_NOW and MTIME_NOW flags to fuse_setattr_in
87  *  - add nonseekable open flag
90  *  - add IOCTL message
91  *  - add unsolicited notification support
92  *  - add POLL message and NOTIFY_POLL notification
95  *  - add umask flag to input argument of create, mknod and mkdir
96  *  - add notification messages for invalidation of inodes and
100  *  - make max number of background requests and congestion threshold
104  *  - add splice support to fuse device
107  *  - add store notify
108  *  - add retrieve notify
111  *  - add BATCH_FORGET request
112  *  - FUSE_IOCTL_UNRESTRICTED shall now return with array of 'struct
114  *  - add FUSE_IOCTL_32BIT flag
117  *  - add FUSE_FLOCK_LOCKS and FUSE_RELEASE_FLOCK_UNLOCK
120  *  - add FUSE_IOCTL_DIR flag
121  *  - add FUSE_NOTIFY_DELETE
124  *  - add FUSE_FALLOCATE
127  *  - add FUSE_AUTO_INVAL_DATA
130  *  - add FUSE_READDIRPLUS
131  *  - send the requested events in POLL request
134  *  - add FUSE_ASYNC_DIO
137  *  - add FUSE_WRITEBACK_CACHE
138  *  - add time_gran to fuse_init_out
139  *  - add reserved space to fuse_init_out
140  *  - add FATTR_CTIME
141  *  - add ctime and ctimensec to fuse_setattr_in
142  *  - add FUSE_RENAME2 request
143  *  - add FUSE_NO_OPEN_SUPPORT flag
146  *  - add FUSE_LSEEK for SEEK_HOLE and SEEK_DATA support
149  *  - add FUSE_PARALLEL_DIROPS
152  *  - add FUSE_HANDLE_KILLPRIV
153  *  - add FUSE_POSIX_ACL
156  *  - add FUSE_ABORT_ERROR
159  *  - add FUSE_COPY_FILE_RANGE
160  *  - add FOPEN_CACHE_DIR
161  *  - add FUSE_MAX_PAGES, add max_pages to init_out
162  *  - add FUSE_CACHE_SYMLINKS
165  *  - add FUSE_NO_OPENDIR_SUPPORT flag
168  *  - add FUSE_EXPLICIT_INVAL_DATA
169  *  - add FUSE_IOCTL_COMPAT_X32
172  *  - add FUSE_WRITE_KILL_PRIV flag
173  *  - add FUSE_SETUPMAPPING and FUSE_REMOVEMAPPING
174  *  - add map_alignment to fuse_init_out, add FUSE_MAP_ALIGNMENT flag
177  *  - add flags to fuse_attr, add FUSE_ATTR_SUBMOUNT, add FUSE_SUBMOUNTS
180  *  - add FUSE_HANDLE_KILLPRIV_V2, FUSE_WRITE_KILL_SUIDGID, FATTR_KILL_SUIDGID
181  *  - add FUSE_OPEN_KILL_SUIDGID
182  *  - extend fuse_setxattr_in, add FUSE_SETXATTR_EXT
183  *  - add FUSE_SETXATTR_ACL_KILL_SGID
186  *  - add FUSE_SYNCFS
189  *  - add FOPEN_NOFLUSH
192  *  - extend fuse_init_in with reserved fields, add FUSE_INIT_EXT init flag
193  *  - add flags2 to fuse_init_in and fuse_init_out
194  *  - add FUSE_SECURITY_CTX init flag
195  *  - add security context to create, mkdir, symlink, and mknod requests
196  *  - add FUSE_HAS_INODE_DAX, FUSE_ATTR_DAX
199  *  - add FUSE_TMPFILE
202  *  - add FUSE_EXPIRE_ONLY flag to fuse_notify_inval_entry
203  *  - add FOPEN_PARALLEL_DIRECT_WRITES
204  *  - add total_extlen to fuse_in_header
205  *  - add FUSE_MAX_NR_SECCTX
206  *  - add extension header
207  *  - add FUSE_EXT_GROUPS
208  *  - add FUSE_CREATE_SUPP_GROUP
209  *  - add FUSE_HAS_EXPIRE_ONLY
212  *  - add FUSE_DIRECT_IO_ALLOW_MMAP
213  *  - add FUSE_STATX and related structures
216  *  - add max_stack_depth to fuse_init_out, add FUSE_PASSTHROUGH init flag
217  *  - add backing_id to fuse_open_out, add FOPEN_PASSTHROUGH open flag
218  *  - add FUSE_NO_EXPORT_SUPPORT init flag
219  *  - add FUSE_NOTIFY_RESEND, add FUSE_HAS_RESEND init flag
222  *  - add FUSE_ALLOW_IDMAP
286  * The following structures are bit-for-bit compatible with the statx(2) ABI in
359  * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
362  * FOPEN_STREAM: the file is stream-like (no file position at all)
363  * FOPEN_NOFLUSH: don't flush data cache on close (unless FUSE_WRITEBACK_CACHE)
364  * FOPEN_PARALLEL_DIRECT_WRITES: Allow concurrent direct writes on the same inode
385  * FUSE_DONT_MASK: don't apply umask to file mode on create operations
386  * FUSE_SPLICE_WRITE: kernel supports splice write on the device
387  * FUSE_SPLICE_MOVE: kernel supports splice move on the device
388  * FUSE_SPLICE_READ: kernel supports splice read on the device
390  * FUSE_HAS_IOCTL_DIR: kernel supports ioctl on directories
396  * FUSE_NO_OPEN_SUPPORT: kernel supports zero-message opens
398  * FUSE_HANDLE_KILLPRIV: fs handles killing suid/sgid/cap on write/chown/trunc
403  * FUSE_NO_OPENDIR_SUPPORT: kernel supports zero-message opendir
404  * FUSE_EXPLICIT_INVAL_DATA: only invalidate cached pages on explicit request
408  * FUSE_SUBMOUNTS: kernel supports auto-mounting directory submounts
409  * FUSE_HANDLE_KILLPRIV_V2: fs kills suid/sgid/cap on write/chown/trunc.
417  * FUSE_SECURITY_CTX:	add security context to create, mkdir, symlink, and
420  * FUSE_CREATE_SUPP_GROUP: add supplementary group info to create, mkdir,
422  * FUSE_HAS_EXPIRE_ONLY: kernel supports expiry-only entry invalidation
520  * FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
521  * FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
525  * FUSE_IOCTL_COMPAT_X32: x32 compat ioctl on 64bit machine (64bit time_t)
645 	/* Reserved opcodes: helpful to detect structure endian-ness */
996  * - fuse daemon enabled FUSE_ALLOW_IDMAP
997  * - idmapping information is not available and uid/gid
1005 #define FUSE_INVALID_UIDGID ((uint32_t)(-1))
1035 	(((x) + sizeof(uint64_t) - 1) & ~(sizeof(uint64_t) - 1))
1040 	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
1050 	FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET_DIRENTPLUS + (d)->dirent.namelen)
1187  * struct fuse_ext_header - extension header
1200  * struct fuse_supp_groups - Supplementary group extension