validation/README.md

   1 # FriiDump 0.5.3.16-pf1 validation history
   2
   3 The Candidate21 validators below are retained as exact campaign evidence. They
   4 verify the candidate identity and should not be renamed or repurposed as
   5 release builders.
   6
   7 For a normal release build, use the maintained entry points:
   8
   9 ```text
  10 Windows: build_msvc32.cmd
  11 Linux:   cmake -S . -B build -DBUILD_STATIC_BINARY=ON
  12          cmake --build build
  13 ```
  14
  15 After validating the exact Linux executable, apply the minimum file capability
  16 with `validation/friidump-linux-rawio-capability.sh`.
  17
  18 ## Candidate21 Linux build
  19 Run from the source root:
  20
  21 ```bash
  22 bash ./validation/friidump-v0.5.3.16-pf1-candidate21-linux-live-validation.sh build
  23 ```
  24
  25 The build gate compiles FriiDump and the native-report fixtures, validates all
  26 13 report fixtures, exercises Redump DAT discovery/matching, runs the Linux Xbox
  27 portable contract, seed-diagnostics contract, raw-I/O parser test, and the
  28 raw-I/O source/documentation contract.
  29
  30 The build deliberately does not apply file capabilities. It prints a warning
  31 that vendor-command hardware runs require a separate capability phase.
  32
  33 Expected final line:
  34
  35 ```text
  36 FRIIDUMP CANDIDATE21 LINUX BUILD: PASS
  37 ```
  38
  39 ## Linux raw-I/O capability
  40
  41 After the exact executable has been built and reviewed:
  42
  43 ```bash
  44 bash ./validation/friidump-v0.5.3.16-pf1-candidate21-linux-live-validation.sh capability
  45 ```
  46
  47 This invokes the maintained helper, applies only `cap_sys_rawio=ep`, verifies
  48 it, and prints the executable SHA-256 and capability state.
  49
  50 Expected final line:
  51
  52 ```text
  53 FRIIDUMP CANDIDATE21 LINUX CAPABILITY: PASS
  54 ```
  55
  56 Rebuilding or replacing the executable clears this capability.
  57
  58 ## Windows
  59
  60 Run the Candidate21 Windows validator from Windows PowerShell 5.1 with Visual
  61 Studio 2019 Build Tools x86 available:
  62
  63 ```powershell
  64 powershell -NoProfile -ExecutionPolicy Bypass `
  65     -File .\validation\friidump-v0.5.3.16-pf1-candidate21-windows-live-validation.ps1 `
  66     -Phase Build `
  67     -SourceRoot (Get-Location).Path
  68 ```
  69
  70 Expected final line:
  71
  72 ```text
  73 FRIIDUMP CANDIDATE21 WINDOWS BUILD: PASS
  74 ```
  75
  76 ## Live gate
  77
  78 A Linux vendor-command live test is valid only when its evidence records:
  79
  80 - normal-user identity;
  81 - exact executable SHA-256;
  82 - `cap_sys_rawio=ep` on that executable;
  83 - runtime raw-I/O preflight PASS;
  84 - selected optical device identity;
  85 - dump or diagnostic result;
  86 - STOP UNIT result.