feat: collect firmware and flagged backlog files

emulators/beetle_saturn.yml

@@ -6,17 +6,18 @@ source: "https://github.com/libretro/beetle-saturn-libretro"
 upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "65f05fa66f83e65e33be83aa433d883b4fd9509a"
-core_version: "v0.9.45.1"
+core_version: "v1.32.1"
 display_name: "Sega - Saturn (Beetle Saturn)"
 cores:
   - mednafen_saturn
   - beetle-saturn
 systems:
   - sega-saturn
+  - sega-stv
 
 notes: |
-  Libretro port of Mednafen's Saturn emulation module, frozen circa v0.9.45.1
-  (2017) with some later backports. Region auto-detection reads the disc header
+  Libretro port of Mednafen's Saturn emulation module, converted to C and
+  reporting v1.32.1 (libretro.c:57). Region auto-detection reads the disc header
   and selects the matching BIOS. Manual override via beetle_saturn_region option.
 
   InitCommon() returns false if the BIOS file is missing or not exactly 512 KB.
@@ -25,8 +26,24 @@ notes: |
   KOF95 and Ultraman ROM carts are loaded when the cart type is set via core
   option or auto-detected from the internal game database.
 
-  Upstream Mednafen (1.32.x) has ST-V arcade board support (3 additional BIOS
-  files) and bootable ROM cart support, both absent from this libretro port.
+  ST-V content is a game ZIP or a bare ROM matched against the ST-V game
+  table (libretro.c:1207-1227, libretro.c:1261-1281). The cabinet region of
+  the matched game selects one of three ST-V BIOS images
+  (mednafen/ss/ss.c:1829-1843), read as a bare file from the system directory
+  or, when that file is absent, as the member of the same name in stvbios.zip
+  there (mednafen/ss/ss.c:1875-1942). Either form may be 131072 or 524288
+  bytes (mednafen/ss/ss.c:1911-1912, mednafen/ss/ss.c:1962).
+
+  The Video CD Card is driven through the CD block. With the
+  beetle_saturn_mpeg_card option enabled, CDB_Init opens mpeg_card.bin in the
+  system directory and MPEG_Init keeps up to 0x80000 bytes of it; without the
+  ROM the card answers commands but does not authenticate
+  (libretro.c:578-586, mednafen/settings.c:68-69, mednafen/ss/cdb.c:1315-1332,
+  mednafen/ss/mpeg.c:423-450).
+
+  No setting names a file for the bootable ROM cart: ss.cart.bootrom_path
+  has no value in the port (mednafen/ss/cart.c:242-262,
+  mednafen/settings.c:60-71).
 
 files:
   - name: "sega_101.bin"
@@ -61,9 +78,43 @@ files:
     note: "Ultraman expansion ROM cart. Loaded when cart type set to Ultraman."
     source_ref: "mednafen/ss/cart.c:200-215 (firmware path + open), mednafen/ss/cart/rom.c:51 (CART_ROM_Init)"
 
+  - name: "epr-20091.ic8"
+    system: sega-stv
+    region: [japan, asia-ntsc]
+    required: true
+    size: [131072, 524288]
+    validation: [size]
+    note: "ST-V BIOS for Japan and Asia NTSC cabinets. Read from stvbios.zip when the bare file is absent."
+    source_ref: "mednafen/ss/ss.c:1838-1839 (region filename), mednafen/ss/ss.c:1871-1988 (open, zip fallback, size check, read, sha256)"
+
+  - name: "epr-17952a.ic8"
+    system: sega-stv
+    region: [north-america, brazil, latin-america]
+    required: true
+    size: [131072, 524288]
+    validation: [size]
+    note: "ST-V BIOS for North America and Central and South America cabinets. Read from stvbios.zip when the bare file is absent."
+    source_ref: "mednafen/ss/ss.c:1840-1841 (region filename), mednafen/ss/ss.c:1871-1988 (open, zip fallback, size check, read, sha256)"
+
+  - name: "epr-17954a.ic8"
+    system: sega-stv
+    region: [europe, south-korea, asia-pal]
+    required: true
+    size: [131072, 524288]
+    validation: [size]
+    note: "ST-V BIOS for every other cabinet region. Read from stvbios.zip when the bare file is absent."
+    source_ref: "mednafen/ss/ss.c:1842-1843 (region filename), mednafen/ss/ss.c:1871-1988 (open, zip fallback, size check, read, sha256)"
+
+  - name: "mpeg_card.bin"
+    system: sega-saturn
+    required: false
+    note: "Video CD Card firmware, opened when beetle_saturn_mpeg_card is enabled. At most 0x80000 bytes are kept and nothing is checked; without it the card does not authenticate."
+    source_ref: "mednafen/settings.c:68-69 (filename), mednafen/ss/cdb.c:1315-1332 (open), mednafen/ss/mpeg.c:423-450 (read)"
+
   - name: "satar4mp.bin"
     system: sega-saturn
     required: false
