docs/CURRENT_STATUS.md

   1 # Current Status
   2
   3 ## Authority
   4
   5 FriiDump remains governed by the established Project Frankenstein repository
   6 and promoted release history. Candidate11 is a development candidate derived
   7 from candidate10; it is not yet a promoted release.
   8
   9 ## Validated paths
  10
  11 - Windows/MSVC 32-bit candidate10 challenge-drive behavior remains the current
  12   live-validated Windows authority.
  13 - Candidate11 compiles cleanly through Linux/CMake as a static binary.
  14 - Native-report fixtures and schema/semantic validation pass.
  15 - A portable XDFS/XBE metadata fixture proves title, media ID, Title ID, raw
  16   GameRegion, formatted region, and UTF-16-to-UTF-8 conversion.
  17 - Linux ISO/XISO code now returns the same structured Xbox result fields used by
  18   native reports, summary output, hashes, and Redump verification.
  19 - Linux GDR-8050L default output names can be derived from XBE/DMI metadata.
  20
  21 ## Hardware-validation boundary
  22
  23 Candidate11 has not yet been run against a physical Xbox-capable optical drive
  24 on Linux. Real hardware must prove no-media behavior, unlock state transitions,
  25 metadata, controlled cancellation, exact hashes, STOP UNIT, complete XISO, and
  26 redump-style ISO behavior before Linux support can be described as validated.
  27
  28 The development-only XGD1 layout and raw-ID probes remain Windows-only in this
  29 first candidate11 increment. They are tracked as a separate Linux-port substage
  30 and do not block ordinary user ISO/XISO validation.
  31
  32 ## Known inherited warnings
  33
  34 `libfriidump/rs.c` retains an inherited right-shift-count warning. Additional
  35 warnings visible under an explicit `-Wall -Wextra` audit predate candidate11 or
  36 are non-fatal test-path warnings. No candidate11 portable metadata source error
  37 or warning blocked the build.
  38
  39 ## Campaign
  40
  41 After Linux user-path validation, work proceeds to exact-tag release automation,
  42 then the FriiDump homepage/compatibility site v1.3.0, then a separately identified
  43 MinGW investigation.
  44
  45 ## Candidate12 correction status
  46
  47 Candidate12 closes the Linux GCC-4244 B101 full-dump gate and corrects runtime
  48 DAT discovery, Linux lock-status reporting, and the Linux `--help` validation
  49 false failure. The accepted live result is Sonic Mega Collection (US), 712880
  50 sectors, with CRC32 `01b52739`, MD5
  51 `85a525df1481d0ad67d8761f832dca12`, SHA-1
  52 `06eb6d15b4d7f90ec0fed9ce9a77db41358d74ed`, and SHA-256
  53 `30098da93f5de9ece8da44f8afdfb85cf9bcdc24d77131221e64e3038a529010`.
  54
  55
  56 ## Candidate16 Linux authorization status
  57
  58 Candidate13's live diagnostics proved that Candidate12/13 seed failures were
  59 host-side authorization failures: vendor opcode `0xE7` returned `EPERM` before
  60 usable drive sense, while Candidate11's working executable carried
  61 `cap_sys_rawio=ep`.
  62
  63 Candidate16 makes this boundary explicit. Linux vendor-command paths preflight
  64 effective `CAP_SYS_RAWIO`, refuse whole-process root execution, provide exact
  65 least-privilege installation instructions, record preflight failures in native
  66 reports, and issue STOP UNIT cleanup. The build emits a warning but does not
  67 silently invoke `sudo` or modify file capabilities.
  68
  69
  70 ## Candidate16 build-hygiene status
  71
  72 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.
  73
  74
  75 ## Candidate16 Linux Xbox tray-cycle status
  76
  77 Candidate15's first Linux Xbox smoke used a normal video DVD and proved target
  78 selection plus raw-I/O authorization, but failed immediately at Stage 2 because
  79 the Linux optical door remained locked while FriiDump held the device open.
  80 Candidate16 releases the Linux `CDROM_LOCKDOOR` state before each GDR-8050L
  81 software eject/load cycle, restores the lock after a successful load, and leaves
  82 the door unlocked on failure for manual recovery. A physical Xbox-disc smoke is
  83 required before the Linux Xbox gate can close.