3. KGDB 环境搭建：内核配置选项与启动参数设置

KGDB 是 Linux 内核源码级调试的核心机制，允许开发者通过串口或网络连接远程 GDB 调试器，对运行中的内核进行断点、单步、变量查看等操作。本章聚焦 KGDB 环境搭建的完整流程，涵盖内核配置选项、串口/网络配置以及启动参数设置，确保调试环境稳定可靠。

3.1 内核配置选项详解

KGDB 功能通过内核编译选项启用，以下为关键配置项及其作用：

3.2 串口配置与网络配置

KGDB 支持两种通信通道：串口（UART）和网络（UDP）。串口配置简单、延迟低，适合早期调试；网络配置灵活、带宽高，适合远程调试。

3.2.1 串口配置

串口调试需指定物理串口设备（如 ttyS0）和波特率。常见配置如下：

# 内核启动参数（GRUB 或 U-Boot）
kgdboc=ttyS0,115200

# 或通过 sysfs 动态设置
echo ttyS0,115200 > /sys/module/kgdboc/parameters/kgdboc

串口连接拓扑：

3.2.2 网络配置

网络调试使用 kgdboe（KGDB over Ethernet），通过 UDP 端口 2159（默认）通信。配置方式：

# 内核启动参数
kgdboe=eth0@192.168.1.100:192.168.1.200@eth0

# 参数格式：<本地网卡>@<本地IP>:<调试机IP>@<调试机网卡>

网络连接拓扑：

3.3 启动参数设置

KGDB 的启动参数通过内核命令行传递，常见引导加载器包括 GRUB、U-Boot 和 EFI stub。以下为典型配置：

3.3.1 GRUB 配置（x86/ARM64）

# 编辑 /etc/default/grub
GRUB_CMDLINE_LINUX="kgdboc=ttyS0,115200 kgdbwait nokaslr"

# 更新 GRUB 配置
grub-mkconfig -o /boot/grub/grub.cfg

3.3.2 U-Boot 配置（嵌入式）

# U-Boot 环境变量
setenv bootargs 'console=ttyS0,115200 kgdboc=ttyS0,115200 kgdbwait nokaslr'
bootm 0x82000000

3.3.3 关键启动参数说明

3.4 动态启用与切换

KGDB 支持运行时动态启用，无需重启内核。通过 sysfs 接口可随时切换调试通道：

# 动态启用串口 KGDB
echo ttyS0,115200 > /sys/module/kgdboc/parameters/kgdboc

# 动态启用网络 KGDB
echo eth0@192.168.1.100:192.168.1.200 > /sys/module/kgdboe/parameters/kgdboe

# 触发 KGDB 中断（需 SysRq 支持）
echo g > /proc/sysrq-trigger

3.5 环境验证流程

搭建完成后，通过以下步骤验证 KGDB 环境是否正常工作：

1. 检查内核配置： 确认 /proc/config.gz 或 /boot/config-$(uname -r) 中包含 CONFIG_KGDB=y 和 CONFIG_KGDB_SERIAL_CONSOLE=y。
2. 确认调试符号： 编译内核时生成的 vmlinux 文件应包含 DWARF 调试信息（file vmlinux | grep -i dwarf）。
3. 测试串口/网络连通性： 调试机使用 minicom 或 screen 连接目标机串口，或使用 nc -u 192.168.1.100 2159 测试 UDP 端口。
4. 启动 GDB 会话： 在调试机执行 gdb vmlinux，输入 target remote /dev/ttyUSB0（串口）或 target remote 192.168.1.100:2159（网络），观察是否成功连接。
5. 设置断点并继续： 在 GDB 中设置断点（如 b start_kernel），输入 c 继续执行，验证断点是否命中。