docs(driver-manager): v4.8 post-cutover comprehensive audit
v4.8 is the first comprehensive cross-subsystem audit after the
cutover completed (pcid-spawner retired 2026-07-24). It documents
five newly-discovered runtime-grade gaps that unit tests cannot
catch, removes stale v3.0-era text whose blockers were closed, and
integrates the boot-race / initnsmgr concurrency design.
Five new gaps:
- G-A1: AER/pciehp hash-deduplication is order-dependent and unreliable
(aer.rs::stable_hash + last_seen: u64). Replace with monotonic seq
number from pcid producer or per-event BTreeSet of seen hashes.
- G-A2: cpufreqd/thermald integration broken - thermald writes
/scheme/cpufreq/governor but cpufreqd provides no scheme server.
- G-A3: pcid AER/pciehp FIFO rollover silently drops events.
- G-A4: redbear-iwlwifi uses legacy PCID_DEVICE_PATH instead of the
standard PCID_CLIENT_CHANNEL channel contract.
- G-A5: driver-manager restart re-applies recovery actions to
already-recovered devices (per-process last_seen state).
v5.x work program: v5.0 (dedup fix), v5.1 (cpufreqd scheme),
v5.2 (iwlwifi spawned-mode), v5.3 (initnsmgr O_NONBLOCK),
v5.4 (Driver::on_error rollout), v5.5 (boot-race instrumentation),
v5.6 (hardware validation matrix - operator-only).
Cross-reference: Linux 7.1 (C13 AER partial - 4-state vs 6-state;
C14 pciehp partial - 4 of 5 hardware bits), CachyOS patterns
(modprobe.d options parsing not yet implemented).
Adjacent-tech audit: cpufreqd/thermald broken; thermald, coretempd,
iommu, numad, udev-shim, driver-params, redox-drm, xhcid/ehcid/ohcid/uhcid,
virtio-netd, acpid, firmware-loader all OK; redbear-iwlwifi legacy.
Boot race conditions documented from INITNSMGR-CONCURRENCY-DESIGN.md:
head-of-line block, pcid producer race, firmware-load race, acpid/AML
race, iopl race.
Driver inventory: 35+ recipes + 17 base-internal daemons cross-referenced
with /lib/drivers.d/*.toml match tables and boot logs.
Stale text removed: outdated LOC counts, closed quirks/service/tests
items, pcid-spawner-as-fallback references (now retired).
v4.7 in turn superseded v4.6 (redbear-hid-core parser integration tests);
v4.6 superseded v4.5 (contract tests for pci_register_error_handler on
linux-kpi); v4.5 superseded v4.4 (Red Bear-original daemon dead-code
removal); v4.4 superseded v4.3 (boot-log noise, real bincode RPC for
iommu_group_env_value); v4.3 superseded v4.2 (Driver-level Driver::on_error
IPC layered architecture); v4.2 superseded v4.1 (acpid pci_fd fix,
per-vendor firmware recipes); v4.1 superseded v4.0.
kellito
917774776a