2 * This file defines the kernel interface of FUSE
3 * Copyright (C) 2001-2007 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
53 #ifndef _FUSE_FUSE_KERNEL_H
54 #define _FUSE_FUSE_KERNEL_H
57 #include <sys/types.h>
58 #define __u64 uint64_t
59 #define __u32 uint32_t
62 #include <asm/types.h>
63 #include <linux/major.h>
66 /** Version number of this interface */
67 #define FUSE_KERNEL_VERSION 7
69 /** Minor version number of this interface */
70 #define FUSE_KERNEL_MINOR_VERSION 10
72 /** The node ID of the root inode */
73 #define FUSE_ROOT_ID 1
75 /** The major number of the fuse character device */
76 #define FUSE_MAJOR MISC_MAJOR
78 /* Make sure all structures are padded to 64bit boundary, so 32bit
79 userspace works under 64bit kernels */
100 struct fuse_kstatfs {
113 struct fuse_file_lock {
117 __u32 pid; /* tgid */
121 * Bitmasks for fuse_setattr_in.valid
123 #define FATTR_MODE (1 << 0)
124 #define FATTR_UID (1 << 1)
125 #define FATTR_GID (1 << 2)
126 #define FATTR_SIZE (1 << 3)
127 #define FATTR_ATIME (1 << 4)
128 #define FATTR_MTIME (1 << 5)
129 #define FATTR_FH (1 << 6)
130 #define FATTR_ATIME_NOW (1 << 7)
131 #define FATTR_MTIME_NOW (1 << 8)
132 #define FATTR_LOCKOWNER (1 << 9)
135 * Flags returned by the OPEN request
137 * FOPEN_DIRECT_IO: bypass page cache for this open file
138 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
139 * FOPEN_NONSEEKABLE: the file is not seekable
141 #define FOPEN_DIRECT_IO (1 << 0)
142 #define FOPEN_KEEP_CACHE (1 << 1)
143 #define FOPEN_NONSEEKABLE (1 << 2)
146 * INIT request/reply flags
148 * FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
150 #define FUSE_ASYNC_READ (1 << 0)
151 #define FUSE_POSIX_LOCKS (1 << 1)
152 #define FUSE_FILE_OPS (1 << 2)
153 #define FUSE_ATOMIC_O_TRUNC (1 << 3)
154 #define FUSE_EXPORT_SUPPORT (1 << 4)
155 #define FUSE_BIG_WRITES (1 << 5)
160 #define FUSE_RELEASE_FLUSH (1 << 0)
165 #define FUSE_GETATTR_FH (1 << 0)
170 #define FUSE_LK_FLOCK (1 << 0)
175 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
176 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
178 #define FUSE_WRITE_CACHE (1 << 0)
179 #define FUSE_WRITE_LOCKOWNER (1 << 1)
184 #define FUSE_READ_LOCKOWNER (1 << 1)
188 FUSE_FORGET = 2, /* no reply */
208 FUSE_REMOVEXATTR = 24,
213 FUSE_RELEASEDIR = 29,
225 /* The read buffer is required to be at least 8k, but may be much larger */
226 #define FUSE_MIN_READ_BUFFER 8192
228 #define FUSE_COMPAT_ENTRY_OUT_SIZE 120
230 struct fuse_entry_out {
231 __u64 nodeid; /* Inode ID */
232 __u64 generation; /* Inode generation: nodeid:gen must
233 be unique for the fs's lifetime */
234 __u64 entry_valid; /* Cache timeout for the name */
235 __u64 attr_valid; /* Cache timeout for the attributes */
236 __u32 entry_valid_nsec;
237 __u32 attr_valid_nsec;
238 struct fuse_attr attr;
241 struct fuse_forget_in {
245 struct fuse_getattr_in {
251 #define FUSE_COMPAT_ATTR_OUT_SIZE 96
253 struct fuse_attr_out {
254 __u64 attr_valid; /* Cache timeout for the attributes */
255 __u32 attr_valid_nsec;
257 struct fuse_attr attr;
260 struct fuse_mknod_in {
265 struct fuse_mkdir_in {
270 struct fuse_rename_in {
274 struct fuse_link_in {
278 struct fuse_setattr_in {
297 struct fuse_open_in {
302 struct fuse_open_out {
308 struct fuse_release_in {
315 struct fuse_flush_in {
322 struct fuse_read_in {
332 #define FUSE_COMPAT_WRITE_IN_SIZE 24
334 struct fuse_write_in {
344 struct fuse_write_out {
349 #define FUSE_COMPAT_STATFS_SIZE 48
351 struct fuse_statfs_out {
352 struct fuse_kstatfs st;
355 struct fuse_fsync_in {
361 struct fuse_setxattr_in {
366 struct fuse_listxattr_in {
371 struct fuse_listxattr_out {
376 struct fuse_getxattr_in {
381 struct fuse_getxattr_out {
389 struct fuse_file_lock lk;
395 struct fuse_file_lock lk;
398 struct fuse_access_in {
403 struct fuse_init_in {
410 struct fuse_init_out {
419 struct fuse_interrupt_in {
423 struct fuse_bmap_in {
429 struct fuse_bmap_out {
433 struct fuse_in_header {
444 struct fuse_out_header {
458 #define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
459 #define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
460 #define FUSE_DIRENT_SIZE(d) \
461 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
463 #endif /* _FUSE_FUSE_KERNEL_H */