-    size: 262144
-    note: "Action Replay 4M Plus firmware. Unfinished in source (mednafen/ss/cart/ar4mp.c:22-24), needs CPU UBC emulation. Cart type not exposed in core options."
-    source_ref: "mednafen/ss/cart.c:218 (CART_AR4MP case), mednafen/ss/cart/ar4mp.c:150 (CART_AR4MP_Init)"
+    min_size: 262144
+    validation: [size]
+    note: "Action Replay 4M Plus firmware. The first 0x40000 bytes are read as big-endian words and a shorter file leaves the cart slot empty; no hash is checked. Unfinished in source (mednafen/ss/cart/ar4mp.c:22-24), needs CPU UBC emulation. Neither the beetle_saturn_cart option (libretro.c:512-530) nor the game table of mednafen/ss/db.c yields CART_AR4MP, so the case is not reached."
+    source_ref: "mednafen/settings.c:66-67 (filename), mednafen/ss/cart.c:218-236 (CART_AR4MP case), mednafen/ss/cart/ar4mp.c:181 (0x40000-byte read)"

emulators/dosbox-staging.yml

@@ -73,10 +73,15 @@ notes: |
   ref: src/midi/soundcanvas.cpp:55-71, 80-147, Nuked-SC55-CLAP plugin.cpp:23-90
 
   FluidSynth: the soundfont setting names a file, tried as given and with .sf2
-  appended, in soundfont_dir, then soundfonts in the configuration directory,
-  then the platform locations. fluid_synth_sfload is the only check. The
-  SoundFont name from the RIFF INFO chunk and the file stem select reverb,
-  chorus and filter presets for four known banks.
+  appended, in soundfont_dir, then in the platform locations. Those are
+  soundfonts in the configuration directory and C:\soundfonts on Windows, the
+  same directory and ~/Library/Audio/Sounds/Banks on macOS, and elsewhere
+  dosbox/soundfonts, soundfonts and sounds/sf2 under the XDG data home,
+  soundfonts and sounds/sf2 under each XDG data directory, then soundfonts in
+  the configuration directory. fluid_synth_sfload is the only check. The
+  SoundFont name from the RIFF INFO chunk and the stem of the file, symbolic
+  links resolved, select reverb, chorus and filter presets for four known
+  banks.
   ref: src/midi/fluidsynth.cpp:107-230, 672-689, 816-883, 1229-1252
 
   Bundled data ships with the program and is read from the resources directory
@@ -590,14 +595,17 @@ files:
     path: "soundfonts/default.sf2"
     description: "SoundFont named by the default soundfont setting"
     required: false
-    unsourceable: "name the operating system gives the SoundFont it installs as default, not shipped with the program; a same-named file of another program must not stand in"
+    unsourceable: "a link the operating system creates to the SoundFont it installs as default, FluidR3_GM.sf2 on Fedora; no file of this name is distributed, and a same-named file of another program must not stand in"
     note: >
       default value of the soundfont setting: the name picks the default
       SoundFont when the operating system installs one, usually Fluid R3.
+      Where it exists the name is a link, found as soundfonts/default.sf2
+      under an XDG data directory; the link is resolved before the name
+      test, so a link to FluidR3_GM.sf2 is identified as Fluid R3.
       Any SoundFont loads; GeneralUser GS, Fluid R3, the AWE32 4MB GM/GS/MT
       bank and the Trevor0402 SC-55 SoundFont are recognised by filename or
       RIFF INFO name and get their own reverb, chorus and filter presets
