4. KGDB 双机调试：原理、配置与实战

KGDB 是 Linux 内核提供的远程调试框架，允许开发者通过 GDB 在另一台主机上调试目标内核。本章从 KGDB 的底层原理出发，逐步讲解串口与网络两种连接方式，并演示断点设置、单步执行等核心操作。

4.1 KGDB 工作原理

KGDB 在内核中嵌入了一个轻量级调试代理（stub），该代理通过串口或网络与远程 GDB 通信。当内核触发断点或异常时，KGDB 暂停所有 CPU 的执行，进入等待命令的循环，直到 GDB 发送继续、单步或内存读写指令。

4.2 串口与网络配置

KGDB 支持两种物理传输层：串口（UART）和网络（UDP）。串口配置简单、延迟低，适合早期调试；网络配置灵活、带宽高，适合后期功能调试。

4.2.1 串口配置

串口调试需要一根交叉串口线（Null Modem）连接两台机器的串口。目标机内核启动参数需指定 KGDB 使用的串口设备及波特率。

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

4.2.2 网络配置

网络模式使用 UDP 协议，通过 kgdboe 参数指定网卡和端口。网络模式支持多 CPU 调试，且不受串口线长度限制。

# 目标机内核启动参数（网络模式）
kgdboe=eth0@192.168.1.100:5555,@192.168.1.200:5555 kgdbwait

4.3 GDB 连接内核

目标机启动并进入 KGDB 等待后，开发机启动 GDB 并加载带符号表的 vmlinux 镜像，然后通过 target remote 命令连接。

# 开发机操作
gdb vmlinux
(gdb) target remote /dev/ttyS0          # 串口连接
(gdb) target remote udp:192.168.1.100:5555  # 网络连接
(gdb) kgdb-ok                            # 验证连接状态

连接成功后，GDB 会显示目标机当前 CPU 的寄存器状态和暂停位置。此时可以执行所有标准 GDB 调试命令。

4.4 设置断点与单步调试内核代码

KGDB 支持硬件断点（利用 CPU 调试寄存器）和软件断点（插入 int3 指令）。内核代码调试与用户态 GDB 用法基本一致，但需注意内核上下文特殊性。

4.4.1 断点设置

(gdb) break do_fork                    # 软件断点，函数入口
(gdb) break schedule+0x20              # 偏移地址断点
(gdb) hbreak __switch_to               # 硬件断点，不修改代码段
(gdb) watch jiffies                    # 数据变化监视

4.4.2 单步调试

(gdb) stepi                           # 单步执行一条指令
(gdb) nexti                           # 单步跳过函数调用
(gdb) continue                        # 恢复执行直到下一个断点
(gdb) finish                          # 执行到当前函数返回

4.5 实战：调试内核模块加载流程

以下演示通过 KGDB 跟踪 init_module 系统调用的完整流程，定位模块初始化失败原因。

# 步骤 1：目标机启动并等待 KGDB
# 内核参数添加 kgdboc=ttyS0,115200 kgdbwait

# 步骤 2：开发机连接
gdb vmlinux
(gdb) target remote /dev/ttyS0
(gdb) break sys_init_module
(gdb) continue

# 步骤 3：目标机触发断点（执行 insmod）
# GDB 停在 sys_init_module 入口
(gdb) print (char *)__argv[1]         # 查看模块路径
(gdb) stepi                           # 单步跟踪参数校验
(gdb) break do_init_module
(gdb) continue

# 步骤 4：进入模块初始化函数
(gdb) print module->name              # 打印模块名
(gdb) stepi                           # 单步执行模块 init 函数

4.6 常见问题与排查