Expand description
§pi_block_device
本 crate 定义异步写时复制块设备的稳定公共接口,并提供基于文件系统的 FileBlockStore。
写入通过单写者事务完成,提交后方可读取。文件实现使用追加日志恢复状态;恢复会
截断 Active 段的完整冗余尾部并删除未引用孤儿文件。提交结果不确定时实例要求恢复。
release_blocks 可原子释放普通块和大块,并在 durable 发布后通过进程内退休队列延迟
删除不再受固定快照或读取缓冲保护的文件。
§碎片整理与空间回收
块设备不解析块内引用,也不会在后台自动搬迁仍存活的数据。外部整理器应先从一个
固定 ReadSnapshot 选择稀疏段并读取其中的存活块,再通过普通 WriteTransaction
分配和写入替代块、重写上层引用或根,最后调用 WriteTransaction::release_blocks
逻辑释放旧块并提交。这样整理操作与普通业务写入共享相同的顺序校验和 durable 协议,
不需要独立的整理会话。
逻辑释放不等于立即删除物理文件。只有当提交后的 State 已不再引用整个段或大块时, 文件后端才会在 durable 发布之后把对应路径登记到退休队列。退休 worker 还会检查当前 State、固定快照和已返回读取缓冲持有的路径 lease;所有保护解除后才执行 unlink。 日志 rotate、checkpoint 和 archive 属于日志维护,不会代替上述数据搬迁流程。
指标仍为零值占位;Windows 目录同步对平台不支持的错误采用 best effort。
Structs§
- Allocated
Block - 绑定到特定存储与事务的待写块凭证。
- Anonymous
Root - 没有任何名称绑定的根版本快照值。
- Block
Device Capabilities - 描述设备声明支持的可选能力。
- Block
Device Metrics Snapshot - 设备指标快照;文件实现当前返回零值占位。
- BlockId
- 编码普通段槽位或独立大块位置的稳定块标识。
- Commit
Result - 持久提交成功后的业务记录序号与维护结果。
- Device
Id - 初始化时生成并持久化的 128 位设备身份。
- File
Block Store - 基于文件系统与追加日志的块存储实现。 使用 data/ 与 log/ 目录持久化状态的文件块存储。
- Large
Block Id - 独立大块的只读非零编号。
- Named
Root - 名称及其目标根版本的快照值。
- Record
Seq - V1 日志记录的只读序号;公开值始终可读取,Null 仅供 crate 内持久状态使用。
- Root
Name - 非空的命名根名称。
- Root
Version - 指向一个已提交块的根版本。
- Segment
Id - 仅在创建它的存储实例和快照中有效的段标识。
- Segment
Info - 固定快照中的段布局与存活统计。
- Segment
Version - 普通段的只读 28 位非零版本号。
- Write
Input - 块分配所携带的待写内容。
Enums§
- Block
Store Error - 块存储操作可能返回的错误。
- Maintenance
Error - 维护工作失败的稳定分类。
- Maintenance
Result - 持久提交完成后维护工作的结果。
- Maintenance
Store Status - 维护失败后存储实例的可服务状态。
- Segment
State - 段在固定快照中的持久状态。
Traits§
- Async
Block Device - 提供按块标识异步读取的设备接口。
- Block
Device Info - 提供设备身份、块尺寸与能力信息。
- Block
Device Metrics - 提供设备指标快照。
- Block
Store - 提供固定快照和单写者事务的块存储接口。
- Read
Snapshot - 表示不随后续提交变化的只读状态快照。
- Write
Transaction - 表示独占写入权限的事务。