3. 调试环境搭建：QEMU + BusyBox 构建最小调试内核，配置 KGDB 与 KDB 双模式调试

在深入文件系统 I/O 栈异常定位之前，必须搭建一个可控、可复现、可打断点的内核调试环境。本章将引导你从零构建基于 QEMU 虚拟化平台的最小 Linux 内核调试系统，并同时启用 KGDB（内核调试器，通过串口/GDB 远程调试）与 KDB（内核内置调试器，直接键盘输入）两种模式，为后续章节的实战调试打下坚实基础。

3.1 环境概览与组件选择

最小调试系统由四个核心组件构成，其关系如下图所示：

3.2 编译带调试符号的内核

内核必须开启调试相关配置，才能支持 KGDB 和 KDB。以下是关键内核配置项：

# 进入内核源码目录
make menuconfig

# 必须开启的调试选项（路径与值）
# Kernel hacking  --->
#   [*] KGDB: kernel debugger
#   [*]     KGDB: use kgdb over serial console
#   [*] KGDB: internal debugger (KDB)
#   [*]     KGDB: KDB keyboard input
#   [*] Compile the kernel with debug info
#   [*]   Provide GDB scripts for kernel debugging
#   [*] Magic SysRq key
#   [*]   Enable magic SysRq key by default

# 也可以直接写入 .config
echo "CONFIG_DEBUG_INFO=y" >> .config
echo "CONFIG_KGDB=y" >> .config
echo "CONFIG_KGDB_SERIAL_CONSOLE=y" >> .config
echo "CONFIG_KGDB_KDB=y" >> .config
echo "CONFIG_KDB_KEYBOARD=y" >> .config
echo "CONFIG_MAGIC_SYSRQ=y" >> .config
echo "CONFIG_MAGIC_SYSRQ_DEFAULT_ENABLE=0x1" >> .config

配置完成后，编译内核并保留调试符号：

# 编译内核（使用 -jN 加速）
make -j$(nproc) bzImage

# 编译模块（可选，用于调试文件系统模块）
make -j$(nproc) modules

# 生成 vmlinux（带完整符号表的内核镜像）
# vmlinux 位于源码根目录，用于 GDB 加载符号
ls -lh vmlinux
# 通常约 500MB-1GB（含调试信息）

# 生成 System.map（符号地址映射）
cp System.map /path/to/debug/env/

3.3 使用 BusyBox 构建最小根文件系统

BusyBox 将数百个常用 Linux 命令合并为一个可执行文件，极大减小了根文件系统体积。构建步骤如下：

# 1. 下载并解压 BusyBox
wget https://busybox.net/downloads/busybox-1.36.1.tar.bz2
tar -xf busybox-1.36.1.tar.bz2
cd busybox-1.36.1

# 2. 配置为静态编译（避免依赖动态库）
make menuconfig
# Settings  --->
#   [*] Build static binary (no shared libs)

# 3. 编译并安装到临时目录
make -j$(nproc)
make install CONFIG_PREFIX=/path/to/initramfs

# 4. 创建必要的设备节点和启动脚本
cd /path/to/initramfs
mkdir -p proc sys dev etc/init.d

# 创建 init 脚本
cat > init << 'EOF'
#!/bin/sh
mount -t proc none /proc
mount -t sysfs none /sys
mount -t devtmpfs none /dev
echo "Welcome to Minimal Debug Kernel"
exec /bin/sh
EOF
chmod +x init

# 5. 打包为 initramfs 镜像
find . | cpio -H newc -o | gzip > /path/to/initramfs.gz

3.4 配置 QEMU 启动参数与双串口映射

QEMU 需要两个串口：一个用于 KGDB（TCP 通道，供 GDB 连接），另一个用于 KDB（stdio 通道，供键盘输入）。启动脚本如下：

#!/bin/bash
# 启动 QEMU 调试内核

KERNEL="/path/to/linux-6.x/arch/x86_64/boot/bzImage"
INITRAMFS="/path/to/initramfs.gz"

qemu-system-x86_64 \
    -kernel ${KERNEL} \
    -initrd ${INITRAMFS} \
    -append "console=ttyS0,115200 nokaslr kgdboc=ttyS1,115200 kgdbwait" \
    -serial tcp::1234,server,nowait \
    -serial stdio \
    -m 512M \
    -smp 2 \
    -nographic

3.5 双模式调试操作流程

启动 QEMU 后，内核会因 kgdbwait 停在启动早期。此时可以分别使用 KGDB 和 KDB 进行调试。

3.5.1 KGDB 模式（远程 GDB 调试）

在宿主机另一个终端中启动 GDB：

# 启动 GDB 并加载内核符号
gdb /path/to/linux-6.x/vmlinux

# 在 GDB 中连接 QEMU 的 KGDB 端口
(gdb) target remote :1234

# 此时 GDB 会显示内核停止的位置，例如：
# Remote debugging using :1234
# 0xffffffff81000000 in ?? ()

# 设置断点，例如在 VFS 的 sys_open 函数
(gdb) b do_sys_open
(gdb) c

# 在 QEMU 串口终端中执行一条命令（如 ls），GDB 会命中断点
# 之后可以使用 bt、info registers、list 等标准 GDB 命令

3.5.2 KDB 模式（内置键盘调试器）

当系统正在运行且未通过 KGDB 连接时，可以通过键盘组合键进入 KDB：

# 在 QEMU 的 stdio 串口终端中，按下：
# Ctrl + A, 然后按 c 切换到 QEMU 控制台
# 再按 Ctrl + Alt + 1 切换回串口终端

# 在串口终端中按下 SysRq 键触发 KDB：
# 对于 QEMU stdio，发送 SysRq 的方式是：
# 先按 Ctrl + A, 然后按 x 退出 QEMU（不推荐）
# 正确方式：在 QEMU 启动时添加 -serial mon:stdio 参数
# 然后按 Ctrl + A, 再按 c 进入 QEMU monitor
# 在 monitor 中执行：sendkey sysrq

# 更简单的方法：在内核启动参数中添加：
#   kgdboc=ttyS1,115200 kgdbcon
# 然后在串口终端中直接输入：
echo g > /proc/sysrq-trigger

# 此时终端会进入 KDB 提示符：
# [0]kdb>

# 常用 KDB 命令：
#   bt          - 打印当前 CPU 的堆栈回溯
#   btpid <pid> - 打印指定进程的堆栈
#   lsmod       - 列出已加载的内核模块
#   ps          - 显示进程列表
#   dmesg       - 查看内核日志
#   go          - 继续执行
#   help        - 显示帮助信息

3.6 验证调试环境是否正常工作

完成上述配置后，执行以下验证步骤确认双模式均可用：

1. 验证 KGDB 连接：启动 QEMU 后，在 GDB 中执行 target remote :1234，应看到内核停止在 kgdb_breakpoint() 函数。执行 bt 应显示完整的启动调用链。
2. 验证 KDB 切换：在 QEMU 串口终端中执行 echo g > /proc/sysrq-trigger，应进入 [0]kdb> 提示符。输入 ps 应显示当前进程列表。
3. 验证断点命中：在 GDB 中设置断点 b do_sys_open，然后 c 继续执行。在 QEMU 串口终端中执行 ls，GDB 应命中断点并暂停。
4. 验证 KDB 回溯：在 KDB 提示符下输入 bt，应显示当前 CPU 的内核堆栈，包含函数名和偏移地址。

3.7 常见问题与解决方案