Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 1 | /* |
| 2 | FUSE: Filesystem in Userspace |
Miklos Szeredi | 2e6b6f2 | 2004-07-07 19:19:53 +0000 | [diff] [blame] | 3 | Copyright (C) 2001-2004 Miklos Szeredi <miklos@szeredi.hu> |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [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 | |
Miklos Szeredi | 8cffdb9 | 2001-11-09 14:49:18 +0000 | [diff] [blame] | 11 | /** Version number of this interface */ |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 12 | #define FUSE_KERNEL_VERSION 4 |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 13 | |
Miklos Szeredi | 2f3d940 | 2003-12-15 12:11:33 +0000 | [diff] [blame] | 14 | /** Minor version number of this interface */ |
Miklos Szeredi | 13ed482 | 2004-11-20 11:12:21 +0000 | [diff] [blame] | 15 | #define FUSE_KERNEL_MINOR_VERSION 2 |
Miklos Szeredi | 2f3d940 | 2003-12-15 12:11:33 +0000 | [diff] [blame] | 16 | |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 17 | /** The node ID of the root inode */ |
| 18 | #define FUSE_ROOT_ID 1 |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 19 | |
Miklos Szeredi | a25d4c2 | 2004-11-23 22:32:16 +0000 | [diff] [blame^] | 20 | /** The major number of the fuse character device */ |
| 21 | #define FUSE_MAJOR 10 |
| 22 | |
| 23 | /** The minor number of the fuse character device */ |
| 24 | #define FUSE_MINOR 229 |
| 25 | |
Miklos Szeredi | 8cffdb9 | 2001-11-09 14:49:18 +0000 | [diff] [blame] | 26 | /** Opening this will yield a new control file */ |
Miklos Szeredi | 13ed482 | 2004-11-20 11:12:21 +0000 | [diff] [blame] | 27 | #define FUSE_DEV "/dev/fuse" |
Miklos Szeredi | 8cffdb9 | 2001-11-09 14:49:18 +0000 | [diff] [blame] | 28 | |
Miklos Szeredi | c40748a | 2004-02-20 16:38:45 +0000 | [diff] [blame] | 29 | /** The file containing the version in the form MAJOR.MINOR */ |
Miklos Szeredi | 13ed482 | 2004-11-20 11:12:21 +0000 | [diff] [blame] | 30 | #define FUSE_VERSION_FILE "/sys/fs/fuse/version" |
Miklos Szeredi | c40748a | 2004-02-20 16:38:45 +0000 | [diff] [blame] | 31 | |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 32 | struct fuse_attr { |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 33 | unsigned long ino; |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 34 | unsigned int mode; |
| 35 | unsigned int nlink; |
| 36 | unsigned int uid; |
| 37 | unsigned int gid; |
| 38 | unsigned int rdev; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 39 | unsigned long long size; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 40 | unsigned long blocks; |
| 41 | unsigned long atime; |
Miklos Szeredi | b595861 | 2004-02-20 14:10:49 +0000 | [diff] [blame] | 42 | unsigned long atimensec; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 43 | unsigned long mtime; |
Miklos Szeredi | b595861 | 2004-02-20 14:10:49 +0000 | [diff] [blame] | 44 | unsigned long mtimensec; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 45 | unsigned long ctime; |
Miklos Szeredi | b595861 | 2004-02-20 14:10:49 +0000 | [diff] [blame] | 46 | unsigned long ctimensec; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 47 | }; |
| 48 | |
Miklos Szeredi | 24ed945 | 2002-10-07 10:24:26 +0000 | [diff] [blame] | 49 | struct fuse_kstatfs { |
Miklos Szeredi | 18e75e4 | 2004-02-19 14:23:27 +0000 | [diff] [blame] | 50 | unsigned int bsize; |
| 51 | unsigned long long blocks; |
| 52 | unsigned long long bfree; |
| 53 | unsigned long long bavail; |
| 54 | unsigned long long files; |
| 55 | unsigned long long ffree; |
| 56 | unsigned int namelen; |
Miklos Szeredi | 24ed945 | 2002-10-07 10:24:26 +0000 | [diff] [blame] | 57 | }; |
| 58 | |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 59 | #define FATTR_MODE (1 << 0) |
| 60 | #define FATTR_UID (1 << 1) |
| 61 | #define FATTR_GID (1 << 2) |
| 62 | #define FATTR_SIZE (1 << 3) |
Miklos Szeredi | b595861 | 2004-02-20 14:10:49 +0000 | [diff] [blame] | 63 | #define FATTR_ATIME (1 << 4) |
| 64 | #define FATTR_MTIME (1 << 5) |
| 65 | #define FATTR_CTIME (1 << 6) |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 66 | |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 67 | enum fuse_opcode { |
Miklos Szeredi | 3ed8423 | 2004-03-30 15:17:26 +0000 | [diff] [blame] | 68 | FUSE_LOOKUP = 1, |
| 69 | FUSE_FORGET = 2, /* no reply */ |
| 70 | FUSE_GETATTR = 3, |
| 71 | FUSE_SETATTR = 4, |
| 72 | FUSE_READLINK = 5, |
| 73 | FUSE_SYMLINK = 6, |
| 74 | FUSE_GETDIR = 7, |
| 75 | FUSE_MKNOD = 8, |
| 76 | FUSE_MKDIR = 9, |
| 77 | FUSE_UNLINK = 10, |
| 78 | FUSE_RMDIR = 11, |
| 79 | FUSE_RENAME = 12, |
| 80 | FUSE_LINK = 13, |
| 81 | FUSE_OPEN = 14, |
| 82 | FUSE_READ = 15, |
| 83 | FUSE_WRITE = 16, |
| 84 | FUSE_STATFS = 17, |
Miklos Szeredi | 72cf5c9 | 2004-11-20 16:10:30 +0000 | [diff] [blame] | 85 | FUSE_RELEASE = 18, |
Miklos Szeredi | 3ed8423 | 2004-03-30 15:17:26 +0000 | [diff] [blame] | 86 | FUSE_INVALIDATE = 19, /* user initiated */ |
| 87 | FUSE_FSYNC = 20, |
| 88 | FUSE_SETXATTR = 21, |
| 89 | FUSE_GETXATTR = 22, |
| 90 | FUSE_LISTXATTR = 23, |
| 91 | FUSE_REMOVEXATTR = 24, |
Miklos Szeredi | e2e4ac2 | 2004-05-18 08:45:28 +0000 | [diff] [blame] | 92 | FUSE_FLUSH = 25, |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 93 | }; |
| 94 | |
| 95 | /* Conservative buffer size for the client */ |
| 96 | #define FUSE_MAX_IN 8192 |
| 97 | |
Miklos Szeredi | c26c14d | 2004-04-09 17:48:32 +0000 | [diff] [blame] | 98 | #define FUSE_NAME_MAX 1024 |
| 99 | #define FUSE_SYMLINK_MAX 4096 |
| 100 | #define FUSE_XATTR_SIZE_MAX 4096 |
| 101 | |
Miklos Szeredi | 254d5ed | 2004-03-02 11:11:24 +0000 | [diff] [blame] | 102 | struct fuse_entry_out { |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 103 | unsigned long nodeid; /* Inode ID */ |
| 104 | unsigned long generation; /* Inode generation: nodeid:gen must |
Miklos Szeredi | 254d5ed | 2004-03-02 11:11:24 +0000 | [diff] [blame] | 105 | be unique for the fs's lifetime */ |
| 106 | unsigned long entry_valid; /* Cache timeout for the name */ |
| 107 | unsigned long entry_valid_nsec; |
| 108 | unsigned long attr_valid; /* Cache timeout for the attributes */ |
| 109 | unsigned long attr_valid_nsec; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 110 | struct fuse_attr attr; |
| 111 | }; |
| 112 | |
Miklos Szeredi | a181e61 | 2001-11-06 12:03:23 +0000 | [diff] [blame] | 113 | struct fuse_forget_in { |
| 114 | int version; |
| 115 | }; |
| 116 | |
Miklos Szeredi | 254d5ed | 2004-03-02 11:11:24 +0000 | [diff] [blame] | 117 | struct fuse_attr_out { |
| 118 | unsigned long attr_valid; /* Cache timeout for the attributes */ |
| 119 | unsigned long attr_valid_nsec; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 120 | struct fuse_attr attr; |
| 121 | }; |
| 122 | |
| 123 | struct fuse_getdir_out { |
| 124 | int fd; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 125 | }; |
| 126 | |
| 127 | struct fuse_mknod_in { |
Miklos Szeredi | 76f6578 | 2004-02-19 16:55:40 +0000 | [diff] [blame] | 128 | unsigned int mode; |
| 129 | unsigned int rdev; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 130 | }; |
| 131 | |
Miklos Szeredi | b483c93 | 2001-10-29 14:57:57 +0000 | [diff] [blame] | 132 | struct fuse_mkdir_in { |
Miklos Szeredi | 76f6578 | 2004-02-19 16:55:40 +0000 | [diff] [blame] | 133 | unsigned int mode; |
Miklos Szeredi | b483c93 | 2001-10-29 14:57:57 +0000 | [diff] [blame] | 134 | }; |
| 135 | |
Miklos Szeredi | b483c93 | 2001-10-29 14:57:57 +0000 | [diff] [blame] | 136 | struct fuse_rename_in { |
| 137 | unsigned long newdir; |
Miklos Szeredi | 19dff1b | 2001-10-30 15:06:52 +0000 | [diff] [blame] | 138 | }; |
| 139 | |
| 140 | struct fuse_link_in { |
| 141 | unsigned long newdir; |
Miklos Szeredi | b483c93 | 2001-10-29 14:57:57 +0000 | [diff] [blame] | 142 | }; |
| 143 | |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 144 | struct fuse_setattr_in { |
| 145 | struct fuse_attr attr; |
| 146 | unsigned int valid; |
| 147 | }; |
| 148 | |
| 149 | struct fuse_open_in { |
| 150 | unsigned int flags; |
| 151 | }; |
| 152 | |
Miklos Szeredi | 209f5d0 | 2004-07-24 19:56:16 +0000 | [diff] [blame] | 153 | struct fuse_open_out { |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 154 | unsigned long fh; |
Miklos Szeredi | 3a6ea06 | 2004-11-11 10:33:58 +0000 | [diff] [blame] | 155 | unsigned int _open_flags; |
Miklos Szeredi | 209f5d0 | 2004-07-24 19:56:16 +0000 | [diff] [blame] | 156 | }; |
| 157 | |
| 158 | struct fuse_release_in { |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 159 | unsigned long fh; |
Miklos Szeredi | 209f5d0 | 2004-07-24 19:56:16 +0000 | [diff] [blame] | 160 | unsigned int flags; |
| 161 | }; |
| 162 | |
| 163 | struct fuse_flush_in { |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 164 | unsigned long fh; |
Miklos Szeredi | 3a6ea06 | 2004-11-11 10:33:58 +0000 | [diff] [blame] | 165 | unsigned int _nref; |
Miklos Szeredi | 209f5d0 | 2004-07-24 19:56:16 +0000 | [diff] [blame] | 166 | }; |
| 167 | |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 168 | struct fuse_read_in { |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 169 | unsigned long fh; |
Miklos Szeredi | 5e18348 | 2001-10-31 14:52:35 +0000 | [diff] [blame] | 170 | unsigned long long offset; |
| 171 | unsigned int size; |
| 172 | }; |
| 173 | |
Miklos Szeredi | a181e61 | 2001-11-06 12:03:23 +0000 | [diff] [blame] | 174 | struct fuse_write_in { |
Miklos Szeredi | 209f5d0 | 2004-07-24 19:56:16 +0000 | [diff] [blame] | 175 | int writepage; |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 176 | unsigned long fh; |
Miklos Szeredi | a181e61 | 2001-11-06 12:03:23 +0000 | [diff] [blame] | 177 | unsigned long long offset; |
| 178 | unsigned int size; |
Miklos Szeredi | a181e61 | 2001-11-06 12:03:23 +0000 | [diff] [blame] | 179 | }; |
| 180 | |
Miklos Szeredi | ad051c3 | 2004-07-02 09:22:50 +0000 | [diff] [blame] | 181 | struct fuse_write_out { |
| 182 | unsigned int size; |
| 183 | }; |
| 184 | |
Mark Glines | d84b39a | 2002-01-07 16:32:02 +0000 | [diff] [blame] | 185 | struct fuse_statfs_out { |
Miklos Szeredi | 24ed945 | 2002-10-07 10:24:26 +0000 | [diff] [blame] | 186 | struct fuse_kstatfs st; |
Mark Glines | d84b39a | 2002-01-07 16:32:02 +0000 | [diff] [blame] | 187 | }; |
| 188 | |
Miklos Szeredi | 5e43f2c | 2003-12-12 14:06:41 +0000 | [diff] [blame] | 189 | struct fuse_fsync_in { |
Miklos Szeredi | 1eea032 | 2004-09-27 18:50:11 +0000 | [diff] [blame] | 190 | unsigned long fh; |
Miklos Szeredi | 5e43f2c | 2003-12-12 14:06:41 +0000 | [diff] [blame] | 191 | int datasync; |
| 192 | }; |
| 193 | |
Miklos Szeredi | 3ed8423 | 2004-03-30 15:17:26 +0000 | [diff] [blame] | 194 | struct fuse_setxattr_in { |
| 195 | unsigned int size; |
| 196 | unsigned int flags; |
| 197 | }; |
| 198 | |
Miklos Szeredi | 03cebae | 2004-03-31 10:19:18 +0000 | [diff] [blame] | 199 | struct fuse_getxattr_in { |
| 200 | unsigned int size; |
| 201 | }; |
| 202 | |
| 203 | struct fuse_getxattr_out { |
Miklos Szeredi | 3ed8423 | 2004-03-30 15:17:26 +0000 | [diff] [blame] | 204 | unsigned int size; |
| 205 | }; |
| 206 | |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 207 | struct fuse_in_header { |
| 208 | int unique; |
| 209 | enum fuse_opcode opcode; |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 210 | unsigned long nodeid; |
Miklos Szeredi | fe25def | 2001-12-20 15:38:05 +0000 | [diff] [blame] | 211 | unsigned int uid; |
| 212 | unsigned int gid; |
Miklos Szeredi | 1f18db5 | 2004-09-27 06:54:49 +0000 | [diff] [blame] | 213 | unsigned int pid; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 214 | }; |
| 215 | |
| 216 | struct fuse_out_header { |
| 217 | int unique; |
Miklos Szeredi | 19dff1b | 2001-10-30 15:06:52 +0000 | [diff] [blame] | 218 | int error; |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 219 | }; |
| 220 | |
Miklos Szeredi | da4e486 | 2003-09-08 11:14:11 +0000 | [diff] [blame] | 221 | struct fuse_user_header { |
| 222 | int unique; /* zero */ |
| 223 | enum fuse_opcode opcode; |
Miklos Szeredi | a13d900 | 2004-11-02 17:32:03 +0000 | [diff] [blame] | 224 | unsigned long nodeid; |
| 225 | unsigned long ino; /* Needed only on 2.4.x where ino is also |
| 226 | used for inode lookup */ |
Miklos Szeredi | da4e486 | 2003-09-08 11:14:11 +0000 | [diff] [blame] | 227 | }; |
| 228 | |
Miklos Szeredi | 85c74fc | 2001-10-28 19:44:14 +0000 | [diff] [blame] | 229 | struct fuse_dirent { |
| 230 | unsigned long ino; |
| 231 | unsigned short namelen; |
| 232 | unsigned char type; |
| 233 | char name[256]; |
| 234 | }; |
| 235 | |
| 236 | #define FUSE_NAME_OFFSET ((unsigned int) ((struct fuse_dirent *) 0)->name) |
| 237 | #define FUSE_DIRENT_ALIGN(x) (((x) + sizeof(long) - 1) & ~(sizeof(long) - 1)) |
| 238 | #define FUSE_DIRENT_SIZE(d) \ |
| 239 | FUSE_DIRENT_ALIGN(FUSE_NAME_OFFSET + (d)->namelen) |