mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-01 00:27:20 -05:00
Abdessamad Derraz
3199bc2a55
Each standalone profile records where its version is read: the source at its pin (clk 2026-07-23-136-g9020107, shadps4 0.20.1 WIP, eden v0.2.0-401-g26a03d2), the APK, binary or archive read (kind package), or, where no reading can be made, kind unverified with the reason: a host the tools cannot read, a forge gone or not answering, no build recorded as read, a pin on another branch. Those keep their value, unconfirmed.
97 lines
4.9 KiB
YAML
97 lines
4.9 KiB
YAML
emulator: SheepShaver
|
|
type: standalone
|
|
core_classification: other
|
|
source: "https://github.com/cebix/macemu"
|
|
upstream: "https://github.com/cebix/macemu"
|
|
profiled_date: "2026-08-08"
|
|
source_commit: "96e512bd6376e78a2869f16dcc8a9028bce5ee72"
|
|
core_version: "2.4"
|
|
version_basis:
|
|
kind: file
|
|
path: "SheepShaver/src/include/version.h"
|
|
pattern: 'const int VERSION_MAJOR = (\d+);\s*\nconst int VERSION_MINOR = (\d+);'
|
|
format: "{1}.{2}"
|
|
display_name: "Apple - Macintosh PowerPC (SheepShaver)"
|
|
cores:
|
|
- sheepshaver
|
|
systems:
|
|
- apple-macintosh
|
|
mode: standalone
|
|
|
|
notes: |
|
|
PowerPC Macintosh emulator living in the macemu tree alongside Basilisk II,
|
|
version 2.4 (version.h:24-25). Runs MacOS 7.5.2 through 9.0.4 (README.md) on
|
|
a PCI PowerMac or NewWorld ROM image.
|
|
|
|
ROM loading (main_unix.cpp:581-613, main_windows.cpp:329-360): the path comes
|
|
from the "rom" prefs item (prefs_items.cpp:45). When that is empty, the file
|
|
named ROM is opened, then the file named Mac OS ROM (main_unix.cpp:162-163,
|
|
main_windows.cpp:58-59). Neither found raises STR_NO_ROM_FILE_ERR and
|
|
main_unix.cpp:987 aborts startup. The filename does not select the format:
|
|
both names go through the same decoder.
|
|
|
|
At most ROM_SIZE = 0x400000 bytes are read (cpu_emulation.h:30). DecodeROM
|
|
(rom_patches.cpp:148-200) accepts two forms. A read of exactly 4 MB is taken
|
|
as a plain image and copied as is. A buffer opening on <CHRP-BOOT> is
|
|
decompressed instead, either LZSS through the lzss-offset and lzss-size
|
|
constants (decode_lzss, rom_patches.cpp:80) or parcel by parcel through
|
|
parcels-offset and parcels-size (decode_parcels, rom_patches.cpp:123).
|
|
Anything else fails, and main_unix.cpp:602-609 picks the message from the
|
|
file size on disk: STR_ROM_SIZE_ERR when it is not 4 MB,
|
|
STR_ROM_FILE_READ_ERR otherwise (user_strings.cpp:66-67).
|
|
|
|
PatchROM (rom_patches.cpp:671-731), called from InitAll at main.cpp:161,
|
|
reads the nanokernel ID at offset 0x30d064 of the decoded image and accepts
|
|
Boot TNT, Boot Alchemy, Boot Zanzibar, Boot Gazelle, Boot Gossamer and
|
|
NewWorld (rom_patches.cpp:682-695). Any other string raises
|
|
STR_UNSUPPORTED_ROM_TYPE_ERR. The free space checks at
|
|
rom_patches.cpp:698-707 and the four patch passes at rom_patches.cpp:710-713
|
|
then rewrite the image in memory, and rom_patches.cpp:729 copies its last
|
|
megabyte past the 4 MB mark for the 68k emulator. Nothing is checksummed:
|
|
the ROM checksum at offset 0 is only printed by a debug build
|
|
(rom_patches.cpp:674).
|
|
|
|
MacOS itself and the applications live in disk images referenced by the
|
|
disk, floppy and cdrom prefs items, supplied by the user.
|
|
|
|
Two files are installed by the emulator's own Makefile into
|
|
$(datadir)/SheepShaver (Makefile.in:21,162-164) and read from there:
|
|
keycodes keycode to Mac keycode table, read only when the keycodes
|
|
prefs item is true, which defaults to false
|
|
(prefs_unix.cpp:117). Overridable with keycodefile.
|
|
configure.ac:754,775 picks ../SDL/keycodes or keycodes
|
|
according to the video backend. video_x.cpp:79,1200,
|
|
video_sdl2.cpp:97,1231
|
|
tunconfig script run to configure the tunN interface for ethernet.
|
|
Overridable with etherconfig. ether_unix.cpp:108,381
|
|
The SDL2 backend falls back to BasiliskII_keycodes in the same directory
|
|
(video_sdl2.cpp:98,1232).
|
|
|
|
The preferences file (.sheepshaver_prefs, prefs_unix.cpp:49, or
|
|
SheepShaver_prefs, prefs_windows.cpp:66) and the NVRAM file
|
|
(.sheepshaver_nvram, xpram_unix.cpp:30, or SheepShaver_nvram.dat,
|
|
xpram_windows.cpp:31) are written by the emulator when absent. Passing a
|
|
.sheepvm directory on the command line reads the preferences from inside it
|
|
instead (main_unix.cpp:371-384, prefs_unix.cpp:57-69).
|
|
|
|
files:
|
|
- name: ROM
|
|
aliases: ["Mac OS ROM"]
|
|
required: true
|
|
validation: [size, signature]
|
|
min_size: 377670
|
|
description: "PowerPC Macintosh ROM, 4 MB PCI PowerMac image or CHRP-BOOT Mac OS ROM"
|
|
source_ref: "SheepShaver/src/Unix/main_unix.cpp:162-163,585-610,987, SheepShaver/src/Windows/main_windows.cpp:58-59,330-344, SheepShaver/src/rom_patches.cpp:80-120,148-200,671-707, SheepShaver/src/main.cpp:161"
|
|
note: >
|
|
DecodeROM takes a 4 MB read as a plain image and any shorter file only
|
|
through the <CHRP-BOOT> header. The check every accepted image passes is
|
|
the nanokernel ID at offset 0x30d064 of the decoded 4 MB image, which
|
|
PatchROM matches against Boot TNT, Boot Alchemy, Boot Zanzibar, Boot
|
|
Gazelle, Boot Gossamer and NewWorld. That bounds the size from below.
|
|
decode_lzss turns 17 input bytes into at most 144 output bytes, so a
|
|
stream that reaches the end of the shortest ID (0x30d06c bytes) is at
|
|
least 377670 bytes long. A 128 KB or 256 KB file is never a SheepShaver
|
|
ROM. The Mac OS ROM file of a Mac OS 8.5 or 8.6 System Folder is used as
|
|
it is: its data fork is the <CHRP-BOOT> image, the resource fork carries
|
|
only icons and version strings.
|