blob: 5c86f1196c3ad132ed714d2a07eb2bfed832bc47 [file] [log] [blame]
Miklos Szeredid8a5ba42005-09-09 13:10:26 -07001/*
2 FUSE: Filesystem in Userspace
Miklos Szeredi71421252006-06-25 05:48:52 -07003 Copyright (C) 2001-2006 Miklos Szeredi <miklos@szeredi.hu>
Miklos Szeredid8a5ba42005-09-09 13:10:26 -07004
5 This program can be distributed under the terms of the GNU GPL.
6 See the file COPYING.
7*/
8
Miklos Szeredic79e3222007-10-18 03:06:59 -07009/*
10 * This file defines the kernel interface of FUSE
11 *
12 * Protocol changelog:
13 *
14 * 7.9:
15 * - new fuse_getattr_in input argument of GETATTR
Miklos Szeredia9ff4f82007-10-18 03:07:02 -070016 * - add lk_flags in fuse_lk_in
Miklos Szeredif3332112007-10-18 03:07:04 -070017 * - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
Miklos Szeredi0e9663e2007-10-18 03:07:05 -070018 * - add blksize field to fuse_attr
Miklos Szeredia6643092007-11-28 16:22:00 -080019 * - add file flags field to fuse_read_in and fuse_write_in
Miklos Szeredic79e3222007-10-18 03:06:59 -070020 */
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070021
22#include <asm/types.h>
Jan Engelhardt3e8c54f2006-06-25 05:48:49 -070023#include <linux/major.h>
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070024
25/** Version number of this interface */
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070026#define FUSE_KERNEL_VERSION 7
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070027
28/** Minor version number of this interface */
Miklos Szeredic79e3222007-10-18 03:06:59 -070029#define FUSE_KERNEL_MINOR_VERSION 9
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070030
31/** The node ID of the root inode */
32#define FUSE_ROOT_ID 1
33
Miklos Szeredi334f4852005-09-09 13:10:27 -070034/** The major number of the fuse character device */
Jan Engelhardt3e8c54f2006-06-25 05:48:49 -070035#define FUSE_MAJOR MISC_MAJOR
Miklos Szeredi334f4852005-09-09 13:10:27 -070036
37/** The minor number of the fuse character device */
38#define FUSE_MINOR 229
39
Miklos Szeredi06663262005-09-09 13:10:32 -070040/* Make sure all structures are padded to 64bit boundary, so 32bit
41 userspace works under 64bit kernels */
42
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070043struct fuse_attr {
44 __u64 ino;
45 __u64 size;
46 __u64 blocks;
47 __u64 atime;
48 __u64 mtime;
49 __u64 ctime;
50 __u32 atimensec;
51 __u32 mtimensec;
52 __u32 ctimensec;
53 __u32 mode;
54 __u32 nlink;
55 __u32 uid;
56 __u32 gid;
57 __u32 rdev;
Miklos Szeredi0e9663e2007-10-18 03:07:05 -070058 __u32 blksize;
59 __u32 padding;
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070060};
61
Miklos Szeredie5e55582005-09-09 13:10:28 -070062struct fuse_kstatfs {
63 __u64 blocks;
64 __u64 bfree;
65 __u64 bavail;
66 __u64 files;
67 __u64 ffree;
68 __u32 bsize;
69 __u32 namelen;
Miklos Szeredide5f1202006-01-06 00:19:37 -080070 __u32 frsize;
71 __u32 padding;
72 __u32 spare[6];
Miklos Szeredie5e55582005-09-09 13:10:28 -070073};
74
Miklos Szeredi71421252006-06-25 05:48:52 -070075struct fuse_file_lock {
76 __u64 start;
77 __u64 end;
78 __u32 type;
79 __u32 pid; /* tgid */
80};
81
Miklos Szeredi9cd68452006-02-01 03:04:40 -080082/**
83 * Bitmasks for fuse_setattr_in.valid
84 */
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070085#define FATTR_MODE (1 << 0)
86#define FATTR_UID (1 << 1)
87#define FATTR_GID (1 << 2)
88#define FATTR_SIZE (1 << 3)
89#define FATTR_ATIME (1 << 4)
90#define FATTR_MTIME (1 << 5)
Miklos Szeredibefc6492005-11-07 00:59:52 -080091#define FATTR_FH (1 << 6)
Miklos Szeredi17637cb2007-10-18 03:07:01 -070092#define FATTR_ATIME_NOW (1 << 7)
93#define FATTR_MTIME_NOW (1 << 8)
Miklos Szeredif3332112007-10-18 03:07:04 -070094#define FATTR_LOCKOWNER (1 << 9)
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070095
Miklos Szeredi45323fb2005-09-09 13:10:37 -070096/**
97 * Flags returned by the OPEN request
98 *
99 * FOPEN_DIRECT_IO: bypass page cache for this open file
100 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
101 */
102#define FOPEN_DIRECT_IO (1 << 0)
103#define FOPEN_KEEP_CACHE (1 << 1)
104
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800105/**
106 * INIT request/reply flags
107 */
108#define FUSE_ASYNC_READ (1 << 0)
Miklos Szeredi71421252006-06-25 05:48:52 -0700109#define FUSE_POSIX_LOCKS (1 << 1)
Miklos Szeredic79e3222007-10-18 03:06:59 -0700110#define FUSE_FILE_OPS (1 << 2)
Miklos Szeredi6ff958e2007-10-18 03:07:02 -0700111#define FUSE_ATOMIC_O_TRUNC (1 << 3)
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800112
Miklos Szeredie9168c12006-12-06 20:35:38 -0800113/**
114 * Release flags
115 */
116#define FUSE_RELEASE_FLUSH (1 << 0)
117
Miklos Szeredic79e3222007-10-18 03:06:59 -0700118/**
119 * Getattr flags
120 */
121#define FUSE_GETATTR_FH (1 << 0)
122
Miklos Szeredia9ff4f82007-10-18 03:07:02 -0700123/**
124 * Lock flags
125 */
126#define FUSE_LK_FLOCK (1 << 0)
127
Miklos Szeredib25e82e2007-10-18 03:07:03 -0700128/**
129 * WRITE flags
130 *
131 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
Miklos Szeredif3332112007-10-18 03:07:04 -0700132 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
Miklos Szeredib25e82e2007-10-18 03:07:03 -0700133 */
134#define FUSE_WRITE_CACHE (1 << 0)
Miklos Szeredif3332112007-10-18 03:07:04 -0700135#define FUSE_WRITE_LOCKOWNER (1 << 1)
136
137/**
138 * Read flags
139 */
140#define FUSE_READ_LOCKOWNER (1 << 1)
Miklos Szeredib25e82e2007-10-18 03:07:03 -0700141
Miklos Szeredi334f4852005-09-09 13:10:27 -0700142enum fuse_opcode {
Miklos Szeredie5e55582005-09-09 13:10:28 -0700143 FUSE_LOOKUP = 1,
144 FUSE_FORGET = 2, /* no reply */
145 FUSE_GETATTR = 3,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700146 FUSE_SETATTR = 4,
Miklos Szeredie5e55582005-09-09 13:10:28 -0700147 FUSE_READLINK = 5,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700148 FUSE_SYMLINK = 6,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700149 FUSE_MKNOD = 8,
150 FUSE_MKDIR = 9,
151 FUSE_UNLINK = 10,
152 FUSE_RMDIR = 11,
153 FUSE_RENAME = 12,
154 FUSE_LINK = 13,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700155 FUSE_OPEN = 14,
156 FUSE_READ = 15,
157 FUSE_WRITE = 16,
Miklos Szeredie5e55582005-09-09 13:10:28 -0700158 FUSE_STATFS = 17,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700159 FUSE_RELEASE = 18,
160 FUSE_FSYNC = 20,
Miklos Szeredi92a87802005-09-09 13:10:31 -0700161 FUSE_SETXATTR = 21,
162 FUSE_GETXATTR = 22,
163 FUSE_LISTXATTR = 23,
164 FUSE_REMOVEXATTR = 24,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700165 FUSE_FLUSH = 25,
Miklos Szeredi04730fe2005-09-09 13:10:36 -0700166 FUSE_INIT = 26,
167 FUSE_OPENDIR = 27,
168 FUSE_READDIR = 28,
Miklos Szeredi82547982005-09-09 13:10:38 -0700169 FUSE_RELEASEDIR = 29,
Miklos Szeredi31d40d72005-11-07 00:59:50 -0800170 FUSE_FSYNCDIR = 30,
Miklos Szeredi71421252006-06-25 05:48:52 -0700171 FUSE_GETLK = 31,
172 FUSE_SETLK = 32,
173 FUSE_SETLKW = 33,
Miklos Szeredifd72faa2005-11-07 00:59:51 -0800174 FUSE_ACCESS = 34,
Miklos Szeredia4d27e72006-06-25 05:48:54 -0700175 FUSE_CREATE = 35,
176 FUSE_INTERRUPT = 36,
Miklos Szeredib2d22722006-12-06 20:35:51 -0800177 FUSE_BMAP = 37,
Miklos Szeredi0ec7ca42006-12-06 20:35:52 -0800178 FUSE_DESTROY = 38,
Miklos Szeredi334f4852005-09-09 13:10:27 -0700179};
180
Miklos Szeredi1d3d7522006-01-06 00:19:40 -0800181/* The read buffer is required to be at least 8k, but may be much larger */
182#define FUSE_MIN_READ_BUFFER 8192
Miklos Szeredie5e55582005-09-09 13:10:28 -0700183
Miklos Szeredi0e9663e2007-10-18 03:07:05 -0700184#define FUSE_COMPAT_ENTRY_OUT_SIZE 120
185
Miklos Szeredie5e55582005-09-09 13:10:28 -0700186struct fuse_entry_out {
187 __u64 nodeid; /* Inode ID */
188 __u64 generation; /* Inode generation: nodeid:gen must
189 be unique for the fs's lifetime */
190 __u64 entry_valid; /* Cache timeout for the name */
191 __u64 attr_valid; /* Cache timeout for the attributes */
192 __u32 entry_valid_nsec;
193 __u32 attr_valid_nsec;
194 struct fuse_attr attr;
195};
196
197struct fuse_forget_in {
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700198 __u64 nlookup;
Miklos Szeredie5e55582005-09-09 13:10:28 -0700199};
200
Miklos Szeredic79e3222007-10-18 03:06:59 -0700201struct fuse_getattr_in {
202 __u32 getattr_flags;
203 __u32 dummy;
204 __u64 fh;
205};
206
Miklos Szeredi0e9663e2007-10-18 03:07:05 -0700207#define FUSE_COMPAT_ATTR_OUT_SIZE 96
208
Miklos Szeredie5e55582005-09-09 13:10:28 -0700209struct fuse_attr_out {
210 __u64 attr_valid; /* Cache timeout for the attributes */
211 __u32 attr_valid_nsec;
212 __u32 dummy;
213 struct fuse_attr attr;
214};
215
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700216struct fuse_mknod_in {
217 __u32 mode;
218 __u32 rdev;
219};
220
221struct fuse_mkdir_in {
222 __u32 mode;
Miklos Szeredi06663262005-09-09 13:10:32 -0700223 __u32 padding;
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700224};
225
226struct fuse_rename_in {
227 __u64 newdir;
228};
229
230struct fuse_link_in {
231 __u64 oldnodeid;
232};
233
234struct fuse_setattr_in {
235 __u32 valid;
Miklos Szeredi06663262005-09-09 13:10:32 -0700236 __u32 padding;
Miklos Szeredibefc6492005-11-07 00:59:52 -0800237 __u64 fh;
238 __u64 size;
Miklos Szeredif3332112007-10-18 03:07:04 -0700239 __u64 lock_owner;
Miklos Szeredibefc6492005-11-07 00:59:52 -0800240 __u64 atime;
241 __u64 mtime;
242 __u64 unused2;
243 __u32 atimensec;
244 __u32 mtimensec;
245 __u32 unused3;
246 __u32 mode;
247 __u32 unused4;
248 __u32 uid;
249 __u32 gid;
250 __u32 unused5;
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700251};
252
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700253struct fuse_open_in {
254 __u32 flags;
Miklos Szeredifd72faa2005-11-07 00:59:51 -0800255 __u32 mode;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700256};
257
258struct fuse_open_out {
259 __u64 fh;
260 __u32 open_flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700261 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700262};
263
264struct fuse_release_in {
265 __u64 fh;
266 __u32 flags;
Miklos Szeredie9168c12006-12-06 20:35:38 -0800267 __u32 release_flags;
268 __u64 lock_owner;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700269};
270
271struct fuse_flush_in {
272 __u64 fh;
Miklos Szeredie9168c12006-12-06 20:35:38 -0800273 __u32 unused;
Miklos Szeredi06663262005-09-09 13:10:32 -0700274 __u32 padding;
Miklos Szeredi71421252006-06-25 05:48:52 -0700275 __u64 lock_owner;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700276};
277
278struct fuse_read_in {
279 __u64 fh;
280 __u64 offset;
281 __u32 size;
Miklos Szeredif3332112007-10-18 03:07:04 -0700282 __u32 read_flags;
283 __u64 lock_owner;
Miklos Szeredia6643092007-11-28 16:22:00 -0800284 __u32 flags;
285 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700286};
287
Miklos Szeredif3332112007-10-18 03:07:04 -0700288#define FUSE_COMPAT_WRITE_IN_SIZE 24
289
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700290struct fuse_write_in {
291 __u64 fh;
292 __u64 offset;
293 __u32 size;
294 __u32 write_flags;
Miklos Szeredif3332112007-10-18 03:07:04 -0700295 __u64 lock_owner;
Miklos Szeredia6643092007-11-28 16:22:00 -0800296 __u32 flags;
297 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700298};
299
300struct fuse_write_out {
301 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700302 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700303};
304
Miklos Szeredide5f1202006-01-06 00:19:37 -0800305#define FUSE_COMPAT_STATFS_SIZE 48
306
Miklos Szeredie5e55582005-09-09 13:10:28 -0700307struct fuse_statfs_out {
308 struct fuse_kstatfs st;
309};
310
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700311struct fuse_fsync_in {
312 __u64 fh;
313 __u32 fsync_flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700314 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700315};
316
Miklos Szeredi92a87802005-09-09 13:10:31 -0700317struct fuse_setxattr_in {
318 __u32 size;
319 __u32 flags;
320};
321
322struct fuse_getxattr_in {
323 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700324 __u32 padding;
Miklos Szeredi92a87802005-09-09 13:10:31 -0700325};
326
327struct fuse_getxattr_out {
328 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700329 __u32 padding;
Miklos Szeredi92a87802005-09-09 13:10:31 -0700330};
331
Miklos Szeredi71421252006-06-25 05:48:52 -0700332struct fuse_lk_in {
333 __u64 fh;
334 __u64 owner;
335 struct fuse_file_lock lk;
Miklos Szeredia9ff4f82007-10-18 03:07:02 -0700336 __u32 lk_flags;
337 __u32 padding;
Miklos Szeredi71421252006-06-25 05:48:52 -0700338};
339
340struct fuse_lk_out {
341 struct fuse_file_lock lk;
342};
343
Miklos Szeredi31d40d72005-11-07 00:59:50 -0800344struct fuse_access_in {
345 __u32 mask;
346 __u32 padding;
347};
348
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800349struct fuse_init_in {
Miklos Szeredi334f4852005-09-09 13:10:27 -0700350 __u32 major;
351 __u32 minor;
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800352 __u32 max_readahead;
353 __u32 flags;
Miklos Szeredi334f4852005-09-09 13:10:27 -0700354};
355
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800356struct fuse_init_out {
357 __u32 major;
358 __u32 minor;
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800359 __u32 max_readahead;
360 __u32 flags;
361 __u32 unused;
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800362 __u32 max_write;
363};
364
Miklos Szeredia4d27e72006-06-25 05:48:54 -0700365struct fuse_interrupt_in {
366 __u64 unique;
367};
368
Miklos Szeredib2d22722006-12-06 20:35:51 -0800369struct fuse_bmap_in {
370 __u64 block;
371 __u32 blocksize;
372 __u32 padding;
373};
374
375struct fuse_bmap_out {
376 __u64 block;
377};
378
Miklos Szeredi334f4852005-09-09 13:10:27 -0700379struct fuse_in_header {
380 __u32 len;
381 __u32 opcode;
382 __u64 unique;
383 __u64 nodeid;
384 __u32 uid;
385 __u32 gid;
386 __u32 pid;
Miklos Szeredi06663262005-09-09 13:10:32 -0700387 __u32 padding;
Miklos Szeredi334f4852005-09-09 13:10:27 -0700388};
389
390struct fuse_out_header {
391 __u32 len;
392 __s32 error;
393 __u64 unique;
394};
395
Miklos Szeredie5e55582005-09-09 13:10:28 -0700396struct fuse_dirent {
397 __u64 ino;
398 __u64 off;
399 __u32 namelen;
400 __u32 type;
401 char name[0];
402};
403
Andrew Morton21f3da92007-07-15 23:39:50 -0700404#define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
Miklos Szeredie5e55582005-09-09 13:10:28 -0700405#define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
406#define FUSE_DIRENT_SIZE(d) \
407 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)