CLAY code
A CLAY code is a vector MDS erasure code that couples layers of scalar codes to support exact repair with partial-fragment reads.
The construction separates recoverability from its efficient repair path. When d is below n-1, the selected helpers must include the surviving nodes in the failed node's construction group; arbitrary d survivors need not support that path. This is a coding group, not a rack-placement rule. [1]
For n=k+m and q=d-k+1, Ceph v18.2.7 pads the construction to the next multiple of q, then omits the added zero-valued data nodes. The sub-chunk count is q^ceil(n/q). With k=10, m=4 and d=13, two virtual nodes give 256 sub-chunks, not 4^3.5=128. The real layout still stores 14 fragments for 10 data fragments. [2]
The single-loss helper-byte budget dS/q assumes S bytes per lost fragment and an eligible repair path. It excludes forwarding the rebuilt fragment. Separate logical helper bytes, network transfers and physical reads. [1]
Ceph's development manual marks the plugin deprecated since Umbrella, with removal planned for Vampire. That release policy is separate from the code's mathematical properties. [3]
Relations
- related
- Minimum-storage regenerating code, Subpacketization, Maximum distance separable code, Repair locality, Erasure coding
Limitations
- Sub-chunk alignment, helper availability and the implementation's repair path can prevent theoretical byte savings from becoming faster recovery. [1]
Citations
- Vajha et al. Clay Codes: Moulding MDS Codes to Yield an MSR Code. FAST 2018, sections 3-5 and Appendix A.
- Ceph v18.2.7: ErasureCodeClay::parse, shortening and sub-chunk count.
- Ceph development documentation: CLAY plugin lifecycle and profile guidance; accessed 2026-11-22.
Further reading
Sources & caveats
- Primary-source synthesis of FAST 2018 sections 3-5 and Appendix A; Ceph v18.2.7 parse and repair-selection source inspected. No codec or cluster benchmark was executed.
- Shortening and byte arithmetic are reproduced by /research/clay-shortening.mjs and its tests; the parameter helper is not a Ceph profile validator.