clay-code · limited · also coupled-layer code, Clay codes

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

  1. Vajha et al. Clay Codes: Moulding MDS Codes to Yield an MSR Code. FAST 2018, sections 3-5 and Appendix A. (accessed 2026-11-22)
  2. Ceph v18.2.7: ErasureCodeClay::parse, shortening and sub-chunk count. (accessed 2026-11-22)
  3. Ceph development documentation: CLAY plugin lifecycle and profile guidance; accessed 2026-11-22. (accessed 2026-11-22)

Further reading

  1. Hesela: CLAY shortening examples and repair accounting (accessed 2026-11-22)
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.

JSON: /data/terms/clay-code.json

Published by Hesela team · Updated

Report a correction · Editorial standards · Reuse guidance

Cite this page
Hesela team. CLAY code. Hesela. 2026-11-22. https://hesela.dev/terms/clay-code/