Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mszeredi...
[deliverable/linux.git] / include / linux / fuse.h
CommitLineData
d8a5ba45
MS
1/*
2 FUSE: Filesystem in Userspace
1f55ed06 3 Copyright (C) 2001-2008 Miklos Szeredi <miklos@szeredi.hu>
d8a5ba45
MS
4
5 This program can be distributed under the terms of the GNU GPL.
6 See the file COPYING.
7*/
8
c79e322f
MS
9/*
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
a9ff4f87 16 * - add lk_flags in fuse_lk_in
f3332114 17 * - add lock_owner field to fuse_setattr_in, fuse_read_in and fuse_write_in
0e9663ee 18 * - add blksize field to fuse_attr
a6643094 19 * - add file flags field to fuse_read_in and fuse_write_in
a7c1b990
TH
20 *
21 * 7.10
22 * - add nonseekable open flag
1f55ed06
MS
23 *
24 * 7.11
25 * - add IOCTL message
26 * - add unsolicited notification support
27 * - add POLL message and NOTIFY_POLL notification
e0a43ddc
MS
28 *
29 * 7.12
30 * - add umask flag to input argument of open, mknod and mkdir
3b463ae0
JM
31 * - add notification messages for invalidation of inodes and
32 * directory entries
7a6d3c8b
CH
33 *
34 * 7.13
35 * - make max number of background requests and congestion threshold
36 * tunables
dd3bb14f
MS
37 *
38 * 7.14
39 * - add splice support to fuse device
a1d75f25
MS
40 *
41 * 7.15
42 * - add store notify
2d45ba38 43 * - add retrieve notify
02c048b9
MS
44 *
45 * 7.16
46 * - add BATCH_FORGET request
1baa26b2
MS
47 * - FUSE_IOCTL_UNRESTRICTED shall now return with array of 'struct
48 * fuse_ioctl_iovec' instead of ambiguous 'struct iovec'
49 * - add FUSE_IOCTL_32BIT flag
37fb3a30
MS
50 *
51 * 7.17
52 * - add FUSE_FLOCK_LOCKS and FUSE_RELEASE_FLOCK_UNLOCK
b18da0c5
MS
53 *
54 * 7.18
55 * - add FUSE_IOCTL_DIR flag
451d0f59 56 * - add FUSE_NOTIFY_DELETE
05ba1f08
AP
57 *
58 * 7.19
59 * - add FUSE_FALLOCATE
c79e322f 60 */
d8a5ba45 61
29d434b3
TH
62#ifndef _LINUX_FUSE_H
63#define _LINUX_FUSE_H
64
1f55ed06 65#include <linux/types.h>
d8a5ba45 66
37d217f0
MS
67/*
68 * Version negotiation:
69 *
70 * Both the kernel and userspace send the version they support in the
71 * INIT request and reply respectively.
72 *
73 * If the major versions match then both shall use the smallest
74 * of the two minor versions for communication.
75 *
76 * If the kernel supports a larger major version, then userspace shall
77 * reply with the major version it supports, ignore the rest of the
78 * INIT message and expect a new INIT message from the kernel with a
79 * matching major version.
80 *
81 * If the library supports a larger major version, then it shall fall
82 * back to the major protocol version sent by the kernel for
83 * communication and reply with that major version (and an arbitrary
84 * supported minor version).
85 */
86
d8a5ba45 87/** Version number of this interface */
9e6268db 88#define FUSE_KERNEL_VERSION 7
d8a5ba45
MS
89
90/** Minor version number of this interface */
05ba1f08 91#define FUSE_KERNEL_MINOR_VERSION 19
d8a5ba45
MS
92
93/** The node ID of the root inode */
94#define FUSE_ROOT_ID 1
95
06663267
MS
96/* Make sure all structures are padded to 64bit boundary, so 32bit
97 userspace works under 64bit kernels */
98
d8a5ba45
MS
99struct fuse_attr {
100 __u64 ino;
101 __u64 size;
102 __u64 blocks;
103 __u64 atime;
104 __u64 mtime;
105 __u64 ctime;
106 __u32 atimensec;
107 __u32 mtimensec;
108 __u32 ctimensec;
109 __u32 mode;
110 __u32 nlink;
111 __u32 uid;
112 __u32 gid;
113 __u32 rdev;
0e9663ee
MS
114 __u32 blksize;
115 __u32 padding;
d8a5ba45
MS
116};
117
e5e5558e
MS
118struct fuse_kstatfs {
119 __u64 blocks;
120 __u64 bfree;
121 __u64 bavail;
122 __u64 files;
123 __u64 ffree;
124 __u32 bsize;
125 __u32 namelen;
de5f1202
MS
126 __u32 frsize;
127 __u32 padding;
128 __u32 spare[6];
e5e5558e
MS
129};
130
71421259
MS
131struct fuse_file_lock {
132 __u64 start;
133 __u64 end;
134 __u32 type;
135 __u32 pid; /* tgid */
136};
137
9cd68455
MS
138/**
139 * Bitmasks for fuse_setattr_in.valid
140 */
9e6268db
MS
141#define FATTR_MODE (1 << 0)
142#define FATTR_UID (1 << 1)
143#define FATTR_GID (1 << 2)
144#define FATTR_SIZE (1 << 3)
145#define FATTR_ATIME (1 << 4)
146#define FATTR_MTIME (1 << 5)
befc649c 147#define FATTR_FH (1 << 6)
17637cba
MS
148#define FATTR_ATIME_NOW (1 << 7)
149#define FATTR_MTIME_NOW (1 << 8)
f3332114 150#define FATTR_LOCKOWNER (1 << 9)
9e6268db 151
45323fb7
MS
152/**
153 * Flags returned by the OPEN request
154 *
155 * FOPEN_DIRECT_IO: bypass page cache for this open file
156 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
a7c1b990 157 * FOPEN_NONSEEKABLE: the file is not seekable
45323fb7
MS
158 */
159#define FOPEN_DIRECT_IO (1 << 0)
160#define FOPEN_KEEP_CACHE (1 << 1)
a7c1b990 161#define FOPEN_NONSEEKABLE (1 << 2)
45323fb7 162
9cd68455
MS
163/**
164 * INIT request/reply flags
33670fa2 165 *
37fb3a30 166 * FUSE_POSIX_LOCKS: remote locking for POSIX file locks
33670fa2 167 * FUSE_EXPORT_SUPPORT: filesystem handles lookups of "." and ".."
e0a43ddc 168 * FUSE_DONT_MASK: don't apply umask to file mode on create operations
37fb3a30 169 * FUSE_FLOCK_LOCKS: remote locking for BSD style file locks
9cd68455
MS
170 */
171#define FUSE_ASYNC_READ (1 << 0)
71421259 172#define FUSE_POSIX_LOCKS (1 << 1)
c79e322f 173#define FUSE_FILE_OPS (1 << 2)
6ff958ed 174#define FUSE_ATOMIC_O_TRUNC (1 << 3)
33670fa2 175#define FUSE_EXPORT_SUPPORT (1 << 4)
78bb6cb9 176#define FUSE_BIG_WRITES (1 << 5)
e0a43ddc 177#define FUSE_DONT_MASK (1 << 6)
37fb3a30 178#define FUSE_FLOCK_LOCKS (1 << 10)
9cd68455 179
151060ac
TH
180/**
181 * CUSE INIT request/reply flags
182 *
183 * CUSE_UNRESTRICTED_IOCTL: use unrestricted ioctl
184 */
185#define CUSE_UNRESTRICTED_IOCTL (1 << 0)
186
e9168c18
MS
187/**
188 * Release flags
189 */
190#define FUSE_RELEASE_FLUSH (1 << 0)
37fb3a30 191#define FUSE_RELEASE_FLOCK_UNLOCK (1 << 1)
e9168c18 192
c79e322f
MS
193/**
194 * Getattr flags
195 */
196#define FUSE_GETATTR_FH (1 << 0)
197
a9ff4f87
MS
198/**
199 * Lock flags
200 */
201#define FUSE_LK_FLOCK (1 << 0)
202
b25e82e5
MS
203/**
204 * WRITE flags
205 *
206 * FUSE_WRITE_CACHE: delayed write from page cache, file handle is guessed
f3332114 207 * FUSE_WRITE_LOCKOWNER: lock_owner field is valid
b25e82e5
MS
208 */
209#define FUSE_WRITE_CACHE (1 << 0)
f3332114
MS
210#define FUSE_WRITE_LOCKOWNER (1 << 1)
211
212/**
213 * Read flags
214 */
215#define FUSE_READ_LOCKOWNER (1 << 1)
b25e82e5 216
59efec7b
TH
217/**
218 * Ioctl flags
219 *
220 * FUSE_IOCTL_COMPAT: 32bit compat ioctl on 64bit machine
221 * FUSE_IOCTL_UNRESTRICTED: not restricted to well-formed ioctls, retry allowed
222 * FUSE_IOCTL_RETRY: retry with new iovecs
1baa26b2 223 * FUSE_IOCTL_32BIT: 32bit ioctl
b18da0c5 224 * FUSE_IOCTL_DIR: is a directory
59efec7b
TH
225 *
226 * FUSE_IOCTL_MAX_IOV: maximum of in_iovecs + out_iovecs
227 */
228#define FUSE_IOCTL_COMPAT (1 << 0)
229#define FUSE_IOCTL_UNRESTRICTED (1 << 1)
230#define FUSE_IOCTL_RETRY (1 << 2)
1baa26b2 231#define FUSE_IOCTL_32BIT (1 << 3)
b18da0c5 232#define FUSE_IOCTL_DIR (1 << 4)
59efec7b
TH
233
234#define FUSE_IOCTL_MAX_IOV 256
235
95668a69
TH
236/**
237 * Poll flags
238 *
239 * FUSE_POLL_SCHEDULE_NOTIFY: request poll notify
240 */
241#define FUSE_POLL_SCHEDULE_NOTIFY (1 << 0)
242
334f485d 243enum fuse_opcode {
e5e5558e
MS
244 FUSE_LOOKUP = 1,
245 FUSE_FORGET = 2, /* no reply */
246 FUSE_GETATTR = 3,
9e6268db 247 FUSE_SETATTR = 4,
e5e5558e 248 FUSE_READLINK = 5,
9e6268db 249 FUSE_SYMLINK = 6,
9e6268db
MS
250 FUSE_MKNOD = 8,
251 FUSE_MKDIR = 9,
252 FUSE_UNLINK = 10,
253 FUSE_RMDIR = 11,
254 FUSE_RENAME = 12,
255 FUSE_LINK = 13,
b6aeaded
MS
256 FUSE_OPEN = 14,
257 FUSE_READ = 15,
258 FUSE_WRITE = 16,
e5e5558e 259 FUSE_STATFS = 17,
b6aeaded
MS
260 FUSE_RELEASE = 18,
261 FUSE_FSYNC = 20,
92a8780e
MS
262 FUSE_SETXATTR = 21,
263 FUSE_GETXATTR = 22,
264 FUSE_LISTXATTR = 23,
265 FUSE_REMOVEXATTR = 24,
b6aeaded 266 FUSE_FLUSH = 25,
04730fef
MS
267 FUSE_INIT = 26,
268 FUSE_OPENDIR = 27,
269 FUSE_READDIR = 28,
82547981 270 FUSE_RELEASEDIR = 29,
31d40d74 271 FUSE_FSYNCDIR = 30,
71421259
MS
272 FUSE_GETLK = 31,
273 FUSE_SETLK = 32,
274 FUSE_SETLKW = 33,
fd72faac 275 FUSE_ACCESS = 34,
a4d27e75
MS
276 FUSE_CREATE = 35,
277 FUSE_INTERRUPT = 36,
b2d2272f 278 FUSE_BMAP = 37,
0ec7ca41 279 FUSE_DESTROY = 38,
59efec7b 280 FUSE_IOCTL = 39,
95668a69 281 FUSE_POLL = 40,
2d45ba38 282 FUSE_NOTIFY_REPLY = 41,
02c048b9 283 FUSE_BATCH_FORGET = 42,
05ba1f08 284 FUSE_FALLOCATE = 43,
151060ac
TH
285
286 /* CUSE specific operations */
287 CUSE_INIT = 4096,
334f485d
MS
288};
289
8599396b 290enum fuse_notify_code {
95668a69 291 FUSE_NOTIFY_POLL = 1,
3b463ae0
JM
292 FUSE_NOTIFY_INVAL_INODE = 2,
293 FUSE_NOTIFY_INVAL_ENTRY = 3,
a1d75f25 294 FUSE_NOTIFY_STORE = 4,
2d45ba38 295 FUSE_NOTIFY_RETRIEVE = 5,
451d0f59 296 FUSE_NOTIFY_DELETE = 6,
8599396b
TH
297 FUSE_NOTIFY_CODE_MAX,
298};
299
1d3d752b
MS
300/* The read buffer is required to be at least 8k, but may be much larger */
301#define FUSE_MIN_READ_BUFFER 8192
e5e5558e 302
0e9663ee
MS
303#define FUSE_COMPAT_ENTRY_OUT_SIZE 120
304
e5e5558e
MS
305struct fuse_entry_out {
306 __u64 nodeid; /* Inode ID */
307 __u64 generation; /* Inode generation: nodeid:gen must
308 be unique for the fs's lifetime */
309 __u64 entry_valid; /* Cache timeout for the name */
310 __u64 attr_valid; /* Cache timeout for the attributes */
311 __u32 entry_valid_nsec;
312 __u32 attr_valid_nsec;
313 struct fuse_attr attr;
314};
315
316struct fuse_forget_in {
9e6268db 317 __u64 nlookup;
e5e5558e
MS
318};
319
02c048b9
MS
320struct fuse_forget_one {
321 __u64 nodeid;
322 __u64 nlookup;
323};
324
325struct fuse_batch_forget_in {
326 __u32 count;
327 __u32 dummy;
328};
329
c79e322f
MS
330struct fuse_getattr_in {
331 __u32 getattr_flags;
332 __u32 dummy;
333 __u64 fh;
334};
335
0e9663ee
MS
336#define FUSE_COMPAT_ATTR_OUT_SIZE 96
337
e5e5558e
MS
338struct fuse_attr_out {
339 __u64 attr_valid; /* Cache timeout for the attributes */
340 __u32 attr_valid_nsec;
341 __u32 dummy;
342 struct fuse_attr attr;
343};
344
e0a43ddc
MS
345#define FUSE_COMPAT_MKNOD_IN_SIZE 8
346
9e6268db
MS
347struct fuse_mknod_in {
348 __u32 mode;
349 __u32 rdev;
e0a43ddc
MS
350 __u32 umask;
351 __u32 padding;
9e6268db
MS
352};
353
354struct fuse_mkdir_in {
355 __u32 mode;
e0a43ddc 356 __u32 umask;
9e6268db
MS
357};
358
359struct fuse_rename_in {
360 __u64 newdir;
361};
362
363struct fuse_link_in {
364 __u64 oldnodeid;
365};
366
367struct fuse_setattr_in {
368 __u32 valid;
06663267 369 __u32 padding;
befc649c
MS
370 __u64 fh;
371 __u64 size;
f3332114 372 __u64 lock_owner;
befc649c
MS
373 __u64 atime;
374 __u64 mtime;
375 __u64 unused2;
376 __u32 atimensec;
377 __u32 mtimensec;
378 __u32 unused3;
379 __u32 mode;
380 __u32 unused4;
381 __u32 uid;
382 __u32 gid;
383 __u32 unused5;
9e6268db
MS
384};
385
b6aeaded 386struct fuse_open_in {
e0a43ddc
MS
387 __u32 flags;
388 __u32 unused;
389};
390
391struct fuse_create_in {
b6aeaded 392 __u32 flags;
fd72faac 393 __u32 mode;
e0a43ddc
MS
394 __u32 umask;
395 __u32 padding;
b6aeaded
MS
396};
397
398struct fuse_open_out {
399 __u64 fh;
400 __u32 open_flags;
06663267 401 __u32 padding;
b6aeaded
MS
402};
403
404struct fuse_release_in {
405 __u64 fh;
406 __u32 flags;
e9168c18
MS
407 __u32 release_flags;
408 __u64 lock_owner;
b6aeaded
MS
409};
410
411struct fuse_flush_in {
412 __u64 fh;
e9168c18 413 __u32 unused;
06663267 414 __u32 padding;
71421259 415 __u64 lock_owner;
b6aeaded
MS
416};
417
418struct fuse_read_in {
419 __u64 fh;
420 __u64 offset;
421 __u32 size;
f3332114
MS
422 __u32 read_flags;
423 __u64 lock_owner;
a6643094
MS
424 __u32 flags;
425 __u32 padding;
b6aeaded
MS
426};
427
f3332114
MS
428#define FUSE_COMPAT_WRITE_IN_SIZE 24
429
b6aeaded
MS
430struct fuse_write_in {
431 __u64 fh;
432 __u64 offset;
433 __u32 size;
434 __u32 write_flags;
f3332114 435 __u64 lock_owner;
a6643094
MS
436 __u32 flags;
437 __u32 padding;
b6aeaded
MS
438};
439
440struct fuse_write_out {
441 __u32 size;
06663267 442 __u32 padding;
b6aeaded
MS
443};
444
de5f1202
MS
445#define FUSE_COMPAT_STATFS_SIZE 48
446
e5e5558e
MS
447struct fuse_statfs_out {
448 struct fuse_kstatfs st;
449};
450
b6aeaded
MS
451struct fuse_fsync_in {
452 __u64 fh;
453 __u32 fsync_flags;
06663267 454 __u32 padding;
b6aeaded
MS
455};
456
92a8780e
MS
457struct fuse_setxattr_in {
458 __u32 size;
459 __u32 flags;
460};
461
462struct fuse_getxattr_in {
463 __u32 size;
06663267 464 __u32 padding;
92a8780e
MS
465};
466
467struct fuse_getxattr_out {
468 __u32 size;
06663267 469 __u32 padding;
92a8780e
MS
470};
471
71421259
MS
472struct fuse_lk_in {
473 __u64 fh;
474 __u64 owner;
475 struct fuse_file_lock lk;
a9ff4f87
MS
476 __u32 lk_flags;
477 __u32 padding;
71421259
MS
478};
479
480struct fuse_lk_out {
481 struct fuse_file_lock lk;
482};
483
31d40d74
MS
484struct fuse_access_in {
485 __u32 mask;
486 __u32 padding;
487};
488
3ec870d5 489struct fuse_init_in {
334f485d
MS
490 __u32 major;
491 __u32 minor;
9cd68455
MS
492 __u32 max_readahead;
493 __u32 flags;
334f485d
MS
494};
495
3ec870d5
MS
496struct fuse_init_out {
497 __u32 major;
498 __u32 minor;
9cd68455
MS
499 __u32 max_readahead;
500 __u32 flags;
7a6d3c8b
CH
501 __u16 max_background;
502 __u16 congestion_threshold;
3ec870d5
MS
503 __u32 max_write;
504};
505
151060ac
TH
506#define CUSE_INIT_INFO_MAX 4096
507
508struct cuse_init_in {
509 __u32 major;
510 __u32 minor;
511 __u32 unused;
512 __u32 flags;
513};
514
515struct cuse_init_out {
516 __u32 major;
517 __u32 minor;
518 __u32 unused;
519 __u32 flags;
520 __u32 max_read;
521 __u32 max_write;
522 __u32 dev_major; /* chardev major */
523 __u32 dev_minor; /* chardev minor */
524 __u32 spare[10];
525};
526
a4d27e75
MS
527struct fuse_interrupt_in {
528 __u64 unique;
529};
530
b2d2272f
MS
531struct fuse_bmap_in {
532 __u64 block;
533 __u32 blocksize;
534 __u32 padding;
535};
536
537struct fuse_bmap_out {
538 __u64 block;
539};
540
59efec7b
TH
541struct fuse_ioctl_in {
542 __u64 fh;
543 __u32 flags;
544 __u32 cmd;
545 __u64 arg;
546 __u32 in_size;
547 __u32 out_size;
548};
549
1baa26b2
MS
550struct fuse_ioctl_iovec {
551 __u64 base;
552 __u64 len;
553};
554
59efec7b
TH
555struct fuse_ioctl_out {
556 __s32 result;
557 __u32 flags;
558 __u32 in_iovs;
559 __u32 out_iovs;
560};
561
95668a69
TH
562struct fuse_poll_in {
563 __u64 fh;
564 __u64 kh;
565 __u32 flags;
566 __u32 padding;
567};
568
569struct fuse_poll_out {
570 __u32 revents;
571 __u32 padding;
572};
573
574struct fuse_notify_poll_wakeup_out {
575 __u64 kh;
576};
577
05ba1f08
AP
578struct fuse_fallocate_in {
579 __u64 fh;
580 __u64 offset;
581 __u64 length;
582 __u32 mode;
583 __u32 padding;
584};
585
334f485d
MS
586struct fuse_in_header {
587 __u32 len;
588 __u32 opcode;
589 __u64 unique;
590 __u64 nodeid;
591 __u32 uid;
592 __u32 gid;
593 __u32 pid;
06663267 594 __u32 padding;
334f485d
MS
595};
596
597struct fuse_out_header {
598 __u32 len;
599 __s32 error;
600 __u64 unique;
601};
602
e5e5558e
MS
603struct fuse_dirent {
604 __u64 ino;
605 __u64 off;
606 __u32 namelen;
607 __u32 type;
c628ee67 608 char name[];
e5e5558e
MS
609};
610
21f3da95 611#define FUSE_NAME_OFFSET offsetof(struct fuse_dirent, name)
e5e5558e
MS
612#define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
613#define FUSE_DIRENT_SIZE(d) \
614 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)
29d434b3 615
3b463ae0
JM
616struct fuse_notify_inval_inode_out {
617 __u64 ino;
618 __s64 off;
619 __s64 len;
620};
621
622struct fuse_notify_inval_entry_out {
623 __u64 parent;
624 __u32 namelen;
625 __u32 padding;
626};
627
451d0f59
JM
628struct fuse_notify_delete_out {
629 __u64 parent;
630 __u64 child;
631 __u32 namelen;
632 __u32 padding;
633};
634
a1d75f25
MS
635struct fuse_notify_store_out {
636 __u64 nodeid;
637 __u64 offset;
638 __u32 size;
639 __u32 padding;
640};
641
2d45ba38
MS
642struct fuse_notify_retrieve_out {
643 __u64 notify_unique;
644 __u64 nodeid;
645 __u64 offset;
646 __u32 size;
647 __u32 padding;
648};
649
650/* Matches the size of fuse_write_in */
651struct fuse_notify_retrieve_in {
652 __u64 dummy1;
653 __u64 offset;
654 __u32 size;
655 __u32 dummy2;
656 __u64 dummy3;
657 __u64 dummy4;
658};
659
29d434b3 660#endif /* _LINUX_FUSE_H */
This page took 0.972731 seconds and 5 git commands to generate.