KGDB（Kernel GNU Debugger）工具使用方法详解

KGDB（Kernel GNU Debugger）是一个强大的、用于调试Linux内核的源代码级调试器。它允许开发人员像调试普通应用程序一样调试内核，可以设置断点、单步执行、检查变量和调用栈等，这对于诊断复杂的内核漏洞、系统挂起（Hangs）或内核崩溃（Panics）至关重要。

---

一、KGDB 的工作原理

理解其工作原理是正确使用它的关键。

1. 目标机（Target）与开发机（Host）：KGDB 采用典型的"双机调试"模型。

   • 目标机 ：运行需要被调试的内核的物理机器或虚拟机。它通过一个特定的I/O端口（通常是串口ttyS0或以太网）输出调试信息并接收调试指令。
   • 开发机：运行GDB（或LLDB）的机器，它通过相同的I/O端口连接到目标机，向其发送调试命令（如读内存、设断点）并接收反馈。

2. 通信协议 ：目标机内核中的KGDB stub（存根）与开发机的GDB之间通过一种基于包的特定协议进行通信。这个协议运行在串行线 或以太网之上。

3. 调试流程：

   • 目标机内核启动后，KGDB stub等待开发机的连接。
   • 当目标机遇到断点、异常或通过魔术键（Magic SysRq）手动触发时，内核的执行会完全停止。
   • 控制权移交給KGDB stub，stub通过通信端口向开发机的GDB发送一个"异常"信号。
   • 开发机的GDB接收到信号后，进入交互模式，开发者就可以开始调试了。
   • 在GDB中输入c（continue）命令后，调试指令被发送回目标机，内核从停止的地方继续执行。

---

二、配置KGDB：从内核编译到系统启动

第1步：配置并编译目标机内核

你需要一个包含KGDB调试功能的内核。在目标机上（或为目标机进行交叉编译）：

cd /path/to/linux-kernel-source
make menuconfig

在配置菜单中，开启以下选项（通常位于 Kernel hacking -> Kernel debugging 和 KGDB: kernel debugger 下）：

• CONFIG_DEBUG_INFO=y （至关重要） 这将包含DWARF调试信息，使GDB能够识别符号和源代码。
• CONFIG_DEBUG_INFO_DWARF4=y （或更高版本） 推荐使用较新的DWARF格式。
• CONFIG_FRAME_POINTER=y （推荐） 生成更可靠的调用栈回溯。
• CONFIG_KGDB=y 启用KGDB核心功能。
• CONFIG_KGDB_SERIAL_CONSOLE=y 通过串口进行KGDB通信（最常用）。
• CONFIG_KGDB_KDB=y （可选但推荐） 启用KDB（内核内置调试器），在无法连接GDB时非常有用。
• CONFIG_MAGIC_SYSRQ=y （必须） 启用魔术SysRq键，用于手动触发调试。

保存配置，然后编译并安装新内核：

make -j$(nproc)
make modules_install
make install

第2步：配置目标机系统启动参数

为了让内核在启动时就等待GDB连接，需要修改引导加载程序（如GRUB）的启动参数。

编辑 /etc/default/grub，在 GRUB_CMDLINE_LINUX 行添加以下参数：

对于串口调试（最常见）：

kgdbwait kgdboc=ttyS0,115200

• kgdbwait：告诉内核在启动初期（在系统完全启动前）等待GDB连接。这对于调试早期启动代码非常有用。如果只想调试完全启动后的系统，可以省略它，稍后通过SysRq触发。
• kgdboc：（kgdb over console）指定调试控制台。ttyS0 是第一个串口，115200 是波特率。请确保你的串口设备号正确。

对于以太网调试（更快速，更灵活）：

kgdbwait kgdboc=eth0

这需要内核支持CONFIG_KGDB_ETH，并且网卡驱动实现了KGDB的以太网钩子，相对复杂，不如串口稳定通用。

更新GRUB并重启目标机：

sudo update-grub
sudo reboot

第3步：物理连接

串口连接（Null-Modem Cable）：

1. 用一条交叉串口线（Null-Modem Cable） 连接目标机和开发机的串口（COM口）。
2. 在开发机上，确定串口设备名（通常是 /dev/ttyS0 或 /dev/ttyUSB0------如果你使用USB转串口线）。

虚拟机调试（更简单）：