-    source_ref: "src/midi/fluidsynth.cpp:672-689, src/midi/fluidsynth.cpp:816-883, src/midi/fluidsynth.cpp:1227-1242"
+    source_ref: "src/midi/fluidsynth.cpp:133-154, src/midi/fluidsynth.cpp:672-689, src/midi/fluidsynth.cpp:816-883, src/midi/fluidsynth.cpp:1227-1242"
 
   - name: "GeneralUser-GS.sf2"
     path: "soundfonts/GeneralUser-GS.sf2"

emulators/dosbox-x.yml

@@ -267,13 +267,15 @@ files:
   - name: "default.sf2"
     description: "SoundFont the operating system installs as FluidSynth default"
     required: false
-    unsourceable: "probed at fixed operating system paths, where the system's own SoundFont sits; a same-named file of another program must not stand in"
+    unsourceable: "a link the operating system creates to the SoundFont it installs as default, FluidR3_GM.sf2 on Fedora; no file of this name is distributed, and a same-named file of another program must not stand in"
     note: >
       first probe when fluid.soundfont is empty:
       /usr/share/soundfonts/default.sf2, or C:\soundfonts\default.sf2 on
-      Windows. Any SF2 or SF3 file loads; fluid.soundfont names it and
+      Windows. The source marks the first path as the Red Hat and Fedora
+      one, where the name links to FluidR3_GM.sf2, the file of the second
+      probe. Any SF2 or SF3 file loads; fluid.soundfont names it and
       fluid_synth_sfload is the only check
-    source_ref: "src/gui/midi_synth.h:346-352, src/gui/midi_synth.h:366-368, src/gui/midi_synth.h:381-384, src/gui/midi_synth.h:462-473, src/dosbox.cpp:3746-3747"
+    source_ref: "src/gui/midi_synth.h:346-352, src/gui/midi_synth.h:364-368, src/gui/midi_synth.h:381-384, src/gui/midi_synth.h:462-473, src/dosbox.cpp:3746-3747"
 
   - name: "FluidR3_GM.sf2"
     description: "Fluid R3 GM SoundFont by Frank Wen"

emulators/dosbox.yml

@@ -207,7 +207,7 @@ files:
     aliases: ["rom2.bin", "ROM2_ST.BIN", "rom2_st.bin"]
     description: "SC-55 family program ROM 2"
     required: false
-    size_options: [262144, 524288]
+    size: [262144, 524288]
     validation: [size]
     mode: libretro
     source_ref: "src/gui/midi_sc55.h:46, src/gui/midi_sc55.h:120, src/gui/midi_sc55.h:135"
@@ -228,7 +228,7 @@ files:
     aliases: ["waverom1.bin"]
     description: "SC-55 family wave ROM 1"
     required: false
-    size_options: [1048576, 2097152]
+    size: [1048576, 2097152]
     validation: [size]
     mode: libretro
     source_ref: "src/gui/midi_sc55.h:48-50, src/gui/midi_sc55.h:120"
@@ -238,20 +238,21 @@ files:
     aliases: ["waverom2.bin"]
     description: "SC-55 family wave ROM 2"
     required: false
-    size_options: [1048576, 2097152]
+    size: [1048576, 2097152]
     validation: [size]
     mode: libretro
     source_ref: "src/gui/midi_sc55.h:48-50, src/gui/midi_sc55.h:120"
 
   - name: "WAVEROM3.BIN"
     path: "SC-55/WAVEROM3.BIN"
-    aliases: ["waverom3.bin"]
+    aliases: ["waverom3.bin", "sc55_waverom3.bin"]
     description: "SC-55/SC-155/CM-300 wave ROM 3"
     required: false
     size: 1048576
     validation: [size]
     mode: libretro
-    source_ref: "src/gui/midi_sc55.h:48-50, src/gui/midi_sc55.h:120, src/gui/midi_sc55.h:160"
+    source_ref: "src/gui/midi_sc55.h:48-50, src/gui/midi_sc55.h:120, src/gui/midi_sc55.h:155, src/gui/midi_sc55.h:160"
+    note: "Next to ROM1.BIN the name is fixed. In SC-55.zip any 1 MiB or 2 MiB member fills the wave slot of the last 1, 2 or 3 in its name, so sc55_waverom3.bin is taken as wave ROM 3. The size test of an SC-55mkII ROM1 does not cover it."
 
   # -- BASS libraries (BASSMIDI driver) --
 

