Skip to main content

Crate pi_block_device

Crate pi_block_device 

Source
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§

AllocatedBlock
绑定到特定存储与事务的待写块凭证。
AnonymousRoot
没有任何名称绑定的根版本快照值。
BlockDeviceCapabilities
描述设备声明支持的可选能力。
BlockDeviceMetricsSnapshot
设备指标快照;文件实现当前返回零值占位。
BlockId
编码普通段槽位或独立大块位置的稳定块标识。
CommitResult
持久提交成功后的业务记录序号与维护结果。
DeviceId
初始化时生成并持久化的 128 位设备身份。
FileBlockStore
基于文件系统与追加日志的块存储实现。 使用 data/ 与 log/ 目录持久化状态的文件块存储。
LargeBlockId
独立大块的只读非零编号。
NamedRoot
名称及其目标根版本的快照值。
RecordSeq
V1 日志记录的只读序号;公开值始终可读取,Null 仅供 crate 内持久状态使用。
RootName
非空的命名根名称。
RootVersion
指向一个已提交块的根版本。
SegmentId
仅在创建它的存储实例和快照中有效的段标识。
SegmentInfo
固定快照中的段布局与存活统计。
SegmentVersion
普通段的只读 28 位非零版本号。
WriteInput
块分配所携带的待写内容。

Enums§

BlockStoreError
块存储操作可能返回的错误。
MaintenanceError
维护工作失败的稳定分类。
MaintenanceResult
持久提交完成后维护工作的结果。
MaintenanceStoreStatus
维护失败后存储实例的可服务状态。
SegmentState
段在固定快照中的持久状态。

Traits§

AsyncBlockDevice
提供按块标识异步读取的设备接口。
BlockDeviceInfo
提供设备身份、块尺寸与能力信息。
BlockDeviceMetrics
提供设备指标快照。
BlockStore
提供固定快照和单写者事务的块存储接口。
ReadSnapshot
表示不随后续提交变化的只读状态快照。
WriteTransaction
表示独占写入权限的事务。