// 读一块镜像的分区表
let img = @block.Image::from_bytes(bytes)
let parts = @partition.read(img)
// 打开 NTFS 卷,读取卷信息
let vol = @ntfs.Volume::open(img, parts[0].start_lba)
println(vol.cluster_size())
三个后端构建与测试:
moon check
moon test
moon test --target js
moon test --target wasm-gc
验证方式
正确性不靠”看起来对”:
用 mkfs.ntfs / mkfs.ext4 生成已知内容的镜像,逐字段断言卷头与元数据;
与 7z l、ntfs-3g、内核 debugfs 的输出做对照,同名文件的内容逐字节比对;
固定样本镜像进仓库前先做去标识化,不提交任何真实用户数据。
参考与许可
本项目为原创实现,依据公开规范编写:
NTFS 结构:linux-ntfs 文档 与 Microsoft [MS-FSCC] / [MS-DOS] 公开规范
moonfs
Pure MoonBit, FFI-free read-only filesystem image parser for NTFS and ext4.
在浏览器里直接打开一块磁盘镜像,列出目录、读出文件——不需要挂载、不需要 root、不需要一个 C 库。
为什么需要它
现存的文件系统解析实现几乎都绑定在 C 库上:Linux 侧是
ntfs-3g(GPL)和内核的 ext4 驱动,Windows 侧是libfsntfs。这些方案有三个绕不过去的问题:moonfs 用纯 MoonBit 实现镜像层与文件系统层的字节解析,不依赖 FFI,因此同一份代码可以在 native / JS / wasm-gc 后端上跑,并且可以在没有特权、没有挂载点的前提下直接读取镜像内容。
当前进度
这是 0.1.0 的在建状态,进度如实列出:
src/biniosrc/blocksrc/partitionsrc/ntfssrc/ext4cmd/maininfo/partitions未完成的部分不会在文档里写成”已支持”。
支持矩阵
明确不做的事
范围写死,避免”大而全”导致的半成品:
Unsupported错误,而不是返回错误数据。使用
三个后端构建与测试:
验证方式
正确性不靠”看起来对”:
mkfs.ntfs/mkfs.ext4生成已知内容的镜像,逐字段断言卷头与元数据;7z l、ntfs-3g、内核debugfs的输出做对照,同名文件的内容逐字节比对;参考与许可
本项目为原创实现,依据公开规范编写:
[MS-FSCC]/[MS-DOS]公开规范Documentation/filesystems/ext4/ntfscrate(MIT)与ext4-view的模块划分思路,未复制其代码FAT12/16/32 不在本项目范围内,已有
chenliyi-cly/moonfat实现,后续通过统一的卷接口对接。Apache License 2.0,见 LICENSE。