Run a virtual iPhone on an Apple Silicon Mac.
Swift
// KernelPatchApfsSnapshot.swift — APFS root snapshot patch.
//
// Patch 1: NOP the tbnz/tbz w<reg>, #5 instruction that gates the
// sealed-volume root snapshot panic in _apfs_vfsop_mount.
//
// Strategy (mirrors kernel_patch_apfs_snapshot.py):
// 1. Find string "Rooting from snapshot with xid" (fallback: "Failed to find
// the root snapshot") in the APFS kext text range.
// 2. For every ADRP+ADD xref, scan forward ≤ 0x200 bytes for a
// tbz/tbnz <reg>, #5, <target> instruction.
// 3. NOP it.
import Foundation
import VPhonePatchKit
extension KernelPatcher {
@discardableResult
func patchApfsRootSnapshot() -> Bool {
log("\n[1] _apfs_vfsop_mount: root snapshot sealed volume check")
let apfsRange = apfsTextRange()
// Try primary string anchor, fall back to secondary.
var refs = findStringRefs(in: apfsRange, string: "Rooting from snapshot with xid")
if refs.isEmpty {
refs = findStringRefs(in: apfsRange, string: "Failed to find the root snapshot")
if refs.isEmpty {
log(" [-] anchor strings not found in APFS text range")
return false
}
}
for (_, addOff) in refs {
let scanEnd = min(addOff + 0x200, buffer.count - 4)
var scan = addOff
while scan <= scanEnd {
guard let insn = disasm.disassembleOne(in: buffer.data, at: scan) else {
scan += 4
continue
}
guard insn.mnemonic == "tbnz" || insn.mnemonic == "tbz" else {
scan += 4
continue
}
// Check: tbz/tbnz <reg>, #5, <target>
// Operands: [0] = register, [1] = bit number (IMM), [2] = branch target (IMM)
guard
let detail = insn.detail,
detail.operands.count >= 2,
detail.operands[0].type == .register,
detail.operands[1].type == .immediate,
detail.operands[1].imm == 5
else {
scan += 4
continue
}
let desc = "NOP \(insn.mnemonic) \(insn.operandString) (sealed vol check) [_apfs_vfsop_mount]"
emit(scan, ARM64.nop, patchID: "kernel-boot-apfs_root_snapshot", description: desc)
return true
}
}
log(" [-] tbz/tbnz <reg>, #5 not found near xref")
return false
}
}