Skip to content

Translation pending. This page is currently available in Chinese.

内核扩展点(KEP)

A20OS 的动态内核扩展机制。与 Linux LKM(可加载内核模块)有本质区别:

Linux LKM A20OS KEP
扩展形态 任意原生代码(编译进内核空间) 验证过的受限字节码程序
权限 加载即全权(可访问任何内核符号) 只能读/写扩展点发布的类型化上下文
安全 模块崩溃 = 内核崩溃;任意指针访问 无指针、无任意内存访问、无循环(结构上终止)
生命周期 insmod/rmmod,ABI 漂移风险 程序对象引用计数,进程退出自动清理
卸载 需要模块作者处理引用 detach/release 由内核管理

设计原则

  • 混合内核的扩展观:热路径留在内核,但扩展不能成为"第二个内核"。KEP 程序是数据面逻辑(过滤、审计、策略判定),运行在内核扩展点,由线性扫描验证器保证不可破坏内核状态。
  • 扩展点 = 类型化上下文:内核子系统注册扩展点并声明上下文布局(64 位字数组)。程序只能通过 LDC/STC 访问该窗口。
  • 终止性 = 结构性保证:所有跳转严格向前(imm 无符号),验证器线性扫描确认,解释器另有指令预算兜底。

指令集(标准 eBPF 编码)

KEP 程序使用 Linux eBPF 指令编码(struct bpf_insn 布局,8 字节/条,寄存器 R0..R10,R10 为帧指针),因此**同一份程序字节码**可以通过 Native ABI(ext_prog_load)或 Linux ABI(bpf(2) BPF_PROG_LOAD)加载。支持的指令族:

  • LD_IMM64(双指令)、MOV64/MOV32(reg/imm)
  • ALU64/ALU32:add/sub/mul/div/or/and/lsh/rsh/neg/mod/xor/arsh
  • JMP/JMP32:ja/jeq/jne/jgt/jge/jlt/jle/jset/jsgt/jsge/jslt/jsle
  • LDX_MEM/ST_MEM/STX_MEM(仅 BPF_DW 大小)
  • EXIT

验证与执行模型是 KEP 自己的,不是 Linux eBPF 的仿制: - 跳转必须严格向前(无循环,结构性终止);Linux eBPF 允许有界循环 - 内存访问仅限扩展点上下文窗口,且必须经 R1 常量偏移;无 maps、无 helper 调用、无任意内存 - 无栈(R10 保留未用)

验证器

线性扫描逐条检查:寄存器/助记符字段界内;LDC/STC 偏移在 KEP_MAX_CONTEXT_WORDS 内;跳转目标在程序内且严格向前;程序以 EXIT 结尾。任何非法指令或越界访问都导致加载拒绝(-EINVAL)。

扩展点:syscall 过滤器

第一个扩展点(id=1,syscall-filter),上下文 8 字:

0 nr  1-6 arg0-5  7 abi (0=Linux, 1=Native)

附着程序在每次系统调用入口执行(两个 ABI 都生效),R0 判定:0 放行、1 拒绝(-EACCES / -A20_ERR_ACCESS)、2 终止调用者。

接口

Native ABI(0x0E00):

  • ext_prog_load(insns, len) → handle:验证并加载程序(A20_OBJ_EXT_PROG)
  • ext_prog_attach(prog, point) / ext_prog_detach(prog, point)
  • ext_prog_release(prog):分离并释放
  • ext_point_info(point, out):查询扩展点(名称、上下文大小)

程序所有权:加载进程持有;进程退出自动释放;handle 关闭(最后一个引用)触发释放。权限:READ=attach/detach,CONTROL=release。

Linux ABI(bpf(2)):BPF_PROG_LOAD/BPF_PROG_ATTACH/ BPF_PROG_DETACH 是同一引擎的薄包装(kernel/abi/linux/sys_bpf.c)。程序 fd 为 memfd,KEP 登记 (owner, fd) 别名并在下次调用时清扫已关闭的 fd。A20 适配:BPF_PROG_ATTACH 的 target_fd 携带扩展点 id(Linux 的 attach 目标是 socket)。原占位 bpf 实现的 map 命令不再提供(-EOPNOTSUPP),kernel/bpf/ 目录已删除;socket 的 SO_ATTACH_BPF 待网络包扩展点落地。

验证

smoke-native-ext(Native 全流程)与 bpf_smoke(Linux bpf(2) 加载/附着/拒绝/分离全流程)。