sys-patch 如何精准改写指令?ARM64 指令编码条件检测(cond)完整原理

原创2026-10-24 15:29:351,364 阅读

sys-patch 如何精准改写指令?ARM64 指令编码条件检测(cond)完整原理

sys-patch 是一个脚本式系统模块(sys-module),它在开机时自动为 fs、es、ldr、nifm、nim 等系统进程精准改写 ARM64 指令。它的"精准"来自两个关键设计:十六进制字节模式定位 + cond 条件检测——只改它确认该改的那 4 个字节。

💡 仓库是只读的,如需阅读源码可克隆: git clone --recurse-submodules https://gitcode.com/gh_mirrors/sysp/sys-patch

核心逻辑全部位于 sysmod/src/main.cpp。

一、改写流水线:定位 → 验证 → 改写 → 记录 🧩

每个补丁由一条 Patterns 记录描述,字段各司其职(Patterns 结构体):

字段 作用
byte_pattern 十六进制字节模式,... 表示通配,用于在内存中"找位置"
inst_offset 从模式起点偏移多少字节处,取出一条待检测指令
patch_offset 相对待检测指令,实际写入补丁的偏移
cond(inst) 条件检测函数:判断这条指令是不是"该改的那一条"
patch(inst) 根据检测到的指令,生成要写入的补丁字节
applied(...) 检查这里是否已经被别人改过(如 sigpatches)

执行顺序在 patcher() 主循环 中体现得非常清晰:

  1. 逐字节滑动匹配 byte_pattern;
  2. 命中后,按 inst_offset 取出 4 字节指令;
  3. 先跑 applied()——已打补丁就跳过,保证幂等;
  4. 再跑 cond()——条件成立才调用 patch() 生成数据,用 svcWriteDebugProcessMemory 写回;
  5. 结果记入日志,供 overlay 界面和 log.ini 展示。

这套"先验证、后改写"的顺序就是精准性的来源:模式只负责缩小范围,cond 负责最终拍板。

二、第一步定位:十六进制模式与 ... 通配符 🔍

模式字符串在编译期就被 str2hex 解析成字节数组。其中 . 是通配符,会被转换成特殊值 REGEX_SKIP(0x100,定义处),匹配时该位置跳过比较。

以 fs 补丁表 中这一条为例:

"0x1E4839....00......0054",  -17,  0
  • 前 4 个字节 1E 48 39 必须完全一致;
  • 4 个 . 位置可以是任意值;
  • 命中后从模式起点偏移 -17 字节处取出待检测指令,再在指令偏移 0 处打补丁。

为什么模式里要故意留"洞"?源码注释(设计说明)给出了规范:被改写的字节必须通配化,否则会误判"已被补丁"的字节序列为模式本身。match_index 则用于一个模式命中多处时指定选第几处(如 ns 补丁 使用第 2 处匹配)。

三、第二步验证:cond 条件检测,为什么只看最高 8 位?

这是全文最核心的部分。ARM64 是定长指令集,每条指令恰好 32 位(4 字节);而指令的高位(opcode 字段)决定了它属于哪个指令族。sys-patch 利用这一点,直接取指令最高字节做分类判断:

// bl_cond:只比较 inst >> 24(最高字节)
const auto type = inst >> 24;
return type == 0x25 || type == 0x94 || type == 0x97;

完整的 cond 函数族在 main.cpp L128-L180,逐一拆解:

