]> FriiDump Source - friidump.git/blob - docs/CURRENT_STATUS.md
FriiDump 0.5.3.16: finalize release identity and documentation
[friidump.git] / 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 Linux GDR-8050L path established both Xbox game-view transitions, read
17   XDVDFS metadata, captured DMI media ID `TQ00501A`, produced a controlled
18   partial GAME-XDVDFS output with hashes and native reporting, and completed
19   STOP UNIT.
20 - Native `friidump-test-result.v1` reports cover complete, partial, failed,
21   cancelled, no-media, seed-failure, and modified-firmware states.
22
23 ## Hardware-validation boundary
24
25 The Linux GDR-8050L evidence validates the command path, game-view state,
26 metadata, controlled partial output, cancellation, reporting, and cleanup. It
27 does not by itself claim a newly completed full Original Xbox image on Linux.
28 Candidate-specific validation scripts remain in `validation/` as historical,
29 exact evidence tools; release builds use the maintained build entry points and
30 the generic raw-I/O capability helper.
31
32 ## Known inherited warnings
33
34 `libfriidump/rs.c` retains an inherited right-shift-count warning. Other
35 explicit `-Wall -Wextra` warnings are pre-existing or non-fatal test-path
36 warnings and were not silently normalized during release finalization.
37
38 ## Campaign
39
40 Release publication uses an exact annotated tag, exact-tag Windows and Linux
41 builders, immutable artifact manifests, and independent private/public
42 read-back. Candidate retirement remains a separate final gate.
43
44 ## Candidate12 correction status
45 Candidate12 closes the Linux GCC-4244 B101 full-dump gate and corrects runtime
46 DAT discovery, Linux lock-status reporting, and the Linux `--help` validation
47 false failure. The accepted live result is Sonic Mega Collection (US), 712880
48 sectors, with CRC32 `01b52739`, MD5
49 `85a525df1481d0ad67d8761f832dca12`, SHA-1
50 `06eb6d15b4d7f90ec0fed9ce9a77db41358d74ed`, and SHA-256
51 `30098da93f5de9ece8da44f8afdfb85cf9bcdc24d77131221e64e3038a529010`.
52
53
54 ## Candidate16 Linux authorization status
55
56 Candidate13's live diagnostics proved that Candidate12/13 seed failures were
57 host-side authorization failures: vendor opcode `0xE7` returned `EPERM` before
58 usable drive sense, while Candidate11's working executable carried
59 `cap_sys_rawio=ep`.
60
61 Candidate16 makes this boundary explicit. Linux vendor-command paths preflight
62 effective `CAP_SYS_RAWIO`, refuse whole-process root execution, provide exact
63 least-privilege installation instructions, record preflight failures in native
64 reports, and issue STOP UNIT cleanup. The build emits a warning but does not
65 silently invoke `sudo` or modify file capabilities.
66
67
68 ## Candidate16 build-hygiene status
69
70 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.
71
72
73 ## Candidate16 Linux Xbox tray-cycle status
74
75 Candidate15's first Linux Xbox smoke used a normal video DVD and proved target
76 selection plus raw-I/O authorization, but failed immediately at Stage 2 because
77 the Linux optical door remained locked while FriiDump held the device open.
78 Candidate16 releases the Linux `CDROM_LOCKDOOR` state before each GDR-8050L
79 software eject/load cycle, restores the lock after a successful load, and leaves
80 the door unlocked on failure for manual recovery. A physical Xbox-disc smoke is
81 required before the Linux Xbox gate can close.