emulators/fba2x.yml

@@ -18,8 +18,6 @@ systems:
   - igs-pgm
 verification: md5
 
-archive_prefix: fbneo
-
 notes: |
   Recalbox's standalone ARM port of Final Burn Alpha, lineage pifba (originally
   by Franxis / Oopsware for the GP2X, modernised to SDL2 by Recalbox). The
@@ -28,9 +26,11 @@ notes: |
 
   BIOS and ROM archives are resolved relative to szAppRomPath, hardcoded to
   "roms/" in rpi/bzip.cpp:4 and overridden only through the rom path argument.
-  BzipOpen (rpi/bzip.cpp:355-394) iterates BurnDrvGetZipName(z) for every
+  BzipOpen (rpi/bzip.cpp:360-394) iterates BurnDrvGetZipName for every
   BIOS/parent slot and opens "<roms/><name>" directly: no fallback
-  directory walking.
+  directory walking. Inside the opened archives each ROM is located by its
+  CRC32 first and by its names only when no member carries that CRC
+  (rpi/bzip.cpp:82-111), so member names are free.
 
   Shared BIOS ROM sets flagged BDF_BOARDROM in the driver source:
     - neogeo (burn/neogeo/d_neogeo.cpp), SNK Neo Geo system BIOS
@@ -56,8 +56,7 @@ files:
     system: snk-neogeo-mvs
     description: "SNK Neo Geo system BIOS ROM set"
     required: true
-    archive: neogeo
-    source_ref: "burn/neogeo/d_neogeo.cpp:923 (BurnDrvneogeo, BDF_BOARDROM)"
+    source_ref: "burn/neogeo/d_neogeo.cpp:679-731 (neogeoRomDesc), burn/neogeo/d_neogeo.cpp:880-884 (BurnDrvNeoGeo, BDF_BOARDROM)"
     contents:
       - name: "vs-bios.rom"
         size: 131072
@@ -123,8 +122,8 @@ files:
     system: igs-pgm
     description: "IGS PGM (Polygame Master) System BIOS ROM set"
     required: true
-    archive: pgm
-    source_ref: "burn/pgm/d_pgm.cpp:255 (BurnDrvpgm, BDF_BOARDROM)"
+    source_ref: "burn/pgm/d_pgm.cpp:245-258 (pgmRomDesc, BurnDrvpgm, BDF_BOARDROM), rpi/bzip.cpp:94-99 (CRC before name)"
+    note: "The three ROMs are matched by CRC32 before any name, so an archive holding them as pgm_p01s.u20, pgm_t01s.rom and pgm_m01s.rom is accepted."
     contents:
       - name: "pgm_p01s.rom"
         size: 131072

emulators/fmsx.yml

@@ -241,12 +241,13 @@ files:
   - name: CARTS.CRC
     required: false
     bundled: false
-    unsourceable: "dead legacy code path, never created or distributed, replaced by CARTS.SHA"
-    note: "CRC database for cartridge identification and mapper detection. Tried first, before CARTS.SHA (fMSX/MSX.c:2701)."
+    unsourceable: "no fMSX release examined ships one; the mapper database the author distributes is CARTS.SHA"
+    source_ref: "fMSX/MSX.c:2697-2713"
+    note: "Mapper database opened in the system directory before CARTS.SHA. Each line holds the sum of the ROM bytes as eight hexadecimal digits and a mapper number (%08X %d); a matching line sets the mapper and CARTS.SHA is not read."
 
   - name: CARTS.SHA
     required: false
     bundled: true
     md5: 74b0f217fa0e2b8bb5a2f8e2ecc69da3
-    note: "SHA1 database for cartridge identification and mapper detection. Fallback when CARTS.CRC absent (fMSX/MSX.c:2716)."
+    note: "SHA1 database for cartridge identification and mapper detection. Read when CARTS.CRC is absent or holds no matching line (fMSX/MSX.c:2716)."
     source_ref: "fMSX/ROMs/CARTS.SHA"

emulators/hatari.yml

@@ -126,11 +126,12 @@ files:
     description: "Symbol table for the TOS image, nm-style text or a program symbol table"
     required: false
     storage: user_provided
