3. kprobe 核心数据结构：struct kprobe、struct kprobe_ctlblk、struct kprobe_insn_slot

kprobe 动态插桩机制的底层实现依赖于三个核心数据结构。它们分别负责：定义探测点属性（struct kprobe）、管理每 CPU 执行上下文（struct kprobe_ctlblk）、以及管理指令槽内存（struct kprobe_insn_slot）。理解这三个结构体是掌握 kprobe 内核实现的关键。

3.1 struct kprobe：探针描述符

struct kprobe 是 kprobe 机制中最上层的结构体，用户通过定义和填充该结构体来注册一个动态探测点。它包含了探测点的地址、触发时的回调函数指针、以及用于链表管理的节点。

// 位于 include/linux/kprobes.h
struct kprobe {
    struct hlist_node hlist;          /* 用于挂入全局 kprobe 哈希表 */
    struct list_head list;            /* 用于同一地址上多个 kprobe 的链表 */
    unsigned long addr;               /* 被探测指令的内核虚拟地址 */
    kprobe_pre_handler_t pre_handler; /* 执行被探测指令前调用的回调 */
    kprobe_post_handler_t post_handler; /* 执行被探测指令后调用的回调 */
    kprobe_fault_handler_t fault_handler; /* 处理 probe 期间异常的 handler */
    kprobe_break_handler_t break_handler; /* 处理 kprobe 自身断点的 handler */
    kprobe_opcode_t opcode;           /* 被替换的原始指令的第一个字节 */
    unsigned long flags;              /* 标志位，如 KPROBE_FLAG_GONE */
    ...
};

3.2 struct kprobe_ctlblk：每 CPU 执行控制块

struct kprobe_ctlblk 是 kprobe 实现递归安全和单步执行状态管理的关键结构体。每个 CPU 都有一个独立的实例，用于保存当前正在处理的 kprobe 上下文、被中断的寄存器状态以及单步执行标志。

// 位于 arch/x86/include/asm/kprobes.h（架构相关）
struct kprobe_ctlblk {
    struct kprobe *cur_kprobe;        /* 当前 CPU 上正在处理的 kprobe */
    struct kprobe *prev_kprobe;       /* 前一个 kprobe（用于嵌套处理） */
    struct pt_regs jprobe_saved_regs; /* 保存的寄存器上下文 */
    kprobe_opcode_t jprobe_saved_ip;  /* 保存的指令指针 */
    unsigned long jprobe_saved_sp;    /* 保存的栈指针 */
    int kprobe_status;                /* 当前 kprobe 状态标志 */
};

3.3 struct kprobe_insn_slot：指令槽管理

当 kprobe 在目标地址写入断点指令（如 x86 的 int3）后，原始指令必须被保存到一块独立的内存区域，以便在单步执行时能够安全地执行。这个内存区域就是指令槽（instruction slot）。struct kprobe_insn_slot 负责管理这些槽位的分配与回收。

// 位于 kernel/kprobes.c
struct kprobe_insn_slot {
    struct hlist_node hlist;          /* 用于挂入 insn_slot 哈希表 */
    unsigned long addr;               /* 指令槽的虚拟地址 */
    int slot;                         /* 槽位索引 */
    unsigned long flags;              /* 标志位，如是否被使用 */
};

3.4 三者的协作关系

在 kprobe 的一次完整触发过程中，三个结构体按以下顺序协作：

1. 注册阶段：用户填充 struct kprobe，内核将其插入全局哈希表，并从 kprobe_insn_slot 池中分配槽位保存原始指令。
2. 触发阶段：CPU 执行到断点指令，进入 kprobe 异常处理函数。通过 this_cpu_ptr(kprobe_ctlblk) 获取当前 CPU 的控制块，设置 cur_kprobe 和 kprobe_status。
3. 回调执行：调用 cur_kprobe->pre_handler，然后单步执行指令槽中的原始指令，最后调用 post_handler。
4. 恢复阶段：清理 kprobe_ctlblk 中的上下文，将 cur_kprobe 置空，CPU 继续执行原代码流。