sys-patch 如何精准改写指令?ARM64 指令编码条件检测(cond)完整原理
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() 主循环 中体现得非常清晰:
- 逐字节滑动匹配
byte_pattern; - 命中后,按
inst_offset取出 4 字节指令; - 先跑
applied()——已打补丁就跳过,保证幂等; - 再跑
cond()——条件成立才调用patch()生成数据,用svcWriteDebugProcessMemory写回; - 结果记入日志,供 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)
- 模式命中某段代码后,偏移 6 处取出指令
1F00016B(小端); cmp_cond检查最高字节0x6B—— 是 32 位寄存器比较指令,条件成立;cmp_patch返回补丁字节0x00(PatchData 表),写入位置是patch_offset=2,也就是比较指令的第二个寄存器编码位;- 于是
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 条件检测"范式对任何做内存级二进制补丁的项目都有参考价值——它证明了跨版本稳定的补丁,关键不在记死地址,而在理解指令本身的结构。