validation/README.md

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