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/arshJMP/JMP32:ja/jeq/jne/jgt/jge/jlt/jle/jset/jsgt/jsge/jslt/jsleLDX_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 字:
附着程序在每次系统调用入口执行(两个 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) 加载/附着/拒绝/分离全流程)。