-    unsourceable: "matches whichever image is installed as tos.img; EmuTOS releases ship one per ROM, Atari TOS has none"
+    unsourceable: "one table per TOS build, valid only beside the image it was linked with: each EmuTOS release archive carries the table of its ROM, etos512k.sym beside etos512k.img, and Atari TOS has none"
     source_ref: "src/tos.c:1094, src/debug/symbols.c:1095-1113, src/debug/symbols.c:1002-1020, src/debug/symbols.c:372-407, src/configuration.c:621, src/includes/configuration.h:29-31"
     note: >
-      Read next to tos.img at every TOS load when present; the symbols
-      serve the built-in debugger.
+      The name is the TOS image path with its last three characters
+      replaced by sym, and the image path is always tos.img here. Read at
+      every TOS load when present; the symbols serve the built-in debugger.
 
   - name: "cartridge ROM"
     path: null

emulators/idtech4a++.yml

@@ -549,18 +549,81 @@ files:
     source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EContextUtils.java:305-345, idTech4Amm/src/main/java/com/n0n3m4/DIII4A/launcher/SetupControlsThemeFunc.java:136-179"
 
   - name: gameaarch64.so
+    path: "doom3/base/gameaarch64.so"
     required: false
-    aliases: [gamearm.so]
-    unsourceable: "compiled per mod against the published SDK, with no released binary to collect"
-    description: "External idTech 4 mod game library"
+    description: "DOOM 3 game library for arm64, built from the DOOM 3 SDK the README links"
     note: >-
       Looked for in the mod folder of DOOM 3, Quake 4, Prey or ETQW when the
       external-library preference is on, copied to a private cache and named to
-      the engine through harm_fs_gameLibPath. The suffix follows the running
-      architecture, gameaarch64.so on arm64 and gamearm.so on armv7. Without it
-      the engine keeps the game code built into the apk. The launcher also
-      accepts a full path to any libxxxxx.so instead.
-    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:342-372, 429-434, idTech4Amm/src/main/java/com/n0n3m4/DIII4A/launcher/AddExternalLibraryFunc.java:71-86, README.md:240-244, README.md:252-262"
+      the engine through harm_fs_gameLibPath. The folder is the one fs_game
+      names, the base folder of the game when it names none. The file name
+      follows the running architecture, gameaarch64.so on arm64 and gamearm.so
+      on armv7. Without it the engine keeps the game code built into the apk.
+      The launcher also accepts a full path to any libxxxxx.so instead.
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGlobals.java:276, Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameConstants.java:147-150, idTech4Amm/src/main/java/com/n0n3m4/DIII4A/launcher/AddExternalLibraryFunc.java:71-86, README.md:240-244, README.md:252-262"
+
+  - name: gamearm.so
+    path: "doom3/base/gamearm.so"
+    required: false
+    description: "DOOM 3 game library for armv7, built from the DOOM 3 SDK the README links"
+    note: "Looked for in the DOOM 3 base folder under the same preference, armv7 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gameaarch64.so
+    path: "doom3/d3xp/gameaarch64.so"
+    required: false
+    description: "DOOM 3 Resurrection of Evil game library for arm64, built from the DOOM 3 SDK the README links"
+    note: "Looked for in the d3xp mod folder of DOOM 3 under the same preference, arm64 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gamearm.so
+    path: "doom3/d3xp/gamearm.so"
+    required: false
+    description: "DOOM 3 Resurrection of Evil game library for armv7, built from the DOOM 3 SDK the README links"
+    note: "Looked for in the d3xp mod folder of DOOM 3 under the same preference, armv7 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gameaarch64.so
+    path: "doom3/bloodmod/gameaarch64.so"
+    required: false
+    description: "DOOM 3 Blood Mod game library for arm64, released from the DOOM 3 SDK repository"
+    note: "Looked for in the bloodmod mod folder of DOOM 3 under the same preference, arm64 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gamearm.so
+    path: "doom3/bloodmod/gamearm.so"
+    required: false
+    description: "DOOM 3 Blood Mod game library for armv7, released from the DOOM 3 SDK repository"
+    note: "Looked for in the bloodmod mod folder of DOOM 3 under the same preference, armv7 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gameaarch64.so
+    path: "quake4/q4base/gameaarch64.so"
+    required: false
+    description: "Quake 4 game library for arm64, built from the Quake 4 SDK the README links"
+    note: "Looked for in the Quake 4 base folder under the same preference, arm64 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gamearm.so
+    path: "quake4/q4base/gamearm.so"
+    required: false
+    description: "Quake 4 game library for armv7, built from the Quake 4 SDK the README links"
+    note: "Looked for in the Quake 4 base folder under the same preference, armv7 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gameaarch64.so
+    path: "prey/preybase/gameaarch64.so"
+    required: false
+    description: "Prey game library for arm64, built from the Prey SDK the README links"
+    note: "Looked for in the Prey base folder under the same preference, arm64 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
+
+  - name: gamearm.so
+    path: "prey/preybase/gamearm.so"
+    required: false
+    description: "Prey game library for armv7, built from the Prey SDK the README links"
+    note: "Looked for in the Prey base folder under the same preference, armv7 builds only."
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:386-416, 472-479"
 
   - name: server.so
     required: false
