2 * This file defines the kernel interface of FUSE
3 * Copyright (C) 2001-2008 Miklos Szeredi <miklos@szeredi.hu>
5 * This program can be distributed under the terms of the GNU GPL.
6 * See the file COPYING.
8 * This -- and only this -- header file may also be distributed under
9 * the terms of the BSD Licence as follows:
11 * Copyright (C) 2001-2007 Miklos Szeredi. All rights reserved.
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
22 * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 * This file defines the kernel interface of FUSE
43 * - new fuse_getattr_in input argument of GETATTR
44 * - add lk_flags in fuse_lk_in
45 * - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
46 * - add blksize field to fuse_attr
47 * - add file flags field to fuse_read_in and fuse_write_in
50 * - add nonseekable open flag
54 * - add unsolicited notification support
57 * - add umask flag to input argument of open, mknod and mkdir
58 * - add notification messages for invalidation of inodes and
62 #ifndef _FUSE_FUSE_KERNEL_H
63 #define _FUSE_FUSE_KERNEL_H
66 #include <sys/types.h>
67 #define __u64 uint64_t
69 #define __u32 uint32_t
72 #include <linux/types.h>
75 /** Version number of this interface */
76 #define FUSE_KERNEL_VERSION 7
78 /** Minor version number of this interface */
79 #define FUSE_KERNEL_MINOR_VERSION 12
81 /** The node ID of the root inode */
82 #define FUSE_ROOT_ID 1
84 /* Make sure all structures are padded to 64bit boundary, so 32bit
85 userspace works under 64bit kernels */
106 struct fuse_kstatfs {
119 struct fuse_file_lock {
123 __u32 pid; /* tgid */
127 * Bitmasks for fuse_setattr_in.valid
129 #define FATTR_MODE (1 << 0)
130 #define FATTR_UID (1 << 1)
131 #define FATTR_GID (1 << 2)
132 #define FATTR_SIZE (1 << 3)
133 #define FATTR_ATIME (1 << 4)
134 #define FATTR_MTIME (1 << 5)
135 #define FATTR_FH (1 << 6)
136 #define FATTR_ATIME_NOW (1 << 7)
137 #define FATTR_MTIME_NOW (1 << 8)
138 #define FATTR_LOCKOWNER (1 << 9)
141 * Flags returned by the OPEN request
143 * FOPEN_DIRECT_IO: bypass page cache for this open file
144 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
145 * FOPEN_NONSEEKABLE: the file is not seekable
147 #define FOPEN_DIRECT_IO (1 << 0)
148 #define FOPEN_KEEP_CACHE (1 << 1)
149 #define FOPEN_NONSEEKABLE (1 << 2)
152 * INIT request/reply flags
154 * FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
155 * FUSE_DONT_MASK: don't apply umask to file mode on create operations
157 #define FUSE_ASYNC_READ (1 << 0)
158 #define FUSE_POSIX_LOCKS (1 << 1)
159 #define FUSE_FILE_OPS (1 << 2)
160 #define FUSE_ATOMIC_O_TRUNC (1 << 3)
161 #define FUSE_EXPORT_SUPPORT (1 << 4)
162 #define FUSE_BIG_WRITES (1 << 5)
163 #define FUSE_DONT_MASK (1 << 6)
167 * CUSE INIT request/reply flags
169 * CUSE_UNRESTRICTED_IOCTL: use unrestricted ioctl
171 #define CUSE_UNRESTRICTED_IOCTL (1 << 0)
177 #define FUSE_RELEASE_FLUSH (1 << 0)
182 #define FUSE_GETATTR_FH (1 << 0)
187 #define FUSE_LK_FLOCK (1 << 0)
192 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
193 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
195 #define FUSE_WRITE_CACHE (1 << 0)
196 #define FUSE_WRITE_LOCKOWNER (1 << 1)
201 #define FUSE_READ_LOCKOWNER (1 << 1)
206 * FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
207 * FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
208 * FUSE_IOCTL_RETRY: retry with new iovecs
210 * FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
212 #define FUSE_IOCTL_COMPAT (1 << 0)
213 #define FUSE_IOCTL_UNRESTRICTED (1 << 1)
214 #define FUSE_IOCTL_RETRY (1 << 2)
216 #define FUSE_IOCTL_MAX_IOV 256
221 * FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
223 #define FUSE_POLL_SCHEDULE_NOTIFY (1 << 0)
227 FUSE_FORGET = 2, /* no reply */
247 FUSE_REMOVEXATTR = 24,
252 FUSE_RELEASEDIR = 29,
266 /* CUSE specific operations */
271 enum fuse_notify_code {
272 FUSE_NOTIFY_POLL = 1,
273 FUSE_NOTIFY_INVAL_INODE = 2,
274 FUSE_NOTIFY_INVAL_ENTRY = 3,
275 FUSE_NOTIFY_CODE_MAX,
278 /* The read buffer is required to be at least 8k, but may be much larger */
279 #define FUSE_MIN_READ_BUFFER 8192
281 #define FUSE_COMPAT_ENTRY_OUT_SIZE 120
283 struct fuse_entry_out {
284 __u64 nodeid; /* Inode ID */
285 __u64 generation; /* Inode generation: nodeid:gen must
286 be unique for the fs's lifetime */
287 __u64 entry_valid; /* Cache timeout for the name */
288 __u64 attr_valid; /* Cache timeout for the attributes */
289 __u32 entry_valid_nsec;
290 __u32 attr_valid_nsec;
291 struct fuse_attr attr;
294 struct fuse_forget_in {
298 struct fuse_getattr_in {
304 #define FUSE_COMPAT_ATTR_OUT_SIZE 96
306 struct fuse_attr_out {
307 __u64 attr_valid; /* Cache timeout for the attributes */
308 __u32 attr_valid_nsec;
310 struct fuse_attr attr;
313 #define FUSE_COMPAT_MKNOD_IN_SIZE 8
315 struct fuse_mknod_in {
322 struct fuse_mkdir_in {
327 struct fuse_rename_in {
331 struct fuse_link_in {
335 struct fuse_setattr_in {
354 struct fuse_open_in {
359 struct fuse_create_in {
366 struct fuse_open_out {
372 struct fuse_release_in {
379 struct fuse_flush_in {
386 struct fuse_read_in {
396 #define FUSE_COMPAT_WRITE_IN_SIZE 24
398 struct fuse_write_in {
408 struct fuse_write_out {
413 #define FUSE_COMPAT_STATFS_SIZE 48
415 struct fuse_statfs_out {
416 struct fuse_kstatfs st;
419 struct fuse_fsync_in {
425 struct fuse_setxattr_in {
430 struct fuse_listxattr_in {
435 struct fuse_listxattr_out {
440 struct fuse_getxattr_in {
445 struct fuse_getxattr_out {
453 struct fuse_file_lock lk;
459 struct fuse_file_lock lk;
462 struct fuse_access_in {
467 struct fuse_init_in {
474 struct fuse_init_out {
484 #define CUSE_INIT_INFO_MAX 4096
486 struct cuse_init_in {
493 struct cuse_init_out {
500 __u32 dev_major; /* chardev major */
501 __u32 dev_minor; /* chardev minor */
506 struct fuse_interrupt_in {
510 struct fuse_bmap_in {
516 struct fuse_bmap_out {
520 struct fuse_ioctl_in {
529 struct fuse_ioctl_out {
536 struct fuse_poll_in {
543 struct fuse_poll_out {
548 struct fuse_notify_poll_wakeup_out {
552 struct fuse_in_header {
563 struct fuse_out_header {
577 #define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
578 #define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
579 #define FUSE_DIRENT_SIZE(d) \
580 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
582 struct fuse_notify_inval_inode_out {
588 struct fuse_notify_inval_entry_out {
594 #endif /* _FUSE_FUSE_KERNEL_H */