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