Run a virtual iPhone on an Apple Silicon Mac.
Swift
cfw: patchers: Make iomfb patch dynamic instead of hard coded bytes
zqxwceaa39b7194df9
diff --git a/README.md b/README.mdindex 507c278d..48a3cdb7 100644--- a/README.md+++ b/README.md@@ -8,17 +8,18 @@ Boot a virtual iPhone (iOS 26) via Apple's Virtualization.framework using PCC re## Tested Environments-| Host | iPhone | CloudOS |-| ------------- | --------------------- | --------------- |-| Mac16,8 26.5.1 | `17,3_26.0_23A341` | `26.1-23B85` |-| Mac16,8 26.5.1 | `17,3_26.0.1_23A355` | `26.1-23B85` |-| Mac16,8 26.5.1 | `17,3_26.1_23B85` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |-| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |-| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |-| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Host | iPhone | CloudOS |+| --------------- | --------------------- | --------------- |+| Mac16,8 26.5.1 | `17,3_26.0_23A341` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.0.1_23A355` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |+| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |+| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |+| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Mac16,11 27.0b2 | `17,3_26.5.2_23F84` | `26.4-23E5207q` |iOS 26.0 and 26.0.1 use the 26.1 PCC vphone600 stack plus the CFW-time`IOMobileFramebuffer` SwapEnd payload-size patch.diff --git a/docs/README_ja.md b/docs/README_ja.mdindex efa5ca5a..edbb7eae 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -8,14 +8,18 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用## 検証済み環境-| ホスト | iPhone | CloudOS |-| ------------- | --------------------- | --------------- |-| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |-| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |-| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |-| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| ホスト | iPhone | CloudOS |+| --------------- | --------------------- | --------------- |+| Mac16,8 26.5.1 | `17,3_26.0_23A341` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.0.1_23A355` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |+| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |+| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |+| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Mac16,11 27.0b2 | `17,3_26.5.2_23F84` | `26.4-23E5207q` |## ファームウェアバリアントdiff --git a/docs/README_ko.md b/docs/README_ko.mdindex 74d8853c..03d33a1d 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -8,14 +8,18 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여## 테스트된 환경-| Host | iPhone | CloudOS |-| ------------- | --------------------- | --------------- |-| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |-| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |-| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |-| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Host | iPhone | CloudOS |+| --------------- | --------------------- | --------------- |+| Mac16,8 26.5.1 | `17,3_26.0_23A341` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.0.1_23A355` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |+| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |+| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |+| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Mac16,11 27.0b2 | `17,3_26.5.2_23F84` | `26.4-23E5207q` |## 펌웨어 변형diff --git a/docs/README_zh.md b/docs/README_zh.mdindex 2d6d4658..534709aa 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -9,13 +9,17 @@## 测试环境| 主机 | iPhone 系统 | CloudOS |-| ------------- | --------------------- | --------------- |-| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |-| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |-| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |-| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |-| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| --------------- | --------------------- | --------------- |+| Mac16,8 26.5.1 | `17,3_26.0_23A341` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.0.1_23A355` | `26.1-23B85` |+| Mac16,8 26.5.1 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.1_23B85` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.1-23B85` |+| Mac16,12 26.3 | `17,3_26.3_23D127` | `26.3-23D128` |+| Mac16,12 26.3 | `17,3_26.3.1_23D8133` | `26.3-23D128` |+| Mac16,11 26.2 | `17,3_26.4_23E246` | `26.4-23E5207q` |+| Mac16,11 26.2 | `17,3_26.5_23F77` | `26.4-23E5207q` |+| Mac16,11 27.0b2 | `17,3_26.5.2_23F84` | `26.4-23E5207q` |## 固件变体diff --git a/scripts/patchers/cfw_patch_iomfb_swapend.py b/scripts/patchers/cfw_patch_iomfb_swapend.pyindex 7af69d84..73188b75 100644--- a/scripts/patchers/cfw_patch_iomfb_swapend.py+++ b/scripts/patchers/cfw_patch_iomfb_swapend.py@@ -1,90 +1,185 @@"""Patch iOS 26.0 and 26.0.1 IOMobileFramebuffer SwapEnd payload size.The PCC vphone600 26.1 kernel-side IOMobileFramebuffer external method 5-expects the newer 0x560-byte swap state. iOS 26.0 and 26.0.1 userland send 0x548,-so SwapEnd returns kIOReturnBadArgument and the VM display stays black.+expects the newer 0x560-byte swap state. iOS 26.0 and 26.0.1 userland send a+smaller state (0x548), so SwapEnd returns kIOReturnBadArgument and the VM+display stays black.++`_kern_SwapEnd` sets up an external-method-5 call:++ ldr w0, [x0,#0x14]+ add x2, x19,#0x18+ mov w1,#5 <- external method selector 5+ mov w3,#<size> <- input-state size (0x548 on 26.0; 0x588 on 26.5)+ mov x4,#0+ mov x5,#0+ bl _io_connect_method++The `mov w3,#<size>` immediate is what this patcher rewrites to 0x560, the+size the 26.1 userclient accepts. The site is located dynamically: resolve+`_kern_SwapEnd`, disassemble it with Capstone, and anchor on the semantic+call-setup shape (selector `mov w1,#5` then `mov w3,#imm` then the zeroed+`mov x4,#0`/`mov x5,#0` and the `bl`). Nothing about the source size is+hardcoded, so this fires on 26.0 and 26.0.1 alike; the replacement immediate+comes from the Keystone-backed `asm()` helper."""+import os+import re+import shutil+import subprocess++from capstone.arm64_const import ARM64_OP_REG, ARM64_OP_IMM+try:+ from .cfw_asm import asm, _csfrom .cfw_dsc_chunks import DSCChunksfrom .cfw_dsc_codesign import reattest_modified_pagesexcept ImportError: # direct self-test execution+ from cfw_asm import asm, _csfrom cfw_dsc_chunks import DSCChunksfrom cfw_dsc_codesign import reattest_modified_pagesIOMFB = "/System/Library/PrivateFrameworks/IOMobileFramebuffer.framework/IOMobileFramebuffer"+SWAPEND_SYMBOL = "_kern_SwapEnd"++# External-method selector for SwapEnd, and the input-state size the 26.1+# vphone600 userclient accepts. TARGET_SIZE is the semantic goal, not an+# anchor — the source immediate (0x548 on 26.0) is discovered, never matched.+SWAPEND_SELECTOR = 5+TARGET_SIZE = 0x560+++def _resolve_symbol(dsc_path, image, symbol):+ """Resolve a single symbol's vmaddr in `image` via `ipsw dyld symaddr`.+ Returns the vmaddr, or raises if unresolved. Mirrors the resolution+ idiom in cfw_patch_camera_dsc."""+ ipsw_bin = shutil.which("ipsw")+ if not ipsw_bin:+ raise RuntimeError("`ipsw` not in PATH")+ cmd = [ipsw_bin, "dyld", "symaddr", dsc_path, "--image", image, symbol]+ out = subprocess.run(cmd, capture_output=True, text=True, check=True).stdout+ for line in out.splitlines():+ line = re.sub(r"\x1b\[[0-9;]*m", "", line).rstrip()+ m = re.match(r"\s*(0x[0-9A-Fa-f]+):.*\b" + re.escape(symbol) + r"\b", line)+ if m:+ return int(m.group(1), 16)+ raise RuntimeError(f"could not resolve {symbol} in {image}")+++def _mov_reg_imm(insn):+ """If `insn` is `mov <reg>, #<imm>`, return (reg_name, imm); else None."""+ if insn.mnemonic != "mov":+ return None+ ops = insn.operands+ if len(ops) != 2 or ops[0].type != ARM64_OP_REG or ops[1].type != ARM64_OP_IMM:+ return None+ return insn.reg_name(ops[0].reg), ops[1].imm+-# _kern_SwapEnd:-# ldr w0, [x0,#0x14]-# add x2, x19,#0x18-# mov w1,#5-# mov w3,#0x548 <-- patch to 0x560-# mov x4,#0-# mov x5,#0-OLD = bytes.fromhex("001440b962620091a100805203a98052040080d2050080d2")-NEW_INSN = bytes.fromhex("03ac8052")+def _disasm_function(chunks, vma, max_insns=64):+ """Disassemble from `vma` up to the first ret/retab (function end) or+ `max_insns`, whichever comes first."""+ buf = chunks.bytes_at_vma(vma, max_insns * 4)+ insns = []+ for insn in _cs.disasm(buf, vma):+ insns.append(insn)+ if insn.mnemonic in ("ret", "retab"):+ break+ return insns-def patch_iomfb_swapend(chunks_dir, *, dry_run=False):+def _find_swap_size_insn(insns):+ """Locate the `mov w3,#imm` that sets the SwapEnd input-state size.++ Anchored on the external-method call setup: `mov w1,#5` (selector),+ immediately followed by `mov w3,#imm`, then `mov x4,#0`, `mov x5,#0`,+ and a `bl`. Returns that insn, or None if the shape isn't found.+ """+ for i in range(len(insns) - 4):+ sel = _mov_reg_imm(insns[i])+ if sel != ("w1", SWAPEND_SELECTOR):+ continue+ size = _mov_reg_imm(insns[i + 1])+ if size is None or size[0] != "w3":+ continue+ if _mov_reg_imm(insns[i + 2]) != ("x4", 0):+ continue+ if _mov_reg_imm(insns[i + 3]) != ("x5", 0):+ continue+ if insns[i + 4].mnemonic != "bl":+ continue+ return insns[i + 1]+ return None+++def patch_iomfb_swapend(chunks_dir, *, dsc_path=None, dry_run=False):chunks = DSCChunks(chunks_dir)print(f" [.] {chunks!r}")- modified = []- already = 0- refused = 0-- for _cp, _foff, vma_start, buf in chunks.iter_executable_mapping_bytes():- i = 0- while True:- p = buf.find(OLD, i)- if p < 0:- break- insn_vma = vma_start + p + 12- header = chunks.find_macho_header_before(insn_vma)- install = chunks.read_install_name_at(header) if header is not None else None- if install != IOMFB:- refused += 1- print(f" [-] refusing non-IOMFB hit at 0x{insn_vma:X}: {install}")- else:- if not dry_run:- chunks.write_at_vma(insn_vma, NEW_INSN)- modified.append(insn_vma)- print(f" [+] {'would patch' if dry_run else 'patched'} {IOMFB} _kern_SwapEnd size 0x548 -> 0x560 at 0x{insn_vma:X}")- i = p + 4-- # Idempotent rerun support.- patched = OLD[:12] + NEW_INSN + OLD[16:]- i = 0- while True:- p = buf.find(patched, i)- if p < 0:- break- insn_vma = vma_start + p + 12- header = chunks.find_macho_header_before(insn_vma)- install = chunks.read_install_name_at(header) if header is not None else None- if install == IOMFB:- already += 1- modified.append(insn_vma)- print(f" [=] already patched at 0x{insn_vma:X}")- i = p + 4-- if not modified:- raise ValueError("IOMobileFramebuffer 26.0/26.0.1 SwapEnd size site not found")- if modified and not dry_run:- print(f" [.] re-attesting {len(set(modified))} modified page(s)...")- reattest_modified_pages(chunks, sorted(set(modified)), dry_run=False)- elif modified:- print(f" [.] dry-run: would re-attest {len(set(modified))} page(s)")-- print(f" [+] IOMFB SwapEnd patch complete: {len(modified) - already} patched, {already} already, {refused} refused")- return len(modified)++ if dsc_path is None:+ dsc_path = os.path.join(chunks_dir, "dyld_shared_cache_arm64e")++ fn_vma = _resolve_symbol(dsc_path, IOMFB, SWAPEND_SYMBOL)+ print(f" [.] {SWAPEND_SYMBOL} @ 0x{fn_vma:X}")++ insns = _disasm_function(chunks, fn_vma)+ target = _find_swap_size_insn(insns)+ if target is None:+ raise ValueError(+ f"{SWAPEND_SYMBOL} SwapEnd size site (mov w1,#{SWAPEND_SELECTOR} "+ f"-> mov w3,#imm -> ... -> bl) not found"+ )++ _reg, cur_size = _mov_reg_imm(target)+ insn_vma = target.address+ new_bytes = asm(f"mov w3, #{TARGET_SIZE}")+ if len(new_bytes) != 4:+ raise RuntimeError(f"expected 4 bytes, got {len(new_bytes)}")++ if cur_size == TARGET_SIZE:+ print(f" [=] already 0x{TARGET_SIZE:X} at 0x{insn_vma:X}; "+ f"re-attesting page only")+ else:+ action = "would patch" if dry_run else "patched"+ print(f" [+] {action} {IOMFB} {SWAPEND_SYMBOL} size "+ f"0x{cur_size:X} -> 0x{TARGET_SIZE:X} at 0x{insn_vma:X}")+ if not dry_run:+ chunks.write_at_vma(insn_vma, new_bytes)++ if not dry_run:+ print(f" [.] re-attesting modified page...")+ reattest_modified_pages(chunks, [insn_vma], dry_run=False)+ if chunks.bytes_at_vma(insn_vma, 4) != new_bytes:+ raise RuntimeError(f"post-write verify failed at 0x{insn_vma:X}")+ else:+ print(f" [.] dry-run: would re-attest page for 0x{insn_vma:X}")++ print(f" [+] IOMFB SwapEnd patch complete")+ return 1def _self_test():- assert OLD[12:16] == bytes.fromhex("03a98052")- assert NEW_INSN == bytes.fromhex("03ac8052")- patched = OLD[:12] + NEW_INSN + OLD[16:]- assert patched == bytes.fromhex("001440b962620091a100805203ac8052040080d2050080d2")+ """Validate the finder against a synthetic call-setup sequence built+ from the assembler, with a source size (0x548) unlike the target."""+ seq = (+ asm("ldr w0, [x0, #0x14]")+ + asm("add x2, x19, #0x18")+ + asm("mov w1, #5")+ + asm("mov w3, #0x548")+ + asm("mov x4, #0")+ + asm("mov x5, #0")+ + asm("bl #0x40")+ )+ insns = list(_cs.disasm(seq, 0x1000))+ target = _find_swap_size_insn(insns)+ assert target is not None, "finder failed to locate size insn"+ reg, imm = _mov_reg_imm(target)+ assert (reg, imm) == ("w3", 0x548), (reg, hex(imm))+ assert target.address == 0x1000 + 12, hex(target.address)+ assert asm(f"mov w3, #{TARGET_SIZE}") == bytes.fromhex("03ac8052")+ print("self-test OK")if __name__ == "__main__":