How riftaway7-code/anathema works
Anathema is a research project for booting an arm64 macOS virtual-machine kernel on x86-64. Its principal path is preparing macOS media, installing the loader to USB, gathering hardware readiness information, then loading the kernel and device tree and executing them in the virtual arm64 runtime. The runtime combines translation, memory management, and virtual devices. The graph also preserves the documented media-tooling and installer capabilities. Some subsystem wiring is documented only at README level; dashed edges mark relationships not verified in excerpts.
Main entry points: src/main.rs IPSW tools · machine.rs ARM machine · src/main.rs UEFI menu · mem.rs RAM and bus
Components 34
Media tooling
- IPSW tools
crates/anathema-media/src/main.rs - Feed and download
crates/anathema-media/src/download.rs - ZIP and plist
crates/anathema-media/src/zip.rs - IM4P unwrap
crates/anathema-media/src/im4p.rs - AEA decrypt
crates/anathema-media/src/aea.rs - APFS reader
crates/anathema-media/src/apfs.rs - dyld cache reader
crates/anathema-media/src/dsc.rs
USB installer
- Installer UI
crates/anathema-setup/src/main.rs - Disk installer
crates/anathema-setup/src/install.rs - Disk operations
crates/anathema-setup/src/disk.rs
UEFI loader
- UEFI menu
crates/anathema-boot/src/main.rs - Hardware inventory
crates/anathema-boot/src/report.rs - Readiness check
crates/anathema-boot/src/readiness.rs - Hardware bring-up
crates/anathema-boot/src/bringup/mod.rs - APIC and SMP
crates/anathema-boot/src/bringup/apic.rs - NVMe and GPT
crates/anathema-boot/src/bringup/nvme.rs - macOS loader
crates/anathema-boot/src/macboot.rs - exFAT reader
crates/anathema-boot/src/exfat.rs
Virtual machine
- Runtime harness
crates/anathema-rt/src/main.rs - ARM machine
crates/anathema-rt/src/machine.rs - RAM and bus
crates/anathema-rt/src/mem.rs - Software MMU
crates/anathema-rt/src/mmu.rs - GICv3
crates/anathema-rt/src/gic.rs - PCIe virtio
crates/anathema-rt/src/pci.rs - AES device
crates/anathema-rt/src/aesdev.rs - SIMD fallbacks
crates/anathema-rt/src/simd.rs - Mach-O loader
crates/anathema-rt/src/macho.rs
Instruction translation
- AArch64 decoder
crates/anathema-xlat/src/decode.rs - x86 emitter
crates/anathema-xlat/src/trans.rs - Block runner
crates/anathema-xlat/src/run.rs
Other components
- Operator
- macOS IPSW
- USB stick
- x86-64 host
Connections 35
- Operator → IPSW tools: prepares media
README.md - macOS IPSW → IPSW tools: provides image
README.md - IPSW tools → Feed and download: uses
README.md - IPSW tools → ZIP and plist: unpacks
README.md - IPSW tools → IM4P unwrap: unwraps
README.md - IPSW tools → AEA decrypt: decrypts
README.md - IPSW tools → APFS reader: reads
README.md - IPSW tools → dyld cache reader: reads
README.md - Operator → Installer UI: starts installation
README.md - Installer UI → Disk installer: starts install
crates/anathema-setup/src/main.rs - Disk installer → Disk operations: writes drive
crates/anathema-setup/src/install.rs - Disk installer → USB stick: prepares
README.md - USB stick → UEFI menu: boots
README.md - x86-64 host → UEFI menu: starts UEFI app
README.md - UEFI menu → Hardware inventory: collects report
crates/anathema-boot/src/main.rs - Hardware inventory → Readiness check: supplies inventory
crates/anathema-boot/src/main.rs - UEFI menu → Hardware bring-up: runs test
crates/anathema-boot/src/main.rs - Hardware bring-up → APIC and SMP: uses
crates/anathema-boot/src/bringup/mod.rs - Hardware bring-up → NVMe and GPT: uses
crates/anathema-boot/src/bringup/mod.rs - UEFI menu → macOS loader: dispatches boot
crates/anathema-boot/src/main.rs - macOS loader → exFAT reader: reads RAM disk
README.md - macOS loader → Runtime harness: runs runtime
README.md - Runtime harness → Mach-O loader: loads kernel image
crates/anathema-rt/src/main.rs - Runtime harness → ARM machine: executes guest
crates/anathema-rt/src/main.rs - ARM machine → RAM and bus: accesses memory bus
crates/anathema-rt/src/machine.rs - ARM machine → Software MMU: translates addresses
crates/anathema-rt/src/machine.rs - ARM machine → AES device: dispatches device I/O
crates/anathema-rt/src/machine.rs - ARM machine → PCIe virtio: dispatches PCI I/O
crates/anathema-rt/src/machine.rs - RAM and bus → GICv3: routes register access
crates/anathema-rt/src/mem.rs - RAM and bus → AES device: backs device DMA
crates/anathema-rt/src/aesdev.rs - RAM and bus → PCIe virtio: backs device access
crates/anathema-rt/src/pci.rs - ARM machine → SIMD fallbacks: uses fallbacks
README.md - ARM machine → Block runner: runs translated blocks
README.md - Block runner → x86 emitter: requests translation
README.md - x86 emitter → AArch64 decoder: decodes instructions
crates/anathema-xlat/src/trans.rs