fuse.h 6.1 KB

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