ceph_features.h 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. #ifndef __CEPH_FEATURES
  3. #define __CEPH_FEATURES
  4. /*
  5. * Each time we reclaim bits for reuse we need to specify another bit
  6. * that, if present, indicates we have the new incarnation of that
  7. * feature. Base case is 1 (first use).
  8. */
  9. #define CEPH_FEATURE_INCARNATION_1 (0ull)
  10. #define CEPH_FEATURE_INCARNATION_2 (1ull<<57) // CEPH_FEATURE_SERVER_JEWEL
  11. #define DEFINE_CEPH_FEATURE(bit, incarnation, name) \
  12. static const uint64_t __maybe_unused CEPH_FEATURE_##name = (1ULL<<bit); \
  13. static const uint64_t __maybe_unused CEPH_FEATUREMASK_##name = \
  14. (1ULL<<bit | CEPH_FEATURE_INCARNATION_##incarnation);
  15. /* this bit is ignored but still advertised by release *when* */
  16. #define DEFINE_CEPH_FEATURE_DEPRECATED(bit, incarnation, name, when) \
  17. static const uint64_t __maybe_unused DEPRECATED_CEPH_FEATURE_##name = (1ULL<<bit); \
  18. static const uint64_t __maybe_unused DEPRECATED_CEPH_FEATUREMASK_##name = \
  19. (1ULL<<bit | CEPH_FEATURE_INCARNATION_##incarnation);
  20. /*
  21. * this bit is ignored by release *unused* and not advertised by
  22. * release *unadvertised*
  23. */
  24. #define DEFINE_CEPH_FEATURE_RETIRED(bit, inc, name, unused, unadvertised)
  25. /*
  26. * test for a feature. this test is safer than a typical mask against
  27. * the bit because it ensures that we have the bit AND the marker for the
  28. * bit's incarnation. this must be used in any case where the features
  29. * bits may include an old meaning of the bit.
  30. */
  31. #define CEPH_HAVE_FEATURE(x, name) \
  32. (((x) & (CEPH_FEATUREMASK_##name)) == (CEPH_FEATUREMASK_##name))
  33. /*
  34. * Notes on deprecation:
  35. *
  36. * A *major* release is a release through which all upgrades must pass
  37. * (e.g., jewel). For example, no pre-jewel server will ever talk to
  38. * a post-jewel server (mon, osd, etc).
  39. *
  40. * For feature bits used *only* on the server-side:
  41. *
  42. * - In the first phase we indicate that a feature is DEPRECATED as of
  43. * a particular release. This is the first major release X (say,
  44. * jewel) that does not depend on its peers advertising the feature.
  45. * That is, it safely assumes its peers all have the feature. We
  46. * indicate this with the DEPRECATED macro. For example,
  47. *
  48. * DEFINE_CEPH_FEATURE_DEPRECATED( 2, 1, MONCLOCKCHECK, JEWEL)
  49. *
  50. * because 10.2.z (jewel) did not care if its peers advertised this
  51. * feature bit.
  52. *
  53. * - In the second phase we stop advertising the bit and call it
  54. * RETIRED. This can normally be done in the *next* major release
  55. * following the one in which we marked the feature DEPRECATED. In
  56. * the above example, for 12.0.z (luminous) we can say:
  57. *
  58. * DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)
  59. *
  60. * - The bit can be reused in the first post-luminous release, 13.0.z
  61. * (m).
  62. *
  63. * This ensures that no two versions who have different meanings for
  64. * the bit ever speak to each other.
  65. */
  66. DEFINE_CEPH_FEATURE( 0, 1, UID)
  67. DEFINE_CEPH_FEATURE( 1, 1, NOSRCADDR)
  68. DEFINE_CEPH_FEATURE_RETIRED( 2, 1, MONCLOCKCHECK, JEWEL, LUMINOUS)
  69. DEFINE_CEPH_FEATURE( 3, 1, FLOCK)
  70. DEFINE_CEPH_FEATURE( 4, 1, SUBSCRIBE2)
  71. DEFINE_CEPH_FEATURE( 5, 1, MONNAMES)
  72. DEFINE_CEPH_FEATURE( 6, 1, RECONNECT_SEQ)
  73. DEFINE_CEPH_FEATURE( 7, 1, DIRLAYOUTHASH)
  74. DEFINE_CEPH_FEATURE( 8, 1, OBJECTLOCATOR)
  75. DEFINE_CEPH_FEATURE( 9, 1, PGID64)
  76. DEFINE_CEPH_FEATURE(10, 1, INCSUBOSDMAP)
  77. DEFINE_CEPH_FEATURE(11, 1, PGPOOL3)
  78. DEFINE_CEPH_FEATURE(12, 1, OSDREPLYMUX)
  79. DEFINE_CEPH_FEATURE(13, 1, OSDENC)
  80. DEFINE_CEPH_FEATURE_RETIRED(14, 1, OMAP, HAMMER, JEWEL)
  81. DEFINE_CEPH_FEATURE(14, 2, SERVER_KRAKEN)
  82. DEFINE_CEPH_FEATURE(15, 1, MONENC)
  83. DEFINE_CEPH_FEATURE_RETIRED(16, 1, QUERY_T, JEWEL, LUMINOUS)
  84. DEFINE_CEPH_FEATURE_RETIRED(17, 1, INDEP_PG_MAP, JEWEL, LUMINOUS)
  85. DEFINE_CEPH_FEATURE(18, 1, CRUSH_TUNABLES)
  86. DEFINE_CEPH_FEATURE_RETIRED(19, 1, CHUNKY_SCRUB, JEWEL, LUMINOUS)
  87. DEFINE_CEPH_FEATURE_RETIRED(20, 1, MON_NULLROUTE, JEWEL, LUMINOUS)
  88. DEFINE_CEPH_FEATURE_RETIRED(21, 1, MON_GV, HAMMER, JEWEL)
  89. DEFINE_CEPH_FEATURE(21, 2, SERVER_LUMINOUS)
  90. DEFINE_CEPH_FEATURE(21, 2, RESEND_ON_SPLIT) // overlap
  91. DEFINE_CEPH_FEATURE(21, 2, RADOS_BACKOFF) // overlap
  92. DEFINE_CEPH_FEATURE(21, 2, OSDMAP_PG_UPMAP) // overlap
  93. DEFINE_CEPH_FEATURE(21, 2, CRUSH_CHOOSE_ARGS) // overlap
  94. DEFINE_CEPH_FEATURE_RETIRED(22, 1, BACKFILL_RESERVATION, JEWEL, LUMINOUS)
  95. DEFINE_CEPH_FEATURE(23, 1, MSG_AUTH)
  96. DEFINE_CEPH_FEATURE_RETIRED(24, 1, RECOVERY_RESERVATION, JEWEL, LUNINOUS)
  97. DEFINE_CEPH_FEATURE(25, 1, CRUSH_TUNABLES2)
  98. DEFINE_CEPH_FEATURE(26, 1, CREATEPOOLID)
  99. DEFINE_CEPH_FEATURE(27, 1, REPLY_CREATE_INODE)
  100. DEFINE_CEPH_FEATURE_RETIRED(28, 1, OSD_HBMSGS, HAMMER, JEWEL)
  101. DEFINE_CEPH_FEATURE(28, 2, SERVER_M)
  102. DEFINE_CEPH_FEATURE(29, 1, MDSENC)
  103. DEFINE_CEPH_FEATURE(30, 1, OSDHASHPSPOOL)
  104. DEFINE_CEPH_FEATURE(31, 1, MON_SINGLE_PAXOS) // deprecate me
  105. DEFINE_CEPH_FEATURE_RETIRED(32, 1, OSD_SNAPMAPPER, JEWEL, LUMINOUS)
  106. DEFINE_CEPH_FEATURE_RETIRED(33, 1, MON_SCRUB, JEWEL, LUMINOUS)
  107. DEFINE_CEPH_FEATURE_RETIRED(34, 1, OSD_PACKED_RECOVERY, JEWEL, LUMINOUS)
  108. DEFINE_CEPH_FEATURE(35, 1, OSD_CACHEPOOL)
  109. DEFINE_CEPH_FEATURE(36, 1, CRUSH_V2)
  110. DEFINE_CEPH_FEATURE(37, 1, EXPORT_PEER)
  111. DEFINE_CEPH_FEATURE(38, 1, OSD_ERASURE_CODES)
  112. DEFINE_CEPH_FEATURE(38, 1, OSD_OSD_TMAP2OMAP) // overlap
  113. DEFINE_CEPH_FEATURE(39, 1, OSDMAP_ENC)
  114. DEFINE_CEPH_FEATURE(40, 1, MDS_INLINE_DATA)
  115. DEFINE_CEPH_FEATURE(41, 1, CRUSH_TUNABLES3)
  116. DEFINE_CEPH_FEATURE(41, 1, OSD_PRIMARY_AFFINITY) // overlap
  117. DEFINE_CEPH_FEATURE(42, 1, MSGR_KEEPALIVE2)
  118. DEFINE_CEPH_FEATURE(43, 1, OSD_POOLRESEND)
  119. DEFINE_CEPH_FEATURE(44, 1, ERASURE_CODE_PLUGINS_V2)
  120. DEFINE_CEPH_FEATURE_RETIRED(45, 1, OSD_SET_ALLOC_HINT, JEWEL, LUMINOUS)
  121. DEFINE_CEPH_FEATURE(46, 1, OSD_FADVISE_FLAGS)
  122. DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_REPOP, JEWEL, LUMINOUS) // overlap
  123. DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_OBJECT_DIGEST, JEWEL, LUMINOUS) // overlap
  124. DEFINE_CEPH_FEATURE_RETIRED(46, 1, OSD_TRANSACTION_MAY_LAYOUT, JEWEL, LUMINOUS) // overlap
  125. DEFINE_CEPH_FEATURE(47, 1, MDS_QUOTA)
  126. DEFINE_CEPH_FEATURE(48, 1, CRUSH_V4)
  127. DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_MIN_SIZE_RECOVERY, JEWEL, LUMINOUS)
  128. DEFINE_CEPH_FEATURE_RETIRED(49, 1, OSD_PROXY_FEATURES, JEWEL, LUMINOUS) // overlap
  129. DEFINE_CEPH_FEATURE(50, 1, MON_METADATA)
  130. DEFINE_CEPH_FEATURE(51, 1, OSD_BITWISE_HOBJ_SORT)
  131. DEFINE_CEPH_FEATURE(52, 1, OSD_PROXY_WRITE_FEATURES)
  132. DEFINE_CEPH_FEATURE(53, 1, ERASURE_CODE_PLUGINS_V3)
  133. DEFINE_CEPH_FEATURE(54, 1, OSD_HITSET_GMT)
  134. DEFINE_CEPH_FEATURE(55, 1, HAMMER_0_94_4)
  135. DEFINE_CEPH_FEATURE(56, 1, NEW_OSDOP_ENCODING)
  136. DEFINE_CEPH_FEATURE(57, 1, MON_STATEFUL_SUB)
  137. DEFINE_CEPH_FEATURE(57, 1, MON_ROUTE_OSDMAP) // overlap
  138. DEFINE_CEPH_FEATURE(57, 1, OSDSUBOP_NO_SNAPCONTEXT) // overlap
  139. DEFINE_CEPH_FEATURE(57, 1, SERVER_JEWEL) // overlap
  140. DEFINE_CEPH_FEATURE(58, 1, CRUSH_TUNABLES5)
  141. DEFINE_CEPH_FEATURE(58, 1, NEW_OSDOPREPLY_ENCODING) // overlap
  142. DEFINE_CEPH_FEATURE(58, 1, FS_FILE_LAYOUT_V2) // overlap
  143. DEFINE_CEPH_FEATURE(59, 1, FS_BTIME)
  144. DEFINE_CEPH_FEATURE(59, 1, FS_CHANGE_ATTR) // overlap
  145. DEFINE_CEPH_FEATURE(59, 1, MSG_ADDR2) // overlap
  146. DEFINE_CEPH_FEATURE(60, 1, OSD_RECOVERY_DELETES) // *do not share this bit*
  147. DEFINE_CEPH_FEATURE(61, 1, CEPHX_V2) // *do not share this bit*
  148. DEFINE_CEPH_FEATURE(62, 1, RESERVED) // do not use; used as a sentinal
  149. DEFINE_CEPH_FEATURE_DEPRECATED(63, 1, RESERVED_BROKEN, LUMINOUS) // client-facing
  150. /*
  151. * Features supported.
  152. */
  153. #define CEPH_FEATURES_SUPPORTED_DEFAULT \
  154. (CEPH_FEATURE_NOSRCADDR | \
  155. CEPH_FEATURE_FLOCK | \
  156. CEPH_FEATURE_SUBSCRIBE2 | \
  157. CEPH_FEATURE_RECONNECT_SEQ | \
  158. CEPH_FEATURE_DIRLAYOUTHASH | \
  159. CEPH_FEATURE_PGID64 | \
  160. CEPH_FEATURE_PGPOOL3 | \
  161. CEPH_FEATURE_OSDENC | \
  162. CEPH_FEATURE_CRUSH_TUNABLES | \
  163. CEPH_FEATURE_SERVER_LUMINOUS | \
  164. CEPH_FEATURE_RESEND_ON_SPLIT | \
  165. CEPH_FEATURE_RADOS_BACKOFF | \
  166. CEPH_FEATURE_OSDMAP_PG_UPMAP | \
  167. CEPH_FEATURE_CRUSH_CHOOSE_ARGS | \
  168. CEPH_FEATURE_MSG_AUTH | \
  169. CEPH_FEATURE_CRUSH_TUNABLES2 | \
  170. CEPH_FEATURE_REPLY_CREATE_INODE | \
  171. CEPH_FEATURE_MDSENC | \
  172. CEPH_FEATURE_OSDHASHPSPOOL | \
  173. CEPH_FEATURE_OSD_CACHEPOOL | \
  174. CEPH_FEATURE_CRUSH_V2 | \
  175. CEPH_FEATURE_EXPORT_PEER | \
  176. CEPH_FEATURE_OSDMAP_ENC | \
  177. CEPH_FEATURE_MDS_INLINE_DATA | \
  178. CEPH_FEATURE_CRUSH_TUNABLES3 | \
  179. CEPH_FEATURE_OSD_PRIMARY_AFFINITY | \
  180. CEPH_FEATURE_MSGR_KEEPALIVE2 | \
  181. CEPH_FEATURE_OSD_POOLRESEND | \
  182. CEPH_FEATURE_MDS_QUOTA | \
  183. CEPH_FEATURE_CRUSH_V4 | \
  184. CEPH_FEATURE_NEW_OSDOP_ENCODING | \
  185. CEPH_FEATURE_SERVER_JEWEL | \
  186. CEPH_FEATURE_MON_STATEFUL_SUB | \
  187. CEPH_FEATURE_CRUSH_TUNABLES5 | \
  188. CEPH_FEATURE_NEW_OSDOPREPLY_ENCODING | \
  189. CEPH_FEATURE_MSG_ADDR2 | \
  190. CEPH_FEATURE_CEPHX_V2)
  191. #define CEPH_FEATURES_REQUIRED_DEFAULT 0
  192. #endif