Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 1 | /* |
| 2 | FUSE: Filesystem in Userspace |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 3 | Copyright (C) 2001-2006 Miklos Szeredi <miklos@szeredi.hu> |
Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 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 Engelhardt | 3e8c54f | 2006-06-25 05:48:49 -0700 | [diff] [blame] | 12 | #include <linux/major.h> |
Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 13 | |
| 14 | /** Version number of this interface */ |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 15 | #define FUSE_KERNEL_VERSION 7 |
Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 16 | |
| 17 | /** Minor version number of this interface */ |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 18 | #define FUSE_KERNEL_MINOR_VERSION 7 |
Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 19 | |
| 20 | /** The node ID of the root inode */ |
| 21 | #define FUSE_ROOT_ID 1 |
| 22 | |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 23 | /** The major number of the fuse character device */ |
Jan Engelhardt | 3e8c54f | 2006-06-25 05:48:49 -0700 | [diff] [blame] | 24 | #define FUSE_MAJOR MISC_MAJOR |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 25 | |
| 26 | /** The minor number of the fuse character device */ |
| 27 | #define FUSE_MINOR 229 |
| 28 | |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 29 | /* Make sure all structures are padded to 64bit boundary, so 32bit |
| 30 | userspace works under 64bit kernels */ |
| 31 | |
Miklos Szeredi | d8a5ba4 | 2005-09-09 13:10:26 -0700 | [diff] [blame] | 32 | struct 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 Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 49 | struct fuse_kstatfs { |
| 50 | __u64 blocks; |
| 51 | __u64 bfree; |
| 52 | __u64 bavail; |
| 53 | __u64 files; |
| 54 | __u64 ffree; |
| 55 | __u32 bsize; |
| 56 | __u32 namelen; |
Miklos Szeredi | de5f120 | 2006-01-06 00:19:37 -0800 | [diff] [blame] | 57 | __u32 frsize; |
| 58 | __u32 padding; |
| 59 | __u32 spare[6]; |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 60 | }; |
| 61 | |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 62 | struct fuse_file_lock { |
| 63 | __u64 start; |
| 64 | __u64 end; |
| 65 | __u32 type; |
| 66 | __u32 pid; /* tgid */ |
| 67 | }; |
| 68 | |
Miklos Szeredi | 9cd6845 | 2006-02-01 03:04:40 -0800 | [diff] [blame] | 69 | /** |
| 70 | * Bitmasks for fuse_setattr_in.valid |
| 71 | */ |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 72 | #define FATTR_MODE (1 << 0) |
| 73 | #define FATTR_UID (1 << 1) |
| 74 | #define FATTR_GID (1 << 2) |
| 75 | #define FATTR_SIZE (1 << 3) |
| 76 | #define FATTR_ATIME (1 << 4) |
| 77 | #define FATTR_MTIME (1 << 5) |
Miklos Szeredi | befc649 | 2005-11-07 00:59:52 -0800 | [diff] [blame] | 78 | #define FATTR_FH (1 << 6) |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 79 | |
Miklos Szeredi | 45323fb | 2005-09-09 13:10:37 -0700 | [diff] [blame] | 80 | /** |
| 81 | * Flags returned by the OPEN request |
| 82 | * |
| 83 | * FOPEN_DIRECT_IO: bypass page cache for this open file |
| 84 | * FOPEN_KEEP_CACHE: don't invalidate the data cache on open |
| 85 | */ |
| 86 | #define FOPEN_DIRECT_IO (1 << 0) |
| 87 | #define FOPEN_KEEP_CACHE (1 << 1) |
| 88 | |
Miklos Szeredi | 9cd6845 | 2006-02-01 03:04:40 -0800 | [diff] [blame] | 89 | /** |
| 90 | * INIT request/reply flags |
| 91 | */ |
| 92 | #define FUSE_ASYNC_READ (1 << 0) |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 93 | #define FUSE_POSIX_LOCKS (1 << 1) |
Miklos Szeredi | 9cd6845 | 2006-02-01 03:04:40 -0800 | [diff] [blame] | 94 | |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 95 | enum fuse_opcode { |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 96 | FUSE_LOOKUP = 1, |
| 97 | FUSE_FORGET = 2, /* no reply */ |
| 98 | FUSE_GETATTR = 3, |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 99 | FUSE_SETATTR = 4, |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 100 | FUSE_READLINK = 5, |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 101 | FUSE_SYMLINK = 6, |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 102 | FUSE_MKNOD = 8, |
| 103 | FUSE_MKDIR = 9, |
| 104 | FUSE_UNLINK = 10, |
| 105 | FUSE_RMDIR = 11, |
| 106 | FUSE_RENAME = 12, |
| 107 | FUSE_LINK = 13, |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 108 | FUSE_OPEN = 14, |
| 109 | FUSE_READ = 15, |
| 110 | FUSE_WRITE = 16, |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 111 | FUSE_STATFS = 17, |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 112 | FUSE_RELEASE = 18, |
| 113 | FUSE_FSYNC = 20, |
Miklos Szeredi | 92a8780 | 2005-09-09 13:10:31 -0700 | [diff] [blame] | 114 | FUSE_SETXATTR = 21, |
| 115 | FUSE_GETXATTR = 22, |
| 116 | FUSE_LISTXATTR = 23, |
| 117 | FUSE_REMOVEXATTR = 24, |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 118 | FUSE_FLUSH = 25, |
Miklos Szeredi | 04730fe | 2005-09-09 13:10:36 -0700 | [diff] [blame] | 119 | FUSE_INIT = 26, |
| 120 | FUSE_OPENDIR = 27, |
| 121 | FUSE_READDIR = 28, |
Miklos Szeredi | 8254798 | 2005-09-09 13:10:38 -0700 | [diff] [blame] | 122 | FUSE_RELEASEDIR = 29, |
Miklos Szeredi | 31d40d7 | 2005-11-07 00:59:50 -0800 | [diff] [blame] | 123 | FUSE_FSYNCDIR = 30, |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 124 | FUSE_GETLK = 31, |
| 125 | FUSE_SETLK = 32, |
| 126 | FUSE_SETLKW = 33, |
Miklos Szeredi | fd72faa | 2005-11-07 00:59:51 -0800 | [diff] [blame] | 127 | FUSE_ACCESS = 34, |
| 128 | FUSE_CREATE = 35 |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 129 | }; |
| 130 | |
Miklos Szeredi | 1d3d752 | 2006-01-06 00:19:40 -0800 | [diff] [blame] | 131 | /* The read buffer is required to be at least 8k, but may be much larger */ |
| 132 | #define FUSE_MIN_READ_BUFFER 8192 |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 133 | |
| 134 | struct fuse_entry_out { |
| 135 | __u64 nodeid; /* Inode ID */ |
| 136 | __u64 generation; /* Inode generation: nodeid:gen must |
| 137 | be unique for the fs's lifetime */ |
| 138 | __u64 entry_valid; /* Cache timeout for the name */ |
| 139 | __u64 attr_valid; /* Cache timeout for the attributes */ |
| 140 | __u32 entry_valid_nsec; |
| 141 | __u32 attr_valid_nsec; |
| 142 | struct fuse_attr attr; |
| 143 | }; |
| 144 | |
| 145 | struct fuse_forget_in { |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 146 | __u64 nlookup; |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 147 | }; |
| 148 | |
| 149 | struct fuse_attr_out { |
| 150 | __u64 attr_valid; /* Cache timeout for the attributes */ |
| 151 | __u32 attr_valid_nsec; |
| 152 | __u32 dummy; |
| 153 | struct fuse_attr attr; |
| 154 | }; |
| 155 | |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 156 | struct fuse_mknod_in { |
| 157 | __u32 mode; |
| 158 | __u32 rdev; |
| 159 | }; |
| 160 | |
| 161 | struct fuse_mkdir_in { |
| 162 | __u32 mode; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 163 | __u32 padding; |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 164 | }; |
| 165 | |
| 166 | struct fuse_rename_in { |
| 167 | __u64 newdir; |
| 168 | }; |
| 169 | |
| 170 | struct fuse_link_in { |
| 171 | __u64 oldnodeid; |
| 172 | }; |
| 173 | |
| 174 | struct fuse_setattr_in { |
| 175 | __u32 valid; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 176 | __u32 padding; |
Miklos Szeredi | befc649 | 2005-11-07 00:59:52 -0800 | [diff] [blame] | 177 | __u64 fh; |
| 178 | __u64 size; |
| 179 | __u64 unused1; |
| 180 | __u64 atime; |
| 181 | __u64 mtime; |
| 182 | __u64 unused2; |
| 183 | __u32 atimensec; |
| 184 | __u32 mtimensec; |
| 185 | __u32 unused3; |
| 186 | __u32 mode; |
| 187 | __u32 unused4; |
| 188 | __u32 uid; |
| 189 | __u32 gid; |
| 190 | __u32 unused5; |
Miklos Szeredi | 9e6268d | 2005-09-09 13:10:29 -0700 | [diff] [blame] | 191 | }; |
| 192 | |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 193 | struct fuse_open_in { |
| 194 | __u32 flags; |
Miklos Szeredi | fd72faa | 2005-11-07 00:59:51 -0800 | [diff] [blame] | 195 | __u32 mode; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 196 | }; |
| 197 | |
| 198 | struct fuse_open_out { |
| 199 | __u64 fh; |
| 200 | __u32 open_flags; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 201 | __u32 padding; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 202 | }; |
| 203 | |
| 204 | struct fuse_release_in { |
| 205 | __u64 fh; |
| 206 | __u32 flags; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 207 | __u32 padding; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 208 | }; |
| 209 | |
| 210 | struct fuse_flush_in { |
| 211 | __u64 fh; |
| 212 | __u32 flush_flags; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 213 | __u32 padding; |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 214 | __u64 lock_owner; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 215 | }; |
| 216 | |
| 217 | struct fuse_read_in { |
| 218 | __u64 fh; |
| 219 | __u64 offset; |
| 220 | __u32 size; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 221 | __u32 padding; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 222 | }; |
| 223 | |
| 224 | struct fuse_write_in { |
| 225 | __u64 fh; |
| 226 | __u64 offset; |
| 227 | __u32 size; |
| 228 | __u32 write_flags; |
| 229 | }; |
| 230 | |
| 231 | struct fuse_write_out { |
| 232 | __u32 size; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 233 | __u32 padding; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 234 | }; |
| 235 | |
Miklos Szeredi | de5f120 | 2006-01-06 00:19:37 -0800 | [diff] [blame] | 236 | #define FUSE_COMPAT_STATFS_SIZE 48 |
| 237 | |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 238 | struct fuse_statfs_out { |
| 239 | struct fuse_kstatfs st; |
| 240 | }; |
| 241 | |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 242 | struct fuse_fsync_in { |
| 243 | __u64 fh; |
| 244 | __u32 fsync_flags; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 245 | __u32 padding; |
Miklos Szeredi | b6aeade | 2005-09-09 13:10:30 -0700 | [diff] [blame] | 246 | }; |
| 247 | |
Miklos Szeredi | 92a8780 | 2005-09-09 13:10:31 -0700 | [diff] [blame] | 248 | struct fuse_setxattr_in { |
| 249 | __u32 size; |
| 250 | __u32 flags; |
| 251 | }; |
| 252 | |
| 253 | struct fuse_getxattr_in { |
| 254 | __u32 size; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 255 | __u32 padding; |
Miklos Szeredi | 92a8780 | 2005-09-09 13:10:31 -0700 | [diff] [blame] | 256 | }; |
| 257 | |
| 258 | struct fuse_getxattr_out { |
| 259 | __u32 size; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 260 | __u32 padding; |
Miklos Szeredi | 92a8780 | 2005-09-09 13:10:31 -0700 | [diff] [blame] | 261 | }; |
| 262 | |
Miklos Szeredi | 7142125 | 2006-06-25 05:48:52 -0700 | [diff] [blame^] | 263 | struct fuse_lk_in { |
| 264 | __u64 fh; |
| 265 | __u64 owner; |
| 266 | struct fuse_file_lock lk; |
| 267 | }; |
| 268 | |
| 269 | struct fuse_lk_out { |
| 270 | struct fuse_file_lock lk; |
| 271 | }; |
| 272 | |
Miklos Szeredi | 31d40d7 | 2005-11-07 00:59:50 -0800 | [diff] [blame] | 273 | struct fuse_access_in { |
| 274 | __u32 mask; |
| 275 | __u32 padding; |
| 276 | }; |
| 277 | |
Miklos Szeredi | 3ec870d | 2006-01-06 00:19:41 -0800 | [diff] [blame] | 278 | struct fuse_init_in { |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 279 | __u32 major; |
| 280 | __u32 minor; |
Miklos Szeredi | 9cd6845 | 2006-02-01 03:04:40 -0800 | [diff] [blame] | 281 | __u32 max_readahead; |
| 282 | __u32 flags; |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 283 | }; |
| 284 | |
Miklos Szeredi | 3ec870d | 2006-01-06 00:19:41 -0800 | [diff] [blame] | 285 | struct fuse_init_out { |
| 286 | __u32 major; |
| 287 | __u32 minor; |
Miklos Szeredi | 9cd6845 | 2006-02-01 03:04:40 -0800 | [diff] [blame] | 288 | __u32 max_readahead; |
| 289 | __u32 flags; |
| 290 | __u32 unused; |
Miklos Szeredi | 3ec870d | 2006-01-06 00:19:41 -0800 | [diff] [blame] | 291 | __u32 max_write; |
| 292 | }; |
| 293 | |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 294 | struct fuse_in_header { |
| 295 | __u32 len; |
| 296 | __u32 opcode; |
| 297 | __u64 unique; |
| 298 | __u64 nodeid; |
| 299 | __u32 uid; |
| 300 | __u32 gid; |
| 301 | __u32 pid; |
Miklos Szeredi | 0666326 | 2005-09-09 13:10:32 -0700 | [diff] [blame] | 302 | __u32 padding; |
Miklos Szeredi | 334f485 | 2005-09-09 13:10:27 -0700 | [diff] [blame] | 303 | }; |
| 304 | |
| 305 | struct fuse_out_header { |
| 306 | __u32 len; |
| 307 | __s32 error; |
| 308 | __u64 unique; |
| 309 | }; |
| 310 | |
Miklos Szeredi | e5e5558 | 2005-09-09 13:10:28 -0700 | [diff] [blame] | 311 | struct fuse_dirent { |
| 312 | __u64 ino; |
| 313 | __u64 off; |
| 314 | __u32 namelen; |
| 315 | __u32 type; |
| 316 | char name[0]; |
| 317 | }; |
| 318 | |
| 319 | #define FUSE_NAME_OFFSET ((unsigned) ((struct fuse_dirent *) 0)->name) |
| 320 | #define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(__u64) - 1) & ~(sizeof(__u64) - 1)) |
| 321 | #define FUSE_DIRENT_SIZE(d) \ |
| 322 | FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen) |