]> git.proxmox.com Git - ceph.git/blame - ceph/src/include/rados.h
projects / ceph.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
bump version to 12.1.1-pve1 while rebasing patches
[ceph.git] / ceph / src / include / rados.h
CommitLineData
7c673cae
FG		 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 "msgr.h"
10
11/*
12 * fs id
13 */
14struct ceph_fsid {
15 unsigned char fsid[16];
16};
17
18static inline int ceph_fsid_compare(const struct ceph_fsid *a,
19 const struct ceph_fsid *b)
20{
21 return memcmp(a, b, sizeof(*a));
22}
23
24/*
25 * ino, object, etc.
26 */
27typedef __le64 ceph_snapid_t;
28#define CEPH_SNAPDIR ((__u64)(-1)) /* reserved for hidden .snap dir */
29#define CEPH_NOSNAP ((__u64)(-2)) /* "head", "live" revision */
30#define CEPH_MAXSNAP ((__u64)(-3)) /* largest valid snapid */
31
32struct ceph_timespec {
33 __le32 tv_sec;
34 __le32 tv_nsec;
35} __attribute__ ((packed));
36
37
38/*
39 * object layout - how objects are mapped into PGs
40 */
41#define CEPH_OBJECT_LAYOUT_HASH 1
42#define CEPH_OBJECT_LAYOUT_LINEAR 2
43#define CEPH_OBJECT_LAYOUT_HASHINO 3
44
45/*
46 * pg layout -- how PGs are mapped onto (sets of) OSDs
47 */
48#define CEPH_PG_LAYOUT_CRUSH 0
49#define CEPH_PG_LAYOUT_HASH 1
50#define CEPH_PG_LAYOUT_LINEAR 2
51#define CEPH_PG_LAYOUT_HYBRID 3
52
53#define CEPH_PG_MAX_SIZE 16 /* max # osds in a single pg */
54
55/*
56 * placement group.
57 * we encode this into one __le64.
58 */
59struct ceph_pg {
60 __le16 preferred; /* preferred primary osd */
61 __le16 ps; /* placement seed */
62 __le32 pool; /* object pool */
63} __attribute__ ((packed));
64
65/*
66 * pg pool types
67 *
68 * NOTE: These map 1:1 on to the pg_pool_t::TYPE_* values. They are
69 * duplicated here only for CrushCompiler's benefit.
70 */
71#define CEPH_PG_TYPE_REPLICATED 1
72/* #define CEPH_PG_TYPE_RAID4 2 never implemented */
73#define CEPH_PG_TYPE_ERASURE 3
74
75/*
76 * stable_mod func is used to control number of placement groups.
77 * similar to straight-up modulo, but produces a stable mapping as b
78 * increases over time. b is the number of bins, and bmask is the
79 * containing power of 2 minus 1.
80 *
81 * b <= bmask and bmask=(2**n)-1
82 * e.g., b=12 -> bmask=15, b=123 -> bmask=127
83 */
84static inline int ceph_stable_mod(int x, int b, int bmask)
85{
86 if ((x & bmask) < b)
87 return x & bmask;
88 else
89 return x & (bmask >> 1);
90}
91
92/*
93 * object layout - how a given object should be stored.
94 */
95struct ceph_object_layout {
96 struct ceph_pg ol_pgid; /* raw pg, with _full_ ps precision. */
97 __le32 ol_stripe_unit; /* for per-object parity, if any */
98} __attribute__ ((packed));
99
100/*
101 * compound epoch+version, used by storage layer to serialize mutations
102 */
103struct ceph_eversion {
104 __le32 epoch;
105 __le64 version;
106} __attribute__ ((packed));
107
108/*
109 * osd map bits
110 */
111
112/* status bits */
31f18b77
FG		 113#define CEPH_OSD_EXISTS (1<<0)
114#define CEPH_OSD_UP (1<<1)
115#define CEPH_OSD_AUTOOUT (1<<2) /* osd was automatically marked out */
116#define CEPH_OSD_NEW (1<<3) /* osd is new, never marked in */
117#define CEPH_OSD_FULL (1<<4) /* osd is at or above full threshold */
118#define CEPH_OSD_NEARFULL (1<<5) /* osd is at or above nearfull threshold */
119#define CEPH_OSD_BACKFILLFULL (1<<6) /* osd is at or above backfillfull threshold */
120#define CEPH_OSD_DESTROYED (1<<7) /* osd has been destroyed */
121#define CEPH_OSD_NOUP (1<<8) /* osd can not be marked up */
122#define CEPH_OSD_NODOWN (1<<9) /* osd can not be marked down */
123#define CEPH_OSD_NOIN (1<<10) /* osd can not be marked in */
124#define CEPH_OSD_NOOUT (1<<11) /* osd can not be marked out */
7c673cae
FG		 125
126extern const char *ceph_osd_state_name(int s);
127
128/* osd weights. fixed point value: 0x10000 == 1.0 ("in"), 0 == "out" */
129#define CEPH_OSD_IN 0x10000
130#define CEPH_OSD_OUT 0
131
132#define CEPH_OSD_MAX_PRIMARY_AFFINITY 0x10000
133#define CEPH_OSD_DEFAULT_PRIMARY_AFFINITY 0x10000
134
135
136/*
137 * osd map flag bits
138 */
31f18b77
FG		 139#define CEPH_OSDMAP_NEARFULL (1<<0) /* sync writes (near ENOSPC) */
140#define CEPH_OSDMAP_FULL (1<<1) /* no data writes (ENOSPC) */
141#define CEPH_OSDMAP_PAUSERD (1<<2) /* pause all reads */
142#define CEPH_OSDMAP_PAUSEWR (1<<3) /* pause all writes */
143#define CEPH_OSDMAP_PAUSEREC (1<<4) /* pause recovery */
144#define CEPH_OSDMAP_NOUP (1<<5) /* block osd boot */
145#define CEPH_OSDMAP_NODOWN (1<<6) /* block osd mark-down/failure */
146#define CEPH_OSDMAP_NOOUT (1<<7) /* block osd auto mark-out */
147#define CEPH_OSDMAP_NOIN (1<<8) /* block osd auto mark-in */
148#define CEPH_OSDMAP_NOBACKFILL (1<<9) /* block osd backfill */
149#define CEPH_OSDMAP_NORECOVER (1<<10) /* block osd recovery and backfill */
150#define CEPH_OSDMAP_NOSCRUB (1<<11) /* block periodic scrub */
151#define CEPH_OSDMAP_NODEEP_SCRUB (1<<12) /* block periodic deep-scrub */
152#define CEPH_OSDMAP_NOTIERAGENT (1<<13) /* disable tiering agent */
153#define CEPH_OSDMAP_NOREBALANCE (1<<14) /* block osd backfill unless pg is degraded */
154#define CEPH_OSDMAP_SORTBITWISE (1<<15) /* use bitwise hobject_t sort */
155#define CEPH_OSDMAP_REQUIRE_JEWEL (1<<16) /* require jewel for booting osds */
156#define CEPH_OSDMAP_REQUIRE_KRAKEN (1<<17) /* require kraken for booting osds */
7c673cae
FG		 157#define CEPH_OSDMAP_REQUIRE_LUMINOUS (1<<18) /* require l for booting osds */
158
159/* these are hidden in 'ceph status' view */
160#define CEPH_OSDMAP_SEMIHIDDEN_FLAGS (CEPH_OSDMAP_REQUIRE_JEWEL| \
161 CEPH_OSDMAP_REQUIRE_KRAKEN | \
162 CEPH_OSDMAP_REQUIRE_LUMINOUS | \
163 CEPH_OSDMAP_SORTBITWISE)
31f18b77
FG		 164#define CEPH_OSDMAP_LEGACY_REQUIRE_FLAGS (CEPH_OSDMAP_REQUIRE_JEWEL | \
165 CEPH_OSDMAP_REQUIRE_KRAKEN | \
166 CEPH_OSDMAP_REQUIRE_LUMINOUS)
167
168/*
169 * major ceph release numbers
170 */
171#define CEPH_RELEASE_ARGONAUT 1
172#define CEPH_RELEASE_BOBTAIL 2
173#define CEPH_RELEASE_CUTTLEFISH 3
174#define CEPH_RELEASE_DUMPLING 4
175#define CEPH_RELEASE_EMPEROR 5
176#define CEPH_RELEASE_FIREFLY 6
177#define CEPH_RELEASE_GIANT 7
178#define CEPH_RELEASE_HAMMER 8
179#define CEPH_RELEASE_INFERNALIS 9
180#define CEPH_RELEASE_JEWEL 10
181#define CEPH_RELEASE_KRAKEN 11
182#define CEPH_RELEASE_LUMINOUS 12
183#define CEPH_RELEASE_MIMIC 13
184#define CEPH_RELEASE_MAX 14 /* highest + 1 */
185
186extern const char *ceph_release_name(int r);
187extern int ceph_release_from_name(const char *s);
188extern uint64_t ceph_release_features(int r);
189extern int ceph_release_from_features(uint64_t features);
7c673cae
FG		 190
191/*
192 * The error code to return when an OSD can't handle a write
193 * because it is too large.
194 */
195#define OSD_WRITETOOBIG EMSGSIZE
196
197/*
198 * osd ops
199 *
200 * WARNING: do not use these op codes directly. Use the helpers
201 * defined below instead. In certain cases, op code behavior was
202 * redefined, resulting in special-cases in the helpers.
203 */
204#define CEPH_OSD_OP_MODE 0xf000
205#define CEPH_OSD_OP_MODE_RD 0x1000
206#define CEPH_OSD_OP_MODE_WR 0x2000
207#define CEPH_OSD_OP_MODE_RMW 0x3000
208#define CEPH_OSD_OP_MODE_SUB 0x4000
209#define CEPH_OSD_OP_MODE_CACHE 0x8000
210
211#define CEPH_OSD_OP_TYPE 0x0f00
212#define CEPH_OSD_OP_TYPE_DATA 0x0200
213#define CEPH_OSD_OP_TYPE_ATTR 0x0300
214#define CEPH_OSD_OP_TYPE_EXEC 0x0400
215#define CEPH_OSD_OP_TYPE_PG 0x0500
216// LEAVE UNUSED 0x0600 used to be multiobject ops
217
218#define __CEPH_OSD_OP1(mode, nr) \
219 (CEPH_OSD_OP_MODE_##mode | (nr))
220
221#define __CEPH_OSD_OP(mode, type, nr) \
222 (CEPH_OSD_OP_MODE_##mode | CEPH_OSD_OP_TYPE_##type | (nr))
223
224#define __CEPH_FORALL_OSD_OPS(f) \
225 /** data **/ \
226 /* read */ \
227 f(READ, __CEPH_OSD_OP(RD, DATA, 1), "read") \
228 f(STAT, __CEPH_OSD_OP(RD, DATA, 2), "stat") \
229 f(MAPEXT, __CEPH_OSD_OP(RD, DATA, 3), "mapext") \
230 f(CHECKSUM, __CEPH_OSD_OP(RD, DATA, 31), "checksum") \
231 \
232 /* fancy read */ \
233 f(MASKTRUNC, __CEPH_OSD_OP(RD, DATA, 4), "masktrunc") \
234 f(SPARSE_READ, __CEPH_OSD_OP(RD, DATA, 5), "sparse-read") \
235 \
236 f(NOTIFY, __CEPH_OSD_OP(RD, DATA, 6), "notify") \
237 f(NOTIFY_ACK, __CEPH_OSD_OP(RD, DATA, 7), "notify-ack") \
238 \
239 /* versioning */ \
240 f(ASSERT_VER, __CEPH_OSD_OP(RD, DATA, 8), "assert-version") \
241 \
242 f(LIST_WATCHERS, __CEPH_OSD_OP(RD, DATA, 9), "list-watchers") \
243 \
244 f(LIST_SNAPS, __CEPH_OSD_OP(RD, DATA, 10), "list-snaps") \
245 \
246 /* sync */ \
247 f(SYNC_READ, __CEPH_OSD_OP(RD, DATA, 11), "sync_read") \
248 \
249 /* write */ \
250 f(WRITE, __CEPH_OSD_OP(WR, DATA, 1), "write") \
251 f(WRITEFULL, __CEPH_OSD_OP(WR, DATA, 2), "writefull") \
252 f(TRUNCATE, __CEPH_OSD_OP(WR, DATA, 3), "truncate") \
253 f(ZERO, __CEPH_OSD_OP(WR, DATA, 4), "zero") \
254 f(DELETE, __CEPH_OSD_OP(WR, DATA, 5), "delete") \
255 \
256 /* fancy write */ \
257 f(APPEND, __CEPH_OSD_OP(WR, DATA, 6), "append") \
258 f(STARTSYNC, __CEPH_OSD_OP(WR, DATA, 7), "startsync") \
259 f(SETTRUNC, __CEPH_OSD_OP(WR, DATA, 8), "settrunc") \
260 f(TRIMTRUNC, __CEPH_OSD_OP(WR, DATA, 9), "trimtrunc") \
261 \
262 f(TMAPUP, __CEPH_OSD_OP(RMW, DATA, 10), "tmapup") \
263 f(TMAPPUT, __CEPH_OSD_OP(WR, DATA, 11), "tmapput") \
264 f(TMAPGET, __CEPH_OSD_OP(RD, DATA, 12), "tmapget") \
265 \
266 f(CREATE, __CEPH_OSD_OP(WR, DATA, 13), "create") \
267 f(ROLLBACK, __CEPH_OSD_OP(WR, DATA, 14), "rollback") \
268 \
269 f(WATCH, __CEPH_OSD_OP(WR, DATA, 15), "watch") \
270 \
271 /* omap */ \
272 f(OMAPGETKEYS, __CEPH_OSD_OP(RD, DATA, 17), "omap-get-keys") \
273 f(OMAPGETVALS, __CEPH_OSD_OP(RD, DATA, 18), "omap-get-vals") \
274 f(OMAPGETHEADER, __CEPH_OSD_OP(RD, DATA, 19), "omap-get-header") \
275 f(OMAPGETVALSBYKEYS, __CEPH_OSD_OP(RD, DATA, 20), "omap-get-vals-by-keys") \
276 f(OMAPSETVALS, __CEPH_OSD_OP(WR, DATA, 21), "omap-set-vals") \
277 f(OMAPSETHEADER, __CEPH_OSD_OP(WR, DATA, 22), "omap-set-header") \
278 f(OMAPCLEAR, __CEPH_OSD_OP(WR, DATA, 23), "omap-clear") \
279 f(OMAPRMKEYS, __CEPH_OSD_OP(WR, DATA, 24), "omap-rm-keys") \
280 f(OMAP_CMP, __CEPH_OSD_OP(RD, DATA, 25), "omap-cmp") \
281 \
282 /* tiering */ \
283 f(COPY_FROM, __CEPH_OSD_OP(WR, DATA, 26), "copy-from") \
284 /* was copy-get-classic */ \
285 f(UNDIRTY, __CEPH_OSD_OP(WR, DATA, 28), "undirty") \
286 f(ISDIRTY, __CEPH_OSD_OP(RD, DATA, 29), "isdirty") \
287 f(COPY_GET, __CEPH_OSD_OP(RD, DATA, 30), "copy-get") \
288 f(CACHE_FLUSH, __CEPH_OSD_OP(CACHE, DATA, 31), "cache-flush") \
289 f(CACHE_EVICT, __CEPH_OSD_OP(CACHE, DATA, 32), "cache-evict") \
290 f(CACHE_TRY_FLUSH, __CEPH_OSD_OP(CACHE, DATA, 33), "cache-try-flush") \
291 \
292 /* convert tmap to omap */ \
293 f(TMAP2OMAP, __CEPH_OSD_OP(RMW, DATA, 34), "tmap2omap") \
294 \
295 /* hints */ \
296 f(SETALLOCHINT, __CEPH_OSD_OP(WR, DATA, 35), "set-alloc-hint") \
297 \
298 /* cache pin/unpin */ \
299 f(CACHE_PIN, __CEPH_OSD_OP(WR, DATA, 36), "cache-pin") \
300 f(CACHE_UNPIN, __CEPH_OSD_OP(WR, DATA, 37), "cache-unpin") \
301 \
302 /* ESX/SCSI */ \
303 f(WRITESAME, __CEPH_OSD_OP(WR, DATA, 38), "write-same") \
304 f(CMPEXT, __CEPH_OSD_OP(RD, DATA, 32), "cmpext") \
305 \
31f18b77
FG		 306 /* Extensible */ \
307 f(SET_REDIRECT, __CEPH_OSD_OP(WR, DATA, 39), "set-redirect") \
308 \
7c673cae
FG		 309 /** attrs **/ \
310 /* read */ \
311 f(GETXATTR, __CEPH_OSD_OP(RD, ATTR, 1), "getxattr") \
312 f(GETXATTRS, __CEPH_OSD_OP(RD, ATTR, 2), "getxattrs") \
313 f(CMPXATTR, __CEPH_OSD_OP(RD, ATTR, 3), "cmpxattr") \
314 \
315 /* write */ \
316 f(SETXATTR, __CEPH_OSD_OP(WR, ATTR, 1), "setxattr") \
317 f(SETXATTRS, __CEPH_OSD_OP(WR, ATTR, 2), "setxattrs") \
318 f(RESETXATTRS, __CEPH_OSD_OP(WR, ATTR, 3), "resetxattrs") \
319 f(RMXATTR, __CEPH_OSD_OP(WR, ATTR, 4), "rmxattr") \
320 \
321 /** subop **/ \
322 f(PULL, __CEPH_OSD_OP1(SUB, 1), "pull") \
323 f(PUSH, __CEPH_OSD_OP1(SUB, 2), "push") \
324 f(BALANCEREADS, __CEPH_OSD_OP1(SUB, 3), "balance-reads") \
325 f(UNBALANCEREADS, __CEPH_OSD_OP1(SUB, 4), "unbalance-reads") \
326 f(SCRUB, __CEPH_OSD_OP1(SUB, 5), "scrub") \
327 f(SCRUB_RESERVE, __CEPH_OSD_OP1(SUB, 6), "scrub-reserve") \
328 f(SCRUB_UNRESERVE, __CEPH_OSD_OP1(SUB, 7), "scrub-unreserve") \
329 /* 8 used to be scrub-stop */ \
330 f(SCRUB_MAP, __CEPH_OSD_OP1(SUB, 9), "scrub-map") \
331 \
332 /** exec **/ \
333 /* note: the RD bit here is wrong; see special-case below in helper */ \
334 f(CALL, __CEPH_OSD_OP(RD, EXEC, 1), "call") \
335 \
336 /** pg **/ \
337 f(PGLS, __CEPH_OSD_OP(RD, PG, 1), "pgls") \
338 f(PGLS_FILTER, __CEPH_OSD_OP(RD, PG, 2), "pgls-filter") \
339 f(PG_HITSET_LS, __CEPH_OSD_OP(RD, PG, 3), "pg-hitset-ls") \
340 f(PG_HITSET_GET, __CEPH_OSD_OP(RD, PG, 4), "pg-hitset-get") \
341 f(PGNLS, __CEPH_OSD_OP(RD, PG, 5), "pgnls") \
342 f(PGNLS_FILTER, __CEPH_OSD_OP(RD, PG, 6), "pgnls-filter") \
343 f(SCRUBLS, __CEPH_OSD_OP(RD, PG, 7), "scrubls")
344
345enum {
346#define GENERATE_ENUM_ENTRY(op, opcode, str) CEPH_OSD_OP_##op = (opcode),
347__CEPH_FORALL_OSD_OPS(GENERATE_ENUM_ENTRY)
348#undef GENERATE_ENUM_ENTRY
349};
350
351static inline int ceph_osd_op_type_data(int op)
352{
353 return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_DATA;
354}
355static inline int ceph_osd_op_type_attr(int op)
356{
357 return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_ATTR;
358}
359static inline int ceph_osd_op_type_exec(int op)
360{
361 return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_EXEC;
362}
363static inline int ceph_osd_op_type_pg(int op)
364{
365 return (op & CEPH_OSD_OP_TYPE) == CEPH_OSD_OP_TYPE_PG;
366}
367
368static inline int ceph_osd_op_mode_subop(int op)
369{
370 return (op & CEPH_OSD_OP_MODE) == CEPH_OSD_OP_MODE_SUB;
371}
372static inline int ceph_osd_op_mode_read(int op)
373{
374 return (op & CEPH_OSD_OP_MODE_RD) &&
375 op != CEPH_OSD_OP_CALL;
376}
377static inline int ceph_osd_op_mode_modify(int op)
378{
379 return op & CEPH_OSD_OP_MODE_WR;
380}
381static inline int ceph_osd_op_mode_cache(int op)
382{
383 return op & CEPH_OSD_OP_MODE_CACHE;
384}
385static inline int ceph_osd_op_uses_extent(int op)
386{
387 switch(op) {
388 case CEPH_OSD_OP_READ:
389 case CEPH_OSD_OP_MAPEXT:
390 case CEPH_OSD_OP_MASKTRUNC:
391 case CEPH_OSD_OP_SPARSE_READ:
392 case CEPH_OSD_OP_SYNC_READ:
393 case CEPH_OSD_OP_WRITE:
394 case CEPH_OSD_OP_WRITEFULL:
395 case CEPH_OSD_OP_TRUNCATE:
396 case CEPH_OSD_OP_ZERO:
397 case CEPH_OSD_OP_APPEND:
398 case CEPH_OSD_OP_TRIMTRUNC:
399 case CEPH_OSD_OP_CMPEXT:
400 return true;
401 default:
402 return false;
403 }
404}
405
406/*
407 * note that the following tmap stuff is also defined in the ceph librados.h
408 * and objclass.h. Any modification here needs to be updated there
409 */
410#define CEPH_OSD_TMAP_HDR 'h'
411#define CEPH_OSD_TMAP_SET 's'
412#define CEPH_OSD_TMAP_CREATE 'c' /* create key */
413#define CEPH_OSD_TMAP_RM 'r'
414#define CEPH_OSD_TMAP_RMSLOPPY 'R'
415
416extern const char *ceph_osd_op_name(int op);
417
418/*
419 * osd op flags
420 *
421 * An op may be READ, WRITE, or READ|WRITE.
422 */
423enum {
424 CEPH_OSD_FLAG_ACK = 0x0001, /* want (or is) "ack" ack */
425 CEPH_OSD_FLAG_ONNVRAM = 0x0002, /* want (or is) "onnvram" ack */
426 CEPH_OSD_FLAG_ONDISK = 0x0004, /* want (or is) "ondisk" ack */
427 CEPH_OSD_FLAG_RETRY = 0x0008, /* resend attempt */
428 CEPH_OSD_FLAG_READ = 0x0010, /* op may read */
429 CEPH_OSD_FLAG_WRITE = 0x0020, /* op may write */
430 CEPH_OSD_FLAG_ORDERSNAP = 0x0040, /* EOLDSNAP if snapc is out of order */
431 CEPH_OSD_FLAG_PEERSTAT_OLD = 0x0080, /* DEPRECATED msg includes osd_peer_stat */
432 CEPH_OSD_FLAG_BALANCE_READS = 0x0100,
433 CEPH_OSD_FLAG_PARALLELEXEC = 0x0200, /* execute op in parallel */
434 CEPH_OSD_FLAG_PGOP = 0x0400, /* pg op, no object */
435 CEPH_OSD_FLAG_EXEC = 0x0800, /* op may exec */
436 CEPH_OSD_FLAG_EXEC_PUBLIC = 0x1000, /* DEPRECATED op may exec (public) */
437 CEPH_OSD_FLAG_LOCALIZE_READS = 0x2000, /* read from nearby replica, if any */
438 CEPH_OSD_FLAG_RWORDERED = 0x4000, /* order wrt concurrent reads */
439 CEPH_OSD_FLAG_IGNORE_CACHE = 0x8000, /* ignore cache logic */
440 CEPH_OSD_FLAG_SKIPRWLOCKS = 0x10000, /* skip rw locks */
441 CEPH_OSD_FLAG_IGNORE_OVERLAY =0x20000, /* ignore pool overlay */
442 CEPH_OSD_FLAG_FLUSH = 0x40000, /* this is part of flush */
443 CEPH_OSD_FLAG_MAP_SNAP_CLONE =0x80000, /* map snap direct to clone id
444 */
445 CEPH_OSD_FLAG_ENFORCE_SNAPC =0x100000, /* use snapc provided even if
446 pool uses pool snaps */
447 CEPH_OSD_FLAG_REDIRECTED = 0x200000, /* op has been redirected */
448 CEPH_OSD_FLAG_KNOWN_REDIR = 0x400000, /* redirect bit is authoritative */
449 CEPH_OSD_FLAG_FULL_TRY = 0x800000, /* try op despite full flag */
450 CEPH_OSD_FLAG_FULL_FORCE = 0x1000000, /* force op despite full flag */
31f18b77 451 CEPH_OSD_FLAG_IGNORE_REDIRECT = 0x2000000, /* ignore redirection */
7c673cae
FG		 452};
453
454enum {
455 CEPH_OSD_OP_FLAG_EXCL = 0x1, /* EXCL object create */
456 CEPH_OSD_OP_FLAG_FAILOK = 0x2, /* continue despite failure */
457 CEPH_OSD_OP_FLAG_FADVISE_RANDOM = 0x4, /* the op is random */
458 CEPH_OSD_OP_FLAG_FADVISE_SEQUENTIAL = 0x8, /* the op is sequential */
459 CEPH_OSD_OP_FLAG_FADVISE_WILLNEED = 0x10,/* data will be accessed in the near future */
460 CEPH_OSD_OP_FLAG_FADVISE_DONTNEED = 0x20,/* data will not be accessed in the near future */
461 CEPH_OSD_OP_FLAG_FADVISE_NOCACHE = 0x40, /* data will be accessed only once by this client */
462};
463
464#define EOLDSNAPC 85 /* ORDERSNAP flag set; writer has old snapc*/
465#define EBLACKLISTED 108 /* blacklisted */
466
467/* xattr comparison */
468enum {
469 CEPH_OSD_CMPXATTR_OP_EQ = 1,
470 CEPH_OSD_CMPXATTR_OP_NE = 2,
471 CEPH_OSD_CMPXATTR_OP_GT = 3,
472 CEPH_OSD_CMPXATTR_OP_GTE = 4,
473 CEPH_OSD_CMPXATTR_OP_LT = 5,
474 CEPH_OSD_CMPXATTR_OP_LTE = 6
475};
476
477enum {
478 CEPH_OSD_CMPXATTR_MODE_STRING = 1,
479 CEPH_OSD_CMPXATTR_MODE_U64 = 2
480};
481
482enum {
483 CEPH_OSD_COPY_FROM_FLAG_FLUSH = 1, /* part of a flush operation */
484 CEPH_OSD_COPY_FROM_FLAG_IGNORE_OVERLAY = 2, /* ignore pool overlay */
485 CEPH_OSD_COPY_FROM_FLAG_IGNORE_CACHE = 4, /* ignore osd cache logic */
486 CEPH_OSD_COPY_FROM_FLAG_MAP_SNAP_CLONE = 8, /* map snap direct to
487 * cloneid */
488 CEPH_OSD_COPY_FROM_FLAG_RWORDERED = 16, /* order with write */
489};
490
491enum {
492 CEPH_OSD_TMAP2OMAP_NULLOK = 1,
493};
494
495enum {
496 CEPH_OSD_WATCH_OP_UNWATCH = 0,
497 CEPH_OSD_WATCH_OP_LEGACY_WATCH = 1,
498 /* note: use only ODD ids to prevent pre-giant code from
499 interpreting the op as UNWATCH */
500 CEPH_OSD_WATCH_OP_WATCH = 3,
501 CEPH_OSD_WATCH_OP_RECONNECT = 5,
502 CEPH_OSD_WATCH_OP_PING = 7,
503};
504
505enum {
506 CEPH_OSD_CHECKSUM_OP_TYPE_XXHASH32 = 0,
507 CEPH_OSD_CHECKSUM_OP_TYPE_XXHASH64 = 1,
508 CEPH_OSD_CHECKSUM_OP_TYPE_CRC32C = 2
509};
510
511const char *ceph_osd_watch_op_name(int o);
512
513enum {
514 CEPH_OSD_ALLOC_HINT_FLAG_SEQUENTIAL_WRITE = 1,
515 CEPH_OSD_ALLOC_HINT_FLAG_RANDOM_WRITE = 2,
516 CEPH_OSD_ALLOC_HINT_FLAG_SEQUENTIAL_READ = 4,
517 CEPH_OSD_ALLOC_HINT_FLAG_RANDOM_READ = 8,
518 CEPH_OSD_ALLOC_HINT_FLAG_APPEND_ONLY = 16,
519 CEPH_OSD_ALLOC_HINT_FLAG_IMMUTABLE = 32,
520 CEPH_OSD_ALLOC_HINT_FLAG_SHORTLIVED = 64,
521 CEPH_OSD_ALLOC_HINT_FLAG_LONGLIVED = 128,
522 CEPH_OSD_ALLOC_HINT_FLAG_COMPRESSIBLE = 256,
523 CEPH_OSD_ALLOC_HINT_FLAG_INCOMPRESSIBLE = 512,
524};
525
526const char *ceph_osd_alloc_hint_flag_name(int f);
527
528enum {
529 CEPH_OSD_BACKOFF_OP_BLOCK = 1,
530 CEPH_OSD_BACKOFF_OP_ACK_BLOCK = 2,
531 CEPH_OSD_BACKOFF_OP_UNBLOCK = 3,
532};
533
534const char *ceph_osd_backoff_op_name(int op);
535
536/*
537 * an individual object operation. each may be accompanied by some data
538 * payload
539 */
540struct ceph_osd_op {
541 __le16 op; /* CEPH_OSD_OP_* */
542 __le32 flags; /* CEPH_OSD_OP_FLAG_* */
543 union {
544 struct {
545 __le64 offset, length;
546 __le64 truncate_size;
547 __le32 truncate_seq;
548 } __attribute__ ((packed)) extent;
549 struct {
550 __le32 name_len;
551 __le32 value_len;
552 __u8 cmp_op; /* CEPH_OSD_CMPXATTR_OP_* */
553 __u8 cmp_mode; /* CEPH_OSD_CMPXATTR_MODE_* */
554 } __attribute__ ((packed)) xattr;
555 struct {
556 __u8 class_len;
557 __u8 method_len;
558 __u8 argc;
559 __le32 indata_len;
560 } __attribute__ ((packed)) cls;
561 struct {
562 __le64 count;
563 __le32 start_epoch; /* for the pgls sequence */
564 } __attribute__ ((packed)) pgls;
565 struct {
566 __le64 snapid;
567 } __attribute__ ((packed)) snap;
568 struct {
569 __le64 cookie;
570 __le64 ver; /* no longer used */
571 __u8 op; /* CEPH_OSD_WATCH_OP_* */
572 __u32 gen; /* registration generation */
573 __u32 timeout; /* connection timeout */
574 } __attribute__ ((packed)) watch;
575 struct {
576 __le64 cookie;
577 } __attribute__ ((packed)) notify;
578 struct {
579 __le64 unused;
580 __le64 ver;
581 } __attribute__ ((packed)) assert_ver;
582 struct {
583 __le64 offset, length;
584 __le64 src_offset;
585 } __attribute__ ((packed)) clonerange;
586 struct {
587 __le64 max; /* max data in reply */
588 } __attribute__ ((packed)) copy_get;
589 struct {
590 __le64 snapid;
591 __le64 src_version;
592 __u8 flags;
593 /*
594 * __le32 flags: CEPH_OSD_OP_FLAG_FADVISE_: mean the fadvise flags for dest object
595 * src_fadvise_flags mean the fadvise flags for src object
596 */
597 __le32 src_fadvise_flags;
598 } __attribute__ ((packed)) copy_from;
599 struct {
600 struct ceph_timespec stamp;
601 } __attribute__ ((packed)) hit_set_get;
602 struct {
603 __u8 flags;
604 } __attribute__ ((packed)) tmap2omap;
605 struct {
606 __le64 expected_object_size;
607 __le64 expected_write_size;
608 __le32 flags; /* CEPH_OSD_OP_ALLOC_HINT_FLAG_* */
609 } __attribute__ ((packed)) alloc_hint;
610 struct {
611 __le64 offset;
612 __le64 length;
613 __le64 data_length;
614 } __attribute__ ((packed)) writesame;
615 struct {
616 __le64 offset;
617 __le64 length;
618 __le32 chunk_size;
619 __u8 type; /* CEPH_OSD_CHECKSUM_OP_TYPE_* */
620 } __attribute__ ((packed)) checksum;
621 };
622 __le32 payload_len;
623} __attribute__ ((packed));
624
625/*
626 * Check the compatibility of struct ceph_osd_op
627 * (2+4+(2*8+8+4)+4) = (sizeof(ceph_osd_op::op) +
628 * sizeof(ceph_osd_op::flags) +
629 * sizeof(ceph_osd_op::extent) +
630 * sizeof(ceph_osd_op::payload_len))
631 */
632#ifdef __cplusplus
633static_assert(sizeof(ceph_osd_op) == (2+4+(2*8+8+4)+4),
634 "sizeof(ceph_osd_op) breaks the compatibility");
635#endif
636
637struct ceph_osd_reply_head {
638 __le32 client_inc; /* client incarnation */
639 __le32 flags;
640 struct ceph_object_layout layout;
641 __le32 osdmap_epoch;
642 struct ceph_eversion reassert_version; /* for replaying uncommitted */
643
644 __le32 result; /* result code */
645
646 __le32 object_len; /* length of object name */
647 __le32 num_ops;
648 struct ceph_osd_op ops[0]; /* ops[], object */
649} __attribute__ ((packed));
650
651
652#endif
Ceph