225 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2#ifndef __CEPH_FEATURES3#define __CEPH_FEATURES4 5/*6 * Each time we reclaim bits for reuse we need to specify another bit7 * that, if present, indicates we have the new incarnation of that8 * feature. Base case is 1 (first use).9 */10#define CEPH_FEATURE_INCARNATION_1 (0ull)11#define CEPH_FEATURE_INCARNATION_2 (1ull<<57) // SERVER_JEWEL12#define CEPH_FEATURE_INCARNATION_3 ((1ull<<57)|(1ull<<28)) // SERVER_MIMIC13 14#define DEFINE_CEPH_FEATURE(bit, incarnation, name) \15 static const uint64_t __maybe_unused CEPH_FEATURE_##name = (1ULL<<bit); \16 static const uint64_t __maybe_unused 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 static const uint64_t __maybe_unused DEPRECATED_CEPH_FEATURE_##name = (1ULL<<bit); \22 static const uint64_t __maybe_unused DEPRECATED_CEPH_FEATUREMASK_##name = \23 (1ULL<<bit | CEPH_FEATURE_INCARNATION_##incarnation);24 25/*26 * this bit is ignored by release *unused* and not advertised by27 * release *unadvertised*28 */29#define DEFINE_CEPH_FEATURE_RETIRED(bit, inc, name, unused, unadvertised)30 31 32/*33 * test for a feature. this test is safer than a typical mask against34 * the bit because it ensures that we have the bit AND the marker for the35 * bit's incarnation. this must be used in any case where the features36 * bits may include an old meaning of the bit.37 */38#define CEPH_HAVE_FEATURE(x, name) \39 (((x) & (CEPH_FEATUREMASK_##name)) == (CEPH_FEATUREMASK_##name))40 41 42/*43 * Notes on deprecation:44 *45 * A *major* release is a release through which all upgrades must pass46 * (e.g., jewel). For example, no pre-jewel server will ever talk to47 * a post-jewel server (mon, osd, etc).48 *49 * For feature bits used *only* on the server-side:50 *51 * - In the first phase we indicate that a feature is DEPRECATED as of52 * a particular release. This is the first major release X (say,53 * jewel) that does not depend on its peers advertising the feature.54 * That is, it safely assumes its peers all have the feature. We55 * indicate this with the DEPRECATED macro. For example,56 *57 * DEFINE_CEPH_FEATURE_DEPRECATED( 2, 1, MONCLOCKCHECK, JEWEL)58 *59 * because 10.2.z (jewel) did not care if its peers advertised this60 * feature bit.61 *62 * - In the second phase we stop advertising the bit and call it63 * RETIRED. This can normally be done in the *next* major release64 * following the one in which we marked the feature DEPRECATED. In65 * the above example, for 12.0.z (luminous) we can say:66 *67 * DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)68 *69 * - The bit can be reused in the first post-luminous release, 13.0.z70 * (m).71 *72 * This ensures that no two versions who have different meanings for73 * the bit ever speak to each other.74 */75 76DEFINE_CEPH_FEATURE( 0, 1, UID)77DEFINE_CEPH_FEATURE( 1, 1, NOSRCADDR)78DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)79DEFINE_CEPH_FEATURE( 2, 3, SERVER_NAUTILUS)80DEFINE_CEPH_FEATURE( 3, 1, FLOCK)81DEFINE_CEPH_FEATURE( 4, 1, SUBSCRIBE2)82DEFINE_CEPH_FEATURE( 5, 1, MONNAMES)83DEFINE_CEPH_FEATURE( 6, 1, RECONNECT_SEQ)84DEFINE_CEPH_FEATURE( 7, 1, DIRLAYOUTHASH)85DEFINE_CEPH_FEATURE( 8, 1, OBJECTLOCATOR)86DEFINE_CEPH_FEATURE( 9, 1, PGID64)87DEFINE_CEPH_FEATURE(10, 1, INCSUBOSDMAP)88DEFINE_CEPH_FEATURE(11, 1, PGPOOL3)89DEFINE_CEPH_FEATURE(12, 1, OSDREPLYMUX)90DEFINE_CEPH_FEATURE(13, 1, OSDENC)91DEFINE_CEPH_FEATURE_RETIRED(14, 1, OMAP, HAMMER, JEWEL)92DEFINE_CEPH_FEATURE(14, 2, SERVER_KRAKEN)93DEFINE_CEPH_FEATURE(15, 1, MONENC)94DEFINE_CEPH_FEATURE_RETIRED(16, 1, QUERY_T, JEWEL, LUMINOUS)95 96DEFINE_CEPH_FEATURE_RETIRED(17, 1, INDEP_PG_MAP, JEWEL, LUMINOUS)97 98DEFINE_CEPH_FEATURE(18, 1, CRUSH_TUNABLES)99DEFINE_CEPH_FEATURE_RETIRED(19, 1, CHUNKY_SCRUB, JEWEL, LUMINOUS)100 101DEFINE_CEPH_FEATURE_RETIRED(20, 1, MON_NULLROUTE, JEWEL, LUMINOUS)102 103DEFINE_CEPH_FEATURE_RETIRED(21, 1, MON_GV, HAMMER, JEWEL)104DEFINE_CEPH_FEATURE(21, 2, SERVER_LUMINOUS)105DEFINE_CEPH_FEATURE(21, 2, RESEND_ON_SPLIT) // overlap106DEFINE_CEPH_FEATURE(21, 2, RADOS_BACKOFF) // overlap107DEFINE_CEPH_FEATURE(21, 2, OSDMAP_PG_UPMAP) // overlap108DEFINE_CEPH_FEATURE(21, 2, CRUSH_CHOOSE_ARGS) // overlap109DEFINE_CEPH_FEATURE_RETIRED(22, 1, BACKFILL_RESERVATION, JEWEL, LUMINOUS)110 111DEFINE_CEPH_FEATURE(23, 1, MSG_AUTH)112DEFINE_CEPH_FEATURE_RETIRED(24, 1, RECOVERY_RESERVATION, JEWEL, LUNINOUS)113 114DEFINE_CEPH_FEATURE(25, 1, CRUSH_TUNABLES2)115DEFINE_CEPH_FEATURE(26, 1, CREATEPOOLID)116DEFINE_CEPH_FEATURE(27, 1, REPLY_CREATE_INODE)117DEFINE_CEPH_FEATURE_RETIRED(28, 1, OSD_HBMSGS, HAMMER, JEWEL)118DEFINE_CEPH_FEATURE(28, 2, SERVER_MIMIC)119DEFINE_CEPH_FEATURE(29, 1, MDSENC)120DEFINE_CEPH_FEATURE(30, 1, OSDHASHPSPOOL)121DEFINE_CEPH_FEATURE(31, 1, MON_SINGLE_PAXOS) // deprecate me122DEFINE_CEPH_FEATURE_RETIRED(32, 1, OSD_SNAPMAPPER, JEWEL, LUMINOUS)123 124DEFINE_CEPH_FEATURE_RETIRED(33, 1, MON_SCRUB, JEWEL, LUMINOUS)125 126DEFINE_CEPH_FEATURE_RETIRED(34, 1, OSD_PACKED_RECOVERY, JEWEL, LUMINOUS)127 128DEFINE_CEPH_FEATURE(35, 1, OSD_CACHEPOOL)129DEFINE_CEPH_FEATURE(36, 1, CRUSH_V2)130DEFINE_CEPH_FEATURE(37, 1, EXPORT_PEER)131DEFINE_CEPH_FEATURE(38, 1, OSD_ERASURE_CODES)132DEFINE_CEPH_FEATURE(38, 1, OSD_OSD_TMAP2OMAP) // overlap133DEFINE_CEPH_FEATURE(39, 1, OSDMAP_ENC)134DEFINE_CEPH_FEATURE(40, 1, MDS_INLINE_DATA)135DEFINE_CEPH_FEATURE(41, 1, CRUSH_TUNABLES3)136DEFINE_CEPH_FEATURE(41, 1, OSD_PRIMARY_AFFINITY) // overlap137DEFINE_CEPH_FEATURE(42, 1, MSGR_KEEPALIVE2)138DEFINE_CEPH_FEATURE(43, 1, OSD_POOLRESEND)139DEFINE_CEPH_FEATURE(44, 1, ERASURE_CODE_PLUGINS_V2)140DEFINE_CEPH_FEATURE_RETIRED(45, 1, OSD_SET_ALLOC_HINT, JEWEL, LUMINOUS)141 142DEFINE_CEPH_FEATURE(46, 1, OSD_FADVISE_FLAGS)143DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_REPOP, JEWEL, LUMINOUS) // overlap144DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_OBJECT_DIGEST, JEWEL, LUMINOUS) // overlap145DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_TRANSACTION_MAY_LAYOUT, JEWEL, LUMINOUS) // overlap146 147DEFINE_CEPH_FEATURE(47, 1, MDS_QUOTA)148DEFINE_CEPH_FEATURE(48, 1, CRUSH_V4)149DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_MIN_SIZE_RECOVERY, JEWEL, LUMINOUS)150DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_PROXY_FEATURES, JEWEL, LUMINOUS) // overlap151 152DEFINE_CEPH_FEATURE(50, 1, MON_METADATA)153DEFINE_CEPH_FEATURE(51, 1, OSD_BITWISE_HOBJ_SORT)154DEFINE_CEPH_FEATURE(52, 1, OSD_PROXY_WRITE_FEATURES)155DEFINE_CEPH_FEATURE(53, 1, ERASURE_CODE_PLUGINS_V3)156DEFINE_CEPH_FEATURE(54, 1, OSD_HITSET_GMT)157DEFINE_CEPH_FEATURE(55, 1, HAMMER_0_94_4)158DEFINE_CEPH_FEATURE(56, 1, NEW_OSDOP_ENCODING)159DEFINE_CEPH_FEATURE(57, 1, MON_STATEFUL_SUB)160DEFINE_CEPH_FEATURE(57, 1, MON_ROUTE_OSDMAP) // overlap161DEFINE_CEPH_FEATURE(57, 1, OSDSUBOP_NO_SNAPCONTEXT) // overlap162DEFINE_CEPH_FEATURE(57, 1, SERVER_JEWEL) // overlap163DEFINE_CEPH_FEATURE(58, 1, CRUSH_TUNABLES5)164DEFINE_CEPH_FEATURE(58, 1, NEW_OSDOPREPLY_ENCODING) // overlap165DEFINE_CEPH_FEATURE(58, 1, FS_FILE_LAYOUT_V2) // overlap166DEFINE_CEPH_FEATURE(59, 1, FS_BTIME)167DEFINE_CEPH_FEATURE(59, 1, FS_CHANGE_ATTR) // overlap168DEFINE_CEPH_FEATURE(59, 1, MSG_ADDR2) // overlap169DEFINE_CEPH_FEATURE(60, 1, OSD_RECOVERY_DELETES) // *do not share this bit*170DEFINE_CEPH_FEATURE(61, 1, CEPHX_V2) // *do not share this bit*171 172DEFINE_CEPH_FEATURE(62, 1, RESERVED) // do not use; used as a sentinal173DEFINE_CEPH_FEATURE_DEPRECATED(63, 1, RESERVED_BROKEN, LUMINOUS) // client-facing174 175 176/*177 * Features supported.178 */179#define CEPH_FEATURES_SUPPORTED_DEFAULT \180 (CEPH_FEATURE_NOSRCADDR | \181 CEPH_FEATURE_SERVER_NAUTILUS | \182 CEPH_FEATURE_FLOCK | \183 CEPH_FEATURE_SUBSCRIBE2 | \184 CEPH_FEATURE_MONNAMES | \185 CEPH_FEATURE_RECONNECT_SEQ | \186 CEPH_FEATURE_DIRLAYOUTHASH | \187 CEPH_FEATURE_PGID64 | \188 CEPH_FEATURE_PGPOOL3 | \189 CEPH_FEATURE_OSDENC | \190 CEPH_FEATURE_MONENC | \191 CEPH_FEATURE_CRUSH_TUNABLES | \192 CEPH_FEATURE_SERVER_LUMINOUS | \193 CEPH_FEATURE_RESEND_ON_SPLIT | \194 CEPH_FEATURE_RADOS_BACKOFF | \195 CEPH_FEATURE_OSDMAP_PG_UPMAP | \196 CEPH_FEATURE_CRUSH_CHOOSE_ARGS | \197 CEPH_FEATURE_MSG_AUTH | \198 CEPH_FEATURE_CRUSH_TUNABLES2 | \199 CEPH_FEATURE_REPLY_CREATE_INODE | \200 CEPH_FEATURE_SERVER_MIMIC | \201 CEPH_FEATURE_MDSENC | \202 CEPH_FEATURE_OSDHASHPSPOOL | \203 CEPH_FEATURE_OSD_CACHEPOOL | \204 CEPH_FEATURE_CRUSH_V2 | \205 CEPH_FEATURE_EXPORT_PEER | \206 CEPH_FEATURE_OSDMAP_ENC | \207 CEPH_FEATURE_MDS_INLINE_DATA | \208 CEPH_FEATURE_CRUSH_TUNABLES3 | \209 CEPH_FEATURE_OSD_PRIMARY_AFFINITY | \210 CEPH_FEATURE_MSGR_KEEPALIVE2 | \211 CEPH_FEATURE_OSD_POOLRESEND | \212 CEPH_FEATURE_MDS_QUOTA | \213 CEPH_FEATURE_CRUSH_V4 | \214 CEPH_FEATURE_NEW_OSDOP_ENCODING | \215 CEPH_FEATURE_SERVER_JEWEL | \216 CEPH_FEATURE_MON_STATEFUL_SUB | \217 CEPH_FEATURE_CRUSH_TUNABLES5 | \218 CEPH_FEATURE_NEW_OSDOPREPLY_ENCODING | \219 CEPH_FEATURE_MSG_ADDR2 | \220 CEPH_FEATURE_CEPHX_V2)221 222#define CEPH_FEATURES_REQUIRED_DEFAULT 0223 224#endif225