📚 课程目录第2章 QEMU系统级模拟基础

2. QEMU系统级模拟基础：架构、模式与命令行参数

QEMU（Quick EMUlator）是一款支持完整系统模拟（System Emulation）与用户态模拟（User Mode Emulation）的开源虚拟化工具。在内核调试场景中，QEMU 作为硬件模拟层与 GDB 调试代理（gdbstub）的载体，是 kgdb 双机调试的核心执行环境。理解 QEMU 的架构分层、两种运行模式的差异以及关键命令行参数，是正确配置 kgdb 调试环境的前提。

2.1 QEMU 整体架构

QEMU 采用前后端分离的模块化设计，核心组件包括：

前端（Frontend）：负责解析命令行参数、管理虚拟设备树（QOM）、处理用户交互（Monitor/HMP/QMP）。
中间层（TCG / Accelerator）：Tiny Code Generator（TCG）实现动态二进制翻译，将目标架构指令翻译为主机指令；KVM / HVF / WHPX 等加速器提供硬件辅助虚拟化。
后端（Backend）：模拟 CPU 核心、内存控制器、中断控制器、定时器、总线（PCIe / AHB / APB）以及各类外设（网卡、磁盘、串口、显示）。
调试接口（gdbstub）：内嵌 GDB 远程调试协议服务端，支持单步、断点、内存/寄存器读写，是 kgdb 连接 QEMU 的桥梁。

调试接口关键点： QEMU 的 gdbstub 在系统模式下默认监听 TCP 1234 端口（-s 简写），支持多核调试时通过 -gdb tcp::1234 指定自定义端口。kgdb 的代理层（kgdboc）通过串口或网络与 QEMU 的 gdbstub 交互，实现主机 GDB 对客户机内核的透明调试。

2.2 系统模式（System Mode）与用户模式（User Mode）

QEMU 提供两种运行模式，其核心差异在于模拟的完整性与调试能力：

对比维度	系统模式（System Mode）	用户模式（User Mode）
模拟对象	完整硬件平台（CPU、内存、外设、中断控制器）	单个用户态进程（系统调用由主机内核转发）
启动方式	`qemu-system-<arch> -kernel bzImage -hda rootfs.img`	`qemu-<arch> ./a.out`
内核调试支持	完整支持 kgdb / kdb / GDB 单步调试内核	不支持内核调试，仅支持用户态程序调试
外设模拟	支持网卡、磁盘、串口、USB、显示等完整外设	无外设模拟，仅提供系统调用转发
性能开销	较高（需模拟完整硬件 + 中断/异常处理）	较低（仅翻译用户态指令）
典型用途	内核开发、驱动调试、系统级测试、kgdb 双机调试	跨架构用户态程序运行、快速测试

  内核调试场景选择： 本课程所有 kgdb 实验均使用 系统模式（qemu-system-arm / qemu-system-x86_64），因为只有系统模式才能模拟完整的中断控制器、串口控制器和内存管理单元（MMU），这些是 kgdb 代理（kgdboc）和断点异常处理所必需的硬件基础。

2.3 常用命令行参数详解

系统模式下 QEMU 命令行参数数量庞大，以下是与内核调试和 kgdb 集成最相关的核心参数分类：

2.3.1 基础平台参数

参数	说明	示例
`-M <machine>`	指定模拟的硬件平台（如 `virt`、`vexpress-a9`、`pc`）	`-M virt`
`-cpu <model>`	指定 CPU 型号（如 `cortex-a57`、`max`、`host`）	`-cpu cortex-a57`
`-smp <n>`	设置 SMP 对称多处理核心数量	`-smp 4`
`-m <size>`	设置客户机物理内存大小	`-m 2G`

2.3.2 内核与启动参数

参数	说明	示例
`-kernel <file>`	指定内核镜像文件（vmlinux / bzImage / zImage）	`-kernel vmlinux`
`-initrd <file>`	指定初始 RAM 磁盘（initrd / initramfs）	`-initrd rootfs.cpio.gz`
`-append <cmdline>`	向内核传递启动命令行参数	`-append "console=ttyAMA0 kgdboc=ttyAMA0,115200"`
`-dtb <file>`	指定设备树 blob（ARM/ARM64 架构必需）	`-dtb board.dtb`

2.3.3 调试与 gdbstub 参数

参数	说明	示例
`-s`	等价于 `-gdb tcp::1234`，在 TCP 1234 端口开启 gdbstub	`-s`
`-gdb <dev>`	指定 gdbstub 监听设备（TCP / UDP / stdio）	`-gdb tcp::1234`
`-S`	启动时暂停 CPU，等待 GDB 连接后再继续执行	`-S`
`-d <log>`	启用调试日志（如 `in_asm`、`cpu`、`int`）	`-d in_asm,cpu`
`-D <file>`	将调试日志输出到指定文件	`-D qemu.log`

2.3.4 存储与网络参数

参数	说明	示例
`-drive <opts>`	配置存储设备（文件格式、接口、缓存策略）	`-drive file=rootfs.img,format=raw,if=virtio`
`-netdev <opts>`	配置网络后端（user / tap / bridge）	`-netdev user,id=net0`
`-device <dev>`	添加虚拟设备（网卡、磁盘控制器、串口）	`-device virtio-net-pci,netdev=net0`
`-serial <dev>`	重定向串口到 stdio / telnet / TCP	`-serial stdio`

kgdb 参数配置陷阱： 使用 -append 传递 kgdboc=ttyAMA0,115200 时，必须确保 QEMU 的串口设备与内核期望的串口名称一致。ARM 平台常用 ttyAMA0（PL011 UART），x86 平台常用 ttyS0（16550A UART）。若串口名称不匹配，kgdb 将无法初始化代理，导致调试连接失败。

2.4 典型 kgdb 调试启动命令示例

以下是一个完整的 QEMU 系统模式启动命令，集成了 kgdb 调试所需的核心参数：

# ARM64 平台 kgdb 调试启动示例
qemu-system-aarch64 \
  -M virt \
  -cpu cortex-a57 \
  -smp 2 \
  -m 2G \
  -kernel vmlinux \
  -initrd rootfs.cpio.gz \
  -append "console=ttyAMA0 kgdboc=ttyAMA0,115200 nokaslr" \
  -serial stdio \
  -s \
  -S

参数说明：

-s：在 TCP 1234 端口开启 gdbstub，等待 GDB 连接。
-S：启动时暂停 CPU，确保 GDB 在第一条指令执行前就能附加。
nokaslr：禁用内核地址空间布局随机化，保证调试时符号地址与内核镜像一致。
kgdboc=ttyAMA0,115200：配置 kgdb 代理通过串口 ttyAMA0 以 115200 波特率通信。

2.5 本章小结

QEMU 采用前端-翻译/加速-后端-调试接口的四层架构，gdbstub 是 kgdb 调试的核心桥梁。
系统模式模拟完整硬件平台，是内核调试的唯一选择；用户模式仅适用于跨架构用户态程序运行。
调试相关核心参数包括 -s（gdbstub 端口）、-S（启动暂停）、-append（传递 kgdboc 参数）和 -serial（串口重定向）。
启动时使用 nokaslr 禁用 KASLR，确保调试符号地址稳定。