Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

Include PCC GPU provenance in sibling package

Lakrd82d00f71ae0
diff --git a/AGENTS.md b/AGENTS.md
index 39f2c70b..d8856fb7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -180,13 +180,13 @@ scripts/ # Build scripts and payloads only; no runtime
├── guest_binaries.mk [b] # Cross-compiles vphoned (needs the iPhoneOS SDK)
├── check_aux.sh [b] # The self-containment admission gates — `make check-aux`
├── setup_tools.sh [b] # Builds insert_dylib, the Mach-O byte-parity test reference
-├── payloads/ # Small GPU driver archive; no bootstrap payloads
├── vphoned/ # Guest daemon source; only its plist and entitlements ship
└── repos/ # Toolchain source (git submodule: insert_dylib)
-siblings/ # Optional guest components; separate Makefile/package
+siblings/ # Guest component sources/provenance; separate package
├── camfix/ vcamcaptured/ # Camera hooks and filter plists
-└── tweakloader/ vpregister/ # Loader and iOS 27 app registrar
+├── tweakloader/ vpregister/ # Loader and iOS 27 app registrar
+└── gpu/ # PCC firmware provenance; no Apple binary
research/ # Detailed firmware/patch documentation
```
diff --git a/Makefile b/Makefile
index fc94e7c3..db0d2606 100644
--- a/Makefile
+++ b/Makefile
@@ -74,7 +74,7 @@ help:
@echo "Build:"
@echo " make build Build + sign vphone-cli"
@echo " make vphoned Cross-compile + sign vphoned for iOS"
- @echo " make siblings_package Build + archive optional guest components"
+ @echo " make siblings_package Archive four optional guest components + GPU provenance"
@echo " make clean Remove build/tooling artifacts only"
@echo " Options: CLEAN_VM=1 Also remove VM_DIR=$(VM_DIR) after confirmation"
@echo " CLEAN_IPSW=1 Also remove ipsws/ after confirmation"
diff --git a/scripts/dist_manifest.sh b/scripts/dist_manifest.sh
index 51292c86..8de0b959 100755
--- a/scripts/dist_manifest.sh
+++ b/scripts/dist_manifest.sh
@@ -59,8 +59,8 @@ done
#
# What is deliberately ABSENT is as important:
# repos/ toolchain submodules — build tier, sources only
-# ../siblings/ optional guest sources and archives; not part of the
-# shipped app or automatic VM installation
+# ../siblings/ guest sources and GPU provenance; not copied into the
+# shipped app (GPU extraction runs in native fw prepare)
# vphoned/*.m *.h vendor/ Makefile same, and it is the bulk of scripts/
print -r -- "vphoned/vphoned.plist" # LaunchDaemon plist, injectLaunchDaemons
print -r -- "vphoned/entitlements.plist" # guest_sign_ent for vphoned
diff --git a/siblings/Makefile b/siblings/Makefile
index f42de999..18df6a27 100644
--- a/siblings/Makefile
+++ b/siblings/Makefile
@@ -1,5 +1,5 @@
-# Optional guest components. Build on the developer machine with the iPhoneOS SDK.
-# Nothing here is staged into vphone-cli.app or installed in a VM.
+# Sibling guest components. The four source components compile with the iPhoneOS SDK.
+# The GPU item is provenance only: fw prepare extracts the actual Apple bundle.
OUT := $(abspath ../.build/siblings)
STAGE := $(OUT)/stage
@@ -13,17 +13,18 @@ TWEAKLOADER := $(STAGE)/tweakloader/TweakLoader.dylib
VPREGISTER := $(STAGE)/vpregister/vpregister
ARTIFACTS := $(CAMFIX) $(VCAMCAPTURED) $(TWEAKLOADER) $(VPREGISTER)
PLISTS := $(STAGE)/camfix/libcamfix.plist $(STAGE)/vcamcaptured/libvcamcaptured.plist
+GPU_PROVENANCE := $(STAGE)/gpu/README.md
.PHONY: all package clean
-all: $(ARTIFACTS) $(PLISTS)
+all: $(ARTIFACTS) $(PLISTS) $(GPU_PROVENANCE)
package: all
@rm -f $(ARCHIVE)
- @/usr/bin/tar -cf $(ARCHIVE) -C $(STAGE) camfix vcamcaptured tweakloader vpregister
+ @/usr/bin/tar -cf $(ARCHIVE) -C $(STAGE) camfix vcamcaptured tweakloader vpregister gpu
@echo "Packaged $(ARCHIVE)"
-$(STAGE)/camfix $(STAGE)/vcamcaptured $(STAGE)/tweakloader $(STAGE)/vpregister:
+$(STAGE)/camfix $(STAGE)/vcamcaptured $(STAGE)/tweakloader $(STAGE)/vpregister $(STAGE)/gpu:
@mkdir -p $@
$(CAMFIX): camfix/libcamfix.m | $(STAGE)/camfix
@@ -58,5 +59,8 @@ $(STAGE)/camfix/libcamfix.plist: camfix/libcamfix.plist | $(STAGE)/camfix
$(STAGE)/vcamcaptured/libvcamcaptured.plist: vcamcaptured/libvcamcaptured.plist | $(STAGE)/vcamcaptured
@cp $< $@
+$(GPU_PROVENANCE): gpu/README.md | $(STAGE)/gpu
+ @cp $< $@
+
clean:
@rm -rf $(OUT)
diff --git a/siblings/README.md b/siblings/README.md
index 52ce2b86..66c5d540 100644
--- a/siblings/README.md
+++ b/siblings/README.md
@@ -1,9 +1,9 @@
-# Optional sibling components
+# Sibling guest components
-`make siblings_package` (or `make -C siblings package`) cross-compiles the
-four optional guest components with Xcode's iPhoneOS SDK and writes
-`.build/siblings/siblings.tar`. The archive contains signed arm64e binaries and
-the two tweak filter plists:
+`make siblings_package` (or `make -C siblings package`) cross-compiles four
+optional guest components with Xcode's iPhoneOS SDK and writes
+`.build/siblings/siblings.tar`. The archive contains signed arm64e binaries,
+two tweak filter plists, and the GPU provenance note:
| Component | Archive contents |
| --- | --- |
@@ -11,8 +11,10 @@ the two tweak filter plists:
| Camera daemon hook | `vcamcaptured/libvcamcaptured.dylib`, `vcamcaptured/libvcamcaptured.plist` |
| Tweak loader | `tweakloader/TweakLoader.dylib` |
| iOS 27 app registrar | `vpregister/vpregister` |
+| PCC GPU driver | `gpu/README.md` (source and extraction flow; no Apple binary) |
-This is a build artifact, not a VM bootstrap. The normal JB build and install
-flow does not stage or install these components. The GPU component is handled
-separately until its firmware-derived build flow is integrated here; no Apple
-GPU driver is stored in this directory.
+The archive is a local build artifact, not a VM bootstrap. The four optional
+components are not installed by the normal JB flow. The required GPU bundle is
+instead extracted from the selected PCC firmware by `vphone-cli fw prepare`
+and copied into the VM during JB installation. No Apple GPU binary is stored
+in this directory, the archive, or the shipped app.