Skip to content

History / Debugging Recipes

Revisions

  • Write the wiki: 47 pages covering theory, guides and reference Seeds the wiki with the full structure rather than an outline. Five groups of pages, each written to be read by a person rather than consulted by a tool: Theory (11) Open Firmware, ARC, the veneer, the NT boot chain, the HAL contract, the NT PowerPC ABI, little-endian PowerPC, the video stack, how Setup chooses a HAL, and why any of this is hard Emulator (10) getting Granny Smith through to capturing and booting an installed image Debugging (5) the emulator shell, bugchecks, reading NT binaries, recipes, and what to do when the instrumentation itself is lying to you Hardware (4) what is known and unknown about real machines, what would have to change, serial consoles, and the risks Machines (4) the Network Server, the TNT desktops, PReP reference systems Reference (6) ARC variables, the address and interrupt map, error codes seen, HAL exports, the veneer patch catalogue, the VrDebug bitmask Project (5) status and roadmap, the ledger of workarounds, provenance, contributing, the story Plus Home, FAQ, Glossary, _Sidebar and _Footer. Everything here is drawn from this repository's own STORY.md, docs/ write-ups, tools and PR descriptions. No page reproduces Microsoft, Apple or third-party documentation; where a fact came from someone else's work it is attributed on the provenance page. The status claims are deliberately conservative and the workarounds are stated where a reader would otherwise be misled - in particular the VideoPortVerifyAccessRanges bypass that graphics-mode Setup currently depends on.

    @pappadf pappadf committed Sep 14, 2026