Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
rados.h
Go to the documentation of this file.
1 #ifndef CEPH_RADOS_H
2 #define CEPH_RADOS_H
3 
4 /*
5  * Data types for the Ceph distributed object storage layer RADOS
6  * (Reliable Autonomic Distributed Object Store).
7  */
8 
9 #include <linux/ceph/msgr.h>
10 
11 /*
12  * osdmap encoding versions
13  */
14 #define CEPH_OSDMAP_INC_VERSION 5
15 #define CEPH_OSDMAP_INC_VERSION_EXT 6
16 #define CEPH_OSDMAP_VERSION 5
17 #define CEPH_OSDMAP_VERSION_EXT 6
18 
19 /*
20  * fs id
21  */
22 struct ceph_fsid {
23  unsigned char fsid[16];
24 };
25 
26 static inline int ceph_fsid_compare(const struct ceph_fsid *a,
27  const struct ceph_fsid *b)
28 {
29  return memcmp(a, b, sizeof(*a));
30 }
31 
32 /*
33  * ino, object, etc.
34  */
36 #define CEPH_SNAPDIR ((__u64)(-1)) /* reserved for hidden .snap dir */
37 #define CEPH_NOSNAP ((__u64)(-2)) /* "head", "live" revision */
38 #define CEPH_MAXSNAP ((__u64)(-3)) /* largest valid snapid */
39 
40 struct ceph_timespec {
43 } __attribute__ ((packed));
44 
45 
46 /*
47  * object layout - how objects are mapped into PGs
48  */
49 #define CEPH_OBJECT_LAYOUT_HASH 1
50 #define CEPH_OBJECT_LAYOUT_LINEAR 2
51 #define CEPH_OBJECT_LAYOUT_HASHINO 3
52 
53 /*
54  * pg layout -- how PGs are mapped onto (sets of) OSDs
55  */
56 #define CEPH_PG_LAYOUT_CRUSH 0
57 #define CEPH_PG_LAYOUT_HASH 1
58 #define CEPH_PG_LAYOUT_LINEAR 2
59 #define CEPH_PG_LAYOUT_HYBRID 3
60 
61 #define CEPH_PG_MAX_SIZE 16 /* max # osds in a single pg */
62 
63 /*
64  * placement group.
65  * we encode this into one __le64.
66  */
67 struct ceph_pg {
68  __le16 preferred; /* preferred primary osd */
69  __le16 ps; /* placement seed */
70  __le32 pool; /* object pool */
71 } __attribute__ ((packed));
72 
73 /*
74  * pg_pool is a set of pgs storing a pool of objects
75  *
76  * pg_num -- base number of pseudorandomly placed pgs
77  *
78  * pgp_num -- effective number when calculating pg placement. this
79  * is used for pg_num increases. new pgs result in data being "split"
80  * into new pgs. for this to proceed smoothly, new pgs are intiially
81  * colocated with their parents; that is, pgp_num doesn't increase
82  * until the new pgs have successfully split. only _then_ are the new
83  * pgs placed independently.
84  *
85  * lpg_num -- localized pg count (per device). replicas are randomly
86  * selected.
87  *
88  * lpgp_num -- as above.
89  */
90 #define CEPH_PG_TYPE_REP 1
91 #define CEPH_PG_TYPE_RAID4 2
92 #define CEPH_PG_POOL_VERSION 2
93 struct ceph_pg_pool {
94  __u8 type; /* CEPH_PG_TYPE_* */
95  __u8 size; /* number of osds in each pg */
96  __u8 crush_ruleset; /* crush placement rule */
97  __u8 object_hash; /* hash mapping object name to ps */
98  __le32 pg_num, pgp_num; /* number of pg's */
99  __le32 lpg_num, lpgp_num; /* number of localized pg's */
100  __le32 last_change; /* most recent epoch changed */
101  __le64 snap_seq; /* seq for per-pool snapshot */
102  __le32 snap_epoch; /* epoch of last snap */
104  __le32 num_removed_snap_intervals; /* if non-empty, NO per-pool snaps */
105  __le64 auid; /* who owns the pg */
106 } __attribute__ ((packed));
108 /*
109  * stable_mod func is used to control number of placement groups.
110  * similar to straight-up modulo, but produces a stable mapping as b
111  * increases over time. b is the number of bins, and bmask is the
112  * containing power of 2 minus 1.
113  *
114  * b <= bmask and bmask=(2**n)-1
115  * e.g., b=12 -> bmask=15, b=123 -> bmask=127
116  */
117 static inline int ceph_stable_mod(int x, int b, int bmask)
118 {
119  if ((x & bmask) < b)
120  return x & bmask;
121  else
122  return x & (bmask >> 1);
123 }
124 
125 /*
126  * object layout - how a given object should be stored.
127  */
129  struct ceph_pg ol_pgid; /* raw pg, with _full_ ps precision. */
130  __le32 ol_stripe_unit; /* for per-object parity, if any */
131 } __attribute__ ((packed));
133 /*
134  * compound epoch+version, used by storage layer to serialize mutations
135  */
139 } __attribute__ ((packed));
141 /*
142  * osd map bits
143  */
144 
145 /* status bits */
146 #define CEPH_OSD_EXISTS 1
147 #define CEPH_OSD_UP 2
148 
149 /* osd weights. fixed point value: 0x10000 == 1.0 ("in"), 0 == "out" */
150 #define CEPH_OSD_IN 0x10000
151 #define CEPH_OSD_OUT 0
152 
153 
154 /*
155  * osd map flag bits
156  */
157 #define CEPH_OSDMAP_NEARFULL (1<<0) /* sync writes (near ENOSPC) */
158 #define CEPH_OSDMAP_FULL (1<<1) /* no data writes (ENOSPC) */
159 #define CEPH_OSDMAP_PAUSERD (1<<2) /* pause all reads */
160 #define CEPH_OSDMAP_PAUSEWR (1<<3) /* pause all writes */
161 #define CEPH_OSDMAP_PAUSEREC (1<<4) /* pause recovery */
162 
163 /*
164  * osd ops
165  */
166 #define CEPH_OSD_OP_MODE 0xf000
167 #define CEPH_OSD_OP_MODE_RD 0x1000
168 #define CEPH_OSD_OP_MODE_WR 0x2000
169 #define CEPH_OSD_OP_MODE_RMW 0x3000
170 #define CEPH_OSD_OP_MODE_SUB 0x4000
171 
172 #define CEPH_OSD_OP_TYPE 0x0f00
173 #define CEPH_OSD_OP_TYPE_LOCK 0x0100
174 #define CEPH_OSD_OP_TYPE_DATA 0x0200
175 #define CEPH_OSD_OP_TYPE_ATTR 0x0300
176 #define CEPH_OSD_OP_TYPE_EXEC 0x0400
177 #define CEPH_OSD_OP_TYPE_PG 0x0500
178 
179 enum {
181  /* read */
185 
186  /* fancy read */
189 
192 
193  /* versioning */
195 
196  /* write */
202 
203  /* fancy write */
208 
212 
215 
217 
219  /* read */
223 
224  /* write */
229 
239 
247 
250 
253 };
254 
255 static inline int ceph_osd_op_type_lock(int op)
256 {
257  return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_LOCK;
258 }
259 static inline int ceph_osd_op_type_data(int op)
260 {
261  return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_DATA;
262 }
263 static inline int ceph_osd_op_type_attr(int op)
264 {
265  return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_ATTR;
266 }
267 static inline int ceph_osd_op_type_exec(int op)
268 {
269  return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_EXEC;
270 }
271 static inline int ceph_osd_op_type_pg(int op)
272 {
273  return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_PG;
274 }
275 
276 static inline int ceph_osd_op_mode_subop(int op)
277 {
278  return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_SUB;
279 }
280 static inline int ceph_osd_op_mode_read(int op)
281 {
282  return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_RD;
283 }
284 static inline int ceph_osd_op_mode_modify(int op)
285 {
286  return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_WR;
287 }
288 
289 /*
290  * note that the following tmap stuff is also defined in the ceph librados.h
291  * any modification here needs to be updated there
292  */
293 #define CEPH_OSD_TMAP_HDR 'h'
294 #define CEPH_OSD_TMAP_SET 's'
295 #define CEPH_OSD_TMAP_RM 'r'
296 
297 extern const char *ceph_osd_op_name(int op);
298 
299 
300 /*
301  * osd op flags
302  *
303  * An op may be READ, WRITE, or READ|WRITE.
304  */
305 enum {
306  CEPH_OSD_FLAG_ACK = 1, /* want (or is) "ack" ack */
307  CEPH_OSD_FLAG_ONNVRAM = 2, /* want (or is) "onnvram" ack */
308  CEPH_OSD_FLAG_ONDISK = 4, /* want (or is) "ondisk" ack */
309  CEPH_OSD_FLAG_RETRY = 8, /* resend attempt */
310  CEPH_OSD_FLAG_READ = 16, /* op may read */
311  CEPH_OSD_FLAG_WRITE = 32, /* op may write */
312  CEPH_OSD_FLAG_ORDERSNAP = 64, /* EOLDSNAP if snapc is out of order */
313  CEPH_OSD_FLAG_PEERSTAT = 128, /* msg includes osd_peer_stat */
315  CEPH_OSD_FLAG_PARALLELEXEC = 512, /* execute op in parallel */
316  CEPH_OSD_FLAG_PGOP = 1024, /* pg op, no object */
317  CEPH_OSD_FLAG_EXEC = 2048, /* op may exec */
318  CEPH_OSD_FLAG_EXEC_PUBLIC = 4096, /* op may exec (public) */
319 };
320 
321 enum {
322  CEPH_OSD_OP_FLAG_EXCL = 1, /* EXCL object create */
323 };
324 
325 #define EOLDSNAPC ERESTART /* ORDERSNAP flag set; writer has old snapc*/
326 #define EBLACKLISTED ESHUTDOWN /* blacklisted */
327 
328 /* xattr comparison */
329 enum {
337 };
338 
339 enum {
342 };
343 
344 #define RADOS_NOTIFY_VER 1
345 
346 /*
347  * an individual object operation. each may be accompanied by some data
348  * payload
349  */
350 struct ceph_osd_op {
351  __le16 op; /* CEPH_OSD_OP_* */
352  __le32 flags; /* CEPH_OSD_FLAG_* */
353  union {
354  struct {
358  } __attribute__ ((packed)) extent;
362  __u8 cmp_op; /* CEPH_OSD_CMPXATTR_OP_* */
363  __u8 cmp_mode; /* CEPH_OSD_CMPXATTR_MODE_* */
364  } __attribute__ ((packed)) xattr;
370  } __attribute__ ((packed)) cls;
373  } __attribute__ ((packed)) pgls;
376  } __attribute__ ((packed)) snap;
378  __le64 cookie;
380  __u8 flag; /* 0 = unwatch, 1 = watch */
381  } __attribute__ ((packed)) watch;
382 };
384 } __attribute__ ((packed));
386 /*
387  * osd request message header. each request may include multiple
388  * ceph_osd_op object operations.
389  */
391  __le32 client_inc; /* client incarnation */
392  struct ceph_object_layout layout; /* pgid */
393  __le32 osdmap_epoch; /* client's osdmap epoch */
394 
396 
397  struct ceph_timespec mtime; /* for mutations only */
398  struct ceph_eversion reassert_version; /* if we are replaying op */
399 
400  __le32 object_len; /* length of object name */
401 
402  __le64 snapid; /* snapid to read */
403  __le64 snap_seq; /* writer's snap context */
405 
407  struct ceph_osd_op ops[]; /* followed by ops[], obj, ticket, snaps */
408 } __attribute__ ((packed));
411  __le32 client_inc; /* client incarnation */
415  struct ceph_eversion reassert_version; /* for replaying uncommitted */
417  __le32 result; /* result code */
419  __le32 object_len; /* length of object name */
421  struct ceph_osd_op ops[0]; /* ops[], object */
422 } __attribute__ ((packed));
423 
426 #endif