中国DOS联盟

Gemini 解答

---

这是一个在 DOS / Win32 命令行环境下用于二进制文件切片、检索、原位修补（Patching）与替换的专用工具。在 2000 年代中后期（尤其在维护系统启动盘、修改引导扇区、修改 GRLDR/DOS 扩展器配置或编写自动化装机批处理时），此类命令行 Hex 处理工具非常常见。

核心功能与运行机制

1. 底层寻址与文件大小限制（2GB 边界）

   • 软件支持十进制与十六进制（0x 前缀）的偏移量（Start/Address）与长度（Bytes）输入。
   • 文档明确指出单文件大小上限为 2GB，这是典型的 32 位有符号整型（signed long / int32_t）限制。在 C 标准 I/O 库中，fseek() 与 ftell() 使用 long 类型记录偏移量，最大寻址范围即为 $2^{31}-1$ 字节（约 2.14GB）。

2. 数据操作模式的本质差异

   • 覆写操作（Overwrite / Patch）：/C（在已有目标上）、/E。这类操作仅改变指定偏移处的字节，不改变目标文件的物理尺寸。
   • 插入/删除操作（Insert / Delete）：/I、/D。此类操作必须对目标偏移点之后的所有数据进行前移或后移重写（或流式重写到新目标文件），操作完成后目标文件尺寸会发生增减。
   • 就地替换（Replace）：/R 模式在二进制修补中的特殊性在于，如果 SrcString 与 DstString 的长度不一致，会导致文件中后续所有数据的绝对偏移发生移动。在修改诸如 PE/MZ 可执行文件或 GRLDR 等引导镜像时，改变数据长度通常会破坏文件头中的结构体偏移或校验和，因此在引导文件定制场景中，通常要求等长替换。

3. 检索算法与匹配步进（Non-overlapping Matching）

   • 作者说明中指出查找使用了 KMP 算法，且采用“非重叠匹配（Non-overlapping）”策略。
   • 当在 0000000000（10 个 0）中查找 0000（4 个 0）时，匹配到偏移 0 后，指针直接跳过 4 个字节从偏移 4 开始下一次匹配，因而仅返回 0 与 4（第 8、9 字节不足 4 字节被舍弃）。这种设计符合文件内容替换工具的标准逻辑（避免产生自重叠递归替换死循环）。

后续跟帖中暴露的典型历史 Bug 与底层原因

1. 写空字节（0x00）截断失效问题（第 19 楼）

   • 现象：str 1.exe 0x03 0 /e /hex:0011 遇到 00 无法写入。
   • 原因：这是 C/C++ 编写此类工具时最常见的逻辑缺陷——在解析命令行传入的十六进制串转换为二进制字节流时，开发者如果将转换后的二进制缓冲区直接当作 C 风格字符串（以 \0 结尾的 ASCIIZ）进行处理（例如使用了 strlen()、strcpy()、fprintf("%s") 或基于 char * 的查找函数），0x00 会被判定为字符串结束符（Null Terminator），导致后续的数据解析或文件写入被提前截断。正确的二进制处理必须显式维护 buffer 指针与其对应的 size_t 长度，完全脱离对 Null 字符的依赖。

2. 字符串转义与长度计算（第 12–14 楼）

   • 在批处理自动化中，直接以 Hex 形式处理控制字符（如换行符 0x0D 0x0A、截断符 0x00）是标准做法。若工具不支持 \r\n\0 等转义序列，可通过将 ASCII 字符与控制字符统一换算为连续的 Hex 字符串（例如将 test + 0x0D + 0x00 写作 /hex:746573740D00）一次性写入，避免分段计算偏移。

3. 退出码与批处理控制（第 21 楼）

   • 程序通过标准返回值（Exit Code）传递执行状态，在 DOS/Windows 批处理中可通过 %errorlevel% 进行流程分支控制（如 IF ERRORLEVEL 12 GOTO NOT_FOUND，注意 DOS 默认的 ERRORLEVEL 判定是大于等于逻辑）。作者定义的退出码枚举如下：

#define SUCCESS              0  // 执行成功
#define COMMON_USE_ERROR     1  // 常规/通用错误
#define OPEN_FILE_ERROR      2  // 打开源文件失败
#define PRG_MODIFIED         3  // 程序/文件已被修改
#define FILE_READ_ERROR      4  // 读取文件失败
#define PARAMETER_ERROR      5  // 命令行参数格式错误
#define CREATE_FILE_ERROR    6  // 创建目标文件失败
#define FILE_WRITE_ERROR     7  // 写入数据失败
#define SRCFILE_DSTFILE_SAME 8  // 源文件与目标文件相同（冲突）
#define USER_CANCEL          9  // 用户取消操作
#define FILE_NOT_EXIST      10  // 文件不存在
#define FILE_SEEK_ERROR     11  // 文件指针定位（fseek）失败
#define STRING_NOT_FOUND    12  // 未找到目标字符串

附件

str.rar (18.38 KiB, 下载附件所需积分 1 点, 下载次数: 171)

strWin32.rar (20.34 KiB, 下载次数: 11)