如果你使用QEMU/KVM，可以轻易地虚拟出一个串口。

启动虚拟机的命令示例：

qemu-system-x86_64 -hda guest.img -m 4096 -smp 4 \
-serial tcp:127.0.0.1:1234,server,nowait

这样，KGDB就会通过TCP端口1234进行通信。

---

三、使用KGDB进行调试

假设目标机已使用kgdbwait参数启动，并停在了等待GDB连接的界面。

第1步：在开发机上启动GDB

你需要有与目标机完全一致 的、包含调试信息 的vmlinux文件（编译内核时在源码根目录生成的那个，不是/boot下的压缩镜像）。

cd /path/to/linux-kernel-source
gdb ./vmlinux

第2步：在GDB中连接到目标机

对于串口：

(gdb) set serial baud 115200
(gdb) target remote /dev/ttyS0  # 请替换为开发机上的实际串口设备

对于QEMU创建的TCP端口：

(gdb) target remote 127.0.0.1:1234

连接成功后，GDB会停在内核的某个初始位置，此时你就可以开始调试了！

第3步：常用GDB命令

• break function_name 或 b function_name：在函数处设置断点（例如：b sys_open）。

• break filename.c:linenumber：在指定文件的指定行设置断点。

• c （continue）：继续执行。

• next 或 n：单步跳过。

• step 或 s：单步进入。

• print variable_name 或 p variable_name：打印变量值。

• bt （backtrace）：打印调用栈回溯，这是分析Panic/Oops的利器。

• info registers：显示所有寄存器内容。

• lx-symbols （需要手动加载）：极其重要！ 如果你需要调试内核模块，在连接上目标机后，在GDB中执行：

  (gdb) lx-symbols /path/to/target-machine-kernel-modules/

  这个命令（内核提供的GDB脚本）会自动加载所有已加载模块的符号表。

第4步：在运行时手动触发调试会话

如果启动时没有加kgdbwait，你可以在目标机系统运行过程中，通过魔术SysRq键强制它进入调试状态。

1. 确保已启用SysRq：echo 1 > /proc/sys/kernel/sysrq
2. 在目标机键盘上按下：Alt + SysRq + g
   （在某些系统上，可能是 Alt + PrintScreen + g，或者通过 echo g > /proc/sysrq-trigger）

按下后，目标机内核会冻结，并通过调试端口等待GDB连接。此时你再从开发机用GDB连上去即可。

---

四、实战示例：调试一个简单的内核模块

1. 目标机 ：插入一个可能有bug的模块my_module.ko。

2. 开发机 ：

   (gdb) target remote /dev/ttyS0
   (gdb) lx-symbols /path/to/build-dir-of-my_module/  # 加载模块符号
   (gdb) b my_module_init         # 在模块的初始化函数设断点
   (gdb) c                        # 继续执行

3. 目标机 ：执行 sudo insmod my_module.ko。此时目标机会在my_module_init处停下。

4. 开发机 ：GDB会获得控制权，你现在可以next，print变量，bt查看调用栈来调试你的模块了。

---

五、常见问题与技巧

1. vmlinux 文件不匹配 ：这是最常见的问题。务必保证开发机上的vmlinux文件与目标机运行的内核是同一次编译产生的。
2. 串口无法连接 ：检查线缆（必须是交叉线）、端口号、波特率，以及用户是否有读写串口设备的权限（通常需要将用户加入dialout组）。
3. 调试早期启动代码 ：使用kgdbwait，它会非常早地等待。你可能需要在GDB中先设置好断点（如start_kernel），然后再连接。
4. 性能影响：KGDB会严重拖慢调试速度，因为每次内存访问都要通过串口/网络来回传输。它不适合做性能分析，只适合做逻辑错误诊断。
5. 替代方案 ：
   • KDB：内核内置调试器，不需要另一台机器，但功能比KGDB+GDB弱，更适合在不便搭建双机环境时进行简单调试。
   • kdump/crash ：用于分析内核崩溃后产生的内存转储（vmcore），是分析内核Panic的行业标准工具，通常与KGDB结合使用。

总结

KGDB是内核开发者工具箱中不可或缺的利器。虽然初始设置稍有繁琐，但一旦配置成功，它提供的强大源代码级调试能力，对于理解内核运行机制、定位棘手Bug的价值是无法估量的。熟练掌握KGDB，是成为一名真正的内核专家的必经之路。