mirror of
https://github.com/Lakr233/vphone-cli.git
synced 2026-09-02 02:34:29 +00:00
zqxwceandClaude Opus 4.8
fcc30e1657
The ramdisk-based install (build/send an SSH ramdisk, iproxy-forward, then
push CFW files over SSH and flip the boot snapshot with snaputil in-VM) has
been fully replaced by the host-mount path: cfw_install_host.sh mounts the
VM's Disk.img on the host, places every file locally, and flips the boot
snapshot offline via tools/apfs_snap_rename.py. This removes all remaining
ramdisk generation, delivery, and usage — no legacy fallback.
Deleted:
- scripts/ramdisk_build.py, scripts/ramdisk_send.sh
Renamed:
- scripts/cfw_host_mode.sh -> scripts/cfw_transport.sh (was a conditional
"host-mode override"; now the sole, unconditionally-sourced transport)
setup_machine.sh: drop the USE_RAMDISK_CFW=1 branch and every iproxy/ramdisk
helper (usbmux UDID resolution, port picking, start/stop iproxy, wait-for-
ramdisk-ssh), all RAMDISK_*/IPROXY_* vars, the cleanup() iproxy handling, and
the orphaned cfw_install_target var. Only the host-mount cfw_install_host call
remains.
cfw_install{,_dev,_jb,_exp}.sh: delete the SSH transport (SSH_* vars, SSH_OPTS,
sshpass prereq/_sshpass/_ssh_retry, ssh_cmd/scp_to/scp_from/remote_file_exists/
remote_mount, wait_for_device_ssh_ready) and the dead ramdisk-mechanism body
blocks (snaputil snapshot flip, dropbearkey host-key pre-generation, halt-over-
SSH, CFW_SKIP_HALT). The transport is now sourced unconditionally from
cfw_transport.sh. dropbear -R generates host keys at first boot; the offline
apfs_snap_rename.py does the boot-source flip. Dropped the vestigial
CFW_HOST_MODE gate.
Also: pymobiledevice3_bridge.py (ramdisk-send command already gone), Makefile
(ramdisk targets/help/IRECOVERY_ECID removed), README + ja/ko/zh (install flow
rewritten to host-mount), AGENTS.md/CLAUDE.md architecture tree, and stale
comments in vphone_jb_setup.sh, VPhoneCLI.swift, apfs_snap_rename.py,
cfw_patch_post_restore_dt.py.
Verified booting via make setup_machine.
Co-Authored-By: Claude Opus 4.8 <[email protected]>
Claude-Session: https://claude.ai/code/session_01XZVS9oqVNmHJzpb8mFtKJx
94 lines
3.8 KiB
Bash
Executable File
94 lines
3.8 KiB
Bash
Executable File
#!/bin/zsh
|
|
# cfw_install_host.sh — CFW install by host-mounting the VM's Disk.img.
|
|
#
|
|
# Attaches the VM's Disk.img on the host and hands the container to the variant
|
|
# installer (cfw_install*.sh), which mounts the APFS volumes and places every
|
|
# CFW file directly. Then flips the boot snapshot offline
|
|
# (tools/apfs_snap_rename.py) so the VM boots the live volume.
|
|
#
|
|
# Prereqs: VM restored (make restore) and powered off; host has gnu-tar, ipsw,
|
|
# aea, ldid, zstd, project venv (make setup_tools). SIP disabled (project
|
|
# baseline); NO authenticated-root/ARV change needed.
|
|
#
|
|
# Usage: cfw_install_host.sh [--variant regular|dev|jb|exp] [vm_dir]
|
|
# Runs as root (mount_apfs/chown/cp to owners-honored mounts); re-execs under
|
|
# sudo automatically (honors SUDO_ASKPASS for non-interactive use).
|
|
set -euo pipefail
|
|
SCRIPT_DIR="${0:a:h}"
|
|
PROJ="${SCRIPT_DIR:h}"
|
|
|
|
VARIANT=exp
|
|
VM_DIR="$PROJ/vm"
|
|
while (( $# )); do
|
|
case "$1" in
|
|
--variant) VARIANT="$2"; shift 2 ;;
|
|
*) VM_DIR="$1"; shift ;;
|
|
esac
|
|
done
|
|
|
|
case "$VARIANT" in
|
|
regular) INSTALLER=cfw_install.sh ;;
|
|
dev) INSTALLER=cfw_install_dev.sh ;;
|
|
jb) INSTALLER=cfw_install_jb.sh ;;
|
|
exp) INSTALLER=cfw_install_exp.sh ;;
|
|
*) echo "[-] unknown variant: $VARIANT (regular|dev|jb|exp)" >&2; exit 1 ;;
|
|
esac
|
|
|
|
# Re-exec as root; owners-honored mounts + chown/cp require it.
|
|
if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
|
|
exec sudo ${SUDO_ASKPASS:+-A} -E /bin/zsh "$0" --variant "$VARIANT" "$VM_DIR"
|
|
fi
|
|
unset SUDO_ASKPASS # already root: host_hdiutil/pre-step use plain sudo/hdiutil
|
|
|
|
VM_DIR="${VM_DIR:a}"
|
|
IMG="$VM_DIR/Disk.img"
|
|
[[ -f "$IMG" ]] || { echo "[-] no Disk.img at $IMG" >&2; exit 1; }
|
|
|
|
# Host-side install toolchain (gnu-tar/ipsw/aea/ldid/zstd + venv python).
|
|
P="$PROJ/.tools/bin:$PROJ/.venv/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
|
|
export PATH="$P"
|
|
PY="$PROJ/.venv/bin/python3"
|
|
|
|
if lsof "$IMG" >/dev/null 2>&1; then
|
|
echo "[-] $IMG is in use — stop the VM first." >&2; exit 1
|
|
fi
|
|
|
|
echo "[*] host-mode CFW install: variant=$VARIANT vm=$VM_DIR"
|
|
AO=$(hdiutil attach -nomount -imagekey diskimage-class=CRawDiskImage "$IMG" 2>/dev/null)
|
|
BASEDISK=$(echo "$AO" | head -1 | awk '{print $1}')
|
|
SYS=$(diskutil apfs list 2>/dev/null | awk '/APFS Volume Disk \(Role\):/{for(i=1;i<=NF;i++) if($i ~ /^disk[0-9]+s[0-9]+$/) dev=$i} /Name:.*System \(Case-sensitive\)/{print dev; exit}')
|
|
CONT="${SYS%s*}"
|
|
[[ -n "$CONT" ]] || { echo "[-] System volume not found in $IMG" >&2; hdiutil detach "$BASEDISK" 2>/dev/null; exit 1; }
|
|
echo "[*] attached: container=$CONT system=$SYS"
|
|
|
|
cleanup() {
|
|
for m in /private/tmp/cfwhost/mnt1 /private/tmp/cfwhost/mnt3 /private/tmp/cfwhost/mnt5; do
|
|
umount "$m" 2>/dev/null || true
|
|
done
|
|
hdiutil detach "$BASEDISK" 2>/dev/null || diskutil eject "$BASEDISK" 2>/dev/null || true
|
|
}
|
|
trap cleanup EXIT
|
|
|
|
echo "[*] running $INSTALLER (files placed on host mounts)..."
|
|
( cd "$VM_DIR" && CFW_HOST_CONTAINER="$CONT" _VPHONE_PATH="$P" \
|
|
${SPOOF_BUILD:+SPOOF_BUILD="$SPOOF_BUILD"} zsh "$SCRIPT_DIR/$INSTALLER" . )
|
|
|
|
cleanup
|
|
trap - EXIT
|
|
|
|
echo "[*] flipping boot snapshot offline (com.apple.os.update -> live volume)..."
|
|
"$PY" "$PROJ/tools/apfs_snap_rename.py" "$IMG"
|
|
|
|
# The whole install ran as root (owners-honored mounts / chown / cp). Hand the
|
|
# host-side artifacts it created (vm/.vphoned.signed, vm/.cfw_temp, extracted
|
|
# cfw_input/cfw_jb_input, the vphoned build) back to the invoking user, so the
|
|
# subsequent user-run steps (make boot / setup_machine first boot, which rewrite
|
|
# vm/.vphoned.signed) don't hit "Permission denied".
|
|
if [[ -n "${SUDO_USER:-}" ]]; then
|
|
chown -R "$SUDO_USER" "$VM_DIR" 2>/dev/null || true
|
|
[[ -e "$PROJ/scripts/vphoned/vphoned" ]] && chown "$SUDO_USER" "$PROJ/scripts/vphoned/vphoned" 2>/dev/null || true
|
|
echo "[*] restored ownership of host-side artifacts to $SUDO_USER"
|
|
fi
|
|
|
|
echo "[+] host-mode CFW install complete. Boot with: make boot"
|