Table of Contents

二进制格式——Meta 家族 / Mirror / VersionedMetadata

分册:总览与通用约定 | Log 族 | Ring 族 | 段元组/索引/快照 | TierVolume | 产品格式 | 网络线格式

Meta 块家族(通用自描述布局)

全部 meta 持久化块(LogMeta/RingMeta/MirrorMeta/SnapshotMeta/MetadataMeta)共用四段自描述容器:

[统一头 12B][结构化水位 Payload(定长)][opaque 实际用量(变长)][统一尾(Footer CRC)]
  • 统一头 12B = 各家族 MetaHeader(同构:Magic 4B + Version 2B + Flags 2B + PayloadLength 2B + PaddingLength 2B, Magic 逐族不同:LMHD/RMHD/…);footer/CRC 偏移由 header.PayloadLength 推出——opaque 容量 零参与盘上几何(容量只做写侧约束)。
  • 旧块短 payload = 零扩展降级(补零解读,新字段读默认值不抛)。
  • LogMeta / RingMeta Flags = 0x4F(ValidEquals 盘上强校验——见 Log 族 / Ring 族)。

五 Meta Payload 对照(偏移均为 payload 内):

Payload 定长 关键字段
LogMetaPayload 80B 双水位 + PreparedTailAddress@64(2PC 悬干)
RingMetaPayload 132B 7 水位 + KeySize@112 锚 + CommittedTailAddress@116(2PC 回退点)+ LastPreparedSeq@88
MirrorMetaPayload 48B Highest@0 / Lowest@16 / 两 seq@32·40
SnapshotMetaPayload 80B 三水位 + CommittedWriteAddress + 两 seq
MetadataMetaPayload 48B 与 Mirror 48B 同构

Mirror 帧(WMHD/PMVH/PMFT 32B+40B)独立分册 → formats-mirror.md。## VersionedMetadata 帧(MetadataHeader 42B)

[Magic@0][Version@4][Flags@6][PayloadLength@8][PaddingLength@12][PreviousVersion@14][MetadataVersion@30][Crc@38] = 42B;payload = MetadataMetaPayload 48B。版本链 N=2 轮替回收——单值元数据跨重启 (水位/配置/锚点),meta 外部隔离传输见 meta.md。