summaryrefslogtreecommitdiffstats
path: root/docs/tools
diff options
context:
space:
mode:
authorArthur Hanson Rasmusson <arthur@vgpu.io>2026-09-23 13:48:07 -0400
committerArthur Hanson Rasmusson <arthur@vgpu.io>2026-09-23 13:48:07 -0400
commitfade84f8b5b781d29daad40699d07928dedea550 (patch)
treee4156b3d0a6a1c794c90ef6834b949321cdfb5cb /docs/tools
parentc587eac377c1c5b720142edadebaace5cb1b17c0 (diff)
downloadopen-iov-fade84f8b5b781d29daad40699d07928dedea550.tar.gz
open-iov-fade84f8b5b781d29daad40699d07928dedea550.zip
docs: merge the legacy flat documents, add the CUDA deep-dive and link checks
* Merge and remove the pre-reboot flat documents, preserving their still-useful material in the structured tree: debugging workflows and the EPT-livelock case study (05-operations/02), performance microbenchmarks and A/B methodology (05-operations/01), the version-upgrade runbook (05-operations/02 section 4, with corrected host/guest framing), kernel-code pitfalls (07-developers) and the OpenRM build/load order (03-architecture/06 section 7). The remaining legacy files were verified redundant and removed. * docs/README now records where each migrated topic lives. * Portability: the config YAML files are called out as design targets that no code reads yet, with what adding support actually requires today. * Getting started: the OpenRM step is marked optional (native vGPU-management workflows only; the emulated path uses the distro driver). * tools docs: rmtool/rmtop marked as planned, pointing at the implemented tools/rmq subset. * wiki: new CUDA-Userspace-Driver deep-dive page (public-safe, links the canonical userspace/cuda analysis) and index update. * scripts/check-docs-links.py plus a CI step so relative links cannot rot. * STATE.md references to removed documents repointed.
Diffstat (limited to 'docs/tools')
-rw-r--r--docs/tools/rmtool.md5
-rw-r--r--docs/tools/rmtop.md5
2 files changed, 10 insertions, 0 deletions
diff --git a/docs/tools/rmtool.md b/docs/tools/rmtool.md
index a7ec2c6..93140f1 100644
--- a/docs/tools/rmtool.md
+++ b/docs/tools/rmtool.md
@@ -1,5 +1,10 @@
# rmtool - RM API Swiss Army Knife
+> **Status: planned / not implemented.** There is no `tools/rmtool/` directory
+> or build target today. The implemented RM-API tooling is the `rmq` subset
+> (`tools/rmq/`, the host RM-API oracle); treat this page as a design sketch,
+> not a user guide. See [tools/README.md](README.md).
+
## Overview
`rmtool` is a comprehensive userspace utility for interacting with the NVIDIA Resource Manager (RM) API. It provides direct access to RM internal state, engine control, memory management, and performance telemetry. Built on top of driver components studied through reverse engineering and
decompilation (referenced by component).
diff --git a/docs/tools/rmtop.md b/docs/tools/rmtop.md
index 6408268..6f9c047 100644
--- a/docs/tools/rmtop.md
+++ b/docs/tools/rmtop.md
@@ -1,5 +1,10 @@
# rmtop - GPU htop Equivalent
+> **Status: planned / not implemented.** There is no `tools/rmtop/` directory
+> or build target today. The implemented RM-API tooling is the `rmq` subset
+> (`tools/rmq/`, the host RM-API oracle); treat this page as a design sketch,
+> not a user guide. See [tools/README.md](README.md).
+
## Overview
`rmtop` is an interactive, ncurses-based real-time GPU monitoring dashboard. Like `htop` but for NVIDIA GPUs, providing live visualization of engine utilization, memory, channels, power, thermals, and GSP-RM telemetry.