@@ -573,7 +636,7 @@ files:
       as the dll, clientlib and menulib parameters with gamelibdir pointing at
       the cache. The three default names are used unless the command line names
       others, and any further libraries in the folder are copied alongside.
-    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:373-414, 445-475"
+    source_ref: "Q3E/src/main/java/com/n0n3m4/q3e/Q3EGameHelper.java:417-458, 488-520"
 
 exclusion_note: >
   The retail game data is not listed. Every engine here loads it by globbing the

emulators/lindbergh-loader.yml

@@ -140,14 +140,11 @@ files:
   - name: segaboot
     system: sega-lindbergh
     required: false
-    description: "Sega Lindbergh boot and hardware check program, version 2.4"
+    description: "Sega Lindbergh boot and hardware check program, the build listed as Segaboot 2.4 with symbols"
     source_ref: "src/lindbergh/lindbergh.c:696-698, src/lindbergh/lindbergh.c:892-895, src/lindbergh/hook.c:1625-1632, src/lindbergh/config.h:57-58, src/lindbergh/gameData.c:51-52"
-    unsourceable: >-
-      Lives at /usr/sbin/segaboot on the board's hard disk, which no dump
-      project covers. The /usr partition images that circulate are encrypted
-      and no key is public.
     note: >-
-      Run as "segaboot -t" under -s or --segaboot. A 32-bit x86 Linux ELF.
+      Run as "segaboot -t" under -s or --segaboot. A 32-bit x86 Linux ELF,
+      /usr/sbin/segaboot on the system CompactFlash card.
       0x38d56318 identifies Segaboot 2.4 and 0xa518b18b the build carrying
       symbols, but neither is a whole-file checksum and neither belongs in a
       hash field: src/lindbergh/hook.c computes them as CRC-32 over 0x4000 bytes starting
@@ -157,6 +154,11 @@ files:
       CRC logs a warning and startup continues. SEGABOOT 0x0027 and
       SEGABOOT_2_6 0x0030 in src/lindbergh/config.h are placeholders, not checksums, and no
       table entry uses them.
+      The retail SegaBoot Ver.1.04-2 of the 2.4.20 system card, built
+      Jan 16 2006 and not stripped, gives 0xf9a67ce2 under that computation
+      and matches no table entry. The file that gives 0xa518b18b is that
+      binary with the two bytes 78 21 at file offset 0x35bc, the js taken
+      when amDongleInit returns a negative value, replaced by 90 90.
 
   # -- Lindbergh boot assets, replaced by built-in copies since 2.0.1 --
 
@@ -189,7 +191,6 @@ files:
     has_builtin: true
     description: "Sega Kaku Gothic console font texture"
     source_ref: "src/lindbergh/hook.c:718-730, src/lindbergh/hook.c:902-914"
-    aliases: ["LucidaConsole_12.tga"]
     note: >-
       Read from the game directory only when DISABLE_BUILTIN_FONT is set.
       The built-in is one shared 128x256 atlas (fontTGA) and one metrics
@@ -216,7 +217,6 @@ files:
     has_builtin: true
     description: "Sega Kaku Gothic console font metrics"
     source_ref: "src/lindbergh/hook.c:732-744, src/lindbergh/hook.c:916-928"
-    aliases: ["LucidaConsole_12.abc"]
     note: >-
       Read from the game directory only when DISABLE_BUILTIN_FONT is set.
       The built-in is one shared 128x256 atlas (fontTGA) and one metrics
