vasilito
1790010483
Round 18's N22 'stale-doc removal' deleted three docs on the stated
premise that they had 'no references anywhere in the repo'. That premise
was wrong for two of them, and SUPERSEDED-DOC-LOG.md's recorded
absorption destinations for those two do not exist:
- CUB-PACKAGE-MANAGER.md was said to be absorbed into a 'redbear-cub
recipe README.md' and NETWORKING-IMPROVEMENT-PLAN.md section 8.2.
Neither exists -- there is no cub README under local/recipes/system/cub,
and that plan has no package-manager section (its 'cubic' matches are
TCP congestion control). README.md meanwhile links the doc from its
Documentation list and names cub in six places, so this left a headline
component with no documentation at all.
- BLUETOOTH-IMPLEMENTATION-PLAN.md was said to be merged into
NETWORKING-IMPROVEMENT-PLAN.md section 3.x. That file contains three
passing mentions of Bluetooth, not a 703-line plan. local/AGENTS.md,
docs/README.md and docs/07 all still list it as a first-class subsystem
plan, and AGENTS.md forbids treating Bluetooth as secondary.
Both restored from aa480f7ca3^ and their SUPERSEDED-DOC-LOG entries
retracted with the reason. USB-VALIDATION-RUNBOOK.md's supersession is
genuine -- USB-IMPLEMENTATION-PLAN.md carries the runbook as section 6.x
test procedures -- so it stays removed and its one reference now points
there.
Also de-dangled references to docs the authorised 2026-07-27
consolidation (092d1b39c3) removed but which canonical docs still cited
as openable: the driver-manager ASSESSMENT-2026-07-22 and D5-AUDIT
evidence files and the archived migration plan, across eight documents.
They now name what they were and where the supersession is recorded.
Remaining unresolved references are upstream KWin's vendored README
pointing at upstream's own CONTRIBUTING.md, which is deliberately not
touched.
262 lines
24 KiB
Markdown
262 lines
24 KiB
Markdown
# Stale-Doc Deletion Log — 2026-07-27
|
||
|
||
This log records every doc affected by the consolidation authorized on 2026-07-27
|
||
(operator selected option A: "Execute the doc deletion + restore"). It is the audit trail.
|
||
|
||
## Backup
|
||
|
||
**Tarball:** `/tmp/opencode/stale-doc-backup-2026-07-27.tar.gz` (386,925 bytes, 40 entries).
|
||
Captured BEFORE any `rm`. tar -tzf integrity verified.
|
||
|
||
## Restored
|
||
|
||
| Source | Destination | Reason |
|
||
|--------|-------------|--------|
|
||
| `local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | `local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | Document self-declares it is still the active low-level-controller authority despite the legacy folder name. SUPERSEDED.md had erroneously listed it as superseded. |
|
||
|
||
The IRQ plan carries stale `pcid-spawner` references that need a follow-up rename pass to
|
||
`driver-manager`. Tracked as a separate cleanup task — NOT executed in this consolidation.
|
||
|
||
## Replaced (deleted, content absorbed into consolidated doc)
|
||
|
||
The new consolidated audit and plan is `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md`
|
||
(1,029 lines, 14 sections). It absorbs the Rounds 1-7 of `3D-DRIVER-PLAN.md` and the
|
||
milestone status of `REDBEAR-FULL-SDDM-BRINGUP.md`.
|
||
|
||
| Deleted | Lines | Reason for replacement |
|
||
|---------|-------|------------------------|
|
||
| `local/docs/3D-DRIVER-PLAN.md` | 960 | All ground-truth and Round-7 work fact-of-record in consolidated doc. Operating principle restated in §0. |
|
||
| `local/docs/REDBEAR-FULL-SDDM-BRINGUP.md` | 177 | Build-campaign log; status captured in §1.5 of consolidated doc. |
|
||
|
||
## Deleted (with backup)
|
||
|
||
### From `local/docs/legacy-obsolete-2026-07-25/` (10 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `05-KDE-PLASMA-ON-REDOX.md` | 560 | Self-labeled historical/superseded. Pre-KF6 instructions superseded by consolidated doc + `CONSOLE-TO-KDE-DESKTOP-PLAN.md` |
|
||
| `BUILD-SYSTEM-ASSESSMENT-2026-07-18.md` | 464 | Audit absorbed into AGENTS.md policies |
|
||
| `BUILD-SYSTEM-HARDENING-PLAN.md` | 624 | Phases implemented; collision work now in `COLLISION-DETECTION-STATUS.md` |
|
||
| `DRM-MODERNIZATION-EXECUTION-PLAN.md` | 498 | Superseded by consolidated doc |
|
||
| `HOOKS.md` | 188 | Subsumed by `RELEASE-BUMP-WORKFLOW.md` + AGENTS.md |
|
||
| `INITNSMGR-CONCURRENCY-DESIGN.md` | 222 | Design for implemented O_NONBLOCK fix (v5.3) |
|
||
| `NETWORKING-STACK-STATE.md` | 120 | Superseded by `NETWORKING-IMPROVEMENT-PLAN.md` |
|
||
| `PATCH-PRESERVATION-AUDIT-2026-07-12.md` | 408 | Historical audit; 144-patch finding was addressed in subsequent rounds |
|
||
| `RAPL-IMPLEMENTATION-PLAN.md` | 530 | Draft, never implemented; power planning in `CONSOLE-TO-KDE` |
|
||
| `redbear-power-improvement-plan.md` | 6,184 | LARGEST file in repo. All improvement items done. Patterns extracted to `RATATUI-APP-PATTERNS.md` |
|
||
| `WAYLAND-IMPLEMENTATION-PLAN.md` | 186 | Diagnostic §§1-2 accurate; execution plan superseded by consolidated doc |
|
||
|
||
(11 entries; "11" matches the 11 legacy-line items, not "10"; counts in summary reflect this.)
|
||
|
||
### From `local/docs/archived/` (16 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `ACPI-I2C-HID-IMPLEMENTATION-PLAN.md` | 339 | Deferred; USB HID is primary input path |
|
||
| `BUILD-SYSTEM-IMPROVEMENTS.md` | 621 | Historical post-mortem |
|
||
| `DRIVER-MANAGER-MIGRATION-PLAN.md` | 2,861 | Round-by-round history superseded by `DRIVER-MANAGER.md` |
|
||
| `IMPLEMENTATION-MASTER-PLAN.md` | 129 | Completion report superseded by `CONSOLE-TO-KDE` |
|
||
| `IMPROVEMENT-PLAN.md` | 575 | RESOLVED quality audit |
|
||
| `INTEL-HDA-IMPLEMENTATION-PLAN.md` | 417 | Deferred audio plan |
|
||
| `KERNEL-SCHEDULER-MULTITHREAD-IMPROVEMENT-PLAN.md` | 1,026 | Historical scheduler analysis |
|
||
| `RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` | 165 | Credential work resolved in `KERNEL-IPC-CREDENTIAL-PLAN.md` |
|
||
| `repo-governance.md` | 99 | Historical, absorbed into AGENTS.md |
|
||
| `SLEEP-IMPLEMENTATION-PLAN.md` | 306 | All phases committed |
|
||
| `STUBS-FIX-PROGRESS.md` | 507 | Completed v6.0 stubs work; outcome captured in §3.2 of consolidated doc |
|
||
| `SYSTEM-STABILITY-AND-UPSTREAM-SYNC-PLAN.md` | 819 | Archived, replaced by `CONSOLE-TO-KDE` |
|
||
| `UPSTREAM-SYNC-PROCEDURE.md` | 829 | References obsolete `pcid-spawner` model |
|
||
| `USB-BOOT-INPUT-PLAN.md` | 169 | Superseded |
|
||
| `USB-VALIDATION-RUNBOOK-2026-07.md` | 137 | Older version; canonical `USB-VALIDATION-RUNBOOK.md` at top-level |
|
||
| `XHCID-DEVICE-IMPROVEMENT-PLAN.md` | 360 | Superseded |
|
||
|
||
### From `local/docs/evidence/driver-manager/` (2 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `ASSESSMENT-2026-07-22.md` | 368 | Pre-cutover; superseded by `DRIVER-MANAGER.md` |
|
||
| `D5-AUDIT.md` | 390 | Pre-cutover D5 gate audit; superseded |
|
||
|
||
### From `local/docs/fork-push-status/` (1 doc)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `2026-07-12-Round-9-phase-8.3.md` | 83 | Point-in-time push log |
|
||
|
||
### From `local/docs/boot-logs/` (6 docs — entire directory)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `README.md` | 57 | Directory inventory only |
|
||
| `cachyos-boot-20260629-0520.md` | 52 | Reference log from CachyOS |
|
||
| `REDBEAR-FULL-BOOT-EXTENDED-RESULTS.md` | 295 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-FULL-BOOT-POST-VIRTIO-BLKD-FIX-RESULTS.md` | 238 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-FULL-BOOT-RESULTS.md` | 281 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-MINI-BOOT-PS2D-INPUTD-LOG-FIX.md` | 134 | Bug diagnostic from 2026-06-30 (bug fixed) |
|
||
|
||
### From `local/docs/legacy-recipe-patches/` (1 doc)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `README.md` | 37 | Navigation aid only |
|
||
|
||
## Updated (NOT deleted; clear superseded entry)
|
||
|
||
| File | Change |
|
||
|------|--------|
|
||
| `local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md` | Removed the incorrectly listed "IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md is subsumed by Round 1-5 kernel work" line; replaced with cross-reference to its restored location. |
|
||
| `local/docs/archived/README.md` | Updated inventory table — entries moved to deletion log. |
|
||
|
||
## KEPT (companion plans, not affected)
|
||
|
||
`local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` is the new authoritative 3D-desktop doc.
|
||
Companion plans (referenced from §12 of the new doc) are NOT touched:
|
||
- `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` (desktop journey)
|
||
- `local/docs/DBUS-INTEGRATION-PLAN.md`, `local/docs/QT6-WAYLAND-NULL8-DIAGNOSIS.md`,
|
||
`local/docs/INPUT-STACK-LINUX-ALIGNMENT-PLAN.md`,
|
||
`local/docs/KERNEL-IPC-CREDENTIAL-PLAN.md`, `local/docs/ACPI-IMPROVEMENT-PLAN.md`,
|
||
`local/docs/USB-IMPLEMENTATION-PLAN.md`, `local/docs/WIFI-IMPLEMENTATION-PLAN.md`,
|
||
`local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md`,
|
||
`local/docs/NETWORKING-IMPROVEMENT-PLAN.md`, `local/docs/DRIVER-MANAGER.md`,
|
||
`local/docs/INIT-NAMESPACE-MANAGER-SCALABILITY-PLAN.md`,
|
||
`local/docs/LG-GRAM-16Z90TP-COMPATIBILITY-PLAN.md`,
|
||
`local/docs/HARDWARE-NETWORKING-INVENTORY.md`,
|
||
`local/docs/HARDWARE-VALIDATION-MATRIX.md`,
|
||
`local/docs/FIREWALL-VALIDATION-LOG.md`,
|
||
`local/docs/BUILD-SYSTEM-INVARIANTS.md`, `local/docs/BUILD-CACHE-PLAN.md`,
|
||
`local/docs/PACKAGE-BUILD-QUIRKS.md`,
|
||
`local/docs/QUIRKS-SYSTEM.md`, `local/docs/QUIRKS-AUDIT.md`,
|
||
`local/docs/QUIRKS-IMPROVEMENT-PLAN.md`,
|
||
`local/docs/LOCAL-FORK-SUPREMACY-POLICY.md`,
|
||
`local/docs/PATCH-GOVERNANCE.md`, `local/docs/RELEASE-BUMP-WORKFLOW.md`,
|
||
`local/docs/SCRIPT-BEHAVIOR-MATRIX.md`, `local/docs/RATATUI-APP-PATTERNS.md`,
|
||
`local/docs/CUB-PACKAGE-MANAGER.md`, `local/docs/GRUB-INTEGRATION-PLAN.md`,
|
||
`local/docs/COLLISION-DETECTION-STATUS.md`,
|
||
`local/docs/USB-VALIDATION-RUNBOOK.md`,
|
||
`local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md`
|
||
- `local/docs/evidence/lg-gram/ASSESSMENT-2026-07-26.md` (active LG Gram evidence)
|
||
- `local/docs/archived/README.md`, `local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md`
|
||
(inventory / index docs; updated, not deleted)
|
||
|
||
## Summary
|
||
|
||
- **Restored:** 1 doc
|
||
- **Replaced (deleted, content absorbed):** 2 docs
|
||
- **Deleted (with backup):** 36 docs across 6 locations
|
||
- **Updated (text only):** 2 inventory docs
|
||
- **Total operations:** 41
|
||
- **Tarball size:** 386,925 bytes
|
||
- **Net effect:** 38 files removed from git's working tree; 1 file moved from
|
||
`legacy-obsolete-2026-07-25/` to top-level. The 3D-desktop subsystem is now expressible
|
||
as a single canonical doc (`3D-DESKTOP-COMPREHENSIVE-PLAN.md`) plus 35 companion plans.
|
||
|
||
## Rounds 11–14 — Source-Level Supersessions (2026-07-27)
|
||
|
||
The above consolidation was a *document* pass. Subsequent rounds fixed
|
||
lie-grade code and stale references that the consolidation had left
|
||
behind or that came up in follow-up audits. Logged here for parity
|
||
with the deletion log.
|
||
|
||
| Round | Item | Resolution commit | Note |
|
||
|-------|------|---------------------|------|
|
||
| 9 (post-doc) | `relibc` RTLD_NOLOAD\|NOW + `readdir_r` panics | `2a2d1f354c` + submodule `dff28f00` | Replaced `todo!`/`unimplemented!` with proper `Result` propagation |
|
||
| 9 (post-doc) | `redbear-iwlwifi` MAC offset ≥ 6 fake-zero packet | `c21c70912e` | Returns `Err(ERANGE)` instead |
|
||
| 9 (post-doc) | `redbear-iwlwifi` `iwl_ops_tx` empty body | `c21c70912e` | Drains `iwl_pcie_txq_reclaim` overflow queue |
|
||
| 9 (post-doc) | Mesa redox_drm_fence type-mismatch UB | `aae6c36b80` | Allocates real `pipe_fence_handle` |
|
||
| 9 (post-doc) | Mesa redox_drm_surface stale "no-op" comment | `aae6c36b80` | Rewrote to describe real `REDOX_SCANOUT_FLIP` |
|
||
| 9 (post-doc) | `redbear-dnsd` `Ok(())` lie-grade config accept | `aae6c36b80` | Bound-checked parser mutates `self.upstream` |
|
||
| 9 (post-doc) | 24 broken doc cross-references (deleted-doc paths) | `163d6f0a59` | Replaced with post-Round-9 doc map |
|
||
| 9 (post-doc) | 7 stale `pcid-spawner` references in docs | `163d6f0a59` | Rewritten to `driver-manager` |
|
||
| 9 (post-doc) | `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` §10 pre-execution audit | `163d6f0a59` | Marked ✅ REPLACE/RESTORE/DELETE as completed |
|
||
| 10 | xwayland patch timestamp + DRM-only stubs | `d6a8159840` | Stripped `diff -ruN` timestamps, dropped DRM hunks (recipe has `-Ddrm=false`), replaced hardcoded button constants with `BTN_*` symbols |
|
||
| 10 | 5 stale `redbear-minimal` config refs | `d6a8159840` | Renamed to `redbear-mini` |
|
||
| 10 | `relibc` ld_so/dso.rs:1129/1203 panic sites | `5fac5f6edb` + submodule `90168f56` | `unimplemented!()` → `Err(format!(...))` |
|
||
| 11 | `local/recipes/system/redbear-passwd/recipe.toml` missing `[source]` | `a9e1c34e27` | Added `[source] path = "source"` |
|
||
| 11 | `local/recipes/dev/libclc/recipe.toml` no post-install verify | `a9e1c34e27` | Added 3 `test -f` checks for `libclc.pc` and `.bc` |
|
||
| 11 | `redbear-sessiond` `can_suspend/can_reboot/can_power_off` lie-grade | `a9e1c34e27` | `kstop_writable()` probes `/scheme/sys/kstop` |
|
||
| 11 | `redbear-dnsd` hardcoded 8.8.8.8/1.1.1.1 fallback | `a9e1c34e27` | Empty `Vec` — main() reads netcfg upstreams |
|
||
| 11 | 16+7 stale `redbear-kde-session` binary refs in 2 docs | `a9e1c34e27` | Renamed to `redbear-session-launch` |
|
||
| 11 | `relibc` TLSDESC misleading message | `2a0c747bc0` + submodule `688e76ca` | "riscv64 and x86" → "this target" |
|
||
| 12 | Mesa `04-sys-ioccom-stub-header.patch` | `f145e9e768` + submodule `ca7a7edb` | Moved to `relibc::include/sys/ioccom.h` (proper Linux IOC encoding). Patch removed. |
|
||
| 12 | `udev-shim` eth0 fallback collision | `6eed30f072` | `predictable_net_name` returns `net-malformed-<sanitized>` |
|
||
| 12 | `netcfg` summary hardcoded eth0 | `6eed30f072` | Iterates full devices map |
|
||
| 12 | 2 final `redbear-kde-session` refs | `6eed30f072` | Renamed to `redbear-session-launch` |
|
||
| 13 | `base::vesad` bare `panic!()` at loop exit | `c79333cd1d` + submodule `c5b32f9f` | `eprintln!` + `process::exit(0)` |
|
||
| 13 | `base::nvmed` `panic!("timeout on init")` | `c79333cd1d` + submodule `c5b32f9f` | Log + `process::exit(1)` so init can fall back |
|
||
| 13 | `base::nvmed` queue-error panics (commented out) | `c79333cd1d` + submodule `c5b32f9f` | Deleted dead commented-out panics |
|
||
| 13 | Stale `redbear-passwd` and `redbear-minimal.toml` refs in assessment doc | `e1adf3e9c8` | Struck through with ✅ RESOLVED 2026-07-27 |
|
||
| 14 | `local/recipes/system/redbear-wayland-guard/` LD_PRELOAD stub | (this commit) | **REMOVED** — violated STUB AND WORKAROUND POLICY ("No LD_PRELOAD tricks"). Correct fix lives in libwayland per `QT6-WAYLAND-NULL8-DIAGNOSIS.md`. |
|
||
| 14 | `local/recipes/system/firmware-loader` daemon 9-`.expect()` chain | (this commit) | All converted to `Result` propagation with log+exit |
|
||
| 14 | `redbear-{keymapd,ime,accessibility}` scheme daemon `.expect()` | (this commit) | Converted to `Result` propagation with `log_msg("ERROR", …)` + `process::exit(1)` |
|
||
| 14 | `local/recipes/AGENTS.md` redbear-wayland-guard entry marked "Rust" | (this commit) | Struck through — was actually a C LD_PRELOAD stub |
|
||
| 15 | `local/recipes/system/redbear-greeter/main.rs` `kill_child()` | `5682072e58` | `let _ = process.kill()/wait()` → logs kill+wait failure (zombie-child prevention) |
|
||
| 15 | `local/recipes/system/redbear-netctl/main.rs` (lines 201, 224) | `5682072e58` | `let _ = fs::remove_file()` → logs failure (stale active-profile prevention) |
|
||
| 15 | `local/recipes/system/redbear-usb-hotplugd/main.rs:254` | `5682072e58` | `let _ = child.kill()` → logs kill failure (USB-device-daemon leak prevention) |
|
||
| 15 | `local/recipes/system/redbear-acmd/main.rs:221` | `883e8147ec` | **SECURITY** — bare `let _ = setrens(0, 0)` → logs and returns on failure (privilege-boundary defense) |
|
||
| 15 | `README.md` status table null+8 contradiction | `883e8147ec` | Line 138 demoted ✅ → 🟡 with caveat about runtime re-verification pending; four lines now agree |
|
||
| 15 | `README.md` + `AGENTS.md` `redbear-live.iso` stale | `883e8147ec` | Replaced with accurate `<config>.iso` pattern (no `redbear-live` config exists) |
|
||
|
||
**Pattern emerging:** Lie-grade code in Red Bear is concentrated in
|
||
three places — (a) relibc fork panic-site catch-alls, (b) scheme daemon
|
||
init paths that use `.expect()` instead of `Result`, (c) Mesa DRM/wayland
|
||
stubbing. The first two are addressed by rounds 9–14. Mesa DRM and
|
||
Wayland null-guard work remains (EGL platform, PRIME/dma-buf, sync objects,
|
||
single-context CS, libwayland null safety) and is tracked in
|
||
`local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` § current state.
|
||
|
||
## Round 16 — More `let _ =` fixes + sessiond sleep-probe design (2026-07-27)
|
||
|
||
| Round | Item | Resolution commit | Note |
|
||
|-------|------|---------------------|------|
|
||
| 16 | `local/docs/SUPERSEDED-DOC-LOG.md` self-update | this entry | R15 entries appended (greeter/netctl/hotplugd let-underscore, acmd setrens security, README null+8 contradiction) |
|
||
| 16 | `local/recipes/system/redbear-sessiond/manager.rs` `can_*` for hibernate/sleep | `7a5b5963c4` | Block comment documents future-work probe design: when `/scheme/sys/sleep` lands, mirror the `kstop_writable()` pattern used by `can_power_off/can_reboot/can_suspend`. No code change yet — kernel support doesn't exist. |
|
||
| 16 | `local/recipes/system/redbear-authd/main.rs:328` child.wait | (this commit) | Replaced `let _ = child.wait()` with `match` that eprintln-logs exit status (validation-mode spawn reaper) |
|
||
| 16 | `local/recipes/system/redbear-dnsd/main.rs:111` socket.send_to | (this commit) | Replaced `let _ = socket.send_to(...)` with `if let Err(e) = ...` logging the loopback failure with `src` peer address |
|
||
|
||
### Round 16 — Audit findings with NO code changes needed
|
||
|
||
| Category | Outcome |
|
||
|----------|---------|
|
||
| **acpi-rs AML 41 bare panics** | Audit classified all 41 sites as internal-invariant (firmware table validation, field/destructure safety). Adding diagnostic strings is a one-shot pure-text edit; tracked for a future round. |
|
||
| **pcid IRQ/MSI-X panics** | All already carry diagnostic messages (`panic!("{driver}: failed to open IRQ file: {err}")`, etc.). The remaining concern is whether they should be `Result` (returns) — deferred; current panic behavior is correct for non-recoverable internal conditions. |
|
||
| **Stale CONFIG references** | All `redbear-kde`/`redbear-minimal`/`redbear-wayland-guard`/`redbear-kde-session`/`pcid-spawner` are in retired/removed context; no live stale references remain. |
|
||
| **USB daemon `let _ =` in ecmd/ftdi/usbaudiod** | All `#[cfg(not(target_os = "redox"))]` host-test paths only; never executed on Redox target. |
|
||
| **`redbear-sessiond` can_hibernate/can_hybrid_sleep/can_suspend_then_hibernate/can_sleep hardcoded `"na"`** | Honest stub — correct D-Bus signal for missing kernel capability. Documented in module comment for future maintenance. |
|
||
| **Mesa CS ioctl numbers** | Verified: `DRM_IOCTL_BASE + 31` / `+ 32` in `26-cs-submit-bidirectional-seqno.patch` match `redox-drm/scheme.rs` constants exactly. No drift. |
|
||
|
||
## Round 17 — Network stack Tier A + Tier B quick wins (2026-07-27)
|
||
|
||
| Round | Item | Resolution commit | Note |
|
||
|-------|------|---------------------|------|
|
||
| 17 | `relibc` `inet_ntop` IPv6 (NEW gap) | this commit | Real RFC 5952 formatter with longest-run `::` compression and tie-break. 7 unit tests (unspecified, loopback, routable, link-local, no-compression, tie-break, trailing-run). Fixes Q3 from the synthesis. |
|
||
| 17 | `relibc` `netinet/ip.h` constants | this commit | Populated the previously-empty 3-line stub. Adds `IP_OPTIONS`, `IP_HDRINCL`, `IP_TTL`, `IP_TOS`, `IP_RECVOPTS`, `IP_RECVRETOPTS`, `IP_RECVDSTADDR`, `IP_PKTINFO`, `IP_RECVPKTINFO`, `IP_MINTTL`, `IP_RECVTTL`, `IP_RECVERR`, `IP_DONTFRAG`, `IP_PMTUDISC_*`, `IP_BOUND_IF`, `IP_ORIGDSTADDR`, `IP_RECVORIGDSTADDR`, plus `struct ip` (BSD) and `struct iphdr` (Linux). 5 unit tests for roundtrip / alignment / value-correctness. |
|
||
| 17 | `relibc` `getaddrinfo` hints (NEW gap) | this commit | Full POSIX implementation: validates flag combinations (`EAI_BADFLAGS`), honors `ai_family`/`ai_socktype`/`ai_protocol`, supports `AI_NUMERICHOST` (now both v4 and v6), `AI_NUMERICSERV`, `AI_PASSIVE`, `AI_CANONNAME`, `AI_V4MAPPED`, `AI_ALL`. New AAAA record query type 0x001c parses 16-byte answers. Real IPv6 path emits `sockaddr_in6` entries with proper `ai_addrlen`. 8 unit tests. |
|
||
| 17 | `relibc` `inet_pton` `parse_ipv6_string` helper | this commit | Public Rust helper delegating to the existing `inet_pton(AF_INET6, ...)` implementation. Avoids reimplementing the parser. |
|
||
| 17 | `relibc` `sys_ioctl` `FIONREAD` | this commit | Wired into `ioctl_inner` via `dup_read(fd, "fionread", ...)`. Returns `ENOTTY` if the scheme does not advertise a `fionread` path (consistent with Linux's `TIOCNOTTY` semantics for unsupported ioctls). |
|
||
| 17 | `relibc` `PalSocket::accept4` (NEW gap) | this commit | Linux: native `__NR_accept4` syscall (288 on x86_64, 242 on aarch64) via `sc::syscall5`. Redox: fall-back to `accept()` + `fcntl()` for `SOCK_CLOEXEC` / `SOCK_NONBLOCK` (mirrors the Linux 2.6.27 pre-syscall situation). Public C wrapper added in `header/sys_socket/mod.rs`. Closes the #1 gap for Qt / glib compatibility. |
|
||
| 17 | `NETWORKING-IMPROVEMENT-PLAN.md:803` broken reference | this commit | Verified `local/docs/networking-validation-log.md` exists (was created 2026-07-27 with run template + open tasks). DEF-P0-12 in `NETWORKING-AND-DRIVERS-SYSTEMATIC-ASSESSMENT-2026-07-27.md` was incorrectly flagged as missing — file exists. |
|
||
| 17 | `NETWORKING-AND-DRIVERS-SYSTEMATIC-ASSESSMENT-2026-07-27.md` § 6.1 stale claims | this commit | DEF-P0-7 (`rtl8139d` / `rtl8168d` BAR panic) and DEF-P0-8 (`libredox` `demux()` `.expect()`) were both resolved in commits `3a3af825` (base) and `bfb5f8b` (libredox) respectively, both 2026-07-27. DEF-P0-10 (`redbear-dnsd` not wired) is wrong — recipe ships in `redbear-mini.toml` with `11_dnsd.service` since Round 11 commit `a9e1c34e27`. DEF-P0-12 reference target exists. |
|
||
| 17 | `local/docs/NETWORKING-IMPROVEMENT-PLAN.md` status row (round 15+) | this commit | Added `Status update — 2026-07-27` epilogue noting Phases 0–1 complete + Phase 2 partial, mirroring the upstream `.omo/plans/redbear-networking-status-2026-07-26.md` layout. |
|
||
|
||
### Round 17 — Audit findings with NO code changes needed
|
||
|
||
| Category | Outcome |
|
||
|----------|---------|
|
||
| **DEF-P0-7 `rtl8139d` / `rtl8168d` BAR lookup panic** | Already resolved in base commit `3a3af825` (Round 11.0). `map_bar()` returns `Option<*mut u8>`; `daemon()` does `match map_bar { Some => continue, None => log::error! + process::exit(1) }`. Driver exits cleanly so `driver-manager` records the failure without crashing the subsystem. |
|
||
| **DEF-P0-8 `libredox` `demux()` `.expect()`** | Already resolved in libredox commit `bfb5f8b` (Round 11.0). Saturates to `u16::MAX` on overflow rather than panicking every syscall wrapper (~40 call sites). |
|
||
| **DEF-P0-10 `redbear-dnsd` not wired** | Wrong — `redbear-dnsd` ships in `redbear-mini.toml` (inherited into `redbear-full.toml`) with `11_dnsd.service` since Round 11 commit `a9e1c34e27`. The systematic assessment was written before the Round 11 merge. |
|
||
| **`redbear-netstat` TCP/UDP table not implemented** | Real gap, deferred — needs live socket introspection from netstack. Tracked in `NETWORKING-IMPROVEMENT-PLAN.md` Phase 6 / § 1.4. |
|
||
| **`/scheme/dns` vs `/etc/resolv.conf`** | Architectural choice (relibc's DNS resolver reads `/etc/net/dns`); `redbear-dnsd` provides caching + `mDNS`. Documented in § 4 of `NETWORKING-IMPROVEMENT-PLAN.md`. |
|
||
| **`local/reference/linux-7.0/net/` missing** | Confirmed present in `local/reference/linux-7.1/` (the existing assessment referenced `linux-7.0`; the directory was bumped to 7.1 in Round 8). The fresh audit's NEW #7 finding about this path was wrong; path verification by `ls local/reference/` confirms. |
|
||
| **`local/recipes/system/redbear-firmware-{amdgpu,intel,iwlwifi,bluetooth}` are skeletons** | Real gap, deferred — requires operator-coordinated firmware blob acquisition per `local/scripts/fetch-firmware.sh`. Tracked as Phase 5. |
|
||
| **`netd` missing daemon** | Real gap — `netstack` (in `base` fork) is the canonical daemon; `recipes/system/netd/` was a never-implemented placeholder removed earlier. |
|
||
|
||
## Round 18 — Stale doc removal (2026-07-27)
|
||
|
||
Three orphaned docs deleted from `local/docs/`. None referenced anywhere in the repo (`grep -rln` returned 0 matches across 2026-07-27 HEAD). All three had last-modified timestamps Jul 10–14 while every other doc in `local/docs/` is Jul 26–27 — clearly superseded by the Round 5–17 consolidation. Backup tarball: `/tmp/opencode/stale-doc-backup-2026-07-27.tar.gz` (existing; updated by `tar --append`).
|
||
|
||
| File | Lines | Last modified | Reason |
|
||
|------|-------|---------------|--------|
|
||
| `local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md` | 770 | 2026-07-14 06:52 | ~~Merged into `NETWORKING-IMPROVEMENT-PLAN.md` § 3.x and `NETWORKING-AND-DRIVERS-CODE-ASSESSMENT-2026-07-27.md` § BTR.~~ **RETRACTED 2026-08-03 — RESTORED.** The claimed merge did not happen: `NETWORKING-IMPROVEMENT-PLAN.md` contains 3 passing mentions of Bluetooth, not a 703-line plan. `local/AGENTS.md` and `docs/README.md` still list this as a first-class subsystem plan, and `AGENTS.md` § SUBSYSTEM PRIORITY forbids treating Bluetooth as secondary. Restored from `aa480f7ca3^`. |
|
||
| `local/docs/CUB-PACKAGE-MANAGER.md` | 308 | 2026-07-12 07:45 | ~~Absorbed into `redbear-cub` recipe `README.md` and `NETWORKING-IMPROVEMENT-PLAN.md` § 8.2.~~ **RETRACTED 2026-08-03 — RESTORED.** Neither destination exists: there is no cub `README.md` under `local/recipes/system/cub/`, and `NETWORKING-IMPROVEMENT-PLAN.md` has no package-manager section (its `cubic` matches are TCP congestion control). This left cub — a headline component named 6 times in `README.md` — with no documentation at all. Restored from `aa480f7ca3^`. |
|
||
| `local/docs/USB-VALIDATION-RUNBOOK.md` | 130 | 2026-07-10 22:47 | Outdated by Round 16 USB P0-A3 CSZ cleanup commit `7cfed158` and `USB-IMPLEMENTATION-PLAN.md` Round-17, which absorbed the runbook as § 6.x test procedures. **Verified 2026-08-03:** absorption is real (15 validation/procedure sections present), so this deletion stands. |
|