mirror of
https://github.com/rustfs/rustfs.git
synced 2026-08-26 05:56:50 +00:00
Zhengchao An
25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
# Compatibility Lens
|
|
|
|
- Internal metadata uses `metadata_compat` helpers for dual RustFS/MinIO keys,
|
|
including mixed casing and removal of both twins.
|
|
- Binary UUID metadata treats absent, empty, and nil as no value. Unversioned
|
|
remote tiers receive no `versionId`; versioned purge requests retain the real
|
|
version ID.
|
|
- `xl.meta` changes preserve supported header/meta versions, recompute
|
|
signatures, decode legacy fixtures, and remain readable by old RustFS/MinIO.
|
|
- Foreign/corrupt metadata validates parallel array lengths and missing fields;
|
|
it returns a decode error rather than indexing, panicking, or fabricating data.
|
|
- Do not “correct” byte-for-byte MinIO ports without legacy fixture evidence.
|
|
Bitrot framing, shard math, distribution, and inline prefixes are contracts.
|
|
- Client-visible metadata/events strip both internal prefixes
|
|
case-insensitively.
|
|
- Proto fields are appended, never reused/renumbered; FlatBuffers tables extend
|
|
compatibly and absent new fields fail closed where authorization/quorum is
|
|
involved.
|
|
- Replay real client request shapes and exact pagination boundaries for S3
|
|
handler changes.
|
|
- Bucket metadata/IAM/config parsing remains compatible with pinned real MinIO
|
|
fixtures and encrypted migration data.
|
|
- Compatibility shims use `RUSTFS_COMPAT_TODO(<task-id>)`, have a removal
|
|
condition, and default toward reading old data safely.
|