📚 课程目录第2章内核调试环境搭建

内核崩溃定位与PCI驱动调试：设备驱动工程实践故障分析 - 第2节

2.1 为什么需要可调试的内核环境

内核崩溃（Kernel Panic / Oops）是设备驱动开发中最棘手的故障之一。当驱动代码访问非法地址、触发空指针解引用或破坏内核关键数据结构时，系统可能直接挂死或重启。在真实硬件上调试这类问题面临三大障碍：

单机调试困难：内核崩溃后系统无法响应，日志可能来不及写入磁盘。
硬件断点受限：真实CPU的硬件调试寄存器数量有限，且无法在驱动加载前设置。
符号信息缺失：发行版内核通常剥离了调试符号，回溯调用栈只能看到十六进制地址。

使用 QEMU + GDB 搭建虚拟化调试环境，可以完美绕过上述限制。QEMU 模拟完整的 PCI 总线拓扑，GDB 通过远程调试协议（gdbstub）连接 QEMU，实现源码级单步调试、条件断点、变量观察和内存读写。配合带调试符号（-g 编译）的内核镜像，驱动开发者可以在开发机上重现并定位崩溃现场。

  核心收益：QEMU 模拟的 PCI 设备允许驱动在未接触真实硬件前完成功能验证和边界测试；GDB 的 watch 命令可以监控驱动对特定 I/O 端口的访问，这在真实硬件上几乎不可能实现。

2.2 编译带调试符号的内核镜像

2.2.1 获取内核源码

从 kernel.org 下载长期支持（LTS）版本，或使用发行版提供的源码包。本课程以 Linux 6.1 LTS 为例：

# 下载并解压
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.1.76.tar.xz
tar -xf linux-6.1.76.tar.xz
cd linux-6.1.76

2.2.2 配置内核选项

调试符号和 QEMU 模拟所需的配置项必须显式开启。使用 make menuconfig 或直接修改 .config 文件。下表列出关键配置项及其作用：

配置项	推荐值	作用说明
`CONFIG_DEBUG_INFO`	y	生成 DWARF 调试符号，GDB 依赖此信息进行源码级调试
`CONFIG_DEBUG_INFO_DWARF5`	y	使用 DWARF5 格式，提供更丰富的类型信息
`CONFIG_GDB_SCRIPTS`	y	加载内核专用的 GDB 辅助脚本（lx-* 命令）
`CONFIG_FRAME_POINTER`	y	使用帧指针寄存器，提升调用栈回溯可靠性
`CONFIG_KGDB`	y	启用内核内建调试器，支持串口/KDB 调试
`CONFIG_PCI`	y	PCI 总线支持，驱动调试的基础
`CONFIG_PCI_DEBUG`	y	PCI 子系统调试信息输出
`CONFIG_VIRTIO_PCI`	y	QEMU 默认的 PCI 设备接口，用于模拟网卡/块设备

快速配置技巧：使用 make defconfig 生成默认配置，然后执行 scripts/config --enable DEBUG_INFO --enable GDB_SCRIPTS --enable FRAME_POINTER --enable PCI_DEBUG 批量开启调试选项。

2.2.3 编译内核与模块

编译时通过 KCFLAGS 传递 -g 标志，确保所有编译单元都包含调试符号：

# 设置编译标志
export KCFLAGS="-g -O2"

# 编译内核镜像和模块
make -j$(nproc) bzImage
make -j$(nproc) modules

# 安装模块到临时目录
make modules_install INSTALL_MOD_PATH=./modules_install

编译产物说明：

文件	路径	用途
`vmlinux`	源码根目录	未压缩的内核镜像，包含完整调试符号，GDB 加载此文件
`arch/x86/boot/bzImage`	压缩后的内核镜像	QEMU 启动时使用的内核文件
`System.map`	源码根目录	符号表，辅助地址到符号的映射
`.ko` 文件	`modules_install/lib/modules/6.1.76/kernel/`	可加载内核模块，驱动调试的目标对象

2.3 制作根文件系统

QEMU 启动内核后需要根文件系统（rootfs）来运行 init 进程和加载驱动模块。使用 BusyBox 制作最小化的 initramfs：

