blob: 8e4319614bef1e25d7aaaaefdabc0ac5c80f173b [file] [log] [blame]
Miklos Szeredid8a5ba42005-09-09 13:10:26 -07001/*
2 FUSE: Filesystem in Userspace
3 Copyright (C) 2001-2005 Miklos Szeredi <miklos@szeredi.hu>
4
5 This program can be distributed under the terms of the GNU GPL.
6 See the file COPYING.
7*/
8
9/* This file defines the kernel interface of FUSE */
10
11#include <asm/types.h>
Jan Engelhardt3e8c54f2006-06-25 05:48:49 -070012#include <linux/major.h>
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070013
14/** Version number of this interface */
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070015#define FUSE_KERNEL_VERSION 7
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070016
17/** Minor version number of this interface */
Miklos Szeredi9cd68452006-02-01 03:04:40 -080018#define FUSE_KERNEL_MINOR_VERSION 6
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070019
20/** The node ID of the root inode */
21#define FUSE_ROOT_ID 1
22
Miklos Szeredi334f4852005-09-09 13:10:27 -070023/** The major number of the fuse character device */
Jan Engelhardt3e8c54f2006-06-25 05:48:49 -070024#define FUSE_MAJOR MISC_MAJOR
Miklos Szeredi334f4852005-09-09 13:10:27 -070025
26/** The minor number of the fuse character device */
27#define FUSE_MINOR 229
28
Miklos Szeredi06663262005-09-09 13:10:32 -070029/* Make sure all structures are padded to 64bit boundary, so 32bit
30 userspace works under 64bit kernels */
31
Miklos Szeredid8a5ba42005-09-09 13:10:26 -070032struct fuse_attr {
33 __u64 ino;
34 __u64 size;
35 __u64 blocks;
36 __u64 atime;
37 __u64 mtime;
38 __u64 ctime;
39 __u32 atimensec;
40 __u32 mtimensec;
41 __u32 ctimensec;
42 __u32 mode;
43 __u32 nlink;
44 __u32 uid;
45 __u32 gid;
46 __u32 rdev;
47};
48
Miklos Szeredie5e55582005-09-09 13:10:28 -070049struct fuse_kstatfs {
50 __u64 blocks;
51 __u64 bfree;
52 __u64 bavail;
53 __u64 files;
54 __u64 ffree;
55 __u32 bsize;
56 __u32 namelen;
Miklos Szeredide5f1202006-01-06 00:19:37 -080057 __u32 frsize;
58 __u32 padding;
59 __u32 spare[6];
Miklos Szeredie5e55582005-09-09 13:10:28 -070060};
61
Miklos Szeredi9cd68452006-02-01 03:04:40 -080062/**
63 * Bitmasks for fuse_setattr_in.valid
64 */
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070065#define FATTR_MODE (1 << 0)
66#define FATTR_UID (1 << 1)
67#define FATTR_GID (1 << 2)
68#define FATTR_SIZE (1 << 3)
69#define FATTR_ATIME (1 << 4)
70#define FATTR_MTIME (1 << 5)
Miklos Szeredibefc6492005-11-07 00:59:52 -080071#define FATTR_FH (1 << 6)
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070072
Miklos Szeredi45323fb2005-09-09 13:10:37 -070073/**
74 * Flags returned by the OPEN request
75 *
76 * FOPEN_DIRECT_IO: bypass page cache for this open file
77 * FOPEN_KEEP_CACHE: don't invalidate the data cache on open
78 */
79#define FOPEN_DIRECT_IO (1 << 0)
80#define FOPEN_KEEP_CACHE (1 << 1)
81
Miklos Szeredi9cd68452006-02-01 03:04:40 -080082/**
83 * INIT request/reply flags
84 */
85#define FUSE_ASYNC_READ (1 << 0)
86
Miklos Szeredi334f4852005-09-09 13:10:27 -070087enum fuse_opcode {
Miklos Szeredie5e55582005-09-09 13:10:28 -070088 FUSE_LOOKUP = 1,
89 FUSE_FORGET = 2, /* no reply */
90 FUSE_GETATTR = 3,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070091 FUSE_SETATTR = 4,
Miklos Szeredie5e55582005-09-09 13:10:28 -070092 FUSE_READLINK = 5,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070093 FUSE_SYMLINK = 6,
Miklos Szeredi9e6268d2005-09-09 13:10:29 -070094 FUSE_MKNOD = 8,
95 FUSE_MKDIR = 9,
96 FUSE_UNLINK = 10,
97 FUSE_RMDIR = 11,
98 FUSE_RENAME = 12,
99 FUSE_LINK = 13,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700100 FUSE_OPEN = 14,
101 FUSE_READ = 15,
102 FUSE_WRITE = 16,
Miklos Szeredie5e55582005-09-09 13:10:28 -0700103 FUSE_STATFS = 17,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700104 FUSE_RELEASE = 18,
105 FUSE_FSYNC = 20,
Miklos Szeredi92a87802005-09-09 13:10:31 -0700106 FUSE_SETXATTR = 21,
107 FUSE_GETXATTR = 22,
108 FUSE_LISTXATTR = 23,
109 FUSE_REMOVEXATTR = 24,
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700110 FUSE_FLUSH = 25,
Miklos Szeredi04730fe2005-09-09 13:10:36 -0700111 FUSE_INIT = 26,
112 FUSE_OPENDIR = 27,
113 FUSE_READDIR = 28,
Miklos Szeredi82547982005-09-09 13:10:38 -0700114 FUSE_RELEASEDIR = 29,
Miklos Szeredi31d40d72005-11-07 00:59:50 -0800115 FUSE_FSYNCDIR = 30,
Miklos Szeredifd72faa2005-11-07 00:59:51 -0800116 FUSE_ACCESS = 34,
117 FUSE_CREATE = 35
Miklos Szeredi334f4852005-09-09 13:10:27 -0700118};
119
Miklos Szeredi1d3d7522006-01-06 00:19:40 -0800120/* The read buffer is required to be at least 8k, but may be much larger */
121#define FUSE_MIN_READ_BUFFER 8192
Miklos Szeredie5e55582005-09-09 13:10:28 -0700122
123struct fuse_entry_out {
124 __u64 nodeid; /* Inode ID */
125 __u64 generation; /* Inode generation: nodeid:gen must
126 be unique for the fs's lifetime */
127 __u64 entry_valid; /* Cache timeout for the name */
128 __u64 attr_valid; /* Cache timeout for the attributes */
129 __u32 entry_valid_nsec;
130 __u32 attr_valid_nsec;
131 struct fuse_attr attr;
132};
133
134struct fuse_forget_in {
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700135 __u64 nlookup;
Miklos Szeredie5e55582005-09-09 13:10:28 -0700136};
137
138struct fuse_attr_out {
139 __u64 attr_valid; /* Cache timeout for the attributes */
140 __u32 attr_valid_nsec;
141 __u32 dummy;
142 struct fuse_attr attr;
143};
144
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700145struct fuse_mknod_in {
146 __u32 mode;
147 __u32 rdev;
148};
149
150struct fuse_mkdir_in {
151 __u32 mode;
Miklos Szeredi06663262005-09-09 13:10:32 -0700152 __u32 padding;
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700153};
154
155struct fuse_rename_in {
156 __u64 newdir;
157};
158
159struct fuse_link_in {
160 __u64 oldnodeid;
161};
162
163struct fuse_setattr_in {
164 __u32 valid;
Miklos Szeredi06663262005-09-09 13:10:32 -0700165 __u32 padding;
Miklos Szeredibefc6492005-11-07 00:59:52 -0800166 __u64 fh;
167 __u64 size;
168 __u64 unused1;
169 __u64 atime;
170 __u64 mtime;
171 __u64 unused2;
172 __u32 atimensec;
173 __u32 mtimensec;
174 __u32 unused3;
175 __u32 mode;
176 __u32 unused4;
177 __u32 uid;
178 __u32 gid;
179 __u32 unused5;
Miklos Szeredi9e6268d2005-09-09 13:10:29 -0700180};
181
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700182struct fuse_open_in {
183 __u32 flags;
Miklos Szeredifd72faa2005-11-07 00:59:51 -0800184 __u32 mode;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700185};
186
187struct fuse_open_out {
188 __u64 fh;
189 __u32 open_flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700190 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700191};
192
193struct fuse_release_in {
194 __u64 fh;
195 __u32 flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700196 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700197};
198
199struct fuse_flush_in {
200 __u64 fh;
201 __u32 flush_flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700202 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700203};
204
205struct fuse_read_in {
206 __u64 fh;
207 __u64 offset;
208 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700209 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700210};
211
212struct fuse_write_in {
213 __u64 fh;
214 __u64 offset;
215 __u32 size;
216 __u32 write_flags;
217};
218
219struct fuse_write_out {
220 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700221 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700222};
223
Miklos Szeredide5f1202006-01-06 00:19:37 -0800224#define FUSE_COMPAT_STATFS_SIZE 48
225
Miklos Szeredie5e55582005-09-09 13:10:28 -0700226struct fuse_statfs_out {
227 struct fuse_kstatfs st;
228};
229
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700230struct fuse_fsync_in {
231 __u64 fh;
232 __u32 fsync_flags;
Miklos Szeredi06663262005-09-09 13:10:32 -0700233 __u32 padding;
Miklos Szeredib6aeade2005-09-09 13:10:30 -0700234};
235
Miklos Szeredi92a87802005-09-09 13:10:31 -0700236struct fuse_setxattr_in {
237 __u32 size;
238 __u32 flags;
239};
240
241struct fuse_getxattr_in {
242 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700243 __u32 padding;
Miklos Szeredi92a87802005-09-09 13:10:31 -0700244};
245
246struct fuse_getxattr_out {
247 __u32 size;
Miklos Szeredi06663262005-09-09 13:10:32 -0700248 __u32 padding;
Miklos Szeredi92a87802005-09-09 13:10:31 -0700249};
250
Miklos Szeredi31d40d72005-11-07 00:59:50 -0800251struct fuse_access_in {
252 __u32 mask;
253 __u32 padding;
254};
255
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800256struct fuse_init_in {
Miklos Szeredi334f4852005-09-09 13:10:27 -0700257 __u32 major;
258 __u32 minor;
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800259 __u32 max_readahead;
260 __u32 flags;
Miklos Szeredi334f4852005-09-09 13:10:27 -0700261};
262
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800263struct fuse_init_out {
264 __u32 major;
265 __u32 minor;
Miklos Szeredi9cd68452006-02-01 03:04:40 -0800266 __u32 max_readahead;
267 __u32 flags;
268 __u32 unused;
Miklos Szeredi3ec870d2006-01-06 00:19:41 -0800269 __u32 max_write;
270};
271
Miklos Szeredi334f4852005-09-09 13:10:27 -0700272struct fuse_in_header {
273 __u32 len;
274 __u32 opcode;
275 __u64 unique;
276 __u64 nodeid;
277 __u32 uid;
278 __u32 gid;
279 __u32 pid;
Miklos Szeredi06663262005-09-09 13:10:32 -0700280 __u32 padding;
Miklos Szeredi334f4852005-09-09 13:10:27 -0700281};
282
283struct fuse_out_header {
284 __u32 len;
285 __s32 error;
286 __u64 unique;
287};
288
Miklos Szeredie5e55582005-09-09 13:10:28 -0700289struct fuse_dirent {
290 __u64 ino;
291 __u64 off;
292 __u32 namelen;
293 __u32 type;
294 char name[0];
295};
296
297#define FUSE_NAME_OFFSET ((unsigned) ((struct fuse_dirent *) 0)->name)
298#define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1))
299#define FUSE_DIRENT_SIZE(d) \
300 FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen)