summaryrefslogtreecommitdiffstats
path: root/docs/03-architecture/01-system-overview.md
diff options
context:
space:
mode:
authorArthur Hanson Rasmusson <arthur@vgpu.io>2026-10-06 15:18:39 -0400
committerArthur Hanson Rasmusson <arthur@vgpu.io>2026-10-06 15:18:39 -0400
commit929646875d80408a21c642ca88ef70efbc0d736a (patch)
treedeb2946cc4407e4edcc6e3b56f37420e321acf40 /docs/03-architecture/01-system-overview.md
parent039daee13c5bac50919eff1ca26977ac49e37b06 (diff)
downloadopen-iov-929646875d80408a21c642ca88ef70efbc0d736a.tar.gz
open-iov-929646875d80408a21c642ca88ef70efbc0d736a.zip
docs: add the GR compute-launch frontier page and align execution status across the tree
New page docs/04-implementation/03-execution-frontier.md describes the chain that must fire for a guest CUDA launch (guest push -> GPFIFO/front-end -> inline launch-descriptor install -> engine read/dispatch -> completion), where the leading edge is (the descriptor install path), how we know (front-end vs engine-authored observables and their limits), what is exonerated (context validity at dispatch, destination window mapping, fetch alignment, shared-buffer rule, parenting), the ranked issues (verbatim prelude targets, missing descriptor-virtualization control, sentinel hygiene), live investigation lines and labelled theories. Align every page that still said GR execution is blocked on engine-context validity to the current frontier, and add the new page to the README reading order (row 15, later rows renumbered). Docs only; no code.
Diffstat (limited to 'docs/03-architecture/01-system-overview.md')
-rw-r--r--docs/03-architecture/01-system-overview.md7
1 files changed, 4 insertions, 3 deletions
diff --git a/docs/03-architecture/01-system-overview.md b/docs/03-architecture/01-system-overview.md
index 8205154..71f52f2 100644
--- a/docs/03-architecture/01-system-overview.md
+++ b/docs/03-architecture/01-system-overview.md
@@ -174,9 +174,10 @@ decompiled and mapped (see `wiki/GSP-570.144W-Firmware-Analysis.md` and
completes and the full CUDA driver-API smoke passes (`ALL OK` 64/64, copies
matched). The execution backend is live: CE-class copies are
forwarded to the physical copy engine (default off) with engine-authored
- semaphore releases and a fault relay; kernel execution is blocked on GR
- engine-context validity (see
- [`08-physical-gpu-integration.md`](08-physical-gpu-integration.md)).
+ semaphore releases and a fault relay; for GR, a forwarded guest launch
+ reaches the front-end but the inline launch-descriptor install has not been
+ observed (no grid dispatched; context validity at dispatch is ruled out —
+ see [`../04-implementation/03-execution-frontier.md`](../04-implementation/03-execution-frontier.md)).
The CUDA-side contract and the reply-fidelity rules are documented in
[`../../userspace/cuda/docs/03-driver-and-gpu-interface.md` §9](../../userspace/cuda/docs/03-driver-and-gpu-interface.md)