feat: collect ap6, shareddata, introset, a2 scsi

emulators/cemu.yml

@@ -294,11 +294,16 @@ files:
     required: false
     hle_fallback: true
     description: "Dump of the shared data region of a console"
+    size: 33554432
     note: >-
       Read only when the four shared fonts are not all present: 32 MiB
       copied from the user data path to 0xF8000000, table of font entries
-      included. Nothing about it is validated.
-    source_ref: "src/Cafe/CafeSystem.cpp:357-365"
+      included. Nothing about it is validated. The region holds the
+      SharedDataEntry table (0xFFCAFE01 to 0xFFCAFE04, type 2) followed by
+      CafeCn.ttf, CafeKr.ttf, CafeStd.ttf and CafeTw.ttf, byte-identical to
+      the console dumps of title 0005001b-10042400 above; every other byte
+      is zero.
+    source_ref: "src/Cafe/CafeSystem.cpp:268-291, src/Cafe/CafeSystem.cpp:357-365"
 
   - name: snd_user.rpl
     path: Cemu/cafeLibs/snd_user.rpl

emulators/clk.yml

@@ -225,12 +225,12 @@ files:
   - name: AP6v133.rom
     path: Electron/AP6v133.rom
     description: "Advanced Plus 6 ROM"
-    size: 8192
+    size: 7772
     crc32: "e0013cfc"
     required: false
-    note: "Conditional: needed for AP6 commands"
+    note: "Conditional: needed for AP6 commands. The catalogue records crc32 e0013cfc, which is the 7772-byte RetroHardware Plus 1 Support 1.33c build of 16 Jun 2020, and declares 8 KiB: Request::Node::validate() resizes the loaded image to 8192 bytes and the fetcher reads any length."
     mode: standalone
-    source_ref: "Machines/Utility/ROMCatalogue.cpp:138-145"
+    source_ref: "Machines/Utility/ROMCatalogue.cpp:138-145, Machines/Utility/ROMCatalogue.cpp:1484-1499, OSBindings/SDL/main.cpp:756-783"
 
   # -------------------------------------------------------
   # Amiga (machine_name: "Amiga")
@@ -508,11 +508,18 @@ files:
     path: DiskII/state-machine-16.rom
     description: "Disk II 16-sector state machine ROM"
     size: 256
-    crc32: "9796a238"
+    crc32: "b72a2c70"
     required: false
-    note: "Conditional: needed for disk controller. Also used by Oric Pravetz."
+    note: >
+      Conditional: needed for disk controller. Also used by Oric Pravetz. The
+      catalogue accepts 9796a238 and b72a2c70, the same PROM in two byte orders.
+      set_state_machine() takes an image whose first byte is 0x18 as already in
+      Beneath Apple ProDOS order (b72a2c70) and only reorders its addresses; any
+      other image is read as the unadulterated P6 PROM (9796a238), its address
+      lines and the top nibble of each value remapped into that order. Both give
+      the same internal table.
     mode: standalone
-    source_ref: "Machines/Utility/ROMCatalogue.cpp:536-543"
+    source_ref: "Machines/Utility/ROMCatalogue.cpp:536-543, Components/DiskII/DiskII.cpp:187-239"
 
   - name: boot-13.rom
     path: DiskII/boot-13.rom
@@ -693,11 +700,16 @@ files:
     path: Macintosh/macplus.rom
     description: "Macintosh Plus ROM"
     size: 131072
-    crc32: "4fa5b399"
+    crc32: "b2102e8e"
     required: true
-    note: "Required for Macintosh 512ke and Plus models"
+    note: >
+      Required for Macintosh 512ke and Plus models. The catalogue accepts three
+      images, 4fa5b399, 7cacd18f and b2102e8e; b2102e8e carries the ROM
+      checksum 4D1F8172 of the third Mac Plus revision. The
+      machine copies whichever is supplied into its 128 KiB ROM without
+      reading the revision.
     mode: standalone
-    source_ref: "Machines/Utility/ROMCatalogue.cpp:740-751"
+    source_ref: "Machines/Utility/ROMCatalogue.cpp:740-751, Machines/Apple/Macintosh/Macintosh.cpp:127-144"
 
   # -------------------------------------------------------
   # Master System (machine_name: "MasterSystem")

emulators/lindbergh-loader.yml