# 下载并编译 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
make defconfig
make -j$(nproc)
make install

# 创建根文件系统目录结构
mkdir -p _install/{dev,proc,sys,etc,lib/modules}
cd _install

# 创建设备节点
sudo mknod dev/console c 5 1
sudo mknod dev/null c 1 3

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

# 打包为 initramfs
find . | cpio -o -H newc | gzip > ../initramfs.cpio.gz

注意：如果需要在调试环境中加载驱动模块，必须在 init 脚本中添加 insmod 或 modprobe 命令，并将编译好的 .ko 文件复制到 lib/modules/ 目录下。

2.4 启动 QEMU 并连接 GDB

2.4.1 QEMU 启动参数

关键参数说明：

参数	值	作用
`-kernel`	arch/x86/boot/bzImage	指定带调试符号编译的内核镜像
`-initrd`	initramfs.cpio.gz	指定根文件系统
`-append`	"console=ttyS0 nokaslr"	禁用 KASLR，确保内核地址固定，便于 GDB 设置断点
`-s`	（无值）	等价于 `-gdb tcp::1234`，在 1234 端口开启 gdbstub
`-S`	（无值）	启动时暂停 CPU，等待 GDB 连接后再继续执行
`-machine`	q35,accel=kvm:tcg	使用 q35 芯片组（PCIe 拓扑），优先 KVM 加速
`-device`	pci-ohci	添加模拟 PCI 设备，供驱动调试使用

完整启动命令：

qemu-system-x86_64 \
  -kernel linux-6.1.76/arch/x86/boot/bzImage \
  -initrd initramfs.cpio.gz \
  -append "console=ttyS0 nokaslr earlyprintk=serial" \
  -s -S \
  -machine q35,accel=kvm:tcg \
  -device pci-ohci \
  -nographic

2.4.2 GDB 连接与调试会话

打开另一个终端，启动 GDB 并加载内核符号：

# 启动 GDB
gdb linux-6.1.76/vmlinux

# 在 GDB 中连接 QEMU
(gdb) target remote localhost:1234

# 设置断点（例如在 PCI 驱动初始化入口）
(gdb) break pci_device_probe

# 继续执行
(gdb) continue

# 当断点命中时，查看调用栈
(gdb) backtrace

# 查看当前 PCI 设备信息
(gdb) print *pci_dev

# 单步执行
(gdb) step

# 查看源代码
(gdb) list

  调试技巧：使用 lx-* 系列命令（需加载 CONFIG_GDB_SCRIPTS）可以查看内核专用数据结构，例如 lx-dmesg 查看内核日志，lx-lsmod 列出已加载模块。

2.5 验证调试环境

完成上述步骤后，通过以下检查点验证环境是否正常工作：

QEMU 启动：虚拟机控制台输出内核启动日志，最终进入 shell 提示符。
GDB 连接：target remote localhost:1234 成功，无超时或拒绝连接错误。
断点命中：在 start_kernel 或 pci_device_probe 设置断点，continue 后 GDB 暂停在预期位置。
符号解析：backtrace 显示函数名和行号，而非纯地址。
模块加载：在虚拟机内执行 insmod my_pci_driver.ko，GDB 能识别模块加载后的符号。

常见问题排查：
• 如果 GDB 提示 Remote 'g' packet reply is too long，在 GDB 中执行 set architecture i386:x86-64:intel 后重新连接。
• 如果断点无法命中，检查 nokaslr 是否已添加到内核命令行，以及 CONFIG_RANDOMIZE_BASE 是否被禁用。
• 如果模块符号无法加载，在 GDB 中执行 lx-symbols 命令手动刷新模块符号表。

2.6 本章小结

本章完成了内核调试环境的完整搭建：

编译了带 DWARF 调试符号 的内核镜像（vmlinux）和可加载模块（.ko）。
使用 BusyBox 制作了最小根文件系统，支持模块加载和 shell 交互。
配置 QEMU 启动参数，开启 gdbstub 并禁用 KASLR。
通过 GDB 远程调试 实现了源码级断点、单步和变量查看。