Files
Deshab-OS/docs/RE/test-cases/x86emu32-coverage.md
T
xyou a26866e339 feat: B7 APIC/IOAPIC接管 + NVMe写路径 + virtio_net virtqueue + PE兼容层修复 + QEMU测试套件全自动化
中断路由 (B7):
- apic.drv: LAPIC enable + IOAPIC重定向表编程(MADT ISO感知) + apic_route/apic_route_legacy/apic_diag开关
- UTSM: LAPIC EOI钩子(register_apic_eoi, ABI尾部追加) + IDT 0-255全覆盖 + spurious 0xFF特判
- FUCK: apic_route=0默认PIC(零回归) / =1 IOAPIC->LAPIC接管(失败完整降级) / legacy放开IRQ1/12/11

存储:
- nvme.drv: 写路径 + PRP list + 读回校验 + MSI/MSI-X中断驱动(nvme_msi开关, 回退纯轮询)
- build.ps1: apic.drv纳入构建(原为预置二进制)

网络:
- virtio_net: virtqueue RX/TX + netdev注册 + DHCP自测(slirp真实OFFER)

PE兼容层:
- pe_shim: guest->host指针转换(g_emu_mem_base + gp()) + shim fn32列补齐
- gen_pe.py: PE32+ RVA偏置修复(BUG-004) + cmd.exe生成
- desktop_app.h: da_mouse_poll先判AUX位 + da_mouse_init冲刷残留(BUG-003/008)
- shell: Ctrl修饰键跟踪(BUG-001) + g_run_image扩至1MB(BUG-002)

QEMU测试套件:
- 9用例全自动化(Run-All.ps1): boot-regression/driver-matrix/linux-compat/pe-compat/deaicup-e2e/userapps-matrix/network-e2e/performance-baseline/x86emu32-coverage
- QemuTest.ps1公共库: 串口断言/monitor sendkey/screendump/HTTP服务器/并发隔离