@@ -298,20 +298,26 @@ files:
   - name: lindbergrc
     system: sega-lindbergh
     required: false
-    description: "Lindbergh site configuration read by Sega's lxmaster boot supervisor"
-    source_ref: "src/lindbergh/hook.c:650-653"
+    description: "Lindbergh development configuration read by Sega's lxmaster and segaboot"
+    source_ref: "src/lindbergh/hook.c:650-653, src/lindbergh/lindbergh.c:892-894"
     unsourceable: >-
       /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.
+      the retail system card. The system card's /etc/rsyncd.conf exports
+      /root as an rsync module commented "/root/ for lindbergrc": the file
+      was pushed from a developer host onto development units, and a stock
+      production machine ships none.
     note: >-
-      An INI file, sections [develop], [terminal], [segaboot] and [keychip].
-      It is read by Sega's lxmaster boot supervisor, not by the games; the
+      An INI file read by Sega's boot programs, not by the games; the
       per-title <id>rc files that do ship in game dumps are xinit client
-      scripts, a different thing. The fopen hook rewrites /root/lindbergrc to
-      lindbergrc in the game directory, and the loader neither creates the file
-      nor substitutes for it.
+      scripts, a different thing. lxmaster (Sep 2005 and Jan 2008 builds)
+      reads [develop], [terminal] and [segaboot], and from the 2008 build
+      [keychip], whose values it writes to /var/lxmaster/keychip. segaboot
+      1.04-2 reads [develop] (source-hdd, no-md5check, debugger) and
+      [keychip] (game-id, major-release, model-type, src-media, src-default,
+      dst-media, nfs-source, debug-arg). The fopen hook rewrites
+      /root/lindbergrc to lindbergrc in the game directory for any program
+      the loader wraps, segaboot included (-s), and the loader neither
+      creates the file nor substitutes for it.
 
   - name: gamecontrollerdb.txt
     system: sega-lindbergh

emulators/thextech.yml

@@ -179,9 +179,8 @@ files:
     category: game_data
     path: "TheXTech/introset/"
     required: false
-    unsourceable: "optional directory a pack author fills with alternative intro levels; the Adventures of Demo pack carries none and the code falls back on intro.lvlx"
-    source_ref: "src/game_main.cpp:194-222, 247"
-    note: "Directory of .lvl/.lvlx intro levels; one is picked at random when present, otherwise the root intro level is opened."
+    source_ref: "src/game_main.cpp:194-222, 247, src/main/level_file.cpp:321-339"
+    note: "Directory of .lvl/.lvlx intro levels; one is picked at random when present, otherwise the root intro level is opened. The Adventures of Demo pack carries none; these 19 levels come from the introset/ of the Nostalgic Paradise pack (Blue Edition 0.2.8b, nostalgic-paradise-stable.7z). A level reads custom graphics from introset/ and from the subfolder named after it (07/, 08/, 10/); every other block, BGO, NPC and background ID they use is present in the Adventures of Demo graphics."
 
   - name: "outro.lvlx"
     category: game_data

emulators/xash3d_fwgs.yml

@@ -21,10 +21,14 @@ notes: |
   filesystem/searchpath.c:327), `fallback_dir` names a second fallback,
   and `game` / `gamename` carry the human-readable title.
 
-  Each supported mod's data is a Valve-style game folder with its own
-  pak0.pak / pak1.pak, maps/, models/, sound/, overviews/ and a game
-  descriptor. The engine does not hash any file; the pak header is the
-  only sanity check (filesystem/pak.c). liblist.gam ships inside each
+  Each supported mod's data is a Valve-style game folder with a game
+  descriptor, maps/, models/, sound/, overviews/ and any number of .pak
+  archives. FS_AddGameDirectory mounts every .pak of the folder, then
+  every .pk3, .pk3dir and .wad, each kind in sorted name order and each
+  above the previous one, then the folder itself on top, so loose files
+  win over packed ones (filesystem/searchpath.c:188-224). No archive name
+  is required. The engine does not hash any file; the pak header is the
+  only sanity check (filesystem/pak.c:98-157). liblist.gam ships inside each
   retail mod and is also written out by the engine as gameinfo.txt the
   first time it imports a Valve folder (filesystem/gameinfo.c:538-544).
 
@@ -34,10 +38,11 @@ notes: |
   conversions this way.
 
   Below are the folders Half-Life retail / official addon releases