@@ -301,10 +301,10 @@ files:
     description: "Lindbergh site configuration read by Sega's lxmaster boot supervisor"
     source_ref: "src/lindbergh/hook.c:650-653"
     unsourceable: >-
-      /root is a symlink to /usr/local/root, so the file sits on the same
-      unpreserved hard-disk partition as segaboot. Nothing canonical exists to
-      reproduce either: every key is a site or unit specific development
-      setting, and a stock production machine ships no lindbergrc at all.
+      /root is a symlink to /usr/local/root, which holds no lindbergrc on
+      the retail system card. Nothing canonical exists to reproduce: every
+      key is a site or unit specific development setting, and a stock
+      production machine ships no lindbergrc at all.
     note: >-
       An INI file, sections [develop], [terminal], [segaboot] and [keychip].
       It is read by Sega's lxmaster boot supervisor, not by the games; the

emulators/pom2.yml

@@ -844,7 +844,6 @@ files:
     category: game_data
     required: false
     bundled: true
-    unsourceable: "host program component shipped inside every POM2 package, not emulation data"
     size: 759720
     sha1: "3061cf7af25793a655a1ff5a509385f3620f3eb3"
     source_ref: "src/main.cpp:533-546"
@@ -855,7 +854,6 @@ files:
     category: game_data
     required: false
     bundled: true
-    unsourceable: "host program component shipped inside every POM2 package, not emulation data"
     size: 426112
     sha1: "0c8c9706abc0116f08b66d11a69da6aa9ef7e6bf"
     source_ref: "src/main.cpp:593-611"
@@ -866,7 +864,6 @@ files:
     category: game_data
     required: false
     bundled: true
-    unsourceable: "host program component shipped inside every POM2 package, not emulation data"
     size: 102046
     sha1: "69358dd499148deae4112b49cedb7bec220584e2"
     source_ref: "src/MainWindow_MiscPanels.cpp:621"
@@ -876,7 +873,6 @@ files:
     category: game_data
     required: false
     bundled: true
-    unsourceable: "host program component shipped inside every POM2 package, not emulation data"
     size: 794259
     sha1: "a178f37661078739637ff7642cd6450c762993aa"
     source_ref: "src/MainWindow_MiscPanels.cpp:480"

emulators/virtualjaguar.yml

@@ -39,8 +39,14 @@ notes: |
   directly, skipping the boot animation.
 
   Nothing here is required: every path falls back to an embedded copy, and a
-  file only replaces it. What the files buy is the real dump rather than the
-  reimplementation, which is why they are collected.
+  file only replaces it. The embedded arrays are the dumps themselves:
+  jaguarBootROM and jaguarBootROM_M hash to the CRC32 values biosdb.c names
+  Series K and Model M, jaguarCDBootROM and jaguarDevCDBootROM to the two
+  values the CD BIOS test accepts (src/bios/jagbios.c, src/bios/jagbios_m.c,
+  src/bios/jagcdbios.c, src/bios/jagdevcdbios.c, src/core/biosdb.c:20-21,
+  libretro.c:4964-4965). A file changes what runs only under BT_CUSTOM,
+  where any image of 0x20000 bytes is loaded and an unrecognised checksum
+  is logged (libretro.c:5245-5284).
 
 files:
   - name: "[BIOS] Atari Jaguar CD (World).j64"
@@ -106,18 +112,20 @@ files:
     required: false
     size: 131072
     validation: [size]
+    aliases:
+      - boot.rom
     description: "Model-M cart boot ROM, read when the BIOS type is Model M"
     source_ref: "libretro.c:5358-5380"
     note: >-
-      Read from the system directory only, under that exact name, and only
-      when biosType is BT_M_SERIES. A short read falls back to the embedded
-      Model M array.
+      Read from the system directory only, as jagboot_m.rom, and only when
+      biosType is BT_M_SERIES. A short read falls back to the embedded
+      Model M array, which carries the same bytes as the Model M dump.
 
 analysis:
   embedded_bios:
     k_series_boot_rom:
-      source_file: src/jagbios.c
-      header: src/jagbios.h
+      source_file: src/bios/jagbios.c
+      header: src/bios/jagbios.h
       symbol: jaguarBootROM
       size: 131072  # 0x20000, 128 KB
       description: "Jaguar K-series boot ROM"
