mirror of
https://github.com/yaelliethy/orchard.git
synced 2026-10-29 18:29:57 +00:00
Boots an arm64 macOS guest on QEMU/TCG on Linux through the genuine Apple
chain -- AVPBooter -> iBootStage1 -> iBootStage2 -> stock XNU -- and renders
its desktop on the host's Vulkan.
QEMU (1044 lines over 18 files, 8 new):
* the `apple-vm` machine: Apple-style timer-on-FIQ wiring, the paravirtual
GPU device, a PAC master key installed across CPUs, and GICv2m's
`macos-compat` bit, without which macOS will not use the MSI frame;
* `bdif` NVRAM block writes. Upstream drops them, so a guest could never
persist a boot variable and every install phase repeated forever;
* `cfg`'s guest-visible random seed at its fixed offset;
* Apple pointer authentication under TCG: the register definitions come
from ChefKissInc/Inferno, the per-core key snapshot and the PSCI CPU_ON
key inheritance (restricted to a kernel caller by testing that its pc is
in the TTBR1 half) are ours. Without them secondaries run keyless and the
first cross-core authentication recurses through its own panic path;
* portability work upstream has not needed before: CONFIG_VMAPPLE was gated
on HVF and shipped off, hw/vmapple/aes.c has a VLA that only compiled
under clang, and the architectural op1-to-minimum-EL assertion rejects
Apple's IMPDEF registers.
The GPU is steelbrain/reims-vgpu, carried as a submodule pinned to the commit
this was tested against; the two changes it needs are in patches/reims-vgpu/.
The AVPBooter patch is NyanSatan's, from Virtual-iBoot-Fun.
Nothing Apple ships is in this repository. The macOS image is fetched from a
public tart image, and Apple's VM firmware is extracted from that image, where
Virtualization.framework carries it -- so no Mac is involved in the setup.
Measured on the reference host: desktop in 75 s at 12 vCPUs and 10 GB.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Youssef <soosef.youssef@gmail.com>
131 lines
3.8 KiB
Makefile
131 lines
3.8 KiB
Makefile
QEMU_VENV_DIR=.dev-venv
|
|
QEMU_MINVENV_DIR=.min-venv
|
|
QEMU_TOX_EXTRA_ARGS ?=
|
|
|
|
.PHONY: help
|
|
help:
|
|
@echo "python packaging help:"
|
|
@echo ""
|
|
@echo "make check-minreqs:"
|
|
@echo " Run tests in the minreqs virtual environment."
|
|
@echo " These tests use the oldest dependencies."
|
|
@echo " Requires: Python 3.12"
|
|
@echo " Hint (Fedora): 'sudo dnf install python3.12'"
|
|
@echo ""
|
|
@echo "make check-tox:"
|
|
@echo " Run tests against multiple python versions."
|
|
@echo " These tests use the newest dependencies."
|
|
@echo " Requires: Python 3.12 - 3.14, and tox."
|
|
@echo " Hint (Fedora): 'sudo dnf install python3-tox python3.14'"
|
|
@echo " The variable QEMU_TOX_EXTRA_ARGS can be use to pass extra"
|
|
@echo " arguments to tox".
|
|
@echo ""
|
|
@echo "make check-dev:"
|
|
@echo " Run tests in a venv against your default python3 version."
|
|
@echo " These tests use the newest dependencies."
|
|
@echo " Requires: Python 3.x"
|
|
@echo ""
|
|
@echo "make check:"
|
|
@echo " Run tests in your *current environment*."
|
|
@echo " Performs no environment setup of any kind."
|
|
@echo ""
|
|
@echo "make develop:"
|
|
@echo " Install deps needed for 'make check',"
|
|
@echo " and install the qemu package in editable mode."
|
|
@echo " (Can be used in or outside of a venv.)"
|
|
@echo ""
|
|
@echo "make min-venv"
|
|
@echo " Creates the minreqs virtual environment ($(QEMU_MINVENV_DIR))"
|
|
@echo ""
|
|
@echo "make dev-venv"
|
|
@echo " Creates a simple venv for check-dev. ($(QEMU_VENV_DIR))"
|
|
@echo ""
|
|
@echo "make clean:"
|
|
@echo " Remove package build output."
|
|
@echo ""
|
|
@echo "make distclean:"
|
|
@echo " remove venv files, qemu package forwarder,"
|
|
@echo " built distribution files, and everything from 'make clean'."
|
|
@echo ""
|
|
@echo -e "Have a nice day ^_^\n"
|
|
|
|
.PHONY: pipenv check-pipenv
|
|
pipenv check-pipenv:
|
|
@echo "pipenv was dropped; try 'make check-minreqs' or 'make min-venv'"
|
|
@exit 1
|
|
|
|
PIP_INSTALL = pip install --disable-pip-version-check
|
|
.PHONY: min-venv
|
|
min-venv: $(QEMU_MINVENV_DIR) $(QEMU_MINVENV_DIR)/bin/activate
|
|
$(QEMU_MINVENV_DIR) $(QEMU_MINVENV_DIR)/bin/activate: setup.cfg tests/minreqs.txt
|
|
@echo "VENV $(QEMU_MINVENV_DIR)"
|
|
@python3.12 -m venv $(QEMU_MINVENV_DIR)
|
|
@( \
|
|
echo "ACTIVATE $(QEMU_MINVENV_DIR)"; \
|
|
. $(QEMU_MINVENV_DIR)/bin/activate; \
|
|
echo "INSTALL -r tests/minreqs.txt $(QEMU_MINVENV_DIR)";\
|
|
$(PIP_INSTALL) -r tests/minreqs.txt 1>/dev/null; \
|
|
echo "INSTALL -e qemu $(QEMU_MINVENV_DIR)"; \
|
|
PIP_CONFIG_SETTINGS="editable_mode=compat" $(PIP_INSTALL) -e . 1>/dev/null; \
|
|
)
|
|
@touch $(QEMU_MINVENV_DIR)
|
|
|
|
.PHONY: check-minreqs
|
|
check-minreqs: min-venv
|
|
@( \
|
|
echo "ACTIVATE $(QEMU_MINVENV_DIR)"; \
|
|
. $(QEMU_MINVENV_DIR)/bin/activate; \
|
|
make check; \
|
|
)
|
|
|
|
.PHONY: dev-venv
|
|
dev-venv: $(QEMU_VENV_DIR) $(QEMU_VENV_DIR)/bin/activate
|
|
$(QEMU_VENV_DIR) $(QEMU_VENV_DIR)/bin/activate: setup.cfg
|
|
@echo "VENV $(QEMU_VENV_DIR)"
|
|
@python3 -m venv $(QEMU_VENV_DIR)
|
|
@( \
|
|
echo "ACTIVATE $(QEMU_VENV_DIR)"; \
|
|
. $(QEMU_VENV_DIR)/bin/activate; \
|
|
echo "INSTALL qemu[devel] $(QEMU_VENV_DIR)"; \
|
|
make develop 1>/dev/null; \
|
|
)
|
|
@touch $(QEMU_VENV_DIR)
|
|
|
|
.PHONY: check-dev
|
|
check-dev: dev-venv
|
|
@( \
|
|
echo "ACTIVATE $(QEMU_VENV_DIR)"; \
|
|
. $(QEMU_VENV_DIR)/bin/activate; \
|
|
make check; \
|
|
)
|
|
|
|
.PHONY: develop
|
|
develop:
|
|
PIP_CONFIG_SETTINGS="editable_mode=compat" $(PIP_INSTALL) -e .[devel]
|
|
|
|
.PHONY: check
|
|
check:
|
|
@pytest -v tests/*.py
|
|
|
|
.PHONY: check-tox
|
|
check-tox:
|
|
@tox $(QEMU_TOX_EXTRA_ARGS)
|
|
|
|
.PHONY: check-coverage
|
|
check-coverage:
|
|
@coverage run -m pytest -v tests/*.py
|
|
@coverage combine
|
|
@coverage html
|
|
@coverage report
|
|
|
|
.PHONY: clean
|
|
clean:
|
|
python3 setup.py clean --all
|
|
rm -f pyproject.toml
|
|
|
|
.PHONY: distclean
|
|
distclean: clean
|
|
rm -rf qemu.egg-info/ .eggs/ dist/
|
|
rm -rf $(QEMU_VENV_DIR) $(QEMU_MINVENV_DIR) .tox/
|
|
rm -f .coverage .coverage.*
|
|
rm -rf htmlcov/
|