docs/CURRENT_STATUS.md

   1 # Current Status
   2
   3 ## Authority
   4
   5 FriiDump 0.5.3.16-pf1 is the release line prepared from the accepted
   6 Candidate21 implementation. The annotated release tag is the immutable
   7 authority after publication; verify the live tag object, peeled commit, and
   8 tree rather than inferring authority from a checkout directory or ZIP name.
   9
  10 ## Validated paths
  11
  12 - The maintained Visual Studio 2019 32-bit build and native-report fixtures pass.
  13 - Linux/CMake builds pass with explicit normal-user `CAP_SYS_RAWIO` handling.
  14 - A GCC-4244 B101 completed the Sonic Mega Collection (US) GameCube dump with an
  15   exact full-image hash match.
  16 - The exact 0.5.3.16-pf1 Linux executable later completed a controlled
  17   GCC-4244 B101 GameCube smoke with all 20 seed blocks, partial output,
  18   cancellation, native reporting, profile reporting, and STOP UNIT.
  19 - The exact 0.5.3.16-pf1 Linux executable completed the modified GDR-8050L
  20   `0xE7` GameCube path on physical GDR-8163B hardware cross-flashed with
  21   GDR-8050L `0012` firmware. The run completed all 20 seed blocks, partial
  22   output, cancellation, native reporting, profile reporting, and internal
  23   STOP UNIT.
  24 - The Linux GDR-8050L path established both Xbox game-view transitions, read
  25   XDVDFS metadata, captured DMI media ID `TQ00501A`, produced a controlled
  26   partial GAME-XDVDFS output with hashes and native reporting, and completed
  27   STOP UNIT.
  28 - Native `friidump-test-result.v1` reports cover complete, partial, failed,
  29   cancelled, no-media, seed-failure, and modified-firmware states.
  30
  31 ## Linux exact-release hardware closure
  32
  33 The two required Linux GameCube hardware targets are complete.
  34
  35 The GCC-4244 B101 exact-release evidence archive has SHA-256
  36 `7c9573d7dddf6381d8847626d0a45e96e57f2b64d79967a041d8acf4affebef5`.
  37 The cross-flashed GDR-8163B/GDR-8050L `0012` evidence archive has SHA-256
  38 `872b8144b8cc55601b268867ad8cc74cc7266a514cf015e24cd2fe3a450ee602`.
  39
  40 The validated cross-flashed unit required a readable Video DVD at power-on
  41 before it identified as GDR-8050L `0012`. The drive remained powered and
  42 connected while the disc was changed to Sonic Mega Collection (US). A
  43 temporary host-probe quarantine prevented background Linux media discovery
  44 from blocking the USB/SCSI path. The host state was restored after the run.
  45
  46 See
  47 [`reports/FRIIDUMP_LINUX_EXACT_RELEASE_HARDWARE_VALIDATION_0.5.3.16-pf1.md`](reports/FRIIDUMP_LINUX_EXACT_RELEASE_HARDWARE_VALIDATION_0.5.3.16-pf1.md).
  48
  49 ## Hardware-validation boundary
  50
  51 The Linux GDR-8050L evidence validates the command path, game-view state,
  52 metadata, controlled partial output, cancellation, reporting, and cleanup. It
  53 does not by itself claim a newly completed full Original Xbox image on Linux.
  54 Candidate-specific validation scripts remain in `validation/` as historical,
  55 exact evidence tools; release builds use the maintained build entry points and
  56 the generic raw-I/O capability helper.
  57
  58 ## Known inherited warnings
  59
  60 `libfriidump/rs.c` retains an inherited right-shift-count warning. Other
  61 explicit `-Wall -Wextra` warnings are pre-existing or non-fatal test-path
  62 warnings and were not silently normalized during release finalization.
  63
  64 ## Campaign
  65
  66 Release publication uses an exact annotated tag, exact-tag Windows and Linux
  67 builders, immutable artifact manifests, and independent private/public
  68 read-back. Candidate retirement remains a separate final gate.
  69
  70 ## Candidate12 correction status
  71 Candidate12 closes the Linux GCC-4244 B101 full-dump gate and corrects runtime
  72 DAT discovery, Linux lock-status reporting, and the Linux `--help` validation
  73 false failure. The accepted live result is Sonic Mega Collection (US), 712880
  74 sectors, with CRC32 `01b52739`, MD5
  75 `85a525df1481d0ad67d8761f832dca12`, SHA-1
  76 `06eb6d15b4d7f90ec0fed9ce9a77db41358d74ed`, and SHA-256
  77 `30098da93f5de9ece8da44f8afdfb85cf9bcdc24d77131221e64e3038a529010`.
  78
  79
  80 ## Candidate16 Linux authorization status
  81
  82 Candidate13's live diagnostics proved that Candidate12/13 seed failures were
  83 host-side authorization failures: vendor opcode `0xE7` returned `EPERM` before
  84 usable drive sense, while Candidate11's working executable carried
  85 `cap_sys_rawio=ep`.
  86
  87 Candidate16 makes this boundary explicit. Linux vendor-command paths preflight
  88 effective `CAP_SYS_RAWIO`, refuse whole-process root execution, provide exact
  89 least-privilege installation instructions, record preflight failures in native
  90 reports, and issue STOP UNIT cleanup. The build emits a warning but does not
  91 silently invoke `sudo` or modify file capabilities.
  92
  93
  94 ## Candidate16 build-hygiene status
  95
  96 Candidate16 preserves Candidate14 raw-I/O authorization and removes the user-side clock-skew and production long-path warning defects. The Linux validator normalizes only future source timestamps before building, and the raw-I/O preflight uses bounded path construction with a larger native-report note buffer.
  97
  98
  99 ## Candidate16 Linux Xbox tray-cycle status
 100
 101 Candidate15's first Linux Xbox smoke used a normal video DVD and proved target
 102 selection plus raw-I/O authorization, but failed immediately at Stage 2 because
 103 the Linux optical door remained locked while FriiDump held the device open.
 104 Candidate16 releases the Linux `CDROM_LOCKDOOR` state before each GDR-8050L
 105 software eject/load cycle, restores the lock after a successful load, and leaves
 106 the door unlocked on failure for manual recovery. The later Candidate21
 107 hardware run closed the Linux Xbox command-path gate with both game-view
 108 transitions, DMI capture, controlled partial output, cancellation, native
 109 reporting, and STOP UNIT. It did not claim a newly completed full Xbox image.