Deaicup/Deshab-OS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3aebe962bee10d6f711cecd57c17d94063ddbf7d
Deshab-OS/docs/RE/test-cases/linux-compat.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.3 KiB
Raw Blame History

Linux 兼容层测试矩阵

对应计划 Phase A：UTSM+Linux 双内核 park-and-resume 端到端验证 前置条件：Linux 6.6 LTS bzImage 已构建（SYSTEM/boot/linux-bzImage + linux-initrd.img）

状态: ⬜ PENDING

测试环境

  • QEMU 加速: WHPX (-accel whpx -cpu max)，TCG 不支持 VMX
  • Linux 模块: limine.conf 中 bzImage/initrd 模块已启用
  • 串口: -serial stdio，过滤 Linux version|utsm-linux|linux_compat|UTSM.*Linux|DSK|shell

测试矩阵

# 测试项 串口/Shell 预期 状态 失败处理 Bug#
A5.1 UTSM VMM self-test 通过 [UTSM] VMM self-test PASS ⬜ 检查 VMCS/EPT 初始化；BIOS 启用 VT-x
A5.2 bzImage 加载与解析 [UTSM] Linux bzImage loaded ⬜ 检查 linux_loader_init header magic 校验
A5.3 EPT 映射 + vmlaunch [UTSM] Linux guest launched ⬜ 检查 EPT 表、VMCS guest 状态
A5.4 Linux 内核启动 Linux version 6.6.x 串口日志 ⬜ 检查 cmdline、boot_params、E820 表
A5.5 init 脚本运行 [utsm-linux] init started ⬜ 检查 initramfs 结构
A5.6 exec daemon 启动 + park [utsm-linux] starting utsm_exec_daemon... → linux_compat_init() ready ⬜ 检查 daemon 编译、IPC 共享内存初始化
A5.7 DSK 正常接管 [DSK] boot → [DSK] SELFTEST PASS ⬜ 验证 Linux park 不阻塞 DSK
A5.8 shell linux（无参）状态查询 Linux 兼容层已就绪 (双内核 park-and-resume) ⬜ 检查 reserved[5] 传递链
A5.9 shell linux ls 输出 initramfs 根目录内容 ⬜ 检查 IPC exec 协议、vmresume 路径
A5.10 shell linux uname -a 输出 Linux ... 6.6.x ... ⬜ 同上
A5.11 shell linux cat /etc/hostname 输出 hostname ⬜ 同上
A5.12 错误路径：linux nosuchprog 输出 exec 失败，shell 不崩溃 ⬜ 检查 EXEC_EXIT 消息处理

关键约束验证

约束 验证方法 状态
Linux guest cmdline 含 nohlt idle=poll 检查 linux_loader.c cmdline 构造 ⬜
IPC 共享内存 GPA=0x04000000, 1MB e820 中标记 RESERVED，Linux 不分配 ⬜
Linux guest RAM 起始 0x05000000 检查 EPT 映射范围 ⬜
exec daemon 先发 EXEC_READY 再 HLT daemon 源码 utsm_exec_daemon.c ⬜
UTSM hypercall ABI: RAX=magic|op 检查 hypercall.c 处理 ⬜

自动化脚本

tests/qemu/linux-compat.ps1 动态检测 VMM 可用性，自动分流：

.\tests\qemu\linux-compat.ps1              # QEMU WHPX：走路径 B（VMM unavailable 优雅降级）
.\tests\qemu\linux-compat.ps1 -Cpu max     # 真机/KVM nested VMX：走路径 A（完整双内核流程）
  • 路径 A（guest VMX 可用）：按序断言 A5.1A5.7 启动链锚点 （VMM init → self-test → bzImage → IPC shm → vmlaunch → Linux version → daemon park → [LNXC] service ready → DSK），随后经 monitor 按键执行 dsl / dsl ls / dsl uname -a / dsl nosuchprog 覆盖 A5.8A5.12。
  • 路径 B（QEMU WHPX/TCG 无 nested VMX，本环境预期）：断言 [UTSM] VMM unavailable 后 DSK 正常接管、dev_tests 完成、dsl 报告运行态不可用、Esc 到 desktop； A5.1~A5.12 标记 SKIP（环境限制，非产品缺陷）。

已知限制

  • QEMU TCG 不支持 VMX，必须 WHPX 或真机
  • WHPX 可能不暴露 nested VMX 给 guest（需实测）
  • 若 CPU 不支持 VT-x，整个 Linux 兼容层降级为"不可用"，不影响其他系统功能

手动测试命令

进入 shell 后执行：

deshab:/ $ linux
deshab:/ $ linux ls
deshab:/ $ linux uname -a
deshab:/ $ linux cat /etc/hostname
deshab:/ $ linux nosuchprog

串口日志锚点

启动后期望按顺序出现：

[UTSM] VMM self-test PASS
[UTSM] Linux bzImage loaded
[UTSM] Linux guest launched
Linux version 6.6.x ...
[utsm-linux] init started
[utsm-linux] kernel: 6.6.x
[utsm-linux] starting utsm_exec_daemon...
[utsm-linux] daemon PID=...
[utsm-linux] init: daemon running, entering idle hold
[UTSM] linux_compat service ready
[DSK] boot
[DSK] SELFTEST PASS
... (进入 shell 提示符)
Reference in New Issue View Git Blame Copy Permalink