函数 判定逻辑 对应的 ARM64 指令族 用在哪个补丁
bl_cond 最高字节 ∈ {0x25, 0x94, 0x97} 分支/调用类(BL/BLR/B) fs 签名检查、am 修复
cmp_cond 最高字节 ∈ {0x6B, 0xF1} 32 位寄存器比较 / 64 位立即数比较 ldr noacidsigchk_10.0.0+
sub_cond 最高字节 == 0xD1 立即数减法(如 sub sp, sp, #0x150) erpt no_erpt
tbz_cond (inst >> 24) & 0x7F == 0x36 位测试分支(TBZ/TBNZ) fs 非 NCA 签名检查
adr_cond 最高字节 == 0x10 ADR 地址加载 nim 空卡带崩溃修复
es_cond 最高字节 ∈ {0xD1, 0xA9, 0xAA, 0x2A, 0x92} 减/存对/orr/逻辑移位类 es 全版本补丁
ctest_cond 最高字节 ∈ {0xF9, 0xA9, 0xF8} LDP/STP/寄存器存储类 nifm ctest
strb_cond 最高字节 == 0x39 字节存储(STRB) ns 卡带区域强制 global

注意两个细节:

  • >> 直接移 24 位:等价于取最高字节,如 0xF1001FAA 右移 24 位得 0xF1;
  • tbz_cond 用了掩码 & 0x7F:TBZ/TBNZ 的最高位是位编号的一部分,不是指令族标志,所以只保留低 7 位比较——这正是"精准"的含义,不同指令族用不同宽度的字段来判。

为什么这种检测能跨固件版本稳定工作? 因为固件每升一次版本,函数地址、偏移量都会变,传统的"地址+固定字节"补丁立刻失效。但某个功能点处的指令类型(这里是 cmp,那里是 bl)往往不变。所以模式负责"找到附近",cond 负责"确认就是它",两层过滤叠加后误报率极低。

四、一个完整实例:ldr 的 cmp 改写 ✅

看 ldr 补丁表 中唯一一条记录(注释即完整过程):

模式 "0x009401C0BE121F00",inst_offset=6,patch_offset=2
1F00016B (cmp w0, w1) → 1F00006B (cmp w0, w0)
  1. 模式命中某段代码后,偏移 6 处取出指令 1F00016B(小端);
  2. cmp_cond 检查最高字节 0x6B —— 是 32 位寄存器比较指令,条件成立;
  3. cmp_patch 返回补丁字节 0x00(PatchData 表),写入位置是 patch_offset=2,也就是比较指令的第二个寄存器编码位;
  4. 于是 cmp w0, w1 被精确改写为 cmp w0, w0——只动 1 个字节,其余 3 字节原样保留。

其余补丁同理:ret0_patch 把检查函数改成 mov w0, #0; ret 直接"通过",nop_patch 把条件跳转填成空操作,ctest 补丁 则把 nifm 中的服务器校验逻辑替换为本地判断,让设备无需联网即可完成 ctest。

五、第四步兜底:applied 幂等检测与日志 📝

写补丁之前,applied() 会先比对当前内存与目标补丁是否一致(检测点):

  • 一致 → 说明 sigpatches 或自定义 Atmosphere 已经打过,标记为 Patched (file),绝不重复写入;
  • 不一致且 cond 成立 → 写入并标记 Patched (sys-patch)。

每次开机结果都会写入 /config/sys-patch/log.ini(日志逻辑),overlay 界面则用颜色区分三种状态(见 README.md):

  • 灰色 Unpatched:未找到(可能该固件版本不需要此补丁);
  • 绿色:本次由 sys-patch 打补丁;
  • 黄色:已被其他工具打过。

配合 /config/sys-patch/config.ini 中的 version_skip(按固件版本跳过过期模式)以及每个补丁的独立开关,整个模块既能在 1.0.0 到 22.0.0+ 的固件跨度内自我适配,又不会与 sigpatches 打架。

六、小结

机制 解决的问题 对应源码
十六进制模式 + ... 通配 地址随固件漂移,如何找到函数附近 str2hex
inst >> 24 高位判族 模式命中多处/近似时如何确认指令 cond 函数族
patch(inst) 动态生成 不同指令需要不同替换字节 PatchData 表
applied() 先查后写 避免与已有补丁冲突、保证幂等 patcher 主循环

sys-patch 的思路可以概括为一句话:用模式找邻域,用 ARM64 指令编码验证,用最小字节数改写。这套"cond 条件检测"范式对任何做内存级二进制补丁的项目都有参考价值——它证明了跨版本稳定的补丁,关键不在记死地址,而在理解指令本身的结构。

登录后查看全文
sys-patch