ceph_fs.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787
  1. /*
  2. * ceph_fs.h - Ceph constants and data types to share between kernel and
  3. * user space.
  4. *
  5. * Most types in this file are defined as little-endian, and are
  6. * primarily intended to describe data structures that pass over the
  7. * wire or that are stored on disk.
  8. *
  9. * LGPL2
  10. */
  11. #ifndef CEPH_FS_H
  12. #define CEPH_FS_H
  13. #include <linux/ceph/msgr.h>
  14. #include <linux/ceph/rados.h>
  15. /*
  16. * subprotocol versions. when specific messages types or high-level
  17. * protocols change, bump the affected components. we keep rev
  18. * internal cluster protocols separately from the public,
  19. * client-facing protocol.
  20. */
  21. #define CEPH_OSDC_PROTOCOL 24 /* server/client */
  22. #define CEPH_MDSC_PROTOCOL 32 /* server/client */
  23. #define CEPH_MONC_PROTOCOL 15 /* server/client */
  24. #define CEPH_INO_ROOT 1
  25. #define CEPH_INO_CEPH 2 /* hidden .ceph dir */
  26. #define CEPH_INO_DOTDOT 3 /* used by ceph fuse for parent (..) */
  27. /* arbitrary limit on max # of monitors (cluster of 3 is typical) */
  28. #define CEPH_MAX_MON 31
  29. /*
  30. * legacy ceph_file_layoute
  31. */
  32. struct ceph_file_layout_legacy {
  33. /* file -> object mapping */
  34. __le32 fl_stripe_unit; /* stripe unit, in bytes. must be multiple
  35. of page size. */
  36. __le32 fl_stripe_count; /* over this many objects */
  37. __le32 fl_object_size; /* until objects are this big, then move to
  38. new objects */
  39. __le32 fl_cas_hash; /* UNUSED. 0 = none; 1 = sha256 */
  40. /* pg -> disk layout */
  41. __le32 fl_object_stripe_unit; /* UNUSED. for per-object parity, if any */
  42. /* object -> pg layout */
  43. __le32 fl_unused; /* unused; used to be preferred primary for pg (-1 for none) */
  44. __le32 fl_pg_pool; /* namespace, crush ruleset, rep level */
  45. } __attribute__ ((packed));
  46. struct ceph_string;
  47. /*
  48. * ceph_file_layout - describe data layout for a file/inode
  49. */
  50. struct ceph_file_layout {
  51. /* file -> object mapping */
  52. u32 stripe_unit; /* stripe unit, in bytes */
  53. u32 stripe_count; /* over this many objects */
  54. u32 object_size; /* until objects are this big */
  55. s64 pool_id; /* rados pool id */
  56. struct ceph_string __rcu *pool_ns; /* rados pool namespace */
  57. };
  58. extern int ceph_file_layout_is_valid(const struct ceph_file_layout *layout);
  59. extern void ceph_file_layout_from_legacy(struct ceph_file_layout *fl,
  60. struct ceph_file_layout_legacy *legacy);
  61. extern void ceph_file_layout_to_legacy(struct ceph_file_layout *fl,
  62. struct ceph_file_layout_legacy *legacy);
  63. #define CEPH_MIN_STRIPE_UNIT 65536
  64. struct ceph_dir_layout {
  65. __u8 dl_dir_hash; /* see ceph_hash.h for ids */
  66. __u8 dl_unused1;
  67. __u16 dl_unused2;
  68. __u32 dl_unused3;
  69. } __attribute__ ((packed));
  70. /* crypto algorithms */
  71. #define CEPH_CRYPTO_NONE 0x0
  72. #define CEPH_CRYPTO_AES 0x1
  73. #define CEPH_AES_IV "cephsageyudagreg"
  74. /* security/authentication protocols */
  75. #define CEPH_AUTH_UNKNOWN 0x0
  76. #define CEPH_AUTH_NONE 0x1
  77. #define CEPH_AUTH_CEPHX 0x2
  78. #define CEPH_AUTH_UID_DEFAULT ((__u64) -1)
  79. /*********************************************
  80. * message layer
  81. */
  82. /*
  83. * message types
  84. */
  85. /* misc */
  86. #define CEPH_MSG_SHUTDOWN 1
  87. #define CEPH_MSG_PING 2
  88. /* client <-> monitor */
  89. #define CEPH_MSG_MON_MAP 4
  90. #define CEPH_MSG_MON_GET_MAP 5
  91. #define CEPH_MSG_STATFS 13
  92. #define CEPH_MSG_STATFS_REPLY 14
  93. #define CEPH_MSG_MON_SUBSCRIBE 15
  94. #define CEPH_MSG_MON_SUBSCRIBE_ACK 16
  95. #define CEPH_MSG_AUTH 17
  96. #define CEPH_MSG_AUTH_REPLY 18
  97. #define CEPH_MSG_MON_GET_VERSION 19
  98. #define CEPH_MSG_MON_GET_VERSION_REPLY 20
  99. /* client <-> mds */
  100. #define CEPH_MSG_MDS_MAP 21
  101. #define CEPH_MSG_FS_MAP_USER 103
  102. #define CEPH_MSG_CLIENT_SESSION 22
  103. #define CEPH_MSG_CLIENT_RECONNECT 23
  104. #define CEPH_MSG_CLIENT_REQUEST 24
  105. #define CEPH_MSG_CLIENT_REQUEST_FORWARD 25
  106. #define CEPH_MSG_CLIENT_REPLY 26
  107. #define CEPH_MSG_CLIENT_CAPS 0x310
  108. #define CEPH_MSG_CLIENT_LEASE 0x311
  109. #define CEPH_MSG_CLIENT_SNAP 0x312
  110. #define CEPH_MSG_CLIENT_CAPRELEASE 0x313
  111. /* pool ops */
  112. #define CEPH_MSG_POOLOP_REPLY 48
  113. #define CEPH_MSG_POOLOP 49
  114. /* mon commands */
  115. #define CEPH_MSG_MON_COMMAND 50
  116. #define CEPH_MSG_MON_COMMAND_ACK 51
  117. /* osd */
  118. #define CEPH_MSG_OSD_MAP 41
  119. #define CEPH_MSG_OSD_OP 42
  120. #define CEPH_MSG_OSD_OPREPLY 43
  121. #define CEPH_MSG_WATCH_NOTIFY 44
  122. /* watch-notify operations */
  123. enum {
  124. CEPH_WATCH_EVENT_NOTIFY = 1, /* notifying watcher */
  125. CEPH_WATCH_EVENT_NOTIFY_COMPLETE = 2, /* notifier notified when done */
  126. CEPH_WATCH_EVENT_DISCONNECT = 3, /* we were disconnected */
  127. };
  128. struct ceph_mon_request_header {
  129. __le64 have_version;
  130. __le16 session_mon;
  131. __le64 session_mon_tid;
  132. } __attribute__ ((packed));
  133. struct ceph_mon_statfs {
  134. struct ceph_mon_request_header monhdr;
  135. struct ceph_fsid fsid;
  136. } __attribute__ ((packed));
  137. struct ceph_statfs {
  138. __le64 kb, kb_used, kb_avail;
  139. __le64 num_objects;
  140. } __attribute__ ((packed));
  141. struct ceph_mon_statfs_reply {
  142. struct ceph_fsid fsid;
  143. __le64 version;
  144. struct ceph_statfs st;
  145. } __attribute__ ((packed));
  146. struct ceph_mon_command {
  147. struct ceph_mon_request_header monhdr;
  148. struct ceph_fsid fsid;
  149. __le32 num_strs; /* always 1 */
  150. __le32 str_len;
  151. char str[];
  152. } __attribute__ ((packed));
  153. struct ceph_osd_getmap {
  154. struct ceph_mon_request_header monhdr;
  155. struct ceph_fsid fsid;
  156. __le32 start;
  157. } __attribute__ ((packed));
  158. struct ceph_mds_getmap {
  159. struct ceph_mon_request_header monhdr;
  160. struct ceph_fsid fsid;
  161. } __attribute__ ((packed));
  162. struct ceph_client_mount {
  163. struct ceph_mon_request_header monhdr;
  164. } __attribute__ ((packed));
  165. #define CEPH_SUBSCRIBE_ONETIME 1 /* i want only 1 update after have */
  166. struct ceph_mon_subscribe_item {
  167. __le64 start;
  168. __u8 flags;
  169. } __attribute__ ((packed));
  170. struct ceph_mon_subscribe_ack {
  171. __le32 duration; /* seconds */
  172. struct ceph_fsid fsid;
  173. } __attribute__ ((packed));
  174. #define CEPH_FS_CLUSTER_ID_NONE -1
  175. /*
  176. * mdsmap flags
  177. */
  178. #define CEPH_MDSMAP_DOWN (1<<0) /* cluster deliberately down */
  179. /*
  180. * mds states
  181. * > 0 -> in
  182. * <= 0 -> out
  183. */
  184. #define CEPH_MDS_STATE_DNE 0 /* down, does not exist. */
  185. #define CEPH_MDS_STATE_STOPPED -1 /* down, once existed, but no subtrees.
  186. empty log. */
  187. #define CEPH_MDS_STATE_BOOT -4 /* up, boot announcement. */
  188. #define CEPH_MDS_STATE_STANDBY -5 /* up, idle. waiting for assignment. */
  189. #define CEPH_MDS_STATE_CREATING -6 /* up, creating MDS instance. */
  190. #define CEPH_MDS_STATE_STARTING -7 /* up, starting previously stopped mds */
  191. #define CEPH_MDS_STATE_STANDBY_REPLAY -8 /* up, tailing active node's journal */
  192. #define CEPH_MDS_STATE_REPLAYONCE -9 /* up, replaying an active node's journal */
  193. #define CEPH_MDS_STATE_REPLAY 8 /* up, replaying journal. */
  194. #define CEPH_MDS_STATE_RESOLVE 9 /* up, disambiguating distributed
  195. operations (import, rename, etc.) */
  196. #define CEPH_MDS_STATE_RECONNECT 10 /* up, reconnect to clients */
  197. #define CEPH_MDS_STATE_REJOIN 11 /* up, rejoining distributed cache */
  198. #define CEPH_MDS_STATE_CLIENTREPLAY 12 /* up, replaying client operations */
  199. #define CEPH_MDS_STATE_ACTIVE 13 /* up, active */
  200. #define CEPH_MDS_STATE_STOPPING 14 /* up, but exporting metadata */
  201. extern const char *ceph_mds_state_name(int s);
  202. /*
  203. * metadata lock types.
  204. * - these are bitmasks.. we can compose them
  205. * - they also define the lock ordering by the MDS
  206. * - a few of these are internal to the mds
  207. */
  208. #define CEPH_LOCK_DVERSION 1
  209. #define CEPH_LOCK_DN 2
  210. #define CEPH_LOCK_ISNAP 16
  211. #define CEPH_LOCK_IVERSION 32 /* mds internal */
  212. #define CEPH_LOCK_IFILE 64
  213. #define CEPH_LOCK_IAUTH 128
  214. #define CEPH_LOCK_ILINK 256
  215. #define CEPH_LOCK_IDFT 512 /* dir frag tree */
  216. #define CEPH_LOCK_INEST 1024 /* mds internal */
  217. #define CEPH_LOCK_IXATTR 2048
  218. #define CEPH_LOCK_IFLOCK 4096 /* advisory file locks */
  219. #define CEPH_LOCK_INO 8192 /* immutable inode bits; not a lock */
  220. #define CEPH_LOCK_IPOLICY 16384 /* policy lock on dirs. MDS internal */
  221. /* client_session ops */
  222. enum {
  223. CEPH_SESSION_REQUEST_OPEN,
  224. CEPH_SESSION_OPEN,
  225. CEPH_SESSION_REQUEST_CLOSE,
  226. CEPH_SESSION_CLOSE,
  227. CEPH_SESSION_REQUEST_RENEWCAPS,
  228. CEPH_SESSION_RENEWCAPS,
  229. CEPH_SESSION_STALE,
  230. CEPH_SESSION_RECALL_STATE,
  231. CEPH_SESSION_FLUSHMSG,
  232. CEPH_SESSION_FLUSHMSG_ACK,
  233. CEPH_SESSION_FORCE_RO,
  234. CEPH_SESSION_REJECT,
  235. };
  236. extern const char *ceph_session_op_name(int op);
  237. struct ceph_mds_session_head {
  238. __le32 op;
  239. __le64 seq;
  240. struct ceph_timespec stamp;
  241. __le32 max_caps, max_leases;
  242. } __attribute__ ((packed));
  243. /* client_request */
  244. /*
  245. * metadata ops.
  246. * & 0x001000 -> write op
  247. * & 0x010000 -> follow symlink (e.g. stat(), not lstat()).
  248. & & 0x100000 -> use weird ino/path trace
  249. */
  250. #define CEPH_MDS_OP_WRITE 0x001000
  251. enum {
  252. CEPH_MDS_OP_LOOKUP = 0x00100,
  253. CEPH_MDS_OP_GETATTR = 0x00101,
  254. CEPH_MDS_OP_LOOKUPHASH = 0x00102,
  255. CEPH_MDS_OP_LOOKUPPARENT = 0x00103,
  256. CEPH_MDS_OP_LOOKUPINO = 0x00104,
  257. CEPH_MDS_OP_LOOKUPNAME = 0x00105,
  258. CEPH_MDS_OP_SETXATTR = 0x01105,
  259. CEPH_MDS_OP_RMXATTR = 0x01106,
  260. CEPH_MDS_OP_SETLAYOUT = 0x01107,
  261. CEPH_MDS_OP_SETATTR = 0x01108,
  262. CEPH_MDS_OP_SETFILELOCK= 0x01109,
  263. CEPH_MDS_OP_GETFILELOCK= 0x00110,
  264. CEPH_MDS_OP_SETDIRLAYOUT=0x0110a,
  265. CEPH_MDS_OP_MKNOD = 0x01201,
  266. CEPH_MDS_OP_LINK = 0x01202,
  267. CEPH_MDS_OP_UNLINK = 0x01203,
  268. CEPH_MDS_OP_RENAME = 0x01204,
  269. CEPH_MDS_OP_MKDIR = 0x01220,
  270. CEPH_MDS_OP_RMDIR = 0x01221,
  271. CEPH_MDS_OP_SYMLINK = 0x01222,
  272. CEPH_MDS_OP_CREATE = 0x01301,
  273. CEPH_MDS_OP_OPEN = 0x00302,
  274. CEPH_MDS_OP_READDIR = 0x00305,
  275. CEPH_MDS_OP_LOOKUPSNAP = 0x00400,
  276. CEPH_MDS_OP_MKSNAP = 0x01400,
  277. CEPH_MDS_OP_RMSNAP = 0x01401,
  278. CEPH_MDS_OP_LSSNAP = 0x00402,
  279. CEPH_MDS_OP_RENAMESNAP = 0x01403,
  280. };
  281. extern const char *ceph_mds_op_name(int op);
  282. #define CEPH_SETATTR_MODE 1
  283. #define CEPH_SETATTR_UID 2
  284. #define CEPH_SETATTR_GID 4
  285. #define CEPH_SETATTR_MTIME 8
  286. #define CEPH_SETATTR_ATIME 16
  287. #define CEPH_SETATTR_SIZE 32
  288. #define CEPH_SETATTR_CTIME 64
  289. /*
  290. * Ceph setxattr request flags.
  291. */
  292. #define CEPH_XATTR_CREATE (1 << 0)
  293. #define CEPH_XATTR_REPLACE (1 << 1)
  294. #define CEPH_XATTR_REMOVE (1 << 31)
  295. /*
  296. * readdir request flags;
  297. */
  298. #define CEPH_READDIR_REPLY_BITFLAGS (1<<0)
  299. /*
  300. * readdir reply flags.
  301. */
  302. #define CEPH_READDIR_FRAG_END (1<<0)
  303. #define CEPH_READDIR_FRAG_COMPLETE (1<<8)
  304. #define CEPH_READDIR_HASH_ORDER (1<<9)
  305. union ceph_mds_request_args {
  306. struct {
  307. __le32 mask; /* CEPH_CAP_* */
  308. } __attribute__ ((packed)) getattr;
  309. struct {
  310. __le32 mode;
  311. __le32 uid;
  312. __le32 gid;
  313. struct ceph_timespec mtime;
  314. struct ceph_timespec atime;
  315. __le64 size, old_size; /* old_size needed by truncate */
  316. __le32 mask; /* CEPH_SETATTR_* */
  317. } __attribute__ ((packed)) setattr;
  318. struct {
  319. __le32 frag; /* which dir fragment */
  320. __le32 max_entries; /* how many dentries to grab */
  321. __le32 max_bytes;
  322. __le16 flags;
  323. } __attribute__ ((packed)) readdir;
  324. struct {
  325. __le32 mode;
  326. __le32 rdev;
  327. } __attribute__ ((packed)) mknod;
  328. struct {
  329. __le32 mode;
  330. } __attribute__ ((packed)) mkdir;
  331. struct {
  332. __le32 flags;
  333. __le32 mode;
  334. __le32 stripe_unit; /* layout for newly created file */
  335. __le32 stripe_count; /* ... */
  336. __le32 object_size;
  337. __le32 file_replication;
  338. __le32 mask; /* CEPH_CAP_* */
  339. __le32 old_size;
  340. } __attribute__ ((packed)) open;
  341. struct {
  342. __le32 flags;
  343. } __attribute__ ((packed)) setxattr;
  344. struct {
  345. struct ceph_file_layout_legacy layout;
  346. } __attribute__ ((packed)) setlayout;
  347. struct {
  348. __u8 rule; /* currently fcntl or flock */
  349. __u8 type; /* shared, exclusive, remove*/
  350. __le64 owner; /* owner of the lock */
  351. __le64 pid; /* process id requesting the lock */
  352. __le64 start; /* initial location to lock */
  353. __le64 length; /* num bytes to lock from start */
  354. __u8 wait; /* will caller wait for lock to become available? */
  355. } __attribute__ ((packed)) filelock_change;
  356. } __attribute__ ((packed));
  357. #define CEPH_MDS_FLAG_REPLAY 1 /* this is a replayed op */
  358. #define CEPH_MDS_FLAG_WANT_DENTRY 2 /* want dentry in reply */
  359. struct ceph_mds_request_head {
  360. __le64 oldest_client_tid;
  361. __le32 mdsmap_epoch; /* on client */
  362. __le32 flags; /* CEPH_MDS_FLAG_* */
  363. __u8 num_retry, num_fwd; /* count retry, fwd attempts */
  364. __le16 num_releases; /* # include cap/lease release records */
  365. __le32 op; /* mds op code */
  366. __le32 caller_uid, caller_gid;
  367. __le64 ino; /* use this ino for openc, mkdir, mknod,
  368. etc. (if replaying) */
  369. union ceph_mds_request_args args;
  370. } __attribute__ ((packed));
  371. /* cap/lease release record */
  372. struct ceph_mds_request_release {
  373. __le64 ino, cap_id; /* ino and unique cap id */
  374. __le32 caps, wanted; /* new issued, wanted */
  375. __le32 seq, issue_seq, mseq;
  376. __le32 dname_seq; /* if releasing a dentry lease, a */
  377. __le32 dname_len; /* string follows. */
  378. } __attribute__ ((packed));
  379. /* client reply */
  380. struct ceph_mds_reply_head {
  381. __le32 op;
  382. __le32 result;
  383. __le32 mdsmap_epoch;
  384. __u8 safe; /* true if committed to disk */
  385. __u8 is_dentry, is_target; /* true if dentry, target inode records
  386. are included with reply */
  387. } __attribute__ ((packed));
  388. /* one for each node split */
  389. struct ceph_frag_tree_split {
  390. __le32 frag; /* this frag splits... */
  391. __le32 by; /* ...by this many bits */
  392. } __attribute__ ((packed));
  393. struct ceph_frag_tree_head {
  394. __le32 nsplits; /* num ceph_frag_tree_split records */
  395. struct ceph_frag_tree_split splits[];
  396. } __attribute__ ((packed));
  397. /* capability issue, for bundling with mds reply */
  398. struct ceph_mds_reply_cap {
  399. __le32 caps, wanted; /* caps issued, wanted */
  400. __le64 cap_id;
  401. __le32 seq, mseq;
  402. __le64 realm; /* snap realm */
  403. __u8 flags; /* CEPH_CAP_FLAG_* */
  404. } __attribute__ ((packed));
  405. #define CEPH_CAP_FLAG_AUTH (1 << 0) /* cap is issued by auth mds */
  406. #define CEPH_CAP_FLAG_RELEASE (1 << 1) /* release the cap */
  407. /* inode record, for bundling with mds reply */
  408. struct ceph_mds_reply_inode {
  409. __le64 ino;
  410. __le64 snapid;
  411. __le32 rdev;
  412. __le64 version; /* inode version */
  413. __le64 xattr_version; /* version for xattr blob */
  414. struct ceph_mds_reply_cap cap; /* caps issued for this inode */
  415. struct ceph_file_layout_legacy layout;
  416. struct ceph_timespec ctime, mtime, atime;
  417. __le32 time_warp_seq;
  418. __le64 size, max_size, truncate_size;
  419. __le32 truncate_seq;
  420. __le32 mode, uid, gid;
  421. __le32 nlink;
  422. __le64 files, subdirs, rbytes, rfiles, rsubdirs; /* dir stats */
  423. struct ceph_timespec rctime;
  424. struct ceph_frag_tree_head fragtree; /* (must be at end of struct) */
  425. } __attribute__ ((packed));
  426. /* followed by frag array, symlink string, dir layout, xattr blob */
  427. /* reply_lease follows dname, and reply_inode */
  428. struct ceph_mds_reply_lease {
  429. __le16 mask; /* lease type(s) */
  430. __le32 duration_ms; /* lease duration */
  431. __le32 seq;
  432. } __attribute__ ((packed));
  433. struct ceph_mds_reply_dirfrag {
  434. __le32 frag; /* fragment */
  435. __le32 auth; /* auth mds, if this is a delegation point */
  436. __le32 ndist; /* number of mds' this is replicated on */
  437. __le32 dist[];
  438. } __attribute__ ((packed));
  439. #define CEPH_LOCK_FCNTL 1
  440. #define CEPH_LOCK_FLOCK 2
  441. #define CEPH_LOCK_FCNTL_INTR 3
  442. #define CEPH_LOCK_FLOCK_INTR 4
  443. #define CEPH_LOCK_SHARED 1
  444. #define CEPH_LOCK_EXCL 2
  445. #define CEPH_LOCK_UNLOCK 4
  446. struct ceph_filelock {
  447. __le64 start;/* file offset to start lock at */
  448. __le64 length; /* num bytes to lock; 0 for all following start */
  449. __le64 client; /* which client holds the lock */
  450. __le64 owner; /* owner the lock */
  451. __le64 pid; /* process id holding the lock on the client */
  452. __u8 type; /* shared lock, exclusive lock, or unlock */
  453. } __attribute__ ((packed));
  454. /* file access modes */
  455. #define CEPH_FILE_MODE_PIN 0
  456. #define CEPH_FILE_MODE_RD 1
  457. #define CEPH_FILE_MODE_WR 2
  458. #define CEPH_FILE_MODE_RDWR 3 /* RD | WR */
  459. #define CEPH_FILE_MODE_LAZY 4 /* lazy io */
  460. #define CEPH_FILE_MODE_BITS 4
  461. int ceph_flags_to_mode(int flags);
  462. #define CEPH_INLINE_NONE ((__u64)-1)
  463. /* capability bits */
  464. #define CEPH_CAP_PIN 1 /* no specific capabilities beyond the pin */
  465. /* generic cap bits */
  466. #define CEPH_CAP_GSHARED 1 /* client can reads */
  467. #define CEPH_CAP_GEXCL 2 /* client can read and update */
  468. #define CEPH_CAP_GCACHE 4 /* (file) client can cache reads */
  469. #define CEPH_CAP_GRD 8 /* (file) client can read */
  470. #define CEPH_CAP_GWR 16 /* (file) client can write */
  471. #define CEPH_CAP_GBUFFER 32 /* (file) client can buffer writes */
  472. #define CEPH_CAP_GWREXTEND 64 /* (file) client can extend EOF */
  473. #define CEPH_CAP_GLAZYIO 128 /* (file) client can perform lazy io */
  474. #define CEPH_CAP_SIMPLE_BITS 2
  475. #define CEPH_CAP_FILE_BITS 8
  476. /* per-lock shift */
  477. #define CEPH_CAP_SAUTH 2
  478. #define CEPH_CAP_SLINK 4
  479. #define CEPH_CAP_SXATTR 6
  480. #define CEPH_CAP_SFILE 8
  481. #define CEPH_CAP_SFLOCK 20
  482. #define CEPH_CAP_BITS 22
  483. /* composed values */
  484. #define CEPH_CAP_AUTH_SHARED (CEPH_CAP_GSHARED << CEPH_CAP_SAUTH)
  485. #define CEPH_CAP_AUTH_EXCL (CEPH_CAP_GEXCL << CEPH_CAP_SAUTH)
  486. #define CEPH_CAP_LINK_SHARED (CEPH_CAP_GSHARED << CEPH_CAP_SLINK)
  487. #define CEPH_CAP_LINK_EXCL (CEPH_CAP_GEXCL << CEPH_CAP_SLINK)
  488. #define CEPH_CAP_XATTR_SHARED (CEPH_CAP_GSHARED << CEPH_CAP_SXATTR)
  489. #define CEPH_CAP_XATTR_EXCL (CEPH_CAP_GEXCL << CEPH_CAP_SXATTR)
  490. #define CEPH_CAP_FILE(x) (x << CEPH_CAP_SFILE)
  491. #define CEPH_CAP_FILE_SHARED (CEPH_CAP_GSHARED << CEPH_CAP_SFILE)
  492. #define CEPH_CAP_FILE_EXCL (CEPH_CAP_GEXCL << CEPH_CAP_SFILE)
  493. #define CEPH_CAP_FILE_CACHE (CEPH_CAP_GCACHE << CEPH_CAP_SFILE)
  494. #define CEPH_CAP_FILE_RD (CEPH_CAP_GRD << CEPH_CAP_SFILE)
  495. #define CEPH_CAP_FILE_WR (CEPH_CAP_GWR << CEPH_CAP_SFILE)
  496. #define CEPH_CAP_FILE_BUFFER (CEPH_CAP_GBUFFER << CEPH_CAP_SFILE)
  497. #define CEPH_CAP_FILE_WREXTEND (CEPH_CAP_GWREXTEND << CEPH_CAP_SFILE)
  498. #define CEPH_CAP_FILE_LAZYIO (CEPH_CAP_GLAZYIO << CEPH_CAP_SFILE)
  499. #define CEPH_CAP_FLOCK_SHARED (CEPH_CAP_GSHARED << CEPH_CAP_SFLOCK)
  500. #define CEPH_CAP_FLOCK_EXCL (CEPH_CAP_GEXCL << CEPH_CAP_SFLOCK)
  501. /* cap masks (for getattr) */
  502. #define CEPH_STAT_CAP_INODE CEPH_CAP_PIN
  503. #define CEPH_STAT_CAP_TYPE CEPH_CAP_PIN /* mode >> 12 */
  504. #define CEPH_STAT_CAP_SYMLINK CEPH_CAP_PIN
  505. #define CEPH_STAT_CAP_UID CEPH_CAP_AUTH_SHARED
  506. #define CEPH_STAT_CAP_GID CEPH_CAP_AUTH_SHARED
  507. #define CEPH_STAT_CAP_MODE CEPH_CAP_AUTH_SHARED
  508. #define CEPH_STAT_CAP_NLINK CEPH_CAP_LINK_SHARED
  509. #define CEPH_STAT_CAP_LAYOUT CEPH_CAP_FILE_SHARED
  510. #define CEPH_STAT_CAP_MTIME CEPH_CAP_FILE_SHARED
  511. #define CEPH_STAT_CAP_SIZE CEPH_CAP_FILE_SHARED
  512. #define CEPH_STAT_CAP_ATIME CEPH_CAP_FILE_SHARED /* fixme */
  513. #define CEPH_STAT_CAP_XATTR CEPH_CAP_XATTR_SHARED
  514. #define CEPH_STAT_CAP_INODE_ALL (CEPH_CAP_PIN | \
  515. CEPH_CAP_AUTH_SHARED | \
  516. CEPH_CAP_LINK_SHARED | \
  517. CEPH_CAP_FILE_SHARED | \
  518. CEPH_CAP_XATTR_SHARED)
  519. #define CEPH_STAT_CAP_INLINE_DATA (CEPH_CAP_FILE_SHARED | \
  520. CEPH_CAP_FILE_RD)
  521. #define CEPH_CAP_ANY_SHARED (CEPH_CAP_AUTH_SHARED | \
  522. CEPH_CAP_LINK_SHARED | \
  523. CEPH_CAP_XATTR_SHARED | \
  524. CEPH_CAP_FILE_SHARED)
  525. #define CEPH_CAP_ANY_RD (CEPH_CAP_ANY_SHARED | CEPH_CAP_FILE_RD | \
  526. CEPH_CAP_FILE_CACHE)
  527. #define CEPH_CAP_ANY_EXCL (CEPH_CAP_AUTH_EXCL | \
  528. CEPH_CAP_LINK_EXCL | \
  529. CEPH_CAP_XATTR_EXCL | \
  530. CEPH_CAP_FILE_EXCL)
  531. #define CEPH_CAP_ANY_FILE_RD (CEPH_CAP_FILE_RD | CEPH_CAP_FILE_CACHE | \
  532. CEPH_CAP_FILE_SHARED)
  533. #define CEPH_CAP_ANY_FILE_WR (CEPH_CAP_FILE_WR | CEPH_CAP_FILE_BUFFER | \
  534. CEPH_CAP_FILE_EXCL)
  535. #define CEPH_CAP_ANY_WR (CEPH_CAP_ANY_EXCL | CEPH_CAP_ANY_FILE_WR)
  536. #define CEPH_CAP_ANY (CEPH_CAP_ANY_RD | CEPH_CAP_ANY_EXCL | \
  537. CEPH_CAP_ANY_FILE_WR | CEPH_CAP_FILE_LAZYIO | \
  538. CEPH_CAP_PIN)
  539. #define CEPH_CAP_LOCKS (CEPH_LOCK_IFILE | CEPH_LOCK_IAUTH | CEPH_LOCK_ILINK | \
  540. CEPH_LOCK_IXATTR)
  541. int ceph_caps_for_mode(int mode);
  542. enum {
  543. CEPH_CAP_OP_GRANT, /* mds->client grant */
  544. CEPH_CAP_OP_REVOKE, /* mds->client revoke */
  545. CEPH_CAP_OP_TRUNC, /* mds->client trunc notify */
  546. CEPH_CAP_OP_EXPORT, /* mds has exported the cap */
  547. CEPH_CAP_OP_IMPORT, /* mds has imported the cap */
  548. CEPH_CAP_OP_UPDATE, /* client->mds update */
  549. CEPH_CAP_OP_DROP, /* client->mds drop cap bits */
  550. CEPH_CAP_OP_FLUSH, /* client->mds cap writeback */
  551. CEPH_CAP_OP_FLUSH_ACK, /* mds->client flushed */
  552. CEPH_CAP_OP_FLUSHSNAP, /* client->mds flush snapped metadata */
  553. CEPH_CAP_OP_FLUSHSNAP_ACK, /* mds->client flushed snapped metadata */
  554. CEPH_CAP_OP_RELEASE, /* client->mds release (clean) cap */
  555. CEPH_CAP_OP_RENEW, /* client->mds renewal request */
  556. };
  557. extern const char *ceph_cap_op_name(int op);
  558. /*
  559. * caps message, used for capability callbacks, acks, requests, etc.
  560. */
  561. struct ceph_mds_caps {
  562. __le32 op; /* CEPH_CAP_OP_* */
  563. __le64 ino, realm;
  564. __le64 cap_id;
  565. __le32 seq, issue_seq;
  566. __le32 caps, wanted, dirty; /* latest issued/wanted/dirty */
  567. __le32 migrate_seq;
  568. __le64 snap_follows;
  569. __le32 snap_trace_len;
  570. /* authlock */
  571. __le32 uid, gid, mode;
  572. /* linklock */
  573. __le32 nlink;
  574. /* xattrlock */
  575. __le32 xattr_len;
  576. __le64 xattr_version;
  577. /* filelock */
  578. __le64 size, max_size, truncate_size;
  579. __le32 truncate_seq;
  580. struct ceph_timespec mtime, atime, ctime;
  581. struct ceph_file_layout_legacy layout;
  582. __le32 time_warp_seq;
  583. } __attribute__ ((packed));
  584. struct ceph_mds_cap_peer {
  585. __le64 cap_id;
  586. __le32 seq;
  587. __le32 mseq;
  588. __le32 mds;
  589. __u8 flags;
  590. } __attribute__ ((packed));
  591. /* cap release msg head */
  592. struct ceph_mds_cap_release {
  593. __le32 num; /* number of cap_items that follow */
  594. } __attribute__ ((packed));
  595. struct ceph_mds_cap_item {
  596. __le64 ino;
  597. __le64 cap_id;
  598. __le32 migrate_seq, seq;
  599. } __attribute__ ((packed));
  600. #define CEPH_MDS_LEASE_REVOKE 1 /* mds -> client */
  601. #define CEPH_MDS_LEASE_RELEASE 2 /* client -> mds */
  602. #define CEPH_MDS_LEASE_RENEW 3 /* client <-> mds */
  603. #define CEPH_MDS_LEASE_REVOKE_ACK 4 /* client -> mds */
  604. extern const char *ceph_lease_op_name(int o);
  605. /* lease msg header */
  606. struct ceph_mds_lease {
  607. __u8 action; /* CEPH_MDS_LEASE_* */
  608. __le16 mask; /* which lease */
  609. __le64 ino;
  610. __le64 first, last; /* snap range */
  611. __le32 seq;
  612. __le32 duration_ms; /* duration of renewal */
  613. } __attribute__ ((packed));
  614. /* followed by a __le32+string for dname */
  615. /* client reconnect */
  616. struct ceph_mds_cap_reconnect {
  617. __le64 cap_id;
  618. __le32 wanted;
  619. __le32 issued;
  620. __le64 snaprealm;
  621. __le64 pathbase; /* base ino for our path to this ino */
  622. __le32 flock_len; /* size of flock state blob, if any */
  623. } __attribute__ ((packed));
  624. /* followed by flock blob */
  625. struct ceph_mds_cap_reconnect_v1 {
  626. __le64 cap_id;
  627. __le32 wanted;
  628. __le32 issued;
  629. __le64 size;
  630. struct ceph_timespec mtime, atime;
  631. __le64 snaprealm;
  632. __le64 pathbase; /* base ino for our path to this ino */
  633. } __attribute__ ((packed));
  634. struct ceph_mds_snaprealm_reconnect {
  635. __le64 ino; /* snap realm base */
  636. __le64 seq; /* snap seq for this snap realm */
  637. __le64 parent; /* parent realm */
  638. } __attribute__ ((packed));
  639. /*
  640. * snaps
  641. */
  642. enum {
  643. CEPH_SNAP_OP_UPDATE, /* CREATE or DESTROY */
  644. CEPH_SNAP_OP_CREATE,
  645. CEPH_SNAP_OP_DESTROY,
  646. CEPH_SNAP_OP_SPLIT,
  647. };
  648. extern const char *ceph_snap_op_name(int o);
  649. /* snap msg header */
  650. struct ceph_mds_snap_head {
  651. __le32 op; /* CEPH_SNAP_OP_* */
  652. __le64 split; /* ino to split off, if any */
  653. __le32 num_split_inos; /* # inos belonging to new child realm */
  654. __le32 num_split_realms; /* # child realms udner new child realm */
  655. __le32 trace_len; /* size of snap trace blob */
  656. } __attribute__ ((packed));
  657. /* followed by split ino list, then split realms, then the trace blob */
  658. /*
  659. * encode info about a snaprealm, as viewed by a client
  660. */
  661. struct ceph_mds_snap_realm {
  662. __le64 ino; /* ino */
  663. __le64 created; /* snap: when created */
  664. __le64 parent; /* ino: parent realm */
  665. __le64 parent_since; /* snap: same parent since */
  666. __le64 seq; /* snap: version */
  667. __le32 num_snaps;
  668. __le32 num_prior_parent_snaps;
  669. } __attribute__ ((packed));
  670. /* followed by my snap list, then prior parent snap list */
  671. #endif