-  install under the Steam install root. Each entry marks the per-mod
-  descriptor and base pak so the engine can detect the game; map / model
-  / sound trees that live beside them are too open-ended to enumerate
-  and are counted as part of the same game data.
+  install under the Steam install root. The descriptor is what makes the
+  engine detect a folder (filesystem/gameinfo.c:614-630); the pak entries
+  name the archives the retail releases ship. Map / model / sound trees
+  that live beside them are too open-ended to enumerate and are counted
+  as part of the same game data.
 
 files:
   # ================================================================
@@ -56,18 +61,18 @@ files:
     category: game_data
     system: halflife
     path: "valve/pak0.pak"
-    required: true
-    source_ref: "filesystem/pak.c (PAK loader), filesystem/searchpath.c:912 (valve fallback)"
-    note: "Retail Half-Life base pak."
-    unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
+    required: false
+    source_ref: "filesystem/searchpath.c:188-224, filesystem/pak.c:98-157"
+    note: "Half-Life game data packed in one archive, as the CD and WON releases install it. The engine mounts whatever .pak the folder holds and requires none: the Steam depot ships valve/ as loose files with no .pak, and the game runs from those."
+    unsourceable: "The WON Linux dedicated servers 1.0.0.9 to 3.1.1.1 carry a server-only valve/pak0.pak (65022757, 47500556 or 33772308 bytes, at most 1035 entries: multiplayer maps, models, sounds, sprites and skies, with no single-player map, gfx/shell or sound/vox), not the client archive of the CD and WON releases."
 
   - name: "pak1.pak"
     category: game_data
     system: halflife
     path: "valve/pak1.pak"
     required: false
-    source_ref: "filesystem/pak.c"
-    note: "Patch pak, present on Steam Half-Life installs."
+    source_ref: "filesystem/searchpath.c:188-224, filesystem/pak.c:98-157"
+    note: "Mounted above pak0.pak when present, as any second .pak of the folder would be. The only valve/pak1.pak released is the one the Blue Shift High Definition Pack installer writes (7839196 bytes, 99 entries: HD models, sounds and sprites for Half-Life); Steam ships no .pak in valve/."
     unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
 
   # ================================================================
@@ -90,7 +95,7 @@ files:
     required: false
     source_ref: "filesystem/pak.c"
     note: "Loose files (maps/, sprites/, sound/, models/) are the usual retail layout; a bundled pak0.pak is optional."
-    unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
+    unsourceable: "The Linux dedicated servers hlds_l 1.1.2.0 and hlds_l_11262003 ship cstrike/ as loose files with no .pak."
 
   # ================================================================
   # Condition Zero (czero/)
@@ -149,7 +154,7 @@ files:
     path: "dmc/pak0.pak"
     required: false
     source_ref: "filesystem/pak.c"
-    unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
+    unsourceable: "The Linux dedicated servers that carry dmc/ (hlds_l 3.1.1.1 and 1.1.2.0) ship it as loose files with no .pak, and none of the WON patches checked carries a dmc/pak0.pak."
 
   # ================================================================
   # Opposing Force (gearbox/)
@@ -169,7 +174,7 @@ files:
     path: "gearbox/pak0.pak"
     required: false
     source_ref: "filesystem/pak.c"
-    unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
+    unsourceable: "The free 1.1.0.8 WON patch ofo1108.exe installs a gearbox/pak0.pak of 83750141 bytes (sha1 aefbe228c010ade60e73d1ddf1f9b2878090b596) holding 514 entries with the 25 multiplayer maps and none of the of0a0 to of7a single-player maps, and the free Linux server opfor_linux.tar.gz carries a 529-entry multiplayer-only pak of 74390909 bytes, so neither is the client archive of the retail release."
 
   # ================================================================
   # Blue Shift (bshift/)
@@ -209,7 +214,7 @@ files:
     path: "ricochet/pak0.pak"
     required: false
     source_ref: "filesystem/pak.c"
-    unsourceable: "retail data the collection does not hold; a same-named file of another game must not stand in"
+    unsourceable: "The Linux dedicated servers that carry ricochet/ (hlds_l 3.1.1.1 and 1.1.2.0) ship it as loose files with no .pak, and none of the WON patches checked carries a ricochet/pak0.pak."
 
   # ================================================================
   # Team Fortress Classic (tfc/)