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.
26     ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
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
238  * INIT request and reply respectively.
245  * INIT message and expect a new INIT message from the kernel with a
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
377  * INIT request/reply flags
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.
422  * FUSE_HAS_EXPIRE_ONLY: kernel supports expiry-only entry invalidation
476  * CUSE INIT request/reply flags
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)
539  * Poll flags
541  * FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
592 	FUSE_FORGET		= 2,  /* no reply */
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