docs/reports/FRIIDUMP_REDUMP_DAT_VERIFICATION_0.5.3.6.md

   1 # FriiDump 0.5.3.6 — Automatic Redump DAT Verification
   2
   3 ## Purpose
   4
   5 After a successful ISO dump, FriiDump now checks the finalized output hashes
   6 against the supplied Redump DAT for the selected system. This removes the
   7 manual copy/paste comparison step while preserving the complete printed hash
   8 set.
   9
  10 ## Matching policy
  11
  12 A `MATCH` requires all available identity fields used by Redump DAT entries:
  13
  14 - output byte size
  15 - CRC32
  16 - MD5
  17 - SHA-1
  18
  19 SHA-256 is still calculated and printed by FriiDump but is not part of the DAT
  20 match because the supplied Logiqx DAT records do not provide SHA-256.
  21
  22 ## System mapping
  23
  24 | Disc type | Stable DAT filename | Supplied entries |
  25 |---|---|---:|
  26 | GameCube | `Nintendo - GameCube.dat` | 2019 |
  27 | Wii / Wii DL | `Nintendo - Wii.dat` | 3780 |
  28 | Xbox/XGD redump-style ISO | `Microsoft - Xbox.dat` | 2683 |
  29
  30 XISO/game-partition output is not compared with the full-disc Xbox DAT.
  31
  32 ## Console behavior
  33
  34 Successful example:
  35
  36 ```text
  37 Redump DAT verification:
  38   Status............: MATCH
  39   DAT...............: redump_dat/Nintendo - GameCube.dat
  40   Entries scanned...: 2019
  41   Game..............: Sonic Mega Collection (USA)
  42   ROM...............: Sonic Mega Collection (USA).iso
  43   Matched...........: Size, CRC32, MD5, and SHA-1 matched.
  44 ```
  45
  46 A missing DAT or `NO MATCH` remains visible in the log and optional JSON report.
  47 It does not erase or modify the image and does not invoke any drive write path.
  48
  49 ## CLI
  50
  51 ```text
  52 --redump-dat-dir <dir>
  53 --redump-report <file>
  54 --no-redump-verify
  55 ```
  56
  57 Default DAT directory: `redump_dat`.
  58
  59 ## Local validation
  60
  61 The parser was built with the current FriiDump source and tested against the
  62 supplied GameCube DAT using two known Redump references:
  63
  64 - Sonic Mega Collection (USA): matched uniquely after scanning 2019 entries.
  65 - Super Smash Bros. Melee (USA) (En,Ja) (Rev 2): matched uniquely after
  66   scanning 2019 entries.
  67
  68 The Linux CMake build completed successfully. The existing MSVC32 response file
  69 was updated to compile `src\redump_dat.c`.