Run a virtual iPhone on an Apple Silicon Mac.
Swift
kernel: Introduce EXP variant and hv_vmm_present OID rename (KernelEXPPatcher)
zqxwceee5e7d0fa2b2
diff --git a/AGENTS.md b/AGENTS.mdindex 6a1241dc..44524f12 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -28,14 +28,17 @@ For any changes applying new patches, also update research/0_binary_patch_compar## Firmware Variants-| Variant | Boot Chain | CFW | Make Targets |-| --------------- | :---------: | :-------: | ---------------------------------- |-| **Regular** | 51 patches | 10 phases | `fw_patch` + `cfw_install` |-| **Development** | 65 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |-| **Jailbreak** | 126 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| Variant | Boot Chain | CFW | Make Targets |+| ---------------- | :------------: | :-------: | ---------------------------------- |+| **Regular** | 51 patches | 10 phases | `fw_patch` + `cfw_install` |+| **Development** | 65 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |+| **Jailbreak** | 126 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| **Experimental** | 140 patches | 18 phases | `fw_patch_exp` + `cfw_install_exp` |> JB finalization (symlinks, Sileo, apt, TrollStore) runs automatically on first boot via `/cores/vphone_jb_setup.sh` LaunchDaemon. Monitor progress: `/var/log/vphone_jb_setup.log`.+> EXP is a JB superset that patches the kernel and DSC to make some Apple services think the device is not a VM, while keeping VM-specific services (graphics passthrough, compute/accel fast paths) working correctly. Other variants are deliberately NOT affected by these changes.+See `research/` for detailed firmware pipeline, component origins, patch breakdowns, and boot flow documentation.## Architecturediff --git a/Makefile b/Makefileindex 334c867d..da805745 100644--- a/Makefile+++ b/Makefile@@ -46,12 +46,18 @@ help:@echo " make setup_machine Full setup through First Boot"@echo " Options: JB=1 Jailbreak firmware/CFW path"@echo " DEV=1 Dev firmware/CFW path (dev TXM + cfw_install_dev)"+ @echo " EXP=1 Experimental firmware/CFW path (JB + EXP-only patches:"+ @echo " kernel hv_vmm rename, DSC byte-5 mangle, watchdogd surgical,"+ @echo " DT identity properties, post-restore DT rewrite, opt-in build spoof)"@echo " LESS=1 Build, keeping iOS security mitigations enabled."@echo " SKIP_PROJECT_SETUP=1 Skip setup_tools/build"@echo " NONE_INTERACTIVE=1 Auto-continue prompts + boot analysis"@echo " SUDO_PASSWORD=... Preload sudo credential for setup flow"@echo " NO_BINPACK=1 Excludes the SSH, VNC, ... binaries from being installed (patchless-only, currently)"@echo " NO_VPHONED=1 Excludes vphoned from being installed (patchless-only, currently)"+ @echo " SPOOF_BUILD=<id> (EXP only) Rewrite ProductBuildVersion in SystemVersion.plist to <id>"+ @echo " e.g. SPOOF_BUILD=23F77 makes Settings -> About show that build."+ @echo " Omitted/empty -> EXP-JB-7 skipped, build version stays at the IPSW value."@echo ""@echo "Setup (one-time):"@echo " make setup_tools Install all tools (brew, trustcache, insert_dylib, venv+pymobiledevice3)"@@ -96,6 +102,7 @@ help:@echo " NO_VPHONED=1 Excludes vphoned from being installed"@echo " make fw_patch_dev Patch boot chain with Swift pipeline (dev mode TXM patches)"@echo " make fw_patch_jb Patch boot chain with Swift pipeline (dev + JB extensions)"+ @echo " make fw_patch_exp Patch boot chain with Swift pipeline (JB + EXP experimental)"@echo ""@echo "Restore:"@echo " make restore_get_shsh Dump SHSH response from Apple"@@ -110,6 +117,7 @@ help:@echo " make cfw_install Install CFW mods via SSH"@echo " make cfw_install_dev Install CFW mods via SSH (dev mode)"@echo " make cfw_install_jb Install CFW + JB extensions (jetsam/procursus/basebin)"+ @echo " make cfw_install_exp Install CFW + JB + EXP experimental (hv_vmm rename, post-restore DT, build spoof)"@echo ""@echo "Variables: VM_DIR=$(VM_DIR) CPU=$(CPU) MEMORY=$(MEMORY) DISK_SIZE=$(DISK_SIZE)"@@ -123,18 +131,21 @@ setup_machine:@if count=0; \[ -n "$(filter 1 true yes YES TRUE,$(JB))" ] && count=$$((count+1)); \[ -n "$(filter 1 true yes YES TRUE,$(DEV))" ] && count=$$((count+1)); \+ [ -n "$(filter 1 true yes YES TRUE,$(EXP))" ] && count=$$((count+1)); \[ -n "$(filter 1 true yes YES TRUE,$(LESS))" ] && count=$$((count+1)); \[ $$count -gt 1 ]; then \- echo "Error: JB=1, DEV=1, and LESS=1 are mutually exclusive"; \+ echo "Error: JB=1, DEV=1, EXP=1, and LESS=1 are mutually exclusive"; \exit 1; \fiSUDO_PASSWORD="$(SUDO_PASSWORD)" \NONE_INTERACTIVE="$(NONE_INTERACTIVE)" \NO_BINPACK="$(NO_BINPACK)" \NO_VPHONED="$(NO_VPHONED)" \+ SPOOF_BUILD="$(SPOOF_BUILD)" \zsh $(SCRIPTS)/setup_machine.sh \$(if $(filter 1 true yes YES TRUE,$(JB)),--jb,) \$(if $(filter 1 true yes YES TRUE,$(DEV)),--dev,) \+ $(if $(filter 1 true yes YES TRUE,$(EXP)),--exp,) \$(if $(filter 1 true yes YES TRUE,$(LESS)),--less,) \$(if $(filter 1 true yes YES TRUE,$(SKIP_PROJECT_SETUP)),--skip-project-setup,)@@ -342,6 +353,9 @@ fw_patch_dev: patcher_buildfw_patch_jb: patcher_build"$(CURDIR)/$(PATCHER_BINARY)" patch-firmware --vm-directory "$(CURDIR)/$(VM_DIR)" --variant jb+fw_patch_exp: patcher_build+ "$(CURDIR)/$(PATCHER_BINARY)" patch-firmware --vm-directory "$(CURDIR)/$(VM_DIR)" --variant exp+# ═══════════════════════════════════════════════════════════════════# Restore# ═══════════════════════════════════════════════════════════════════@@ -429,7 +443,7 @@ ramdisk_send:# CFW# ═══════════════════════════════════════════════════════════════════-.PHONY: cfw_install cfw_install_dev cfw_install_jb+.PHONY: cfw_install cfw_install_dev cfw_install_jb cfw_install_expcfw_install:cd $(VM_DIR) && $(if $(SSH_PORT),SSH_PORT="$(SSH_PORT)") _VPHONE_PATH="$$PATH" zsh "$(CURDIR)/$(SCRIPTS)/cfw_install.sh" .@@ -439,3 +453,6 @@ cfw_install_dev:cfw_install_jb:cd $(VM_DIR) && $(if $(SSH_PORT),SSH_PORT="$(SSH_PORT)") _VPHONE_PATH="$$PATH" zsh "$(CURDIR)/$(SCRIPTS)/cfw_install_jb.sh" .++cfw_install_exp:+ cd $(VM_DIR) && $(if $(SSH_PORT),SSH_PORT="$(SSH_PORT)") $(if $(SPOOF_BUILD),SPOOF_BUILD="$(SPOOF_BUILD)") _VPHONE_PATH="$$PATH" zsh "$(CURDIR)/$(SCRIPTS)/cfw_install_exp.sh" .diff --git a/README.md b/README.mdindex df467eb2..dccc9692 100644--- a/README.md+++ b/README.md@@ -17,17 +17,20 @@ Boot a virtual iPhone (iOS 26) via Apple's Virtualization.framework using PCC re## Firmware Variants-Four patch variants are available with increasing levels of security bypass:+Five patch variants are available with increasing levels of security bypass:-| Variant | Boot Chain | CFW | Make Targets |-| --------------- | :---------: | :-------: | ----------------------------------- |-| **Patchless** | 3 patches | 2 phases | `fw_patch_less` + `boot_less` |-| **Regular** | 41 patches | 10 phases | `fw_patch` + `cfw_install` |-| **Development** | 52 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |-| **Jailbreak** | 112 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| Variant | Boot Chain | CFW | Make Targets |+| ---------------- | :------------: | :--------: | ----------------------------------- |+| **Patchless** | 3 patches | 2 phases | `fw_patch_less` + `boot_less` |+| **Regular** | 41 patches | 10 phases | `fw_patch` + `cfw_install` |+| **Development** | 52 patches | 12 phases | `fw_patch_dev` + `cfw_install_dev` |+| **Jailbreak** | 112 patches | 14 phases | `fw_patch_jb` + `cfw_install_jb` |+| **Experimental** | 140 patches | 18 phases | `fw_patch_exp` + `cfw_install_exp` |> JB finalization (symlinks, Sileo, apt, TrollStore) runs automatically on first boot via `/cores/vphone_jb_setup.sh` LaunchDaemon. Monitor progress: `/var/log/vphone_jb_setup.log`.+> **Experimental (EXP)** is a JB superset that patches the kernel and DSC to make some Apple services think the device is not a VM, while keeping VM-specific services (graphics passthrough, compute/accel fast paths) working correctly. Other variants are deliberately NOT affected.+See [research/0_binary_patch_comparison.md](./research/0_binary_patch_comparison.md) for the detailed per-component breakdown.## Prerequisites@@ -115,6 +118,8 @@ make setup_machine # full automation through "First Boot" (includes r# LESS=1 for patchless variant (- AMFI, SSV, Img4, TXM bypasses)# DEV=1 for dev variant (+ TXM entitlement/debug bypasses)# JB=1 for jailbreak variant (+ full security bypass)+# EXP=1 for experimental variant (JB + research patches: hv_vmm rename, DT identity, post-restore rewrite)+# SPOOF_BUILD=<id> (EXP only) Rewrite SystemVersion.plist ProductBuildVersion to <id>, e.g. 23F77```## Manual Setup@@ -129,6 +134,7 @@ make fw_patch # patch boot chain (regular variant)# or: sudo make fw_patch_less # patchless variant (- AMFI, SSV, Img4, TXM bypasses)# or: make fw_patch_dev # dev variant (+ TXM entitlement/debug bypasses)# or: make fw_patch_jb # jailbreak variant (+ full security bypass)+# or: make fw_patch_exp # experimental variant (JB + research stack)```### Cleaning@@ -198,6 +204,8 @@ python3 -m pymobiledevice3 usbmux forward 2222 22# terminal 2make cfw_install# or: make cfw_install_jb # jailbreak variant+# or: make cfw_install_exp # experimental variant (JB + research stack)+# or: SPOOF_BUILD=23F77 make cfw_install_exp # additionally rewrite ProductBuildVersion```## First Bootdiff --git a/docs/README_ja.md b/docs/README_ja.mdindex a7d8b8ba..a2518f5e 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -17,17 +17,20 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用## ファームウェアバリアント-セキュリティバイパスのレベルが異なる4つのパッチバリアントが利用可能です:+セキュリティバイパスのレベルが異なる5つのパッチバリアントが利用可能です:-| バリアント | ブートチェーン | CFW | Make ターゲット |-| ---------- | :------------: | :---------: | -------------------------------------------- |-| **Patchless** | 3 パッチ | 2 フェーズ | `fw_patch_less` + `boot_less` |-| **通常版** | 41 パッチ | 10 フェーズ | `fw_patch` + `cfw_install` |-| **開発版** | 52 パッチ | 12 フェーズ | `fw_patch_dev` + `cfw_install_dev` |-| **脱獄版** | 112 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` |+| バリアント | ブートチェーン | CFW | Make ターゲット |+| ------------- | :----------------: | :----------: | -------------------------------------------- |+| **Patchless** | 3 パッチ | 2 フェーズ | `fw_patch_less` + `boot_less` |+| **通常版** | 41 パッチ | 10 フェーズ | `fw_patch` + `cfw_install` |+| **開発版** | 52 パッチ | 12 フェーズ | `fw_patch_dev` + `cfw_install_dev` |+| **脱獄版** | 112 パッチ | 14 フェーズ | `fw_patch_jb` + `cfw_install_jb` |+| **実験版** | 脱獄 + EXP 専用 | 脱獄 + EXP | `fw_patch_exp` + `cfw_install_exp` |> JB最終設定(シンボリックリンク、Sileo、apt、TrollStore)は `/cores/vphone_jb_setup.sh` LaunchDaemon により初回起動時に自動実行されます。進捗確認:`/var/log/vphone_jb_setup.log`。+> **実験版(EXP)** は脱獄版の上位集合で、リサーチブランチの実験的パッチを追加で実行します:カーネルの `hv_vmm_present` sysctl リネーム + カーネル内部呼び出し元の改変(`KernelEXPPatcher`)、サインインブラックリスト付きの DSC バイト5改変 + スロット再認証、watchdogd 精密 2 命令パッチ(EXP-JB-3.5)、fw_patch 時点での DeviceTree アイデンティティプロパティ 8 件、復元後の DT アイデンティティ書き換え(EXP-JB-6)、`SPOOF_BUILD=<id>` によるオプトイン式の `SystemVersion.plist` `ProductBuildVersion` 書き換え(EXP-JB-7)。他のバリアントは意図的に影響を受けません。+詳細なコンポーネントごとの内訳については [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md) を参照してください。## 前提条件@@ -103,6 +106,8 @@ make setup_machine # 初回起動までを完全自動化(復元/# LESS=1 で patchless バリアント(- AMFI, SSV, Img4, TXM バイパス)# DEV=1 で開発バリアント(+ TXM entitlement/デバッグバイパス)# JB=1 で脱獄バリアント(dev + 完全セキュリティバイパス)+# EXP=1 で実験バリアント(脱獄 + リサーチパッチ: hv_vmm リネーム、DT アイデンティティ、復元後書き換え)+# SPOOF_BUILD=<id>(EXP 限定)SystemVersion.plist の ProductBuildVersion を <id> に書き換え、例: 23F77```## 手動セットアップ@@ -117,6 +122,7 @@ make fw_patch # ブートチェーンのパッチ当て(通常# または: sudo make fw_patch_less # patchless バリアント(- AMFI, SSV, Img4, TXM バイパス)# または: make fw_patch_dev # 開発バリアント(+ TXM entitlement/デバッグバイパス)# または: make fw_patch_jb # 脱獄バリアント(dev + 完全セキュリティバイパス)+# または: make fw_patch_exp # 実験バリアント(脱獄 + リサーチパッチスタック)```### クリーンアップ@@ -186,6 +192,8 @@ python3 -m pymobiledevice3 usbmux forward 2222 22# ターミナル 2make cfw_install# または: make cfw_install_jb # 脱獄バリアント+# または: make cfw_install_exp # 実験バリアント(脱獄 + リサーチパッチスタック)+# または: SPOOF_BUILD=23F77 make cfw_install_exp # ProductBuildVersion も書き換え```## 初回起動diff --git a/docs/README_ko.md b/docs/README_ko.mdindex 0754be98..2ed127c4 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -17,17 +17,20 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여## 펌웨어 변형-보안 우회 수준이 다른 4가지 패치 변형을 사용할 수 있습니다:+보안 우회 수준이 다른 5가지 패치 변형을 사용할 수 있습니다:-| 변형 | 부트 체인 | CFW | Make 타겟 |-| ------------ | :-------: | :-------: | ------------------------------------------- |-| **Patchless** | 3 패치 | 2 페이즈 | `fw_patch_less` + `boot_less` |-| **일반** | 41 패치 | 10 페이즈 | `fw_patch` + `cfw_install` |-| **개발** | 52 패치 | 12 페이즈 | `fw_patch_dev` + `cfw_install_dev` |-| **탈옥** | 112 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` |+| 변형 | 부트 체인 | CFW | Make 타겟 |+| -------------- | :---------------: | :--------: | ------------------------------------------- |+| **Patchless** | 3 패치 | 2 페이즈 | `fw_patch_less` + `boot_less` |+| **일반** | 41 패치 | 10 페이즈 | `fw_patch` + `cfw_install` |+| **개발** | 52 패치 | 12 페이즈 | `fw_patch_dev` + `cfw_install_dev` |+| **탈옥** | 112 패치 | 14 페이즈 | `fw_patch_jb` + `cfw_install_jb` |+| **실험** | 탈옥 + EXP 전용 | 탈옥 + EXP | `fw_patch_exp` + `cfw_install_exp` |> JB 최종 설정(심볼릭 링크, Sileo, apt, TrollStore)은 `/cores/vphone_jb_setup.sh` LaunchDaemon을 통해 첫 번째 부팅 시 자동으로 실행됩니다. 진행 상황 확인: `/var/log/vphone_jb_setup.log`.+> **실험(EXP)** 변형은 탈옥 변형의 상위 집합으로, 연구 브랜치의 실험적 패치를 추가로 실행합니다: 커널 `hv_vmm_present` sysctl 이름 변경 + 커널 내부 호출자 변조(`KernelEXPPatcher`), 로그인 블랙리스트가 있는 DSC 바이트 5 변조 + 슬롯 재인증, watchdogd 정밀 2개 명령어 패치(EXP-JB-3.5), 펌웨어 패치 단계의 DeviceTree 식별 속성 8개, 복원 후 DT 식별 재작성(EXP-JB-6), 그리고 `SPOOF_BUILD=<id>`를 통한 옵트인 `SystemVersion.plist` `ProductBuildVersion` 재작성(EXP-JB-7). 다른 변형은 의도적으로 영향을 받지 않습니다.+컴포넌트별 상세 분류는 [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md)를 참조하세요.## 사전 요구 사항@@ -103,6 +106,8 @@ make setup_machine # "First Boot"까지의 전체 과정 자동화 (# LESS=1 Patchless 변형 (- AMFI, SSV, Img4, TXM 우회)# DEV=1 개발 변형 (+ TXM 권한/디버그 우회)# JB=1 탈옥 변형 (dev + 전체 보안 우회)+# EXP=1 실험 변형 (탈옥 + 연구 패치: hv_vmm 이름 변경, DT 식별, 복원 후 재작성)+# SPOOF_BUILD=<id> (EXP 전용) SystemVersion.plist의 ProductBuildVersion을 <id>로 재작성, 예: 23F77```## 수동 설정@@ -117,6 +122,7 @@ make fw_patch # 부트 체인 패치 (일반 변형)# 또는: sudo make fw_patch_less # Patchless 변형 (- AMFI, SSV, Img4, TXM 우회)# 또는: make fw_patch_dev # 개발 변형 (+ TXM 권한/디버그 우회)# 또는: make fw_patch_jb # 탈옥 변형 (dev + 전체 보안 우회)+# 또는: make fw_patch_exp # 실험 변형 (탈옥 + 연구 패치 스택)```### 정리@@ -186,6 +192,8 @@ python3 -m pymobiledevice3 usbmux forward 2222 22# 터미널 2make cfw_install# 또는: make cfw_install_jb # 탈옥 변형+# 또는: make cfw_install_exp # 실험 변형 (탈옥 + 연구 패치 스택)+# 또는: SPOOF_BUILD=23F77 make cfw_install_exp # 추가로 ProductBuildVersion 재작성```## 첫 부팅diff --git a/docs/README_zh.md b/docs/README_zh.mdindex 7a022ce8..a31d521b 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -17,17 +17,20 @@## 固件变体-提供四种补丁变体,安全绕过级别逐步递增:+提供五种补丁变体,安全绕过级别逐步递增:-| 变体 | 启动链 | 自定义固件 | Make 目标 |-| ------------- | :--------: | :--------: | ------------------------------------------- |-| **Patchless** | 3 个补丁 | 2 个阶段 | `fw_patch_less` + `boot_less` |-| **常规版** | 41 个补丁 | 10 个阶段 | `fw_patch` + `cfw_install` |-| **开发版** | 52 个补丁 | 12 个阶段 | `fw_patch_dev` + `cfw_install_dev` |-| **越狱版** | 112 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` |+| 变体 | 启动链 | 自定义固件 | Make 目标 |+| -------------- | :--------------: | :--------: | ------------------------------------------- |+| **Patchless** | 3 个补丁 | 2 个阶段 | `fw_patch_less` + `boot_less` |+| **常规版** | 41 个补丁 | 10 个阶段 | `fw_patch` + `cfw_install` |+| **开发版** | 52 个补丁 | 12 个阶段 | `fw_patch_dev` + `cfw_install_dev` |+| **越狱版** | 112 个补丁 | 14 个阶段 | `fw_patch_jb` + `cfw_install_jb` |+| **实验版** | 越狱 + EXP 专属 | 越狱 + EXP | `fw_patch_exp` + `cfw_install_exp` |> 越狱最终配置(符号链接、Sileo、apt、TrollStore)通过 `/cores/vphone_jb_setup.sh` LaunchDaemon 在首次启动时自动运行。查看进度:`/var/log/vphone_jb_setup.log`。+> **实验版(EXP)** 是越狱版的超集,额外运行研究分支中的实验性补丁:内核 `hv_vmm_present` sysctl 重命名 + 内核内部调用者改写(`KernelEXPPatcher`)、带登录黑名单的 DSC 字节 5 改写 + slot 重新认证、watchdogd 精准 2 条指令补丁(EXP-JB-3.5)、固件补丁阶段的 8 项 DeviceTree 身份属性、还原后 DT 身份重写(EXP-JB-6)、以及通过 `SPOOF_BUILD=<id>` 可选启用的 `SystemVersion.plist` `ProductBuildVersion` 改写(EXP-JB-7)。其他变体不受影响。+详见 [research/0_binary_patch_comparison.md](../research/0_binary_patch_comparison.md) 了解各组件的详细分项对比。## 先决条件@@ -103,6 +106,8 @@ make setup_machine # 完全自动化完成"首次启动"流程(包# LESS=1 patchless 变体(- AMFI、SSV、Img4、TXM 绕过)# DEV=1 开发变体(+ TXM 权限/调试绕过)# JB=1 越狱变体(dev + 完整安全绕过)+# EXP=1 实验变体(越狱 + 研究补丁:hv_vmm 重命名、DT 身份、还原后重写)+# SPOOF_BUILD=<id> (仅 EXP)将 SystemVersion.plist 的 ProductBuildVersion 改写为 <id>,例如 23F77```## 手动设置@@ -117,6 +122,7 @@ make fw_patch # 修补启动链(常规变体)# 或:sudo make fw_patch_less # patchless 变体(- AMFI、SSV、Img4、TXM 绕过)# 或:make fw_patch_dev # 开发变体(+ TXM 权限/调试绕过)# 或:make fw_patch_jb # 越狱变体(dev + 完整安全绕过)+# 或:make fw_patch_exp # 实验变体(越狱 + 研究补丁栈)```### 清理@@ -186,6 +192,8 @@ python3 -m pymobiledevice3 usbmux forward 2222 22# 终端 2make cfw_install# 或:make cfw_install_jb # 越狱变体+# 或:make cfw_install_exp # 实验变体(越狱 + 研究补丁栈)+# 或:SPOOF_BUILD=23F77 make cfw_install_exp # 同时改写 ProductBuildVersion```## 首次启动diff --git a/scripts/cfw_install_exp.sh b/scripts/cfw_install_exp.shnew file mode 100755index 00000000..4db72bf2--- /dev/null+++ b/scripts/cfw_install_exp.sh@@ -0,0 +1,427 @@+#!/bin/zsh+# cfw_install_exp.sh — Install base CFW + JB extensions + EXP experimental+# patches on vphone via SSH ramdisk.+#+# Currently runs the same set of phases as the JB install script (JB-1..JB-5):+# launchd jetsam patch, dylib injection, procursus bootstrap, BaseBin hook+# deployment, first-boot setup. Subsequent commits in this branch add the+# EXP-only experimental phases (DSC pre-step, EXP-JB-3.5 watchdogd, EXP-JB-6+# post-restore DT, EXP-JB-7 build-version) on top.+#+# Prerequisites (in addition to cfw_install.sh requirements):+# - cfw_jb_input/ or resources/cfw_jb_input.tar.zst present+# - zstd (for bootstrap decompression)+#+# Usage: make cfw_install_exp+set -euo pipefail++# ── Restore caller's PATH — Nix /etc/zshenv resets PATH on zsh startup ─+[[ -n "${_VPHONE_PATH:-}" ]] && export PATH="$_VPHONE_PATH"+VM_DIR="${1:-.}"+SCRIPT_DIR="${0:a:h}"++# ── Python resolver — prefer project venv over whatever is in PATH ─+# Resolves to .venv/bin/python3 relative to the project root (parent of+# scripts/), falling back to the system python3 when the venv is absent.+_resolve_python3() {+ local venv_py="${SCRIPT_DIR:h}/.venv/bin/python3"+ if [[ -x "$venv_py" ]]; then+ echo "$venv_py"+ else+ command -v python3 || true+ fi+}+PYTHON3="$(_resolve_python3)"++# ════════════════════════════════════════════════════════════════+# Step 1: Run base CFW install (skip halt — we continue with JB phases)+# ════════════════════════════════════════════════════════════════+echo "[*] cfw_install_exp.sh — Installing CFW + JB extensions + EXP experimental patches..."+echo ""+CFW_SKIP_HALT=1 zsh "$SCRIPT_DIR/cfw_install.sh" "$VM_DIR"++# ════════════════════════════════════════════════════════════════+# Step 2: JB-specific phases+# ════════════════════════════════════════════════════════════════++# Resolve absolute paths (same as base script)+VM_DIR="$(cd "${VM_DIR}" && pwd)"++# ── Configuration ───────────────────────────────────────────────+CFW_INPUT="cfw_input"+CFW_JB_INPUT="cfw_jb_input"+CFW_JB_ARCHIVE="cfw_jb_input.tar.zst"+TEMP_DIR="$VM_DIR/.cfw_temp"++SSH_PORT="${SSH_PORT:-2222}"+SSH_PASS="alpine"+SSH_USER="root"+SSH_HOST="localhost"+SSH_RETRY="${SSH_RETRY:-3}"+SSHPASS_BIN=""+SSH_OPTS=(+ -o StrictHostKeyChecking=no+ -o UserKnownHostsFile=/dev/null+ -o PreferredAuthentications=password+ -o ConnectTimeout=30+ -q+)++# ── Helpers ─────────────────────────────────────────────────────+die() {+ echo "[-] $*" >&2+ exit 1+}++check_prerequisites() {+ local missing=()+ command -v sshpass &>/dev/null || missing+=("sshpass")+ command -v ldid &>/dev/null || missing+=("ldid (brew install ldid-procursus)")+ command -v xcrun &>/dev/null || missing+=("xcrun (Xcode command line tools)")+ if ((${#missing[@]} > 0)); then+ die "Missing required tools: ${missing[*]}. Run: make setup_tools"+ fi+ SSHPASS_BIN="$(command -v sshpass)"+}++_sshpass() {+ "$SSHPASS_BIN" -p "$SSH_PASS" "$@"+}++_ssh_retry() {+ local attempt rc label+ label=${2:-cmd}+ for ((attempt = 1; attempt <= SSH_RETRY; attempt++)); do+ "$@" && return 0+ rc=$?+ [[ $rc -ne 255 ]] && return $rc # real command failure — don't retry+ echo " [${label}] connection lost (attempt $attempt/$SSH_RETRY), retrying in 3s..." >&2+ sleep 3+ done+ return 255+}++ssh_cmd() {+ _ssh_retry _sshpass ssh "${SSH_OPTS[@]}" -p "$SSH_PORT" "$SSH_USER@$SSH_HOST" "$@"+}+scp_to() {+ _ssh_retry _sshpass scp -q "${SSH_OPTS[@]}" -P "$SSH_PORT" -r "$1" "$SSH_USER@$SSH_HOST:$2"+}+scp_from() {+ _ssh_retry _sshpass scp -q "${SSH_OPTS[@]}" -P "$SSH_PORT" "$SSH_USER@$SSH_HOST:$1" "$2"+}++remote_file_exists() {+ ssh_cmd "test -f '$1'" 2>/dev/null+}++ldid_sign() {+ local file="$1" bundle_id="${2:-}"+ local args=(-S -M "-K$VM_DIR/$CFW_INPUT/signcert.p12")+ [[ -n "$bundle_id" ]] && args+=("-I$bundle_id")+ ldid "${args[@]}" "$file"+}++ldid_sign_ent() {+ local file="$1" entitlements_plist="$2" bundle_id="${3:-}"+ local args=("-S$entitlements_plist" "-K$VM_DIR/$CFW_INPUT/signcert.p12")+ [[ -n "$bundle_id" ]] && args+=("-I$bundle_id")+ ldid "${args[@]}" "$file"+}++build_tweakloader() {+ local src="$SCRIPT_DIR/tweakloader/TweakLoader.m"+ local out="$TEMP_DIR/TweakLoader.dylib"+ local sdk cc++ [[ -f "$src" ]] || die "Missing tweak loader source at $src"++ sdk="$(xcrun --sdk iphoneos --show-sdk-path)"+ cc="$(xcrun --sdk iphoneos -f clang)"++ "$cc" -isysroot "$sdk" \+ -arch arm64 -arch arm64e \+ -miphoneos-version-min=15.0 \+ -dynamiclib \+ -fobjc-arc -O3 \+ -framework Foundation \+ -o "$out" \+ "$src"++ ldid_sign "$out"+ echo "$out"+}++remote_mount() {+ local dev="$1" mnt="$2" opts="${3:-rw}"+ ssh_cmd "/bin/mkdir -p $mnt"+ if ssh_cmd "/sbin/mount | /usr/bin/grep -q ' on $mnt '"; then+ return 0+ fi+ ssh_cmd "/sbin/mount_apfs -o $opts $dev $mnt 2>/dev/null || true"+ if ! ssh_cmd "/sbin/mount | /usr/bin/grep -q ' on $mnt '"; then+ die "Failed to mount $dev at $mnt (opts=$opts). Make sure the ramdisk was booted with the expected patched kernel."+ fi+}++get_boot_manifest_hash() {+ ssh_cmd "/bin/ls /mnt5 2>/dev/null" | awk 'length($0)==96{print; exit}'+}++# ── Setup JB input resources ──────────────────────────────────+setup_cfw_jb_input() {+ [[ -d "$VM_DIR/$CFW_JB_INPUT" ]] && return+ local archive+ for search_dir in "$SCRIPT_DIR/resources" "$SCRIPT_DIR" "$VM_DIR"; do+ archive="$search_dir/$CFW_JB_ARCHIVE"+ if [[ -f "$archive" ]]; then+ echo " Extracting $CFW_JB_ARCHIVE..."+ tar --zstd -xf "$archive" -C "$VM_DIR"+ return+ fi+ done+ die "JB mode: neither $CFW_JB_INPUT/ nor $CFW_JB_ARCHIVE found"+}++# ── Apply dev overlay (replace rpcserver_ios in iosbinpack64) ──+apply_dev_overlay() {+ local dev_bin+ for search_dir in "$SCRIPT_DIR/resources/cfw_dev" "$SCRIPT_DIR/cfw_dev"; do+ dev_bin="$search_dir/rpcserver_ios"+ if [[ -f "$dev_bin" ]]; then+ echo " Applying dev overlay (rpcserver_ios)..."+ local iosbinpack="$VM_DIR/$CFW_INPUT/jb/iosbinpack64.tar"+ local tmpdir="$VM_DIR/.iosbinpack_tmp"+ mkdir -p "$tmpdir"+ tar -xf "$iosbinpack" -C "$tmpdir"+ cp "$dev_bin" "$tmpdir/iosbinpack64/usr/local/bin/rpcserver_ios"+ (cd "$tmpdir" && tar -cf "$iosbinpack" iosbinpack64)+ rm -rf "$tmpdir"+ return+ fi+ done+ die "Dev overlay not found (cfw_dev/rpcserver_ios)"+}++# ── Check JB prerequisites ────────────────────────────────────+command -v zstd >/dev/null 2>&1 || die "'zstd' not found (required for JB bootstrap phase)"++setup_cfw_jb_input+JB_INPUT_DIR="$VM_DIR/$CFW_JB_INPUT"+echo ""+echo "[+] JB input resources: $JB_INPUT_DIR"+check_prerequisites++mkdir -p "$TEMP_DIR"++# Mount device rootfs (may already be mounted from base install)+remote_mount /dev/disk1s1 /mnt1++# ═══════════ JB-1 PATCH LAUNCHD (JETSAM + DYLIB INJECTION) ════+echo ""+echo "[JB-1] Patching launchd (jetsam guard + hook injection)..."++if ! remote_file_exists "/mnt1/sbin/launchd.bak"; then+ echo " Creating backup..."+ ssh_cmd "/bin/cp /mnt1/sbin/launchd /mnt1/sbin/launchd.bak"+fi++scp_from "/mnt1/sbin/launchd.bak" "$TEMP_DIR/launchd"++# Extract original entitlements before patching (must preserve for spawn permissions)+echo " Extracting original entitlements..."+ldid -e "$TEMP_DIR/launchd" > "$TEMP_DIR/launchd.entitlements" 2>/dev/null || true+if [[ -s "$TEMP_DIR/launchd.entitlements" ]]; then+ echo " [+] Preserved launchd entitlements"+else+ echo " [!] No entitlements found on original launchd"+fi++# Inject launchdhook via short root alias to avoid Mach-O header overflow.+# Keep the full /cores/launchdhook.dylib copy on disk for compatibility, but+# load /b from launchd because this launchd sample only has room for a short+# LC_LOAD_DYLIB command after stripping LC_CODE_SIGNATURE.+if [[ -d "$JB_INPUT_DIR/basebin" ]]; then+ echo " Injecting LC_LOAD_DYLIB for /b (short launchdhook alias)..."+ "$PYTHON3" "$SCRIPT_DIR/patchers/cfw.py" inject-dylib "$TEMP_DIR/launchd" "/b"+fi++"$PYTHON3" "$SCRIPT_DIR/patchers/cfw.py" patch-launchd-jetsam "$TEMP_DIR/launchd"++# Re-sign with original entitlements to avoid "operation not permitted" on spawn+if [[ -s "$TEMP_DIR/launchd.entitlements" ]]; then+ ldid -S"$TEMP_DIR/launchd.entitlements" -M "-K$VM_DIR/$CFW_INPUT/signcert.p12" "$TEMP_DIR/launchd"+else+ ldid_sign "$TEMP_DIR/launchd"+fi+scp_to "$TEMP_DIR/launchd" "/mnt1/sbin/launchd"+ssh_cmd "/bin/chmod 0755 /mnt1/sbin/launchd"++echo " [+] launchd patched"++# ═══════════ JB-2 INSTALL IOSBINPACK64 ════════════════════════+echo ""+echo "[JB-2] Installing iosbinpack64..."++apply_dev_overlay+scp_to "$VM_DIR/$CFW_INPUT/jb/iosbinpack64.tar" "/mnt1"+ssh_cmd "/usr/bin/tar --preserve-permissions --no-overwrite-dir \+ -xf /mnt1/iosbinpack64.tar -C /mnt1"+ssh_cmd "/bin/rm -f /mnt1/iosbinpack64.tar"++echo " [+] iosbinpack64 installed"++# ═══════════ JB-3 PATCH debugserver entitlements ════+echo ""+echo "[JB-3] Patching debugserver entitlements..."++scp_from "/mnt1/usr/libexec/debugserver" "$TEMP_DIR/debugserver"+ldid -e "$TEMP_DIR/debugserver" > "$TEMP_DIR/debugserver-entitlements.plist"+plutil -remove seatbelt-profiles "$TEMP_DIR/debugserver-entitlements.plist" || true+plutil -insert task_for_pid-allow -bool YES "$TEMP_DIR/debugserver-entitlements.plist" || true+ldid_sign_ent "$TEMP_DIR/debugserver" "$TEMP_DIR/debugserver-entitlements.plist"+scp_to "$TEMP_DIR/debugserver" "/mnt1/usr/libexec/debugserver"+ssh_cmd "/bin/chmod 0755 /mnt1/usr/libexec/debugserver"++echo " [+] debugserver entitlements patched"+++# ═══════════ JB-4 INSTALL PROCURSUS BOOTSTRAP ══════════════════+echo ""+echo "[JB-4] Installing procursus bootstrap..."++remote_mount /dev/disk1s5 /mnt5+BOOT_HASH="$(get_boot_manifest_hash)"+[[ -n "$BOOT_HASH" ]] || die "Could not find 96-char boot manifest hash in /mnt5"+echo " Boot manifest hash: $BOOT_HASH"++BOOTSTRAP_ZST="$JB_INPUT_DIR/jb/bootstrap-iphoneos-arm64.tar.zst"+SILEO_DEB="$JB_INPUT_DIR/jb/org.coolstar.sileo_2.5.1_iphoneos-arm64.deb"+[[ -f "$BOOTSTRAP_ZST" ]] || die "Missing $BOOTSTRAP_ZST"++BOOTSTRAP_TAR="$TEMP_DIR/bootstrap-iphoneos-arm64.tar"+zstd -d -f "$BOOTSTRAP_ZST" -o "$BOOTSTRAP_TAR"++scp_to "$BOOTSTRAP_TAR" "/mnt5/$BOOT_HASH/bootstrap-iphoneos-arm64.tar"+if [[ -f "$SILEO_DEB" ]]; then+ scp_to "$SILEO_DEB" "/mnt5/$BOOT_HASH/org.coolstar.sileo_2.5.1_iphoneos-arm64.deb"+fi++JB_DIR_NAME="jb-vphone"+ssh_cmd "/bin/rm -rf /mnt5/$BOOT_HASH/jb"+ssh_cmd "/bin/rm -rf /mnt5/$BOOT_HASH/$JB_DIR_NAME"+ssh_cmd "/bin/mkdir -p /mnt5/$BOOT_HASH/$JB_DIR_NAME"+ssh_cmd "/bin/chmod 0755 /mnt5/$BOOT_HASH/$JB_DIR_NAME"+ssh_cmd "/usr/sbin/chown 0:0 /mnt5/$BOOT_HASH/$JB_DIR_NAME"+ssh_cmd "/usr/bin/tar --preserve-permissions -xf /mnt5/$BOOT_HASH/bootstrap-iphoneos-arm64.tar \+ -C /mnt5/$BOOT_HASH/$JB_DIR_NAME/"+ssh_cmd "/bin/mv /mnt5/$BOOT_HASH/$JB_DIR_NAME/var /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus"+ssh_cmd "/bin/mv /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/jb/* /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus 2>/dev/null || true"+ssh_cmd "/bin/rm -rf /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/jb"+ssh_cmd "/bin/rm -f /mnt5/$BOOT_HASH/bootstrap-iphoneos-arm64.tar"+rm -f "$BOOTSTRAP_TAR"++# NOTE: /var/jb symlink is created at runtime by launchdhook.dylib+# (Data volume is encrypted and not mountable from ramdisk).++echo " [+] procursus bootstrap installed"++# ═══════════ JB-4 DEPLOY BASEBIN HOOKS ═════════════════════════+BASEBIN_DIR="$JB_INPUT_DIR/basebin"++if [[ -d "$BASEBIN_DIR" ]]; then+ echo ""+ echo "[JB-4] Deploying BaseBin hooks to /cores/..."++ # Clean previous dylibs before re-uploading+ echo " Cleaning old /cores/ dylibs..."+ ssh_cmd "/bin/rm -rf /mnt1/cores"+ ssh_cmd "/bin/mkdir -p /mnt1/cores"+ ssh_cmd "/bin/chmod 0755 /mnt1/cores"++ # Install all pre-built dylibs from basebin payload+ for dylib in "$BASEBIN_DIR"/*.dylib; do+ [[ -f "$dylib" ]] || continue+ dylib_name="$(basename "$dylib")"+ echo " Installing $dylib_name..."+ ldid_sign "$dylib"+ scp_to "$dylib" "/mnt1/cores/$dylib_name"+ ssh_cmd "/bin/chmod 0755 /mnt1/cores/$dylib_name"+ done++ # Short alias for launchdhook (header space is tight)+ if [[ -f "$BASEBIN_DIR/launchdhook.dylib" ]]; then+ echo " Installing short launchdhook alias at /b..."+ cp "$BASEBIN_DIR/launchdhook.dylib" "$TEMP_DIR/b"+ ldid_sign "$TEMP_DIR/b"+ ssh_cmd "/bin/rm -f /mnt1/b"+ scp_to "$TEMP_DIR/b" "/mnt1/b"+ ssh_cmd "/bin/chmod 0755 /mnt1/b"+ fi++ echo " [+] BaseBin hooks deployed"+fi++# ═══════════ JB-4 INSTALL TWEAKLOADER ════════════════════════════+echo ""+echo "[JB-4] Building and installing TweakLoader..."++TWEAKLOADER_OUT="$(build_tweakloader)"+ssh_cmd "/bin/mkdir -p /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/usr/lib"+scp_to "$TWEAKLOADER_OUT" "/mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/usr/lib/TweakLoader.dylib"+ssh_cmd "/usr/sbin/chown 0:0 /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/usr/lib/TweakLoader.dylib"+ssh_cmd "/bin/chmod 0755 /mnt5/$BOOT_HASH/$JB_DIR_NAME/procursus/usr/lib/TweakLoader.dylib"++echo " [+] TweakLoader installed to procursus/usr/lib/TweakLoader.dylib"++# ═══════════ JB-5 DEPLOY FIRST-BOOT SETUP ══════════════════════+echo ""+echo "[JB-5] Deploying first-boot setup..."++# Deploy first-boot JB setup script + LaunchDaemon+SETUP_SCRIPT="$SCRIPT_DIR/vphone_jb_setup.sh"+SETUP_PLIST="$SCRIPT_DIR/vphone_jb_setup.plist"+if [[ -f "$SETUP_SCRIPT" ]]; then+ scp_to "$SETUP_SCRIPT" "/mnt1/cores/vphone_jb_setup.sh"+ ssh_cmd "/bin/chmod 0755 /mnt1/cores/vphone_jb_setup.sh"+ echo " [+] vphone_jb_setup.sh -> /cores/"+fi+if [[ -f "$SETUP_PLIST" ]]; then+ scp_to "$SETUP_PLIST" "/mnt1/System/Library/LaunchDaemons/com.vphone.jb-setup.plist"+ ssh_cmd "/bin/chmod 0644 /mnt1/System/Library/LaunchDaemons/com.vphone.jb-setup.plist"++ # Inject into launchd.plist so launchd starts it at boot+ echo " Injecting com.vphone.jb-setup into launchd.plist..."+ scp_from "/mnt1/System/Library/xpc/launchd.plist" "$TEMP_DIR/launchd.plist"+ "$PYTHON3" -c "+import plistlib, sys+with open(sys.argv[1], 'rb') as f:+ target = plistlib.load(f)+with open(sys.argv[2], 'rb') as f:+ daemon = plistlib.load(f)+target.setdefault('LaunchDaemons', {})['/System/Library/LaunchDaemons/com.vphone.jb-setup.plist'] = daemon+with open(sys.argv[1], 'wb') as f:+ plistlib.dump(target, f, sort_keys=False)+" "$TEMP_DIR/launchd.plist" "$SETUP_PLIST"+ scp_to "$TEMP_DIR/launchd.plist" "/mnt1/System/Library/xpc/launchd.plist"+ ssh_cmd "/bin/chmod 0644 /mnt1/System/Library/xpc/launchd.plist"+ echo " [+] com.vphone.jb-setup.plist injected into launchd.plist"+fi++# ═══════════ CLEANUP ═════════════════════════════════════════+echo ""+echo "[*] Unmounting device filesystems..."+ssh_cmd "/sbin/umount /mnt1 2>/dev/null || true"+ssh_cmd "/sbin/umount /mnt3 2>/dev/null || true"+ssh_cmd "/sbin/umount /mnt5 2>/dev/null || true"++echo "[*] Cleaning up temp binaries..."+rm -f "$TEMP_DIR/launchd" \+ "$TEMP_DIR/bootstrap-iphoneos-arm64.tar"++echo ""+echo "[+] CFW + JB + EXP installation complete!"+echo " Reboot the device for changes to take effect."+echo " After boot, SSH will be available on port 22222 (password: alpine)"++ssh_cmd "/sbin/halt" || truediff --git a/scripts/setup_machine.sh b/scripts/setup_machine.shindex f025ebcb..b794a64f 100755--- a/scripts/setup_machine.sh+++ b/scripts/setup_machine.sh@@ -62,6 +62,7 @@ NO_VPHONED_RAW="${NO_VPHONED:-0}"NO_VPHONED=0JB_MODE=0DEV_MODE=0+EXP_MODE=0LESS_MODE=0SKIP_PROJECT_SETUP=0@@ -962,6 +963,9 @@ parse_args() {--dev)DEV_MODE=1;;+ --exp)+ EXP_MODE=1+ ;;--less)LESS_MODE=1;;@@ -970,11 +974,15 @@ parse_args() {;;-h|--help)cat <<'EOF'-Usage: setup_machine.sh [--jb] [--dev] [--skip-project-setup]+Usage: setup_machine.sh [--jb] [--dev] [--exp] [--less] [--skip-project-setup]Options:--jb Use jailbreak firmware patching + jailbreak CFW install.--dev Use dev firmware patching + dev CFW install.+ --exp Use experimental firmware patching + EXP CFW install+ (JB + kernel hv_vmm rename, DSC byte-5 mangle, watchdogd+ surgical patch, DT identity properties, post-restore DT+ rewrite, opt-in build-version spoof via SPOOF_BUILD).--less Use patchless firmware patching + CFW install.--skip-project-setup Skip setup_tools/build stage.@@ -983,6 +991,8 @@ Environment:SUDO_PASSWORD=... Preload sudo credential via askpass.NO_BINPACK=1 Excludes the SSH, VNC, ... binaries from being installed (patchless-only, currently)NO_VPHONED=1 Excludes vphoned from being installed (patchless-only, currently)+ SPOOF_BUILD=<id> (EXP only) Rewrite SystemVersion.plist ProductBuildVersion+ to <id> (e.g. 23F77). Omitted/empty -> skipped.EOFexit 0;;@@ -1010,8 +1020,8 @@ main() {local cfw_install_target="cfw_install"local mode_label="base"- if (( JB_MODE + DEV_MODE + LESS_MODE > 1 )); then- die "--jb, --dev, and --less are mutually exclusive"+ if (( JB_MODE + DEV_MODE + EXP_MODE + LESS_MODE > 1 )); then+ die "--jb, --dev, --exp, and --less are mutually exclusive"fiif [[ "$JB_MODE" -eq 1 ]]; then@@ -1022,6 +1032,10 @@ main() {fw_patch_target="fw_patch_dev"cfw_install_target="cfw_install_dev"mode_label="dev"+ elif [[ "$EXP_MODE" -eq 1 ]]; then+ fw_patch_target="fw_patch_exp"+ cfw_install_target="cfw_install_exp"+ mode_label="experimental"elif [[ "$LESS_MODE" -eq 1 ]]; thenfw_patch_target="fw_patch_less"cfw_install_target=""@@ -1118,7 +1132,7 @@ main() {BOOT_FIFO=""fi- if [[ "$JB_MODE" -eq 1 ]]; then+ if [[ "$JB_MODE" -eq 1 || "$EXP_MODE" -eq 1 ]]; thenecho ""echo "=== JB Finalize ==="echo "[*] JB finalization will run automatically on first normal boot"diff --git a/sources/FirmwarePatcher/Kernel/EXPPatches/KernelEXPPatchHvVmmRename.swift b/sources/FirmwarePatcher/Kernel/EXPPatches/KernelEXPPatchHvVmmRename.swiftnew file mode 100644index 00000000..457d072f--- /dev/null+++ b/sources/FirmwarePatcher/Kernel/EXPPatches/KernelEXPPatchHvVmmRename.swift@@ -0,0 +1,279 @@+// KernelEXPPatchHvVmmRename.swift — EXP kernel patch: rename the+// `hv_vmm_present` sysctl OID name AND mangle every kernel-internal+// `kern.hv_vmm_present` caller cstring so they keep working after the+// rename.+//+// Variant scope: `.exp` only. JB and other variants are NOT affected.+//+// Two-part design:+//+// Part A (OID rename): single byte change at offset 0 of the+// 14-byte NUL-delimited cstring `\0hv_vmm_present\0` (the OID's+// `oid_name` value): 'h' (0x68) → 'X' (0x58). After this, the+// kernel resolves `sysctlbyname("kern.hv_vmm_present", ...)` as+// ENOENT and `sysctlbyname("kern.Xv_vmm_present", ...)` to the+// OID's real int value (1 on this VM).+//+// Part B (internal caller mangle): single byte change at offset 5+// of every kernel-internal NUL-delimited cstring+// `\0kern.hv_vmm_present\0`: the `'h'` after `kern.` → `'X'`. This+// covers cstrings that the kernel itself, AMFI, or other kexts+// hard-code as the full sysctl name when they call a kernel-side+// sysctlbyname-equivalent. Without this mangle those callers+// query the now-ENOENT name and take their "not in a VM" branch,+// which on this hardware causes AMFI to panic with+// "AMFI: No PMGR?" (ConfigurationSettings.cpp:388) during ramdisk+// boot. Mangling those callers to the new name makes them see+// the truthful `1` again — same value they got pre-Part-A.+//+// User-mode counterpart+// ---------------------+// `scripts/patchers/cfw_patch_hv_vmm_dsc.py` applies the same byte-5+// mangle to DSC dylibs that are NOT in `DONT_PATCH_INSTALL_NAMES`+// (graphics + accel passthrough). Blacklisted dylibs keep the+// original cstring and hit ENOENT after Part A. The two halves+// (kernel + user-mode) together implement the blacklist-flip+// design: callers that should see `1` (graphics, accel, AMFI,+// other kexts) get the byte-5 mangle; callers that should see+// ENOENT-which-defensively-caches-0 (sign-in / device-likeness+// libs) get left alone.+//+// Reveal strategy+// ---------------+// The kernelcache's LC_SYMTAB is fully stripped on this build, so+// symbol-based reveals don't apply. Both parts work by byte search+// for cstrings in `buffer.data`:+//+// - Part A's needle is `\0hv_vmm_present\0` (16 bytes). We require+// exactly one match — there's only one OID with this short name.+// - Part B searches for two byte-aligned forms of the+// `kern.hv_vmm_present` name:+// (i) `\0kern.hv_vmm_present\0` (21 bytes) — the standard+// NUL-delimited cstring form used by code in+// `__TEXT,__cstring` of every kext that calls+// `sysctlbyname` by full name. Verified consumers on+// iPhone17,3 / iOS 26.1: AMFI, IOCryptoAcceleratorFamily,+// sandbox (regular cstring), apfs.+// (ii) `kern.hv_vmm_present\x0f` (20 bytes, no leading or+// trailing NUL) — a sandbox-profile name-token. The+// compiled sandbox-profile format inside+// com.apple.security.sandbox stores OID names this way;+// without this needle, Part B misses one occurrence at+// file offset 0xa6618b. The token's terminator byte+// `\x0f` is the sandbox-profile end-of-name marker.+// Each match is mangled at byte 5 of the cstring/token (the+// `'h'` after `kern.`) → `'X'`, producing `kern.Xv_vmm_present`,+// so sysctlbyname-by-name callers and sandbox-profile name+// matches both continue to resolve correctly after Part A's+// OID rename.+//+// Idempotence+// -----------+// Re-running this patch is a no-op:+// - Part A: detects post-patch `\0Xv_vmm_present\0` and bails.+// - Part B: each cstring's byte 5 is checked before write; if it+// is already 'X' the patcher skips that occurrence.++import Foundation++extension KernelEXPPatcher {+ /// Apply Part A (OID rename) + Part B (kernel-internal caller+ /// byte-5 mangle). Returns true if any byte was modified.+ @discardableResult+ func patchHvVmmRename() -> Bool {+ log("\n[EXP] hv_vmm_present sysctl: OID rename + kernel-internal caller mangle")+ let aChanged = renameOidNameCstring()+ let bChanged = mangleKernelInternalCallers()+ return aChanged || bChanged+ }++ // MARK: - Part A: rename the OID's name cstring++ /// Rename `\0hv_vmm_present\0` → `\0Xv_vmm_present\0` (single byte at+ /// offset 0 of the 14-byte cstring). Exactly one occurrence is required.+ private func renameOidNameCstring() -> Bool {+ // Bytes: '\0' 'h' 'v' '_' 'v' 'm' 'm' '_' 'p' 'r' 'e' 's' 'e' 'n' 't' '\0'+ let needle = Data([+ 0x00, 0x68, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F,+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74, 0x00,+ ])+ let patched = Data([+ 0x00, 0x58, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F,+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74, 0x00,+ ])++ let originalHits = buffer.findAll(needle)+ let patchedHits = buffer.findAll(patched)++ if originalHits.isEmpty, patchedHits.count == 1 {+ log(" [.] Part A: OID name already renamed at foff 0x"+ + String(format: "%X", patchedHits[0] + 1))+ return false+ }++ guard !originalHits.isEmpty else {+ log(" [-] Part A: no NUL-delimited 'hv_vmm_present' cstring "+ + "found — OID may have a different name shape on this build")+ return false+ }++ guard originalHits.count == 1 else {+ let list = originalHits.map { String(format: "0x%X", $0 + 1) }+ .joined(separator: ", ")+ log(" [-] Part A: expected exactly 1 NUL-delimited "+ + "'hv_vmm_present' cstring, found \(originalHits.count) "+ + "(\(list)) — refusing to rename ambiguously")+ return false+ }++ if !patchedHits.isEmpty {+ log(" [-] Part A: both original and renamed cstrings present "+ + "(\(originalHits.count) + \(patchedHits.count)) — refusing")+ return false+ }++ let cstringStart = originalHits[0] + 1+ let firstByte = buffer.data[cstringStart]+ guard firstByte == 0x68 else {+ log(" [-] Part A: unexpected first byte at 0x"+ + String(format: "%X", cstringStart)+ + " (found 0x\(String(format: "%02X", firstByte)), "+ + "expected 0x68 'h') — refusing")+ return false+ }++ let va = fileOffsetToVA(cstringStart)+ emit(cstringStart,+ Data([0x58]),+ patchID: "kernelcache_exp.hv_vmm_oid_rename",+ virtualAddress: va,+ description: "Part A: rename OID name 'h' -> 'X' "+ + "('hv_vmm_present' -> 'Xv_vmm_present')")+ return true+ }++ // MARK: - Part B: mangle kernel-internal `kern.hv_vmm_present` callers++ /// For every kernel-internal occurrence of `kern.hv_vmm_present`+ /// inside the kernelcache buffer (kernel proper + kexts + fileset+ /// entries + compiled sandbox-profile blobs), flip byte 5 of the+ /// cstring/token from 'h' to 'X' so it becomes+ /// `kern.Xv_vmm_present`. Matches Part A's OID rename, so the+ /// caller's runtime sysctlbyname call (or the sandbox profile's+ /// name-token comparison) now hits the renamed OID and gets the+ /// truthful 1.+ ///+ /// Two byte-aligned forms are handled:+ /// - NUL-delimited cstring `\0kern.hv_vmm_present\0` (4 known+ /// occurrences: AMFI, IOCryptoAcceleratorFamily, sandbox+ /// cstring, apfs).+ /// - Sandbox-profile name-token `kern.hv_vmm_present\x0f` —+ /// trailing `\x0f` is the sandbox-profile end-of-name marker,+ /// no leading NUL. 1 known occurrence inside+ /// com.apple.security.sandbox.+ private func mangleKernelInternalCallers() -> Bool {+ // ── Form (i): NUL-delimited cstring.+ // 21 bytes total (leading NUL + 19 cstring bytes + trailing NUL).+ // Mangle offset within the needle: 1 (skip leading NUL) + 5 = 6.+ let cstrOriginalNeedle = Data([+ 0x00, // \0+ 0x6B, 0x65, 0x72, 0x6E, 0x2E, // "kern."+ 0x68, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F, // "hv_vmm_"+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74, // "present"+ 0x00, // \0+ ])+ let cstrPatchedNeedle = Data([+ 0x00,+ 0x6B, 0x65, 0x72, 0x6E, 0x2E, // "kern."+ 0x58, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F, // "Xv_vmm_"+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74,+ 0x00,+ ])++ // ── Form (ii): sandbox-profile name-token.+ // 20 bytes total (19 name bytes + trailing \x0f). No leading byte+ // in the needle. Mangle offset within the needle: 5.+ let tlvOriginalNeedle = Data([+ 0x6B, 0x65, 0x72, 0x6E, 0x2E, // "kern."+ 0x68, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F, // "hv_vmm_"+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74, // "present"+ 0x0F, // sandbox EOT+ ])+ let tlvPatchedNeedle = Data([+ 0x6B, 0x65, 0x72, 0x6E, 0x2E,+ 0x58, 0x76, 0x5F, 0x76, 0x6D, 0x6D, 0x5F, // "Xv_vmm_"+ 0x70, 0x72, 0x65, 0x73, 0x65, 0x6E, 0x74,+ 0x0F,+ ])++ // (mangle position relative to the needle's start, originalByte)+ let sites: [(needle: Data, patched: Data, mangleDelta: Int, label: String)] = [+ (cstrOriginalNeedle, cstrPatchedNeedle, 6, "cstring"),+ (tlvOriginalNeedle, tlvPatchedNeedle, 5, "sandbox-profile token"),+ ]++ var totalOriginal = 0+ var totalPatched = 0+ var totalWritten = 0++ for site in sites {+ let originalHits = buffer.findAll(site.needle)+ let patchedHits = buffer.findAll(site.patched)+ totalOriginal += originalHits.count+ totalPatched += patchedHits.count++ log(" [.] Part B (\(site.label)): \(originalHits.count) "+ + "original, \(patchedHits.count) already-mangled")++ for needleOff in originalHits {+ let mangleOffset = needleOff + site.mangleDelta++ // Defensive re-check: the byte we're about to flip must+ // be 'h' (0x68). If it isn't, something has changed+ // structurally — skip this occurrence and log it.+ let byteHere = buffer.data[mangleOffset]+ guard byteHere == 0x68 else {+ log(" [-] Part B (\(site.label)): byte at 0x"+ + String(format: "%X", mangleOffset)+ + " is 0x\(String(format: "%02X", byteHere)), "+ + "expected 0x68 'h' — skipping")+ continue+ }++ let va = fileOffsetToVA(mangleOffset)+ emit(mangleOffset,+ Data([0x58]),+ patchID: "kernelcache_exp.hv_vmm_internal_caller_mangle",+ virtualAddress: va,+ description: "Part B (\(site.label)): byte-5 mangle "+ + "'h' -> 'X' at foff 0x"+ + String(format: "%X", mangleOffset)+ + " ('kern.hv_vmm_present' -> 'kern.Xv_vmm_present')")+ totalWritten += 1+ }+ }++ let totalKnown = totalOriginal + totalPatched+ log(" [.] Part B summary: \(totalOriginal) original + "+ + "\(totalPatched) already-mangled (total \(totalKnown)) — "+ + "wrote \(totalWritten) byte(s)")++ if totalOriginal == 0 {+ if totalPatched == 0 {+ log(" [.] Part B: no kernel-internal callers found — "+ + "either no kext queries the sysctl by full name, "+ + "or they all live elsewhere")+ } else {+ log(" [.] Part B: all \(totalPatched) kernel-internal "+ + "occurrence(s) already mangled — nothing to do")+ }+ return false+ }++ if totalWritten > 0 {+ log(" [+] Part B: mangled \(totalWritten) kernel-internal "+ + "occurrence(s) (cstring + sandbox-profile combined)")+ }+ return totalWritten > 0+ }+}diff --git a/sources/FirmwarePatcher/Kernel/KernelEXPPatcher.swift b/sources/FirmwarePatcher/Kernel/KernelEXPPatcher.swiftnew file mode 100644index 00000000..41c75cd7--- /dev/null+++ b/sources/FirmwarePatcher/Kernel/KernelEXPPatcher.swift@@ -0,0 +1,42 @@+// KernelEXPPatcher.swift — Experimental kernel patcher orchestrator.+//+// Runs after KernelPatcher + KernelJBPatcher for the `.exp` firmware variant+// only. JB and other variants are NOT affected by patches owned here.+//+// Current contents:+// - patchHvVmmRename (Part A + Part B): rename the kern.hv_vmm_present+// sysctl OID cstring AND mangle every kernel-internal caller. See+// EXPPatches/KernelEXPPatchHvVmmRename.swift for the implementation.++import Foundation++/// Experimental kernel patcher.+///+/// Inherits the JB infrastructure (symbol table, ADRP/BL indices, branch+/// encoders, code-cave finder, string-anchored function finders, etc.) from+/// `KernelJBPatcherBase` so EXP-specific patches can use the same helpers+/// as JB ones without duplicating them.+public final class KernelEXPPatcher: KernelJBPatcherBase, Patcher {+ public let component = "kernelcache_exp"++ public func findAll() throws -> [PatchRecord] {+ try parseMachO()+ buildADRPIndex()+ buildBLIndex()+ buildSymbolTable()+ findPanic()++ // Experimental patches (EXP variant only)+ patchHvVmmRename()++ return patches+ }++ public func apply() throws -> Int {+ let records = try (patches.isEmpty ? findAll() : patches)+ for record in records {+ buffer.writeBytes(at: record.fileOffset, bytes: record.patchedBytes)+ }+ return records.count+ }+}diff --git a/sources/FirmwarePatcher/Pipeline/FirmwarePipeline.swift b/sources/FirmwarePatcher/Pipeline/FirmwarePipeline.swiftindex 3dde5671..97f32b43 100644--- a/sources/FirmwarePatcher/Pipeline/FirmwarePipeline.swift+++ b/sources/FirmwarePatcher/Pipeline/FirmwarePipeline.swift@@ -8,6 +8,9 @@// .regular — base patchers only// .dev — TXMDevPatcher instead of TXMPatcher// .jb — TXMDevPatcher + IBootJBPatcher (iBSS) + KernelJBPatcher+// .exp — JB + experimental: KernelEXPPatcher (hv_vmm rename) ++// DeviceTreePatcher identity properties (D47AP/iPhone17,3).+// Other variants are NOT affected by experimental patches.import Darwinimport Foundation@@ -28,6 +31,7 @@ public final class FirmwarePipeline {case regularcase devcase jb+ case exp}// MARK: - Firmware Loader (pluggable IM4P support)@@ -174,7 +178,8 @@ public final class FirmwarePipeline {func buildComponentList() -> [ComponentDescriptor] {var components: [ComponentDescriptor] = []- // 1. AVPBooter — always present, lives in VM root+ // 1. AVPBooter — always present, lives in VM root.+ // Patched for every non-less variant (regular/dev/jb/exp).components.append(ComponentDescriptor(name: "AVPBooter",inRestoreDir: false,@@ -191,7 +196,7 @@ public final class FirmwarePipeline {}()))- // 2. iBSS — JB variant runs the base iBSS patcher, then the nonce-skip extension.+ // 2. iBSS — JB and EXP variants run the base iBSS patcher, then the nonce-skip extension.components.append(ComponentDescriptor(name: "iBSS",inRestoreDir: true,@@ -204,7 +209,7 @@ public final class FirmwarePipeline {[{ data, verbose inIBootPatcher(data: data, mode: .ibss, verbose: verbose)}]- case .jb:+ case .jb, .exp:[{ data, verbose inIBootPatcher(data: data, mode: .ibss, verbose: verbose)@@ -237,7 +242,7 @@ public final class FirmwarePipeline {}]))- // 5. TXM — dev/jb variants use TXMDevPatcher (adds entitlements, debugger, dev-mode)+ // 5. TXM — dev/jb/exp variants use TXMDevPatcher (adds entitlements, debugger, dev-mode)components.append(ComponentDescriptor(name: "TXM",inRestoreDir: true,@@ -250,7 +255,7 @@ public final class FirmwarePipeline {[{ data, verbose inTXMPatcher(data: data, verbose: verbose)}]- case .dev, .jb:+ case .dev, .jb, .exp:[{ data, verbose inTXMDevPatcher(data: data, verbose: verbose)}]@@ -259,6 +264,7 @@ public final class FirmwarePipeline {))// 6. Kernel — JB variant runs base kernel patches first, then JB extensions.+ // EXP variant runs base + JB + experimental extensions (hv_vmm rename).components.append(ComponentDescriptor(name: "kernelcache",inRestoreDir: true,@@ -284,11 +290,23 @@ public final class FirmwarePipeline {KernelJBPatcher(data: data, verbose: verbose)},]+ case .exp:+ [+ { data, verbose in+ KernelPatcher(data: data, verbose: verbose, isDev: false)+ },+ { data, verbose in+ KernelJBPatcher(data: data, verbose: verbose)+ },+ { data, verbose in+ KernelEXPPatcher(data: data, verbose: verbose)+ },+ ]}}()))- // 7. DeviceTree — same for all variants+ // 7. DeviceTree — same base property patches for every variant.components.append(ComponentDescriptor(name: "DeviceTree",inRestoreDir: true,@@ -309,7 +327,7 @@ public final class FirmwarePipeline {[{ data, verbose inCryptexFilesystemPatcher(buildManiest: data, restoreDir: try! self.findRestoreDirectory(), verbose: verbose, noBinpack: self.noBinpack, noVphoned: self.noVphoned)}]- case .regular, .dev, .jb:+ case .regular, .dev, .jb, .exp:[]}}()@@ -326,7 +344,7 @@ public final class FirmwarePipeline {[{ data, verbose inManifestHashPatcher(data: data, restoreDir: try? self.findRestoreDirectory(), verbose: verbose)}]- case .regular, .dev, .jb:+ case .regular, .dev, .jb, .exp:[]}}()@@ -446,6 +464,7 @@ public final class FirmwarePipeline {if let txm = patcher as? TXMPatcher { return txm.buffer.data }if let kp = patcher as? KernelPatcher { return kp.buffer.data }if let kjb = patcher as? KernelJBPatcher { return kjb.buffer.data }+ if let kexp = patcher as? KernelEXPPatcher { return kexp.buffer.data }if let dt = patcher as? DeviceTreePatcher { return dt.patchedData }// Fallback: apply records manually to a copy of the original data.diff --git a/sources/vphone-cli/VPhoneCLI.swift b/sources/vphone-cli/VPhoneCLI.swiftindex 9fd7a714..362be521 100644--- a/sources/vphone-cli/VPhoneCLI.swift+++ b/sources/vphone-cli/VPhoneCLI.swift@@ -120,6 +120,7 @@ struct PatchFirmwareCLI: ParsableCommand {case regularcase devcase jb+ case expvar pipelineVariant: FirmwarePipeline.Variant {switch self {@@ -127,15 +128,17 @@ struct PatchFirmwareCLI: ParsableCommand {case .regular: .regularcase .dev: .devcase .jb: .jb+ case .exp: .exp}}-+var virtualMachineVariant: VPhoneVirtualMachine.Variant {switch self {case .less: .lesscase .regular: .regularcase .dev: .devcase .jb: .jb+ case .exp: .exp}}}diff --git a/sources/vphone-cli/VPhoneVirtualMachine.swift b/sources/vphone-cli/VPhoneVirtualMachine.swiftindex 05aa9160..d292b449 100644--- a/sources/vphone-cli/VPhoneVirtualMachine.swift+++ b/sources/vphone-cli/VPhoneVirtualMachine.swift@@ -18,6 +18,7 @@ class VPhoneVirtualMachine: NSObject, VZVirtualMachineDelegate {case regularcase devcase jb+ case exp}struct Options {