@@ -125,42 +133,26 @@ analysis:
       filedb_name: "[BIOS] Atari Jaguar (World)"
 
     m_series_boot_rom:
-      source_file: src/jagbios2.c
-      header: src/jagbios2.h
-      symbol: jaguarBootROM2
+      source_file: src/bios/jagbios_m.c
+      header: src/bios/jagbios_m.h
+      symbol: jaguarBootROM_M
       size: 131072  # 0x20000, 128 KB
       description: "Jaguar M-series boot ROM"
+      biosdb_crc: "0xAE25BDF5"
+      biosdb_name: "Model M boot ROM"
 
     cd_boot_rom:
-      source_file: src/jagcdbios.c
-      header: src/jagcdbios.h
+      source_file: src/bios/jagcdbios.c
+      header: src/bios/jagcdbios.h
       symbol: jaguarCDBootROM
       size: 262144  # 0x40000, 256 KB
       description: "Jaguar CD boot ROM"
       filedb_crc: "0x687068D5"
       filedb_name: "[BIOS] Atari Jaguar CD (World)"
 
-    stubulator_93:
-      source_file: src/jagstub1bios.c
-      header: src/jagstub1bios.h
-      symbol: jaguarDevBootROM1
-      size: 131072  # 0x20000, 128 KB
-      description: "Jaguar Stubulator '93 dev BIOS"
-      filedb_crc: "0xE60277BB"
-      filedb_name: "[BIOS] Atari Jaguar Stubulator '93 (World)"
-
-    stubulator_94:
-      source_file: src/jagstub2bios.c
-      header: src/jagstub2bios.h
-      symbol: jaguarDevBootROM2
-      size: 131072  # 0x20000, 128 KB
-      description: "Jaguar Stubulator '94 dev BIOS"
-      filedb_crc: "0x8D15DBC6"
-      filedb_name: "[BIOS] Atari Jaguar Stubulator '94 (World)"
-
     dev_cd_boot_rom:
-      source_file: src/jagdevcdbios.c
-      header: src/jagdevcdbios.h
+      source_file: src/bios/jagdevcdbios.c
+      header: src/bios/jagdevcdbios.h
       symbol: jaguarDevCDBootROM
       size: 262144  # 0x40000, 256 KB
       description: "Jaguar Developer CD boot ROM"
@@ -178,16 +170,16 @@ analysis:
 
   core_option:
     key: virtualjaguar_bios
-    label: "BIOS"
-    description: "Use the Jaguar BIOS, required for some games."
+    label: "BIOS (Cartridges)"
+    description: "Which BIOS a cartridge boots with: disabled is HLE, enabled runs the boot ROM."
     default: disabled
-    source_ref: "libretro_core_options.h:123"
+    source_ref: "libretro_core_options.h:588-600"
 
   bios_loading:
     mechanism: embedded
     load_address: "0xE00000"
     load_size: "0x20000"
-    source_ref: "libretro.c:5339-5382, libretro.c:6331"
+    source_ref: "libretro.c:5339-5383, libretro.c:6332"
     selection_logic: "BT_CUSTOM reads a file, BT_M_SERIES tries jagboot_m.rom, otherwise the embedded array"
     external_loading: true
     note: |

emulators/xroar.yml

@@ -420,9 +420,8 @@ files:
     system: dragon64
     description: "Ikon Ultra Drive Dragonfly ROM 2.3"
     required: false
-    unsourceable: "not yet dumped, only v1.3 publicly available, XRoar support is experimental (#ifdef WANT_EXPERIMENTAL)"
-    source_ref: "xroar.c:715 (romlist ikon), ikon.c:151 (default @ikon)"
-    note: "Experimental. Ikon Ultra Drive storage interface. First candidate of the ikon romlist."
+    source_ref: "src/xroar.c:715 (romlist ikon), src/ikon.c:151 (default @ikon), src/ikon.c:26 (WANT_EXPERIMENTAL)"
+    note: "Experimental, compiled only with WANT_EXPERIMENTAL. Ikon Ultra Drive storage interface. First candidate of the ikon romlist; no crclist entry names it."
 
   - name: "dragonfly-1.3.rom"
     system: dragon64