Porting System 7.5.3 to A/UX
A/UX 3.1 is Apple’s Unix for 68k Macs, and its Mac side is stuck at System 7.0.1. It was never updated; Apple moved on to other things (MAE on Solaris and HP-UX, and eventually Copland and Rhapsody, and we all know how those went).
It turns out 7.5.3 can run as the A/UX Mac environment, with a surprisingly small set of patches - and Apple had already done most of the homework for us, in a product almost nobody used.
This post covers how the port came together, what didn’t work along the way, and the patcher that builds it from your own copies of Apple’s files. The patcher is available at the end.
Like the Carrera040 work, a lot of this was done with bot assistance - disassembling, diffing thousands of resources, and grinding through test boots. If that’s a deal breaker for you, I get it.
How A/UX runs the Mac
A/UX doesn’t run Mac OS on the bare hardware. The Toolbox runs as an ordinary Unix user process, startmac, on top of the machine’s ROM:
- Anything that touches hardware goes through the kernel. Mac drivers are split in two: the Mac-facing half stays in the user process, and the hardware half is a kernel driver.
- Most of the A/UX glue lives in
/mac/lib/Patches:Patch.0178for the Mac II/IIx/SE/30 ROM andPatch.067Cfor the Universal ROM. Each is a ~480 KB m68k COFF executable with its symbol table intact, which made reading them much easier. - There are two System Folders. The HFS boot partition runs a near-stock System 7.1, only to boot the machine and launch A/UX Startup. The one that matters is
/mac/sys/System Folderon the Unix side, and that’s 7.0.1.TBSYSTEMpicks which System Folderstartmacruns, which means an experimental System can be tested without touching the working one.
Apple already did this once
The plan started as “port 7.5.3” and changed when the bot dug into MAE 3.0.4, Apple’s Macintosh Application Environment for Solaris. MAE is the A/UX Mac layer moved to another Unix host, and MAE 3 runs System 7.5.3.
The Solaris package is a byte-swapped cpio archive, and 1,474 of the code resources in its System Folder are 42-byte placeholders pointing into a separate data file. Rebuilding them restored 4,399 resources, and a complete 7.5.3 System Folder.
Diffing that against a stock 7.5.3 install (from the Infinite Mac images) showed:
- MAE’s System file is essentially stock: 1,333 of 1,382 resources are byte-identical.
- All of Apple’s changes for running under a Unix host are in the MAE Enabler, which is Apple’s own System 7.5 Update, stripped and patched: a few hundred bytes of Process Manager changes, the boot code, and about a dozen patches.
So the target became 7.5.3, with MAE as a map of what Apple had to change.
Measuring the A/UX delta
The next step was finding what A/UX changed in its own 7.0.1, by diffing it against stock 7.0.1. It’s a surprisingly short list:
- The Process Manager: 13 of 14
scodresources, about 11 KB in all, plus a new 2.4 KB A/UX glue module that launches and switches Unix (COFF) processes through_AUXDispatch. boot 2: extension loading bracketed byAUX_SECONDARY_INITcalls, and the cache flush and_InitApplZoneremoved.- Two sound-related
procresources.
Everything hardware-related is in the Patches files, not in the System. Reading Patch.067C showed what it needs from the System file, and the only version checks are “at least $0700”, with no upper limit. 7.5.3 passes all seven.
Test boots
All of the testing was done in QEMU on a Quadra 800, with a harness that installed each candidate System Folder and ran startmac with debug logging:
| Test | System Folder | Result |
|---|---|---|
| baseline | A/UX 3.1 stock | Finder, System 7.0.1 |
| t2 | stock, unpatched 7.5.3 + A/UX Finder and extensions | Boots to the Finder! CommandShell fails (no COFF launch) |
| t3 | + Apple’s System 7.5 Update | Bus error at the startup screen |
| t4 | + an “A/UX Enabler”: the Update minus everything MAE removed | Bus error |
| t5 | … minus all the remaining gpch |
Bus error |
| t6 | … with boot 3 and lpch 31 from MAE |
Boots, with the enabler loaded |
The fact that an unmodified 7.5.3 System booted under startmac on the first try was a pleasant surprise. The System 7.5 Update was the problem, and its boot 3 was the culprit; MAE’s Unix-hosted versions work.
Things that went sideways
- The tar checksum. A/UX’s System V tar uses signed char header checksums, so any file with a Mac Roman character in its name failed with “directory checksum error”. The test harness had to write signed checksums.
- “Out of date”. When
startmaccouldn’t open the System file at all, A/UX reported the folder as “out of date”. Let’s not discuss how much time was spent looking for a version check that wasn’t there. - The planned Process Manager port didn’t happen. The plan was to port A/UX’s scheduling changes into 7.5.3’s Process Manager. It turned out A/UX’s own 7.0.1 Process Manager runs unchanged inside the 7.5.3 System, so swapping it in was way simpler.
- Missing Apple menu items. The Finder would randomly drop Apple-menu picks such as CommandShell. 7.5.3’s PPC port-name resource has two strings where A/UX’s code expects three, so local Apple events went out with a garbage sender location.
- The startup screen. A/UX’s Toolbox swallows the “Welcome to Macintosh” SysError, so 7.5.3’s startup screen never appears. Patching that one compare in
Patch.067Cmakes it show up, progress bar and all… and afterwards Calculator crashes with error 10. That one stays in the experimental folder.
The patches
aux753patch.py builds two files from your own copies of Apple’s files: a 7.5.3 System and an AUX Enabler.
System:
| Resource | Change | Why |
|---|---|---|
scod -16479..-16460 |
A/UX’s Process Manager | A/UX process layers, COFF launch and _AUXDispatch |
scod -16462 |
PPC init reads strings 1 and 2 of STR# -16415 |
the missing Apple-menu picks |
scod -16461 |
GetMinTimeout capped at 60 ticks |
A/UX’s idle behaviour |
MDEF 0 |
A/UX’s | the Apple-menu icons |
ptch 32 |
RESET becomes NOP |
InitGraf checks the ROM copyright string and executes RESET on anything but a IIx-era ROM; under A/UX that’s a privilege violation that recurses until the stack overflows |
gpch 666 |
one mask byte | an init for IIci/IIfx-style ROMs called _SoundDispatch before A/UX provides it (“unimplemented trap”) |
gusd 1 |
SE/30 patch class 3 -> 5 | SE/30s with a 32-bit-clean ROM only, see below |
AUX Enabler (from the System 7.5 Update): the Process Manager, hardware patches and drivers that A/UX supplies itself are removed, and boot 3 and lpch 31 come from MAE 3.0.
The SE/30
The SE/30 has a couple of extra wrinkles. With a 32-bit-clean ROM like the BMOW ROM SIMM, A/UX’s SE/30 machine record would still make 7.5.3 load the patches meant for the original SE/30 ROM. The fix is Gamba’s technique from running OS 8 on the SE/30: move the SE/30 to the IIci/IIfx/IIsi patch class in gusd 1.
The emulator found one more difference. The gpch loader picks ROM-specific code by feature bits, and the BMOW ROM (IIsi-based) and a IIfx ROM get different bits. So the IIfx ROM in the emulator crashed where the real BMOW ROM didn’t. The gpch 666 fix makes both behave the same.
The end result runs on a Quadra 650 and an SE/30 in QEMU, and on the real SE/30 with the Carrera040 and BMOW ROM. Getting A/UX itself to start on the Carrera was a much bigger job: see A/UX on the Carrera040.

System 7.5.3 under A/UX on the real SE/30, with the “Macintosh” model name and 16,384K total memory from the known issues below.
Known issues
- About This Macintosh shows the model as “Macintosh” and Total Memory as 16,384K.
- The copyright line reads 1983-1993.
- No 7.5.3 startup screen, unless you use the experimental patch (and give up Calculator).
Download
aux-system753.tar.gz contains aux753patch.py, build_both.sh (builds the Quadra-class and SE/30 variants in one go) and the experimental greeting patch. No Apple code is included: you need a stock 7.5.3 System and System 7.5 Update, the System from MAE 3.0.x, and A/UX 3.1’s own System.
python3 aux753patch.py \
--system753 "753.dsk::System Folder:System" \
--update753 "753.dsk::System Folder:System 7.5 Update" \
--mae-system "MAE.dsk::System Folder:System" \
--aux-system System.aux701 --out out --se30-universal-rom
Leave out --se30-universal-rom except on an SE/30 with a 32-bit-clean ROM. To install, make a new System Folder with A/UX’s Finder and extensions plus the two output files, and point TBSYSTEM at it. Keep A/UX’s 7.0.1 System Folder as a fallback.