文档:
- CLAUDE.md: APIC/IOAPIC能力 + kernel_api暴露 + IRQ后端升级状态
- LESSONS_LEARNED.md: B7 LAPIC/IOAPIC经验教训(2条)
- Bug记录.txt: BUG-20260801-001~008 + BUG-20260803-009(9条)
- test-cases/*.md: 全部补充自动化脚本小节
- 桌面设计.md: .lnk快捷方式 + LINUXAPP.CNF Linux应用图标
- 系统开发策划.md: NVMe/virtio_net标完成 + B2/B7标已解决 + M2进度列
2026-08-04 18:08:08 +08:00

4.9 KiB
Raw Blame History

x86emu32 指令覆盖率测试

对应计划 Phase B3:枚举 x86emu32.c 已实现指令,验证覆盖率

状态: ⬜ PENDING

已实现指令清单

待根据 x86emu32.c 实际代码枚举填充

数据传送

指令 操作码 测试程序 预期 状态
MOV r32, imm32 B8+rd mov eax, 0x12345678 eax=0x12345678 ⬜
MOV r32, r/m32 8B /r mov eax, ebx eax=ebx ⬜
MOV r/m32, r32 89 /r mov [esi], eax [esi]=eax ⬜
PUSH r32 50+rd push eax [esp]=eax, esp-=4 ⬜
POP r32 58+rd pop eax eax=[esp], esp+=4 ⬜

算术运算

指令 操作码 测试程序 预期 状态
ADD r32, r/m32 03 /r add eax, ebx eax=eax+ebx ⬜
SUB r32, r/m32 2B /r sub eax, ebx eax=eax-ebx ⬜
INC r32 FF /0 inc eax eax=eax+1 ⬜
DEC r32 FF /1 dec eax eax=eax-1 ⬜
MUL r/m32 F7 /4 mul ebx edx:eax=eax*ebx ⬜
DIV r/m32 F7 /6 div ebx eax=edx:eax/ebx ⬜

逻辑运算

指令 操作码 测试程序 预期 状态
AND r32, r/m32 23 /r and eax, ebx eax=eax&ebx ⬜
OR r32, r/m32 0B /r or eax, ebx eax=eax|ebx ⬜
XOR r32, r/m32 33 /r xor eax, ebx eax=eax^ebx ⬜
NOT r/m32 F7 /2 not eax eax=~eax ⬜

控制流

指令 操作码 测试程序 预期 状态
JMP rel32 E9 cw/cd jmp label rip=label ⬜
JMP r/m32 FF /4 jmp eax rip=eax ⬜
CALL rel32 E8 cd call func push rip, rip=func ⬜
RET C3 ret pop rip ⬜
Jcc rel32 0F 8x cd jz label 条件跳转 ⬜

字符串操作

指令 操作码 测试程序 预期 状态
MOVSB A4 movsb [edi]=[esi], inc/dec ⬜
STOSB AA stosb [edi]=al, inc/dec ⬜
REP MOVSB F3 A4 rep movsb 重复 ecx 次 ⬜
REP STOSB F3 AA rep stosb 重复 ecx 次 ⬜

堆栈与控制

指令 操作码 测试程序 预期 状态
ENTER imm16, imm8 C8 iw ib enter 8, 0 建立栈帧 ⬜
LEAVE C9 leave 释放栈帧 ⬜
NOP 90 nop 无操作 ⬜
INT3 CC int3 触发断点 ⬜

测试 PE 程序

每个指令类别构造一个最小 PE32 测试程序,在 CODE/tools/pe-samples/ 下:

  • test_arith.exe:算术运算
  • test_logic.exe:逻辑运算
  • test_control.exe:控制流
  • test_string.exe:字符串操作

每个测试程序通过 WriteFile 输出结果到 cmd.elf,与预期对比。

覆盖率统计

已测试指令数 / 已实现指令数 = 覆盖率

目标:核心指令(MOV/ADD/SUB/CMP/JMP/CALL/RET/PUSH/POP)覆盖率 100%。

自动化脚本

tests/qemu/x86emu32-coverage.ps1 两层验证:

.\tests\qemu\x86emu32-coverage.ps1            # 复用现有镜像
.\tests\qemu\x86emu32-coverage.ps1 -Build     # 先全量构建再测
  1. 静态枚举(无需 QEMU):解析 x86emu32.c 统计 case 0xNN 操作码分支数(覆盖率分母,含 0F 扩展页),并校验 hello32.exe 头 (machine=0x14C / optional magic=0x10B,确为 PE32 样本)。

  2. 动态执行:正常启动 → cmd.elf,AUTOEXEC.BAT 执行 pe HELLO32.EXE + exit。 自动断言 [PE] running PE32 via x86emu32 解释器接管;禁止 [PE32] emulator error / [PE] unimplemented import / [PE] unimplemented API called / [PANIC]。 注意 [PE] PE32 (32-bit) 仅 PE32+ 原生路径(pe_load_image)输出,解释器路径 (pe32_load_into)不打印该行,不可作锚点。

    BUG-20260801-006/007 已修复(Bug记录.txt),原软升级项已转 硬断言(回归守护):Hello from PE32!(shim IAT 拦截输出)与 [cmd] PE run end → [DSK] cmd.elf returned(完整返回链)。

    已知系统侧阻塞(2026-08-04 monitor 取证定案):末锚点 [DSK] cmd.elf returned 当前必缺失。根因不在 PE 层——cmd run_autoexec 的 data/size 直指共享静态 缓冲 f32_data(fat32_io.h),首行 pe HELLO32.EXE 加载 PE 文件即覆盖剩余 脚本,exit 行丢失,cmd 停留交互主循环轮询键盘(guest 存活、无异常投递、 无三重故障)。反证:pe-compat 会话 C(pe NONEXIST.EXE + exit,文件未找到 不覆盖缓冲)返回链正常。待 cmd 侧修复(脚本先拷入私有缓冲再逐行执行)后 末锚点自动转绿。

指令级逐条覆盖(上方矩阵 test_arith/test_logic/test_control/test_string)依赖 CODE/tools/pe-samples/ 下尚未构建的分类测试 PE,标 MANUAL。