]> git.proxmox.com Git - ceph.git/blame - ceph/src/include/ceph_features.h
update sources to 12.2.7
[ceph.git] / ceph / src / include / ceph_features.h
CommitLineData
7c673cae
FG
1#ifndef __CEPH_FEATURES
2#define __CEPH_FEATURES
3
4#include "sys/types.h"
5
6/*
7 * Each time we reclaim bits for reuse we need to specify another bit
8 * that, if present, indicates we have the new incarnation of that
9 * feature. Base case is 1 (first use)
10 */
11#define CEPH_FEATURE_INCARNATION_1 (0ull)
12#define CEPH_FEATURE_INCARNATION_2 (1ull<<57) // CEPH_FEATURE_SERVER_JEWEL
13
14#define DEFINE_CEPH_FEATURE(bit, incarnation, name) \
15 const static uint64_t CEPH_FEATURE_##name = (1ULL<<bit); \
16 const static uint64_t CEPH_FEATUREMASK_##name = \
17 (1ULL<<bit | CEPH_FEATURE_INCARNATION_##incarnation);
18
19// this bit is ignored but still advertised by release *when*
20#define DEFINE_CEPH_FEATURE_DEPRECATED(bit, incarnation, name, when) \
21 const static uint64_t DEPRECATED_CEPH_FEATURE_##name = (1ULL<<bit); \
22 const static uint64_t DEPRECATED_CEPH_FEATUREMASK_##name = \
23 (1ULL<<bit | CEPH_FEATURE_INCARNATION_##incarnation);
24
25// this bit is ignored by release *unused* and not advertised by
26// release *unadvertised*
27#define DEFINE_CEPH_FEATURE_RETIRED(bit, inc, name, unused, unadvertised)
28
29
30// test for a feature. this test is safer than a typical mask against
31// the bit because it ensures that we have the bit AND the marker for the
32// bit's incarnation. this must be used in any case where the features
33// bits may include an old meaning of the bit.
34#define HAVE_FEATURE(x, name) \
35 (((x) & (CEPH_FEATUREMASK_##name)) == (CEPH_FEATUREMASK_##name))
36
37
38/*
39 * Notes on deprecation:
40 *
41 * A *major* release is a release through which all upgrades must pass
42 * (e.g., jewel). For example, no pre-jewel server will ever talk to
43 * a post-jewel server (mon, osd, etc).
44 *
45 * For feature bits used *only* on the server-side:
46 *
47 * - In the first phase we indicate that a feature is DEPRECATED as of
48 * a particular release. This is the first major release X (say,
49 * jewel) that does not depend on its peers advertising the feature.
50 * That is, it safely assumes its peers all have the feature. We
51 * indicate this with the DEPRECATED macro. For example,
52 *
53 * DEFINE_CEPH_FEATURE_DEPRECATED( 2, 1, MONCLOCKCHECK, JEWEL)
54 *
55 * because 10.2.z (jewel) did not care if its peers advertised this
56 * feature bit.
57 *
58 * - In the second phase we stop advertising the the bit and call it
59 * RETIRED. This can normally be done in the *next* major release
60 * following the one in which we marked the feature DEPRECATED. In
61 * the above example, for 12.0.z (luminous) we can say:
62 *
63 * DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)
64 *
65 * - The bit can be reused in the first post-luminous release, 13.0.z
66 * (m).
67 *
68 * This ensures that no two versions who have different meanings for
69 * the bit ever speak to each other.
70 */
71
72DEFINE_CEPH_FEATURE( 0, 1, UID)
73DEFINE_CEPH_FEATURE( 1, 1, NOSRCADDR)
74DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)
75
76DEFINE_CEPH_FEATURE( 3, 1, FLOCK)
77DEFINE_CEPH_FEATURE( 4, 1, SUBSCRIBE2)
78DEFINE_CEPH_FEATURE( 5, 1, MONNAMES)
79DEFINE_CEPH_FEATURE( 6, 1, RECONNECT_SEQ)
80DEFINE_CEPH_FEATURE( 7, 1, DIRLAYOUTHASH)
81DEFINE_CEPH_FEATURE( 8, 1, OBJECTLOCATOR)
82DEFINE_CEPH_FEATURE( 9, 1, PGID64)
83DEFINE_CEPH_FEATURE(10, 1, INCSUBOSDMAP)
84DEFINE_CEPH_FEATURE(11, 1, PGPOOL3)
85DEFINE_CEPH_FEATURE(12, 1, OSDREPLYMUX)
86DEFINE_CEPH_FEATURE(13, 1, OSDENC)
87DEFINE_CEPH_FEATURE_RETIRED(14, 1, OMAP, HAMMER, JEWEL)
88DEFINE_CEPH_FEATURE(14, 2, SERVER_KRAKEN)
89DEFINE_CEPH_FEATURE(15, 1, MONENC)
90DEFINE_CEPH_FEATURE_RETIRED(16, 1, QUERY_T, JEWEL, LUMINOUS)
91
92DEFINE_CEPH_FEATURE_RETIRED(17, 1, INDEP_PG_MAP, JEWEL, LUMINOUS)
93
94DEFINE_CEPH_FEATURE(18, 1, CRUSH_TUNABLES)
95DEFINE_CEPH_FEATURE_RETIRED(19, 1, CHUNKY_SCRUB, JEWEL, LUMINOUS)
96
97DEFINE_CEPH_FEATURE_RETIRED(20, 1, MON_NULLROUTE, JEWEL, LUMINOUS)
98
99DEFINE_CEPH_FEATURE_RETIRED(21, 1, MON_GV, HAMMER, JEWEL)
100DEFINE_CEPH_FEATURE(21, 2, SERVER_LUMINOUS)
101DEFINE_CEPH_FEATURE(21, 2, RESEND_ON_SPLIT) // overlap
102DEFINE_CEPH_FEATURE(21, 2, RADOS_BACKOFF) // overlap
103DEFINE_CEPH_FEATURE(21, 2, OSDMAP_PG_UPMAP) // overlap
31f18b77 104DEFINE_CEPH_FEATURE(21, 2, CRUSH_CHOOSE_ARGS) // overlap
7c673cae
FG
105DEFINE_CEPH_FEATURE_RETIRED(22, 1, BACKFILL_RESERVATION, JEWEL, LUMINOUS)
106
107DEFINE_CEPH_FEATURE(23, 1, MSG_AUTH)
108DEFINE_CEPH_FEATURE_RETIRED(24, 1, RECOVERY_RESERVATION, JEWEL, LUNINOUS)
109
110DEFINE_CEPH_FEATURE(25, 1, CRUSH_TUNABLES2)
111DEFINE_CEPH_FEATURE(26, 1, CREATEPOOLID)
112DEFINE_CEPH_FEATURE(27, 1, REPLY_CREATE_INODE)
113DEFINE_CEPH_FEATURE_RETIRED(28, 1, OSD_HBMSGS, HAMMER, JEWEL)
114DEFINE_CEPH_FEATURE(28, 2, SERVER_M)
115DEFINE_CEPH_FEATURE(29, 1, MDSENC)
116DEFINE_CEPH_FEATURE(30, 1, OSDHASHPSPOOL)
117DEFINE_CEPH_FEATURE(31, 1, MON_SINGLE_PAXOS) // deprecate me
118DEFINE_CEPH_FEATURE_RETIRED(32, 1, OSD_SNAPMAPPER, JEWEL, LUMINOUS)
119
120DEFINE_CEPH_FEATURE_RETIRED(33, 1, MON_SCRUB, JEWEL, LUMINOUS)
121
122DEFINE_CEPH_FEATURE_RETIRED(34, 1, OSD_PACKED_RECOVERY, JEWEL, LUMINOUS)
123
124DEFINE_CEPH_FEATURE(35, 1, OSD_CACHEPOOL)
125DEFINE_CEPH_FEATURE(36, 1, CRUSH_V2)
126DEFINE_CEPH_FEATURE(37, 1, EXPORT_PEER)
127DEFINE_CEPH_FEATURE(38, 1, OSD_ERASURE_CODES)
128DEFINE_CEPH_FEATURE(38, 1, OSD_OSD_TMAP2OMAP) // overlap
129DEFINE_CEPH_FEATURE(39, 1, OSDMAP_ENC)
130DEFINE_CEPH_FEATURE(40, 1, MDS_INLINE_DATA)
131DEFINE_CEPH_FEATURE(41, 1, CRUSH_TUNABLES3)
132DEFINE_CEPH_FEATURE(41, 1, OSD_PRIMARY_AFFINITY) // overlap
133DEFINE_CEPH_FEATURE(42, 1, MSGR_KEEPALIVE2)
134DEFINE_CEPH_FEATURE(43, 1, OSD_POOLRESEND)
135DEFINE_CEPH_FEATURE(44, 1, ERASURE_CODE_PLUGINS_V2)
136DEFINE_CEPH_FEATURE_RETIRED(45, 1, OSD_SET_ALLOC_HINT, JEWEL, LUMINOUS)
137
138DEFINE_CEPH_FEATURE(46, 1, OSD_FADVISE_FLAGS)
139DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_REPOP, JEWEL, LUMINOUS) // overlap
140DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_OBJECT_DIGEST, JEWEL, LUMINOUS) // overlap
141DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_TRANSACTION_MAY_LAYOUT, JEWEL, LUMINOUS) // overlap
142
143DEFINE_CEPH_FEATURE(47, 1, MDS_QUOTA)
144DEFINE_CEPH_FEATURE(48, 1, CRUSH_V4)
145DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_MIN_SIZE_RECOVERY, JEWEL, LUMINOUS)
146DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_PROXY_FEATURES, JEWEL, LUMINOUS) // overlap
147
148DEFINE_CEPH_FEATURE(50, 1, MON_METADATA)
149DEFINE_CEPH_FEATURE(51, 1, OSD_BITWISE_HOBJ_SORT)
150DEFINE_CEPH_FEATURE(52, 1, OSD_PROXY_WRITE_FEATURES)
151DEFINE_CEPH_FEATURE(53, 1, ERASURE_CODE_PLUGINS_V3)
152DEFINE_CEPH_FEATURE(54, 1, OSD_HITSET_GMT)
153DEFINE_CEPH_FEATURE(55, 1, HAMMER_0_94_4)
154DEFINE_CEPH_FEATURE(56, 1, NEW_OSDOP_ENCODING)
155DEFINE_CEPH_FEATURE(57, 1, MON_STATEFUL_SUB)
156DEFINE_CEPH_FEATURE(57, 1, MON_ROUTE_OSDMAP) // overlap
157DEFINE_CEPH_FEATURE(57, 1, OSDSUBOP_NO_SNAPCONTEXT) // overlap
158DEFINE_CEPH_FEATURE(57, 1, SERVER_JEWEL) // overlap
159DEFINE_CEPH_FEATURE(58, 1, CRUSH_TUNABLES5)
160DEFINE_CEPH_FEATURE(58, 1, NEW_OSDOPREPLY_ENCODING) // overlap
161DEFINE_CEPH_FEATURE(58, 1, FS_FILE_LAYOUT_V2) // overlap
162DEFINE_CEPH_FEATURE(59, 1, FS_BTIME)
163DEFINE_CEPH_FEATURE(59, 1, FS_CHANGE_ATTR) // overlap
164DEFINE_CEPH_FEATURE(59, 1, MSG_ADDR2) // overlap
c07f9fc5 165DEFINE_CEPH_FEATURE(60, 1, OSD_RECOVERY_DELETES) // *do not share this bit*
28e407b8 166DEFINE_CEPH_FEATURE(61, 1, CEPHX_V2) // *do not share this bit*
7c673cae 167
7c673cae
FG
168DEFINE_CEPH_FEATURE(62, 1, RESERVED) // do not use; used as a sentinal
169DEFINE_CEPH_FEATURE_DEPRECATED(63, 1, RESERVED_BROKEN, LUMINOUS) // client-facing
170
171
7c673cae
FG
172/*
173 * Features supported. Should be everything above.
174 */
175#define CEPH_FEATURES_ALL \
176 (CEPH_FEATURE_UID | \
177 CEPH_FEATURE_NOSRCADDR | \
178 CEPH_FEATURE_FLOCK | \
179 CEPH_FEATURE_SUBSCRIBE2 | \
180 CEPH_FEATURE_MONNAMES | \
181 CEPH_FEATURE_RECONNECT_SEQ | \
182 CEPH_FEATURE_DIRLAYOUTHASH | \
183 CEPH_FEATURE_OBJECTLOCATOR | \
184 CEPH_FEATURE_PGID64 | \
185 CEPH_FEATURE_INCSUBOSDMAP | \
186 CEPH_FEATURE_PGPOOL3 | \
187 CEPH_FEATURE_OSDREPLYMUX | \
188 CEPH_FEATURE_OSDENC | \
189 CEPH_FEATURE_MONENC | \
190 CEPH_FEATURE_CRUSH_TUNABLES | \
191 CEPH_FEATURE_MSG_AUTH | \
192 CEPH_FEATURE_CRUSH_TUNABLES2 | \
193 CEPH_FEATURE_CREATEPOOLID | \
194 CEPH_FEATURE_REPLY_CREATE_INODE | \
195 CEPH_FEATURE_MDSENC | \
196 CEPH_FEATURE_OSDHASHPSPOOL | \
197 CEPH_FEATURE_NEW_OSDOP_ENCODING | \
198 CEPH_FEATURE_NEW_OSDOPREPLY_ENCODING | \
199 CEPH_FEATURE_MON_SINGLE_PAXOS | \
200 CEPH_FEATURE_OSD_CACHEPOOL | \
201 CEPH_FEATURE_CRUSH_V2 | \
202 CEPH_FEATURE_EXPORT_PEER | \
203 CEPH_FEATURE_OSD_ERASURE_CODES | \
204 CEPH_FEATURE_OSDMAP_ENC | \
205 CEPH_FEATURE_MDS_INLINE_DATA | \
206 CEPH_FEATURE_CRUSH_TUNABLES3 | \
207 CEPH_FEATURE_OSD_PRIMARY_AFFINITY | \
208 CEPH_FEATURE_MSGR_KEEPALIVE2 | \
209 CEPH_FEATURE_OSD_POOLRESEND | \
210 CEPH_FEATURE_ERASURE_CODE_PLUGINS_V2 | \
211 CEPH_FEATURE_OSD_FADVISE_FLAGS | \
212 CEPH_FEATURE_MDS_QUOTA | \
213 CEPH_FEATURE_CRUSH_V4 | \
214 CEPH_FEATURE_MON_METADATA | \
215 CEPH_FEATURE_OSD_BITWISE_HOBJ_SORT | \
216 CEPH_FEATURE_ERASURE_CODE_PLUGINS_V3 | \
217 CEPH_FEATURE_OSD_PROXY_WRITE_FEATURES | \
218 CEPH_FEATURE_OSD_HITSET_GMT | \
219 CEPH_FEATURE_HAMMER_0_94_4 | \
220 CEPH_FEATURE_MON_STATEFUL_SUB | \
221 CEPH_FEATURE_MON_ROUTE_OSDMAP | \
222 CEPH_FEATURE_CRUSH_TUNABLES5 | \
223 CEPH_FEATURE_SERVER_JEWEL | \
224 CEPH_FEATURE_FS_FILE_LAYOUT_V2 | \
225 CEPH_FEATURE_SERVER_KRAKEN | \
226 CEPH_FEATURE_FS_BTIME | \
227 CEPH_FEATURE_FS_CHANGE_ATTR | \
228 CEPH_FEATURE_MSG_ADDR2 | \
229 CEPH_FEATURE_SERVER_LUMINOUS | \
230 CEPH_FEATURE_RESEND_ON_SPLIT | \
231 CEPH_FEATURE_RADOS_BACKOFF | \
c07f9fc5 232 CEPH_FEATURE_OSD_RECOVERY_DELETES | \
28e407b8 233 CEPH_FEATURE_CEPHX_V2 | \
7c673cae
FG
234 0ULL)
235
236#define CEPH_FEATURES_SUPPORTED_DEFAULT CEPH_FEATURES_ALL
237
238/*
239 * crush related features
240 */
241#define CEPH_FEATURES_CRUSH \
242 (CEPH_FEATURE_CRUSH_TUNABLES | \
243 CEPH_FEATURE_CRUSH_TUNABLES2 | \
244 CEPH_FEATURE_CRUSH_TUNABLES3 | \
245 CEPH_FEATURE_CRUSH_TUNABLES5 | \
246 CEPH_FEATURE_CRUSH_V2 | \
247 CEPH_FEATURE_CRUSH_V4 | \
c07f9fc5 248 CEPH_FEATUREMASK_CRUSH_CHOOSE_ARGS)
7c673cae
FG
249
250/*
251 * make sure we don't try to use the reserved features
252 */
253#define CEPH_STATIC_ASSERT(x) (void)(sizeof(int[((x)==0) ? -1 : 0]))
254
255static inline void ____build_time_check_for_reserved_bits(void) {
256 CEPH_STATIC_ASSERT((CEPH_FEATURES_ALL &
257 (CEPH_FEATURE_RESERVED |
7c673cae
FG
258 DEPRECATED_CEPH_FEATURE_RESERVED_BROKEN)) == 0);
259}
260
261#endif