Table of Contents

二进制格式——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。