二进制格式——TierVolume 虚拟卷盘上格式
分册:总览与通用约定 | Log 族 | Ring 族 | 段元组/索引/快照 | TierVolume | 产品格式 | 网络线格式
2.11 TierVolume 虚拟卷盘上格式(Core.IO virtual:// 介质)
.tier 虚拟磁盘文件(TierVolumeFs)的完整盘上布局——superblock + 位图 + journal + delta +
数据 extent。崩溃一致性 = CoW 元数据 + superblock 代数翻转(单一原子提交点)。
卷布局总览:
[Superblock 4096B @0] [位图区] [Journal 区] [镜像区(检查点)] [数据区]
主侧 superblock → 备份侧 superblock(代数+1 翻转)——双侧轮替
Superblock(4096B,"RAW1")——标量区 + 表区 + Crc@4088:
| 偏移 | 宽度 | 字段 | 含义 |
|---|---|---|---|
| 0 | 4 | MagicValue | 0x31574152 "RAW1" |
| 4 | 2 | Version | — |
| 6 | 2 | Flags | — |
| 8 | 4 | BlockSize | 块大小(字节) |
| 12 | 8 | CapacityBlocks | 卷容量(块) |
| 20 | 8 | BitmapStart / BitmapBlocks | 位图区位置 |
| 36 | 4 | ImageRunCount | 镜像区间数 |
| 136 | 8 | ImageLength / ImageCrc | 镜像长度 + CRC |
| 148 | 8 | Generation | 代数(崩溃一致性翻转点) |
| 172 | 2 | CarrierIndex | 成员载体索引 |
| 174 | 4 | MemberCount | 成员数 |
| 178 | 8 | JournalStart / JournalBlocks / JournalGeneration / JournalState / JournalCkptLsn / JournalHeadLsn | journal 区(日志模式检查点) |
| 4088 | 4 | Crc | CRC32C 覆盖 [0, 4088) |
表区几何(固定容量槽,v1 冻结格式):image runs 8×12B(SuperblockImageRun:[0] Start u64 + [8] Count u32)、members 8×40B(SuperblockMember:uuid 16B 裸区 + [16] CapacityBlocks + [24] BitmapStartLocal + [32] BitmapBlocksLocal)、snapshots 16×180B(SuperblockSnapshot:name 32B + ticks/lsn/runs 表 ≤8×12 + image 字段 + bitmap 字段 + inUse)。
成员载体身份头(512B,"RAWC"):[0] Magic 4 [4] Version 2 [24] CarrierIndex 4 [28] BitmapStartLocal 8 [36] BitmapBlocksLocal 8 [44] Capacity 8 [508] Crc 4(CRC32C 覆盖 [0,508))。uuid 裸区 @8..24。
位图(空间事实真相源):1 bit/块,容量成比例、格式化时静态定长;64 块对齐(保证位字不跨成员——BitmapAlignBlocks=64);小端位序(位 i 在字 i/64 的位 i%64)。
Journal 帧(32B,"RJRN"):[0] Magic 4 [4] Type 1B [8] Lsn u64 [16] Generation u64 [24] BodyLength u32 [28] BodyCrc u32。记录类型(JournalRecordType):FileCreate=1 / FileDelete=2 / FileMove=3 / DirCreate=4 / DirDelete=5 / DirMove=6 / SetLength=7 / ExtentTailExtend=8 / ExtentAppend=9 / ExtentCover=10 / PunchHole=11(+)。日志模式:WAL 记录先于屏障、LSn 发射预分配、检查点 CkptLsn 前进 + 区代数复位随 superblock 翻转原子生效。
Delta 流(跨载体增量/快照):文件头 44B [Magic "TCD1"][Ver][Flags][BlockSize 4][uuid 16B 裸区][BaseLsn 8][BaseCrc 4][HeaderCrc 4];数据段 12B [Magic "TCD3"][Count u64] + 条目 12B [Block u64][BlockCrc u32];流尾 16B [Magic "TCD2"][Count u64][PayloadCrc u32]。
区间状态(文件 extent,ExtentState):Unwritten=0(预分配 fallocate 语义——物理已留、读零、写时转 Written)/ Written=1(已写数据);Sparse 洞 = 无 extent 条目(读零)——"区间三态" = 洞 / Unwritten / Written。
崩溃一致性:CommitMetadata——元数据序列化为镜像 → 新块落盘(旧块不动 = CoW)→ 位图落盘 → 备份侧翻转(代数+1)→ 主侧翻转。提交序不变量:数据先于元数据、元数据先于翻转。恢复:取 CRC 有效且代数最高的一份 superblock → 载入其镜像 → dirty 则可达性对账重写位图(孤儿回收——未提交的分配消失,位图 = 可达集恢复)→ 可写继续。
段元组(SegmentTuple,36B + 变长 + 4B)——SegmentTable 地址空间持久
2.8 段元组(SegmentTuple,36B + 变长 + 4B)
段表恢复时逐段的磁盘权威(per-segment FileExtra 元数据)。
[MagicValue 8][Ver 1][State 1][MaxOffset 8][GrowthLimit 8][RealSize 8][SummaryLength 2][Summary var][CRC32C 4]
0 8 9 10 18 26 34 36
| 偏移 | 宽度 | 字段 | 含义 |
|---|---|---|---|
| 0 | 8 | MagicValue | 0x54435F5345475455 "TC_SEGTU" |
| 8 | 1 | Version | = 2 |
| 9 | 1 | State | StableState 枚举 |
| 10 | 8 | MaxOffset | 段已提交水位 |
| 18 | 8 | GrowthLimit | 段生长上限 |
| 26 | 8 | RealSize | 物理大小 |
| 34 | 2 | SummaryLength | 区间摘要字节数(0 = 无摘要;预算 ≤ 1496B) |
| 36+len | 4 | CRC32C | 覆盖 [0, 36+len) |
SegId 不编码(文件名 data.{segId} 承载)。段表盘上无独立"地址表文件"——恢复走扫盘
(枚举段文件 + 读段元组 → LoadAddressTable);footer 双尾水位由 meta/扫盘现算。
源码:src/KernLab.Tier.Runtime/Storage/SegmentTupleCodec.cs:13-108、AddressSpace/SegmentTable.Checkpoint.cs。
源码:src/KernLab.Tier.Core/IO/TierVolume/TierVolumeFrameLayouts.cs、TierVolumeFs.Superblock.cs、TierVolumeFs.Bitmap.cs、TierVolumeFs.Journal.cs、TierVolumeFs.Consistency.cs、TierVolumeFs.Delta.cs、TierVolumeFs.Metadata.cs。