rados.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427
  1. #ifndef CEPH_RADOS_H
  2. #define CEPH_RADOS_H
  3. /*
  4. * Data types for the Ceph distributed object storage layer RADOS
  5. * (Reliable Autonomic Distributed Object Store).
  6. */
  7. #include "msgr.h"
  8. /*
  9. * osdmap encoding versions
  10. */
  11. #define CEPH_OSDMAP_INC_VERSION 5
  12. #define CEPH_OSDMAP_INC_VERSION_EXT 6
  13. #define CEPH_OSDMAP_VERSION 5
  14. #define CEPH_OSDMAP_VERSION_EXT 6
  15. /*
  16. * fs id
  17. */
  18. struct ceph_fsid {
  19. unsigned char fsid[16];
  20. };
  21. static inline int ceph_fsid_compare(const struct ceph_fsid *a,
  22. const struct ceph_fsid *b)
  23. {
  24. return memcmp(a, b, sizeof(*a));
  25. }
  26. /*
  27. * ino, object, etc.
  28. */
  29. typedef __le64 ceph_snapid_t;
  30. #define CEPH_SNAPDIR ((__u64)(-1)) /* reserved for hidden .snap dir */
  31. #define CEPH_NOSNAP ((__u64)(-2)) /* "head", "live" revision */
  32. #define CEPH_MAXSNAP ((__u64)(-3)) /* largest valid snapid */
  33. struct ceph_timespec {
  34. __le32 tv_sec;
  35. __le32 tv_nsec;
  36. } __attribute__ ((packed));
  37. /*
  38. * object layout - how objects are mapped into PGs
  39. */
  40. #define CEPH_OBJECT_LAYOUT_HASH 1
  41. #define CEPH_OBJECT_LAYOUT_LINEAR 2
  42. #define CEPH_OBJECT_LAYOUT_HASHINO 3
  43. /*
  44. * pg layout -- how PGs are mapped onto (sets of) OSDs
  45. */
  46. #define CEPH_PG_LAYOUT_CRUSH 0
  47. #define CEPH_PG_LAYOUT_HASH 1
  48. #define CEPH_PG_LAYOUT_LINEAR 2
  49. #define CEPH_PG_LAYOUT_HYBRID 3
  50. #define CEPH_PG_MAX_SIZE 16 /* max # osds in a single pg */
  51. /*
  52. * placement group.
  53. * we encode this into one __le64.
  54. */
  55. struct ceph_pg {
  56. __le16 preferred; /* preferred primary osd */
  57. __le16 ps; /* placement seed */
  58. __le32 pool; /* object pool */
  59. } __attribute__ ((packed));
  60. /*
  61. * pg_pool is a set of pgs storing a pool of objects
  62. *
  63. * pg_num -- base number of pseudorandomly placed pgs
  64. *
  65. * pgp_num -- effective number when calculating pg placement. this
  66. * is used for pg_num increases. new pgs result in data being "split"
  67. * into new pgs. for this to proceed smoothly, new pgs are intiially
  68. * colocated with their parents; that is, pgp_num doesn't increase
  69. * until the new pgs have successfully split. only _then_ are the new
  70. * pgs placed independently.
  71. *
  72. * lpg_num -- localized pg count (per device). replicas are randomly
  73. * selected.
  74. *
  75. * lpgp_num -- as above.
  76. */
  77. #define CEPH_PG_TYPE_REP 1
  78. #define CEPH_PG_TYPE_RAID4 2
  79. #define CEPH_PG_POOL_VERSION 2
  80. struct ceph_pg_pool {
  81. __u8 type; /* CEPH_PG_TYPE_* */
  82. __u8 size; /* number of osds in each pg */
  83. __u8 crush_ruleset; /* crush placement rule */
  84. __u8 object_hash; /* hash mapping object name to ps */
  85. __le32 pg_num, pgp_num; /* number of pg's */
  86. __le32 lpg_num, lpgp_num; /* number of localized pg's */
  87. __le32 last_change; /* most recent epoch changed */
  88. __le64 snap_seq; /* seq for per-pool snapshot */
  89. __le32 snap_epoch; /* epoch of last snap */
  90. __le32 num_snaps;
  91. __le32 num_removed_snap_intervals; /* if non-empty, NO per-pool snaps */
  92. __le64 auid; /* who owns the pg */
  93. } __attribute__ ((packed));
  94. /*
  95. * stable_mod func is used to control number of placement groups.
  96. * similar to straight-up modulo, but produces a stable mapping as b
  97. * increases over time. b is the number of bins, and bmask is the
  98. * containing power of 2 minus 1.
  99. *
  100. * b <= bmask and bmask=(2**n)-1
  101. * e.g., b=12 -> bmask=15, b=123 -> bmask=127
  102. */
  103. static inline int ceph_stable_mod(int x, int b, int bmask)
  104. {
  105. if ((x & bmask) < b)
  106. return x & bmask;
  107. else
  108. return x & (bmask >> 1);
  109. }
  110. /*
  111. * object layout - how a given object should be stored.
  112. */
  113. struct ceph_object_layout {
  114. struct ceph_pg ol_pgid; /* raw pg, with _full_ ps precision. */
  115. __le32 ol_stripe_unit; /* for per-object parity, if any */
  116. } __attribute__ ((packed));
  117. /*
  118. * compound epoch+version, used by storage layer to serialize mutations
  119. */
  120. struct ceph_eversion {
  121. __le32 epoch;
  122. __le64 version;
  123. } __attribute__ ((packed));
  124. /*
  125. * osd map bits
  126. */
  127. /* status bits */
  128. #define CEPH_OSD_EXISTS 1
  129. #define CEPH_OSD_UP 2
  130. /* osd weights. fixed point value: 0x10000 == 1.0 ("in"), 0 == "out" */
  131. #define CEPH_OSD_IN 0x10000
  132. #define CEPH_OSD_OUT 0
  133. /*
  134. * osd map flag bits
  135. */
  136. #define CEPH_OSDMAP_NEARFULL (1<<0) /* sync writes (near ENOSPC) */
  137. #define CEPH_OSDMAP_FULL (1<<1) /* no data writes (ENOSPC) */
  138. #define CEPH_OSDMAP_PAUSERD (1<<2) /* pause all reads */
  139. #define CEPH_OSDMAP_PAUSEWR (1<<3) /* pause all writes */
  140. #define CEPH_OSDMAP_PAUSEREC (1<<4) /* pause recovery */
  141. /*
  142. * osd ops
  143. */
  144. #define CEPH_OSD_OP_MODE 0xf000
  145. #define CEPH_OSD_OP_MODE_RD 0x1000
  146. #define CEPH_OSD_OP_MODE_WR 0x2000
  147. #define CEPH_OSD_OP_MODE_RMW 0x3000
  148. #define CEPH_OSD_OP_MODE_SUB 0x4000
  149. #define CEPH_OSD_OP_TYPE 0x0f00
  150. #define CEPH_OSD_OP_TYPE_LOCK 0x0100
  151. #define CEPH_OSD_OP_TYPE_DATA 0x0200
  152. #define CEPH_OSD_OP_TYPE_ATTR 0x0300
  153. #define CEPH_OSD_OP_TYPE_EXEC 0x0400
  154. #define CEPH_OSD_OP_TYPE_PG 0x0500
  155. enum {
  156. /** data **/
  157. /* read */
  158. CEPH_OSD_OP_READ = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 1,
  159. CEPH_OSD_OP_STAT = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 2,
  160. CEPH_OSD_OP_MAPEXT = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 3,
  161. /* fancy read */
  162. CEPH_OSD_OP_MASKTRUNC = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 4,
  163. CEPH_OSD_OP_SPARSE_READ = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 5,
  164. CEPH_OSD_OP_NOTIFY = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 6,
  165. CEPH_OSD_OP_NOTIFY_ACK = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 7,
  166. /* versioning */
  167. CEPH_OSD_OP_ASSERT_VER = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 8,
  168. /* write */
  169. CEPH_OSD_OP_WRITE = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 1,
  170. CEPH_OSD_OP_WRITEFULL = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 2,
  171. CEPH_OSD_OP_TRUNCATE = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 3,
  172. CEPH_OSD_OP_ZERO = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 4,
  173. CEPH_OSD_OP_DELETE = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 5,
  174. /* fancy write */
  175. CEPH_OSD_OP_APPEND = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 6,
  176. CEPH_OSD_OP_STARTSYNC = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 7,
  177. CEPH_OSD_OP_SETTRUNC = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 8,
  178. CEPH_OSD_OP_TRIMTRUNC = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 9,
  179. CEPH_OSD_OP_TMAPUP = CEPH_OSD_OP_MODE_RMW | CEPH_OSD_OP_TYPE_DATA | 10,
  180. CEPH_OSD_OP_TMAPPUT = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 11,
  181. CEPH_OSD_OP_TMAPGET = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_DATA | 12,
  182. CEPH_OSD_OP_CREATE = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 13,
  183. CEPH_OSD_OP_ROLLBACK= CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 14,
  184. CEPH_OSD_OP_WATCH = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_DATA | 15,
  185. /** attrs **/
  186. /* read */
  187. CEPH_OSD_OP_GETXATTR = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_ATTR | 1,
  188. CEPH_OSD_OP_GETXATTRS = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_ATTR | 2,
  189. CEPH_OSD_OP_CMPXATTR = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_ATTR | 3,
  190. /* write */
  191. CEPH_OSD_OP_SETXATTR = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_ATTR | 1,
  192. CEPH_OSD_OP_SETXATTRS = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_ATTR | 2,
  193. CEPH_OSD_OP_RESETXATTRS = CEPH_OSD_OP_MODE_WR|CEPH_OSD_OP_TYPE_ATTR | 3,
  194. CEPH_OSD_OP_RMXATTR = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_ATTR | 4,
  195. /** subop **/
  196. CEPH_OSD_OP_PULL = CEPH_OSD_OP_MODE_SUB | 1,
  197. CEPH_OSD_OP_PUSH = CEPH_OSD_OP_MODE_SUB | 2,
  198. CEPH_OSD_OP_BALANCEREADS = CEPH_OSD_OP_MODE_SUB | 3,
  199. CEPH_OSD_OP_UNBALANCEREADS = CEPH_OSD_OP_MODE_SUB | 4,
  200. CEPH_OSD_OP_SCRUB = CEPH_OSD_OP_MODE_SUB | 5,
  201. CEPH_OSD_OP_SCRUB_RESERVE = CEPH_OSD_OP_MODE_SUB | 6,
  202. CEPH_OSD_OP_SCRUB_UNRESERVE = CEPH_OSD_OP_MODE_SUB | 7,
  203. CEPH_OSD_OP_SCRUB_STOP = CEPH_OSD_OP_MODE_SUB | 8,
  204. /** lock **/
  205. CEPH_OSD_OP_WRLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 1,
  206. CEPH_OSD_OP_WRUNLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 2,
  207. CEPH_OSD_OP_RDLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 3,
  208. CEPH_OSD_OP_RDUNLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 4,
  209. CEPH_OSD_OP_UPLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 5,
  210. CEPH_OSD_OP_DNLOCK = CEPH_OSD_OP_MODE_WR | CEPH_OSD_OP_TYPE_LOCK | 6,
  211. /** exec **/
  212. CEPH_OSD_OP_CALL = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_EXEC | 1,
  213. /** pg **/
  214. CEPH_OSD_OP_PGLS = CEPH_OSD_OP_MODE_RD | CEPH_OSD_OP_TYPE_PG | 1,
  215. };
  216. static inline int ceph_osd_op_type_lock(int op)
  217. {
  218. return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_LOCK;
  219. }
  220. static inline int ceph_osd_op_type_data(int op)
  221. {
  222. return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_DATA;
  223. }
  224. static inline int ceph_osd_op_type_attr(int op)
  225. {
  226. return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_ATTR;
  227. }
  228. static inline int ceph_osd_op_type_exec(int op)
  229. {
  230. return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_EXEC;
  231. }
  232. static inline int ceph_osd_op_type_pg(int op)
  233. {
  234. return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_PG;
  235. }
  236. static inline int ceph_osd_op_mode_subop(int op)
  237. {
  238. return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_SUB;
  239. }
  240. static inline int ceph_osd_op_mode_read(int op)
  241. {
  242. return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_RD;
  243. }
  244. static inline int ceph_osd_op_mode_modify(int op)
  245. {
  246. return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_WR;
  247. }
  248. /*
  249. * note that the following tmap stuff is also defined in the ceph librados.h
  250. * any modification here needs to be updated there
  251. */
  252. #define CEPH_OSD_TMAP_HDR 'h'
  253. #define CEPH_OSD_TMAP_SET 's'
  254. #define CEPH_OSD_TMAP_RM 'r'
  255. extern const char *ceph_osd_op_name(int op);
  256. /*
  257. * osd op flags
  258. *
  259. * An op may be READ, WRITE, or READ|WRITE.
  260. */
  261. enum {
  262. CEPH_OSD_FLAG_ACK = 1, /* want (or is) "ack" ack */
  263. CEPH_OSD_FLAG_ONNVRAM = 2, /* want (or is) "onnvram" ack */
  264. CEPH_OSD_FLAG_ONDISK = 4, /* want (or is) "ondisk" ack */
  265. CEPH_OSD_FLAG_RETRY = 8, /* resend attempt */
  266. CEPH_OSD_FLAG_READ = 16, /* op may read */
  267. CEPH_OSD_FLAG_WRITE = 32, /* op may write */
  268. CEPH_OSD_FLAG_ORDERSNAP = 64, /* EOLDSNAP if snapc is out of order */
  269. CEPH_OSD_FLAG_PEERSTAT = 128, /* msg includes osd_peer_stat */
  270. CEPH_OSD_FLAG_BALANCE_READS = 256,
  271. CEPH_OSD_FLAG_PARALLELEXEC = 512, /* execute op in parallel */
  272. CEPH_OSD_FLAG_PGOP = 1024, /* pg op, no object */
  273. CEPH_OSD_FLAG_EXEC = 2048, /* op may exec */
  274. CEPH_OSD_FLAG_EXEC_PUBLIC = 4096, /* op may exec (public) */
  275. };
  276. enum {
  277. CEPH_OSD_OP_FLAG_EXCL = 1, /* EXCL object create */
  278. };
  279. #define EOLDSNAPC ERESTART /* ORDERSNAP flag set; writer has old snapc*/
  280. #define EBLACKLISTED ESHUTDOWN /* blacklisted */
  281. /* xattr comparison */
  282. enum {
  283. CEPH_OSD_CMPXATTR_OP_NOP = 0,
  284. CEPH_OSD_CMPXATTR_OP_EQ = 1,
  285. CEPH_OSD_CMPXATTR_OP_NE = 2,
  286. CEPH_OSD_CMPXATTR_OP_GT = 3,
  287. CEPH_OSD_CMPXATTR_OP_GTE = 4,
  288. CEPH_OSD_CMPXATTR_OP_LT = 5,
  289. CEPH_OSD_CMPXATTR_OP_LTE = 6
  290. };
  291. enum {
  292. CEPH_OSD_CMPXATTR_MODE_STRING = 1,
  293. CEPH_OSD_CMPXATTR_MODE_U64 = 2
  294. };
  295. #define RADOS_NOTIFY_VER 1
  296. /*
  297. * an individual object operation. each may be accompanied by some data
  298. * payload
  299. */
  300. struct ceph_osd_op {
  301. __le16 op; /* CEPH_OSD_OP_* */
  302. __le32 flags; /* CEPH_OSD_FLAG_* */
  303. union {
  304. struct {
  305. __le64 offset, length;
  306. __le64 truncate_size;
  307. __le32 truncate_seq;
  308. } __attribute__ ((packed)) extent;
  309. struct {
  310. __le32 name_len;
  311. __le32 value_len;
  312. __u8 cmp_op; /* CEPH_OSD_CMPXATTR_OP_* */
  313. __u8 cmp_mode; /* CEPH_OSD_CMPXATTR_MODE_* */
  314. } __attribute__ ((packed)) xattr;
  315. struct {
  316. __u8 class_len;
  317. __u8 method_len;
  318. __u8 argc;
  319. __le32 indata_len;
  320. } __attribute__ ((packed)) cls;
  321. struct {
  322. __le64 cookie, count;
  323. } __attribute__ ((packed)) pgls;
  324. struct {
  325. __le64 snapid;
  326. } __attribute__ ((packed)) snap;
  327. struct {
  328. __le64 cookie;
  329. __le64 ver;
  330. __u8 flag; /* 0 = unwatch, 1 = watch */
  331. } __attribute__ ((packed)) watch;
  332. };
  333. __le32 payload_len;
  334. } __attribute__ ((packed));
  335. /*
  336. * osd request message header. each request may include multiple
  337. * ceph_osd_op object operations.
  338. */
  339. struct ceph_osd_request_head {
  340. __le32 client_inc; /* client incarnation */
  341. struct ceph_object_layout layout; /* pgid */
  342. __le32 osdmap_epoch; /* client's osdmap epoch */
  343. __le32 flags;
  344. struct ceph_timespec mtime; /* for mutations only */
  345. struct ceph_eversion reassert_version; /* if we are replaying op */
  346. __le32 object_len; /* length of object name */
  347. __le64 snapid; /* snapid to read */
  348. __le64 snap_seq; /* writer's snap context */
  349. __le32 num_snaps;
  350. __le16 num_ops;
  351. struct ceph_osd_op ops[]; /* followed by ops[], obj, ticket, snaps */
  352. } __attribute__ ((packed));
  353. struct ceph_osd_reply_head {
  354. __le32 client_inc; /* client incarnation */
  355. __le32 flags;
  356. struct ceph_object_layout layout;
  357. __le32 osdmap_epoch;
  358. struct ceph_eversion reassert_version; /* for replaying uncommitted */
  359. __le32 result; /* result code */
  360. __le32 object_len; /* length of object name */
  361. __le32 num_ops;
  362. struct ceph_osd_op ops[0]; /* ops[], object */
  363. } __attribute__ ((packed));
  364. #endif