[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASKFPMWCPEB8AF24WPZ39E":3,"skill-same:01M7ASKFPMWCPEB8AF24WPZ39E":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7ASKFPMWCPEB8AF24WPZ39E","re-ebpf",null,"eBPF 程序逆向与对抗分析：BPF-64 指令集、progs\u002Fmaps 关联、bpftool 反汇编、跟踪取证\u002F恶意样本\u002FEDR 对抗三用途。 触发词：eBPF、BPF、bpftool、bcc、libbpf、xlated、BPF 指令、bpf hook、EDR 对抗、tracepoint、kprobe。","dslsdzc\u002Frev-skills","dslsdzc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F150430440?v=4","01M7ASEW5AKHWCFR1TXPAXQ237","DslsDZC","01M7ASEW5WJZ3GGBCCT12KHAQZ",243,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-ebpf\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: re-ebpf\ndescription: >\n  eBPF 程序逆向与对抗分析：BPF-64 指令集、progs\u002Fmaps 关联、bpftool 反汇编、跟踪取证\u002F恶意样本\u002FEDR 对抗三用途。\n  触发词：eBPF、BPF、bpftool、bcc、libbpf、xlated、BPF 指令、bpf hook、EDR 对抗、tracepoint、kprobe。\ncapabilities: [ebpf-analysis]\n---\n\n# eBPF 程序逆向与对抗分析（BPF-64、progs\u002Fmaps、xlated）\n\n## 何时使用 \u002F 何时不用\n\n- 用：BPF-64 指令集（8 字节定长指令、r0-r10 寄存器、lddw\u002Falu32\u002Fhelper 调用约定）层面的程序分析\n- 用：三种来源形态——BCC（运行期编译，多只剩内核态 prog）、libbpf（常规 BPF ELF，.maps\u002F.BTF 齐全）、手工字节码（bpf_insn 数组\u002F预编译 blob，无元数据）\n- 用：三用途——跟踪取证（bpftrace\u002Fbcc 程序功能还原）、恶意 eBPF（内核驻留\u002F加载链\u002F规避手法）、EDR 对抗（bpf hook 识别与反制）\n- 用：progs\u002Fmaps 关联还原、hook 点（kprobe\u002Ftracepoint\u002Fcgroup\u002Fxdp\u002Ftc\u002Ffentry）识别、helper 调用号到内核 API 的语义映射\n- 不用：经典内核模块（.ko 驱动）——走 [[re-kernel]]\n- 不用：seccomp\u002F套接字过滤器等传统 cBPF（经典 BPF，指令集与 BPF-64 不同，本技能不覆盖）\n- 不用：仅需分析宿主加载器二进制的通用场景（[[re-binary-core]]）；链上 BPF 字节码（Solana 类）语义表不同，走 [[re-blockchain]]\n- 注意：helper ID 是 Linux BPF UAPI 的稳定编号（已有 `BPF_FUNC_*` 数值不随内核版本重新编号），版本差异影响 helper 是否存在、是否允许用于特定 prog_type\u002Fcontext，以及内核结构布局；分析环境内核版本与样本目标版本尽量一致（见坑 3）\n\n## 工具准备\n\n所有工具先验证再使用。加载\u002F运行 BPF 程序到内核需要 root（或 CAP_BPF\u002FCAP_SYS_ADMIN）；恶意样本（内核驻留\u002F规避类）的动态分析默认在隔离虚拟机 + 快照中进行（[[re-sandbox]]，[[re-analyze\u002Fplatform-tips]] 最高原则）；仅只读查询（`prog list`\u002F`dump xlated`）风险较低，但同样建议在可控环境核对内核版本一致性。\n\n### bpftool —— 核心工具（prog\u002Fmap 查询与 xlated 反汇编）\n\n- Debian\u002FUbuntu: `apt install bpftool`（Debian bullseye 起有独立包；Ubuntu 19.10+ 亦可装 `linux-tools-common` + `linux-tools-generic`——前者只是 wrapper，真实二进制在 `linux-tools-$(uname -r)` 内核配套包里）；旧版 Debian（buster 及更早）无独立包，从内核源码编译 `tools\u002Fbpf\u002Fbpftool` 或克隆 libbpf\u002Fbpftool 仓库构建\n- Fedora: `dnf install bpftool`（官方仓库）；Arch: `pacman -S bpftool`\n- Windows: 无 Linux 内核 eBPF 运行环境（微软 ebpf-for-windows 为独立实现，非 Linux 内核形态），在 WSL2（Linux 内核）内按发行版安装；macOS: 无内核 eBPF 支持，用 Linux 虚拟机\n- 验证: `bpftool version`；查询类命令加 `sudo`（`bpftool prog list`、`bpftool prog dump xlated id N`、`bpftool feature probe`、`bpftool map show\u002Fdump id N`、`bpftool net show`、`bpftool btf dump file \u002Fsys\u002Fkernel\u002Fbtf\u002Fvmlinux`）\n\n### llvm-objdump —— 静态反汇编 BPF ELF\n\n- Debian\u002FUbuntu: `apt install llvm`；Fedora: `dnf install llvm`；Arch: `pacman -S llvm`；macOS: `brew install llvm`（llvm-objdump 在 \u002Fopt\u002Fhomebrew\u002Fopt\u002Fllvm\u002Fbin\u002F）\n- 验证: `llvm-objdump --version`；反汇编: `llvm-objdump -d prog.o`（ELF e_machine=EM_BPF(247) 自动识别，无需指定目标）；GNU objdump（binutils 2.29+ 带 bpf 目标）也可作备选\n- 注意: 静态反汇编的是源码编译产物，与内核中执行形态（xlated）有差异（见坑 2）\n\n### bpftrace —— 跟踪取证还原（被分析的 bpftrace\u002Fbcc 程序还原时对照用）\n\n- Debian\u002FUbuntu: `apt install bpftrace`；Fedora: `dnf install bpftrace`；Arch: `pacman -S bpftrace`\n- 验证: `bpftrace --version`；`bpftrace -d -e 'probe { ... }'` 输出其生成的 BPF 指令，用于对照 xlated dump 还原脚本行为\n\n### pyelftools —— ELF section 定位脚本化\n\n- `pip install pyelftools`（跨平台）\n- 验证: `python3 -c \"import elftools; print(elftools.__version__)\"`；用于批量提取 BPF ELF 的 `.text`\u002F`.maps`\u002F`.BTF`\u002F`.rel*` 段\n\n### Ghidra —— eBPF 处理器（10.3+ 内置）\n\n- Ghidra 10.3 起官方内置 eBPF 处理器（社区 eBPF-for-Ghidra 扩展已并入上游；旧版 Ghidra 需装该扩展），支持 lddw\u002FALU32\u002FJMP32\u002FBPF_ATOMIC、bpf2bpf 相对调用、map 重定位、helper 以 syscall 形式带签名\n- Linux: 官方 release（需 JDK）或发行版包（部分仓库有 `apt install ghidra`\u002F`pacman -S ghidra`）；macOS: `brew install --cask ghidra`；Windows: 官方 zip\n- 验证: 导入 BPF ELF，语言栏应显示 eBPF:LE:64:default\n- 已知限制: eBPF 无专用栈指针寄存器，模块以 r10 充当 SP（栈深度恒 0、部分 r10 相对访问被当死代码）——反编译结果需与 xlated dump 交叉验证\n\n### LIEF —— eBPF 反汇编库（批量处理）\n\n- `pip install lief`（新版内置 LLVM MC 驱动的 eBPF 反汇编器，`lief.parse()` 后按 section\u002F地址反汇编）\n- 验证: `python3 -c \"import lief; print(lief.__version__)\"`\n- 适合脚本化批量反汇编；无 GUI\u002F反编译\n\n### 专用逆向框架现状（边界说明）\n\n- 此前设想的「bpf-gazelle 类」专用 eBPF 逆向框架：经检索（2026-08）未发现公开可用实现，本技能不依赖此类工具；当前做法为组合通用工具链（Ghidra 处理器 + bpftool xlated + llvm-objdump\u002FLIEF），后续若出现专用框架再补充\n\n## 操作步骤\n\n按顺序执行，每步结果存档；运行期查询需要 root，动态分析默认沙箱。\n\n1. **定位载体**（样本是什么形态，决定后续手段）：\n   - **libbpf 型 BPF ELF**: `file prog.o` 显示 eBPF；`readelf -S prog.o` \u002F `llvm-readelf -S` 查看 section——`.text` 与按 attach 点命名的 section（如 `kprobe\u002Fdo_sys_openat2`、`tracepoint\u002Fsyscalls\u002Fsys_enter_openat`、`xdp`、`tc`、`cgroup_skb\u002Fingress`、`fentry\u002F\u003Cfn>`）、`.maps`（BTF-defined map 定义）、`.BTF`（类型信息）、`.BTF.ext`（line info + CO-RE 重定位）、`.rel*`（重定位段）；需要批量提取时用 pyelftools\n   - **BCC 型**: 运行期由内嵌 clang 现场编译，编译产物通常不留盘——静态侧只剩加载脚本（Python\u002F其它语言），内核侧才是成品；取证还原以 `bpftool prog dump xlated` 为主\n   - **手工字节码**: bpf_insn 数组或预编译 blob，无 ELF 元数据无 BTF——只能整体反汇编（lddw 双指令、偏移字段手工解）或从内核 dump\n   - **运行期定位**: `sudo bpftool prog list` 列出全部已加载 prog（id\u002Ftype\u002Fname\u002Ftag\u002Fmap_ids\u002Fbtf_id），核对样本特征（name\u002Ftag\u002F加载时间）\n\n2. **反汇编（静态与运行期双视角）**：\n   - 静态: `llvm-objdump -d prog.o` —— 编译产物，符号与注释保留，利于快速通读逻辑\n   - 运行期: `sudo bpftool prog dump xlated id \u003Cid> opcodes`（追加 `linum` 显示源码行信息）——verifier 处理后的真实执行形态\n   - 双份并排对比：差异点即 verifier 重写点（上下文访问改写、map 访问内联、常量折叠等，见坑 2）\n   - xlated 输出格式：`序号: (opcode十六进制) 指令`，例：`0: (b7) r0 = 0`、`4: (18) r1 = map[id:2]`、`6: (85) call bpf_tail_call#12`、`7: (15) if r0 == 0x0 goto pc+18`；`opcodes` 选项在每行下附原始字节\n   - 指令集要点：8 字节定长（opcode\u002Fdst:src\u002F16 位 off\u002F32 位 imm）；r0 返回值、r1-r5 传参、r6-r9 被调用者保存、r10 帧指针只读；ALU32 用 w0-w9 寄存器（r0-r9 低 32 位，零扩展）；`call`（0x85）统一编码——imm 为 helper 调用号，bpf2bpf 子程序调用则以相对偏移 + src_reg 标记区分；lddw（0x18）占两条指令（第二条存高 32 位），src_reg 区分 map 指针\u002Fmap 值地址\u002F子程序地址等用途\n\n3. **progs\u002Fmaps 关联还原**：\n   - 运行期: `prog list` 的 map_ids 字段给出 prog 引用的 map；xlated 中 `(18) r1 = map[id:N]`（需 kallsyms 可用，见坑 3）→ `sudo bpftool map show id N`（类型\u002Fkey_size\u002Fvalue_size\u002Fmax_entries\u002Fpinning）→ `sudo bpftool map dump id N`（部分类型支持；prog_array 可枚举尾调用目标链）\n   - 静态: 从 `.maps` section 的 BTF 结构还原 map 定义（type\u002Fkey\u002Fvalue\u002Fmax_entries\u002Fpinning\u002Fflags），`.rel*` 段记录 map 引用点；运行期实例与静态定义按 name\u002Fid 关联\n   - 注意共享关系：多 prog 共用一个 map（内核态收集、用户态读取）是常态，还原时按 map 聚合所有引用方\n\n4. **hook 点识别**：\n   - ELF 侧: section 名即 attach 目标（`kprobe\u002Fxxx`、`tracepoint\u002Fsyscalls\u002Fsys_enter_*`、`fentry\u002F\u003C函数>`——fentry 系需要 vmlinux BTF）\n   - 运行期侧: prog type 定 attach 大类（KPROBE\u002FTRACEPOINT\u002FRAW_TRACEPOINT\u002FXDP\u002FSCHED_CLS\u002FCGROUP_*\u002FLSM\u002FTRACING 等），具体挂点用 `sudo bpftool net show`（tc\u002Fxdp 及网卡）、`sudo bpftool cgroup show`（cgroup 系）、`sudo bpftool link show`（fentry\u002Ffexit\u002Fkprobe 链接）确认\n   - prog type 同时决定 verifier 允许的 helper 白名单与 ctx 语义（如 KPROBE 的 ctx 是 pt_regs、tracepoint 的 ctx 是事件结构体）——白名单直接约束了语义还原空间\n\n5. **语义还原**：\n   - helper: xlated 中 `call \u003C名称>#\u003C调用号>`，调用号按 Linux BPF UAPI 的固定 ID 映射解析（`include\u002Fuapi\u002Flinux\u002Fbpf.h` 的 `___BPF_FUNC_MAPPER` 逐项显式编号，方法见坑 3）；名称对照 bpftool 编译时表或目标内核；调用约定 r1-r5 参数、r0 返回值\n   - 数据面: map 内容（收集的数据）、perf ring buffer\u002Ftrace_pipe 输出（helper 写出的记录）还原程序行为闭环\n   - 恶意样本重点: 加载链（加载器 ELF\u002F脚本 + 字节码如何进内核）、持久化（pin 到 \u002Fsys\u002Ffs\u002Fbpf、配套守护进程）、规避手法（hook 目标选择、fentry 前置\u002F后置篡改）；内核语义交叉参考 [[re-kernel]]\n   - 产出: 伪代码级说明（xlated 指令 → 函数语义）+ hook 点 + map 布局 + 行为结论\n\n## 跨域联合\n\n- [[re-kernel]]: helper 调用号到内核 API 的语义映射、xlated 中直接访问的内核结构体布局交叉\n- [[re-tracing]]: 运行期系统调用\u002F函数跟踪的互补视角——strace 覆盖不到的 skb\u002F内核路径由 BPF 观测还原\n- [[re-evasion]]: EDR 对抗——识别与分析驻留的 bpf hook（fentry\u002Fkprobe\u002Ftracepoint\u002Fcgroup），对抗侧手法联动\n- [[re-sandbox]]: 加载\u002F运行 BPF 样本强制前置（隔离 VM + 快照）\n- [[re-ghidra]]: Ghidra 内置 eBPF 处理器反编译工作流\n- [[re-format-elf]]: BPF ELF 的 section 解析底座（.maps\u002F.BTF\u002F.rel* 语义）\n- [[re-malware]]: 恶意 eBPF 样本的完整分析流程（本技能承担字节码还原环节）\n- [[re-blockchain]]: Solana 等链上 BPF 字节码（指令集同源、helper 表不同）\n- [[re-variant]]: 同程序多版本\u002F补丁的指令级对比\n- 配套: [[re-binary-core]]（宿主加载器通用分析）、[[re-behavior]]（eBPF 驻留侧行为归纳）\n\n## 常见坑与陷阱\n\n- **helper 集合\u002F可用性随内核版本演进，ID 本身稳定**：现象——xlated 里 `call \u003C名>#\u003C号>` 的名称与手上工具显示对不上，或 bpftool 显示 `call unknown#\u003C号>`（kptr_restrict=2 时显示 `bpf_unspec#0`）；原因——helper ID 是 Linux BPF UAPI 的稳定编号，已有 `BPF_FUNC_*` 数值不随内核版本重新编号（`___BPF_FUNC_MAPPER` 逐项显式指定数值，正是为保证 backport 场景下 ID 可移植），版本差异影响的是 helper 是否存在、是否允许用于特定 prog_type\u002Fcontext、语义是否扩展——旧 bpftool 显示 `call unknown#N` 只是它的名称表不认识较新的 ID，不能反推 ID 漂移；名称来源两分：helper 名来自 bpftool 编译时表（与运行内核可能不同版本），`call pc+X#` 子程序名来自运行内核 kallsyms（需 bpf_jit_kallsyms=1、kptr_restrict=0，符号形如 bpf_prog_\u003Ctag>_\u003Cname>）；对策——解析按 UAPI 固定 ID 映射：以 `include\u002Fuapi\u002Flinux\u002Fbpf.h` 的 `___BPF_FUNC_MAPPER` 核对 ID→名称；可调用性用 `sudo bpftool feature probe` 列出该内核实际支持的 helper（按名，分 prog type）确认；kfunc 不属于该稳定 ABI；kallsyms 关联（`\u002Fproc\u002Fsys\u002Fkernel\u002Fbpf_jit_kallsyms`=1、kptr_restrict=0）影响名称显示，ID 本身以 UAPI 为准\n- **xlated 与源码不对应（verifier 重写）**：现象——xlated 指令数\u002F顺序\u002F常量与 llvm-objdump 结果明显不同；原因——xlated 是 verifier 处理后的形态：上下文访问改写（如 __sk_buff 改为 sk_buff 直接偏移）、map 访问内联（helper 调用替换为直接地址加载）、helper 内联为内核实现函数（如 `__htab_map_lookup_elem`）、常量折叠、不可达代码删除；bpf2bpf 子程序显示为 `call pc+X#\u003C子程序符号名>` 相对调用；尾调用目标不在本 prog（藏在 prog_array map 里，xlated 只见 `bpf_tail_call`）；对策——以 xlated 为执行真相，静态反汇编仅作语义参考；用 `linum` 选项把源码行信息贴到 xlated 上对齐；尾调用链沿 prog_array map 的 fd 逐跳展开\n- **BTF 缺失类型盲区**：现象——手写字节码\u002F旧工具链产物没有 `.BTF`，map 布局、结构体偏移无从解析，Ghidra 里全是裸地址；原因——BTF 是类型信息的唯一权威来源（CO-RE 重定位也依赖它）；对策——从 xlated 的 ldimm64 目标与 STX\u002FST 指令的偏移常量反推布局；有 `.BTF` 时用 `bpftool btf dump file prog.o` 导出类型，vmlinux 侧用 `bpftool btf dump file \u002Fsys\u002Fkernel\u002Fbtf\u002Fvmlinux` 对照结构体\n- **map 与 prog 分离\u002F生命周期**：现象——只 dump prog 不 dump map，行为链条断裂；prog 卸载后未 pin 的 map 即销毁，现场不留证据；原因——map 独立于 prog 存在（可多 prog 共享、可 pin 于 \u002Fsys\u002Ffs\u002Fbpf 持久化）；对策——分析现场先 `bpftool map show` + `prog list` 做全量快照，再逐 map dump；取证前把 pin 目录 \u002Fsys\u002Ffs\u002Fbpf 完整归档\n- **无符号库函数匹配**：现象——剥离符号的加载器\u002F字节码 blob 里，自实现的字符串\u002F哈希\u002F编码逻辑无任何符号可打；原因——BPF 程序无动态链接，所有逻辑内联在 prog 内；对策——按常量模式（字符串、magic 值、表基址）与行为指纹（与 helper 调用序列的组合形态）识别；对照同源加载器源码或常见模式库\n- **CO-RE 重定位陷阱**：现象——静态读 ELF 里结构体字段偏移，与目标内核实际布局不符，语义还原错误；原因——CO-RE 程序（`.BTF.ext` 带重定位记录）的字段偏移是加载时由 libbpf 按目标内核 BTF 计算的，ELF 里的偏移只是占位；对策——结合目标内核版本的 vmlinux BTF 重算偏移，或直接以 xlated（已重定位后的最终偏移）为准\n","# eBPF 程序逆向与对抗分析（BPF-64、progs\u002Fmaps、xlated）\n\n## 何时使用 \u002F 何时不用\n\n- 用：BPF-64 指令集（8 字节定长指令、r0-r10 寄存器、lddw\u002Falu32\u002Fhelper 调用约定）层面的程序分析\n- 用：三种来源形态——BCC（运行期编译，多只剩内核态 prog）、libbpf（常规 BPF ELF，.maps\u002F.BTF 齐全）、手工字节码（bpf_insn 数组\u002F预编译 blob，无元数据）\n- 用：三用途——跟踪取证（bpftrace\u002Fbcc 程序功能还原）、恶意 eBPF（内核驻留\u002F加载链\u002F规避手法）、EDR 对抗（bpf hook 识别与反制）\n- 用：progs\u002Fmaps 关联还原、hook 点（kprobe\u002Ftracepoint\u002Fcgroup\u002Fxdp\u002Ftc\u002Ffentry）识别、helper 调用号到内核 API 的语义映射\n- 不用：经典内核模块（.ko 驱动）——走 [[re-kernel]]\n- 不用：seccomp\u002F套接字过滤器等传统 cBPF（经典 BPF，指令集与 BPF-64 不同，本技能不覆盖）\n- 不用：仅需分析宿主加载器二进制的通用场景（[[re-binary-core]]）；链上 BPF 字节码（Solana 类）语义表不同，走 [[re-blockchain]]\n- 注意：helper ID 是 Linux BPF UAPI 的稳定编号（已有 `BPF_FUNC_*` 数值不随内核版本重新编号），版本差异影响 helper 是否存在、是否允许用于特定 prog_type\u002Fcontext，以及内核结构布局；分析环境内核版本与样本目标版本尽量一致（见坑 3）\n\n## 工具准备\n\n所有工具先验证再使用。加载\u002F运行 BPF 程序到内核需要 root（或 CAP_BPF\u002FCAP_SYS_ADMIN）；恶意样本（内核驻留\u002F规避类）的动态分析默认在隔离虚拟机 + 快照中进行（[[re-sandbox]]，[[re-analyze\u002Fplatform-tips]] 最高原则）；仅只读查询（`prog list`\u002F`dump xlated`）风险较低，但同样建议在可控环境核对内核版本一致性。\n\n### bpftool —— 核心工具（prog\u002Fmap 查询与 xlated 反汇编）\n\n- Debian\u002FUbuntu: `apt install bpftool`（Debian bullseye 起有独立包；Ubuntu 19.10+ 亦可装 `linux-tools-common` + `linux-tools-generic`——前者只是 wrapper，真实二进制在 `linux-tools-$(uname -r)` 内核配套包里）；旧版 Debian（buster 及更早）无独立包，从内核源码编译 `tools\u002Fbpf\u002Fbpftool` 或克隆 libbpf\u002Fbpftool 仓库构建\n- Fedora: `dnf install bpftool`（官方仓库）；Arch: `pacman -S bpftool`\n- Windows: 无 Linux 内核 eBPF 运行环境（微软 ebpf-for-windows 为独立实现，非 Linux 内核形态），在 WSL2（Linux 内核）内按发行版安装；macOS: 无内核 eBPF 支持，用 Linux 虚拟机\n- 验证: `bpftool version`；查询类命令加 `sudo`（`bpftool prog list`、`bpftool prog dump xlated id N`、`bpftool feature probe`、`bpftool map show\u002Fdump id N`、`bpftool net show`、`bpftool btf dump file \u002Fsys\u002Fkernel\u002Fbtf\u002Fvmlinux`）\n\n### llvm-objdump —— 静态反汇编 BPF ELF\n\n- Debian\u002FUbuntu: `apt install llvm`；Fedora: `dnf install llvm`；Arch: `pacman -S llvm`；macOS: `brew install llvm`（llvm-objdump 在 \u002Fopt\u002Fhomebrew\u002Fopt\u002Fllvm\u002Fbin\u002F）\n- 验证: `llvm-objdump --version`；反汇编: `llvm-objdump -d prog.o`（ELF e_machine=EM_BPF(247) 自动识别，无需指定目标）；GNU objdump（binutils 2.29+ 带 bpf 目标）也可作备选\n- 注意: 静态反汇编的是源码编译产物，与内核中执行形态（xlated）有差异（见坑 2）\n\n### bpftrace —— 跟踪取证还原（被分析的 bpftrace\u002Fbcc 程序还原时对照用）\n\n- Debian\u002FUbuntu: `apt install bpftrace`；Fedora: `dnf install bpftrace`；Arch: `pacman -S bpftrace`\n- 验证: `bpftrace --version`；`bpftrace -d -e 'probe { ... }'` 输出其生成的 BPF 指令，用于对照 xlated dump 还原脚本行为\n\n### pyelftools —— ELF section 定位脚本化\n\n- `pip install pyelftools`（跨平台）\n- 验证: `python3 -c \"import elftools; print(elftools.__version__)\"`；用于批量提取 BPF ELF 的 `.text`\u002F`.maps`\u002F`.BTF`\u002F`.rel*` 段\n\n### Ghidra —— eBPF 处理器（10.3+ 内置）\n\n- Ghidra 10.3 起官方内置 eBPF 处理器（社区 eBPF-for-Ghidra 扩展已并入上游；旧版 Ghidra 需装该扩展），支持 lddw\u002FALU32\u002FJMP32\u002FBPF_ATOMIC、bpf2bpf 相对调用、map 重定位、helper 以 syscall 形式带签名\n- Linux: 官方 release（需 JDK）或发行版包（部分仓库有 `apt install ghidra`\u002F`pacman -S ghidra`）；macOS: `brew install --cask ghidra`；Windows: 官方 zip\n- 验证: 导入 BPF ELF，语言栏应显示 eBPF:LE:64:default\n- 已知限制: eBPF 无专用栈指针寄存器，模块以 r10 充当 SP（栈深度恒 0、部分 r10 相对访问被当死代码）——反编译结果需与 xlated dump 交叉验证\n\n### LIEF —— eBPF 反汇编库（批量处理）\n\n- `pip install lief`（新版内置 LLVM MC 驱动的 eBPF 反汇编器，`lief.parse()` 后按 section\u002F地址反汇编）\n- 验证: `python3 -c \"import lief; print(lief.__version__)\"`\n- 适合脚本化批量反汇编；无 GUI\u002F反编译\n\n### 专用逆向框架现状（边界说明）\n\n- 此前设想的「bpf-gazelle 类」专用 eBPF 逆向框架：经检索（2026-08）未发现公开可用实现，本技能不依赖此类工具；当前做法为组合通用工具链（Ghidra 处理器 + bpftool xlated + llvm-objdump\u002FLIEF），后续若出现专用框架再补充\n\n## 操作步骤\n\n按顺序执行，每步结果存档；运行期查询需要 root，动态分析默认沙箱。\n\n1. **定位载体**（样本是什么形态，决定后续手段）：\n   - **libbpf 型 BPF ELF**: `file prog.o` 显示 eBPF；`readelf -S prog.o` \u002F `llvm-readelf -S` 查看 section——`.text` 与按 attach 点命名的 section（如 `kprobe\u002Fdo_sys_openat2`、`tracepoint\u002Fsyscalls\u002Fsys_enter_openat`、`xdp`、`tc`、`cgroup_skb\u002Fingress`、`fentry\u002F\u003Cfn>`）、`.maps`（BTF-defined map 定义）、`.BTF`（类型信息）、`.BTF.ext`（line info + CO-RE 重定位）、`.rel*`（重定位段）；需要批量提取时用 pyelftools\n   - **BCC 型**: 运行期由内嵌 clang 现场编译，编译产物通常不留盘——静态侧只剩加载脚本（Python\u002F其它语言），内核侧才是成品；取证还原以 `bpftool prog dump xlated` 为主\n   - **手工字节码**: bpf_insn 数组或预编译 blob，无 ELF 元数据无 BTF——只能整体反汇编（lddw 双指令、偏移字段手工解）或从内核 dump\n   - **运行期定位**: `sudo bpftool prog list` 列出全部已加载 prog（id\u002Ftype\u002Fname\u002Ftag\u002Fmap_ids\u002Fbtf_id），核对样本特征（name\u002Ftag\u002F加载时间）\n\n2. **反汇编（静态与运行期双视角）**：\n   - 静态: `llvm-objdump -d prog.o` —— 编译产物，符号与注释保留，利于快速通读逻辑\n   - 运行期: `sudo bpftool prog dump xlated id \u003Cid> opcodes`（追加 `linum` 显示源码行信息）——verifier 处理后的真实执行形态\n   - 双份并排对比：差异点即 verifier 重写点（上下文访问改写、map 访问内联、常量折叠等，见坑 2）\n   - xlated 输出格式：`序号: (opcode十六进制) 指令`，例：`0: (b7) r0 = 0`、`4: (18) r1 = map[id:2]`、`6: (85) call bpf_tail_call#12`、`7: (15) if r0 == 0x0 goto pc+18`；`opcodes` 选项在每行下附原始字节\n   - 指令集要点：8 字节定长（opcode\u002Fdst:src\u002F16 位 off\u002F32 位 imm）；r0 返回值、r1-r5 传参、r6-r9 被调用者保存、r10 帧指针只读；ALU32 用 w0-w9 寄存器（r0-r9 低 32 位，零扩展）；`call`（0x85）统一编码——imm 为 helper 调用号，bpf2bpf 子程序调用则以相对偏移 + src_reg 标记区分；lddw（0x18）占两条指令（第二条存高 32 位），src_reg 区分 map 指针\u002Fmap 值地址\u002F子程序地址等用途\n\n3. **progs\u002Fmaps 关联还原**：\n   - 运行期: `prog list` 的 map_ids 字段给出 prog 引用的 map；xlated 中 `(18) r1 = map[id:N]`（需 kallsyms 可用，见坑 3）→ `sudo bpftool map show id N`（类型\u002Fkey_size\u002Fvalue_size\u002Fmax_entries\u002Fpinning）→ `sudo bpftool map dump id N`（部分类型支持；prog_array 可枚举尾调用目标链）\n   - 静态: 从 `.maps` section 的 BTF 结构还原 map 定义（type\u002Fkey\u002Fvalue\u002Fmax_entries\u002Fpinning\u002Fflags），`.rel*` 段记录 map 引用点；运行期实例与静态定义按 name\u002Fid 关联\n   - 注意共享关系：多 prog 共用一个 map（内核态收集、用户态读取）是常态，还原时按 map 聚合所有引用方\n\n4. **hook 点识别**：\n   - ELF 侧: section 名即 attach 目标（`kprobe\u002Fxxx`、`tracepoint\u002Fsyscalls\u002Fsys_enter_*`、`fentry\u002F\u003C函数>`——fentry 系需要 vmlinux BTF）\n   - 运行期侧: prog type 定 attach 大类（KPROBE\u002FTRACEPOINT\u002FRAW_TRACEPOINT\u002FXDP\u002FSCHED_CLS\u002FCGROUP_*\u002FLSM\u002FTRACING 等），具体挂点用 `sudo bpftool net show`（tc\u002Fxdp 及网卡）、`sudo bpftool cgroup show`（cgroup 系）、`sudo bpftool link show`（fentry\u002Ffexit\u002Fkprobe 链接）确认\n   - prog type 同时决定 verifier 允许的 helper 白名单与 ctx 语义（如 KPROBE 的 ctx 是 pt_regs、tracepoint 的 ctx 是事件结构体）——白名单直接约束了语义还原空间\n\n5. **语义还原**：\n   - helper: xlated 中 `call \u003C名称>#\u003C调用号>`，调用号按 Linux BPF UAPI 的固定 ID 映射解析（`include\u002Fuapi\u002Flinux\u002Fbpf.h` 的 `___BPF_FUNC_MAPPER` 逐项显式编号，方法见坑 3）；名称对照 bpftool 编译时表或目标内核；调用约定 r1-r5 参数、r0 返回值\n   - 数据面: map 内容（收集的数据）、perf ring buffer\u002Ftrace_pipe 输出（helper 写出的记录）还原程序行为闭环\n   - 恶意样本重点: 加载链（加载器 ELF\u002F脚本 + 字节码如何进内核）、持久化（pin 到 \u002Fsys\u002Ffs\u002Fbpf、配套守护进程）、规避手法（hook 目标选择、fentry 前置\u002F后置篡改）；内核语义交叉参考 [[re-kernel]]\n   - 产出: 伪代码级说明（xlated 指令 → 函数语义）+ hook 点 + map 布局 + 行为结论\n\n## 跨域联合\n\n- [[re-kernel]]: helper 调用号到内核 API 的语义映射、xlated 中直接访问的内核结构体布局交叉\n- [[re-tracing]]: 运行期系统调用\u002F函数跟踪的互补视角——strace 覆盖不到的 skb\u002F内核路径由 BPF 观测还原\n- [[re-evasion]]: EDR 对抗——识别与分析驻留的 bpf hook（fentry\u002Fkprobe\u002Ftracepoint\u002Fcgroup），对抗侧手法联动\n- [[re-sandbox]]: 加载\u002F运行 BPF 样本强制前置（隔离 VM + 快照）\n- [[re-ghidra]]: Ghidra 内置 eBPF 处理器反编译工作流\n- [[re-format-elf]]: BPF ELF 的 section 解析底座（.maps\u002F.BTF\u002F.rel* 语义）\n- [[re-malware]]: 恶意 eBPF 样本的完整分析流程（本技能承担字节码还原环节）\n- [[re-blockchain]]: Solana 等链上 BPF 字节码（指令集同源、helper 表不同）\n- [[re-variant]]: 同程序多版本\u002F补丁的指令级对比\n- 配套: [[re-binary-core]]（宿主加载器通用分析）、[[re-behavior]]（eBPF 驻留侧行为归纳）\n\n## 常见坑与陷阱\n\n- **helper 集合\u002F可用性随内核版本演进，ID 本身稳定**：现象——xlated 里 `call \u003C名>#\u003C号>` 的名称与手上工具显示对不上，或 bpftool 显示 `call unknown#\u003C号>`（kptr_restrict=2 时显示 `bpf_unspec#0`）；原因——helper ID 是 Linux BPF UAPI 的稳定编号，已有 `BPF_FUNC_*` 数值不随内核版本重新编号（`___BPF_FUNC_MAPPER` 逐项显式指定数值，正是为保证 backport 场景下 ID 可移植），版本差异影响的是 helper 是否存在、是否允许用于特定 prog_type\u002Fcontext、语义是否扩展——旧 bpftool 显示 `call unknown#N` 只是它的名称表不认识较新的 ID，不能反推 ID 漂移；名称来源两分：helper 名来自 bpftool 编译时表（与运行内核可能不同版本），`call pc+X#` 子程序名来自运行内核 kallsyms（需 bpf_jit_kallsyms=1、kptr_restrict=0，符号形如 bpf_prog_\u003Ctag>_\u003Cname>）；对策——解析按 UAPI 固定 ID 映射：以 `include\u002Fuapi\u002Flinux\u002Fbpf.h` 的 `___BPF_FUNC_MAPPER` 核对 ID→名称；可调用性用 `sudo bpftool feature probe` 列出该内核实际支持的 helper（按名，分 prog type）确认；kfunc 不属于该稳定 ABI；kallsyms 关联（`\u002Fproc\u002Fsys\u002Fkernel\u002Fbpf_jit_kallsyms`=1、kptr_restrict=0）影响名称显示，ID 本身以 UAPI 为准\n- **xlated 与源码不对应（verifier 重写）**：现象——xlated 指令数\u002F顺序\u002F常量与 llvm-objdump 结果明显不同；原因——xlated 是 verifier 处理后的形态：上下文访问改写（如 __sk_buff 改为 sk_buff 直接偏移）、map 访问内联（helper 调用替换为直接地址加载）、helper 内联为内核实现函数（如 `__htab_map_lookup_elem`）、常量折叠、不可达代码删除；bpf2bpf 子程序显示为 `call pc+X#\u003C子程序符号名>` 相对调用；尾调用目标不在本 prog（藏在 prog_array map 里，xlated 只见 `bpf_tail_call`）；对策——以 xlated 为执行真相，静态反汇编仅作语义参考；用 `linum` 选项把源码行信息贴到 xlated 上对齐；尾调用链沿 prog_array map 的 fd 逐跳展开\n- **BTF 缺失类型盲区**：现象——手写字节码\u002F旧工具链产物没有 `.BTF`，map 布局、结构体偏移无从解析，Ghidra 里全是裸地址；原因——BTF 是类型信息的唯一权威来源（CO-RE 重定位也依赖它）；对策——从 xlated 的 ldimm64 目标与 STX\u002FST 指令的偏移常量反推布局；有 `.BTF` 时用 `bpftool btf dump file prog.o` 导出类型，vmlinux 侧用 `bpftool btf dump file \u002Fsys\u002Fkernel\u002Fbtf\u002Fvmlinux` 对照结构体\n- **map 与 prog 分离\u002F生命周期**：现象——只 dump prog 不 dump map，行为链条断裂；prog 卸载后未 pin 的 map 即销毁，现场不留证据；原因——map 独立于 prog 存在（可多 prog 共享、可 pin 于 \u002Fsys\u002Ffs\u002Fbpf 持久化）；对策——分析现场先 `bpftool map show` + `prog list` 做全量快照，再逐 map dump；取证前把 pin 目录 \u002Fsys\u002Ffs\u002Fbpf 完整归档\n- **无符号库函数匹配**：现象——剥离符号的加载器\u002F字节码 blob 里，自实现的字符串\u002F哈希\u002F编码逻辑无任何符号可打；原因——BPF 程序无动态链接，所有逻辑内联在 prog 内；对策——按常量模式（字符串、magic 值、表基址）与行为指纹（与 helper 调用序列的组合形态）识别；对照同源加载器源码或常见模式库\n- **CO-RE 重定位陷阱**：现象——静态读 ELF 里结构体字段偏移，与目标内核实际布局不符，语义还原错误；原因——CO-RE 程序（`.BTF.ext` 带重定位记录）的字段偏移是加载时由 libbpf 按目标内核 BTF 计算的，ELF 里的偏移只是占位；对策——结合目标内核版本的 vmlinux BTF 重算偏移，或直接以 xlated（已重定位后的最终偏移）为准\n",{"name":5,"description":24,"capabilities":25},"eBPF 程序逆向与对抗分析：BPF-64 指令集、progs\u002Fmaps 关联、bpftool 反汇编、跟踪取证\u002F恶意样本\u002FEDR 对抗三用途。 触发词：eBPF、BPF、bpftool、bcc、libbpf、xlated、BPF 指令、bpf hook、EDR 对抗、tracepoint、kprobe。\n",[26],"ebpf-analysis","main","1977504515d3f5fa8889da43974feb7a0f4eaab9",".claude\u002Fskills\u002Fre-ebpf",43,"https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills","https:\u002F\u002Fgithub.com\u002Fdslsdzc","Building systems from scratch","2026-10-12 04:15:49",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add dslsdzc\u002Frev-skills --skill re-ebpf",{"tool":41,"command":42},"bunx","bunx skills add dslsdzc\u002Frev-skills --skill re-ebpf",{"tool":44,"command":45},"pnpm","pnpm dlx skills add dslsdzc\u002Frev-skills --skill re-ebpf","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-ebpf\u002FSKILL.md",true,[],[50,57,63,70,77,84],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7AT3SFGN6KTM2DBN8TCNC4K","no-tools","缺工具准备章节。missing tools section.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fno-tools\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT3PY0QVB4A4WGAZHY43WP","good-skill","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT3NJ1PG8DR115AMJC1Q1C","gateway-skill","网关型技能，无工具准备章节。gateway skill.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgateway-skill\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT3KCJGZV60PKJX244V8Z4","broken-link","含死链接与合法 references 链接。broken link.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbroken-link\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT3HMVTA2MR66A5FMATVFQ","wrong-name","名字与目录不符。name mismatch.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-name\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7AT3F4K5ES6N62092Y8TRNG","bad-frontmatter","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-frontmatter\u002FSKILL.md",[],[]]