DOSBox-X 中 IMGMAKE 工具生成磁盘镜像的 BPB 参数问题分析

问题背景

在 DOSBox-X 模拟器的 2024 年 8 月夜间构建版本中，用户报告了一个关于 IMGMAKE 工具的重要功能退化问题。IMGMAKE 是 DOSBox-X 提供的一个实用工具，用于创建各种类型的磁盘镜像文件。在最新版本中，该工具无法正确应用 -rootdir 和 -spc 参数来创建软盘镜像，导致生成的磁盘镜像不符合预期规格。

问题表现

当用户尝试使用以下命令创建 1.44MB 软盘镜像时：

IMGMAKE test.ima -t fd_1440 -fatcopies 1 -rootdir 32 -spc 4

生成的镜像文件存在以下问题：

1. 根目录条目数（root entries）默认为 224 而非指定的 32
2. 每簇扇区数（sectors per cluster）默认为 1 而非指定的 4
3. FAT 表大小计算不正确

技术分析

通过对比 2024 年 7 月 1 日发布版本和 8 月夜间构建版本生成的镜像文件，可以确认这是一个回归问题。问题源于提交 4462d888 中对软盘镜像 BPB（BIOS Parameter Block）参数的修改，虽然修正了标准软盘镜像的 BPB 参数，但意外破坏了自定义参数的功能。

BPB 是 DOS 文件系统中存储磁盘几何参数的关键数据结构，包含以下重要字段：

• 每扇区字节数
• 每簇扇区数
• 保留扇区数
• FAT 表数量
• 根目录条目数
• 总扇区数
• 介质描述符
• 每个 FAT 表占用的扇区数
• 每磁道扇区数
• 磁头数

解决方案

开发团队通过以下方式解决了这个问题：

1. 对标准软盘类型（如 1.44MB、1.2MB 等）保留优化的默认 BPB 参数
2. 当用户指定自定义参数（如 -rootdir、-spc）时，正确计算并应用这些参数
3. 调整 FAT 表大小计算算法，确保与用户指定的参数匹配
4. 确保生成的镜像文件能够通过常见工具（fsck.vfat、CHKDSK 等）的验证

验证结果

修复后的版本生成的镜像文件具有以下正确特性：

• 根目录条目数准确反映用户指定的值
• 每簇扇区数正确设置
• FAT 表大小经过精确计算
• 文件系统完整性通过 fsck.vfat 验证
• 虽然 FreeDOS 的 CHKDSK 会报告"可疑的引导描述符"警告，但这属于对非标准参数的预期反应，不影响实际使用

技术建议

对于需要在 DOSBox-X 中创建自定义规格磁盘镜像的用户，建议：

1. 使用修复后的版本（2024 年 8 月 15 日之后的夜间构建）
2. 验证生成的镜像文件是否符合预期：
   • 使用 minfo 工具检查 BPB 参数
   • 使用 fsck.vfat 验证文件系统完整性
3. 对于生产环境，建议先在测试环境中验证镜像文件的兼容性

此问题的解决确保了 DOSBox-X 在保持标准软盘兼容性的同时，也支持用户创建各种自定义规格的磁盘镜像，为开发者测试不同配置的 DOS 环境提供了更大的灵活性。