kernel: GR context-promote bisection modes 4-17 and server-managed-ctxbuf registry variant; complete vgsp rename; docs/tooling refresh

- gsp_phys_booter: GR promote bisection modes 4-17 (two-phase zero-field VA,
  batched entries, hVirtMemory, bare VA, KMD SKIP_CTXBUFFER_ALLOC channel,
  old-interface GPU_INITIALIZE_CTX, FBMEM context buffer, UVM-faithful PA-only,
  PATCH/PM auxiliary promotes, server-managed no-promote path); PATCH/PM
  geometry queries and buffers; pre-boot SET_REGISTRY profile selection
- gsp_phys_gpu: gsp_phys_rmcall_gr_promote clamp 0..17 and gsp_phys_srv_ctxbuf
  parameter; registry image variant with RMSetClientRMAllocatedCtxBuffer=0
- vgsp rename across kernel, scripts, tools and docs (module vgsp.ko,
  /sys/kernel/debug/vgsp/, vgsp-<subsystem>: log prefixes)
- risc-v-gsp-rm-debugger user-facing rename and docs/CI refresh; guest-diag
  tool updates; README/SBOM/install/Makefile sync

Live status: CE ladder and P6 guest-copy forwarding green; GR engine context
commit still open (all promote shapes accepted or cleanly refused; the channel
stays CTXNOTVALID) - see Handoff-vGPU-IO.md Addendum 21 (local).

1 files changed, 15 insertions, 15 deletions

diff --git a/tools/guest-diag/phys_claim_cycle.sh b/tools/guest-diag/phys_claim_cycle.sh
index 0e00ae8..e89fbfc 100755
--- a/tools/guest-diag/phys_claim_cycle.sh
+++ b/tools/guest-diag/phys_claim_cycle.sh
@@ -2,7 +2,7 @@
 # phys_claim_cycle.sh - supervised physical-GPU claim/release cycle harness.
 #
 # Drives one or more full "D0 pre-lock" cycles of the physical-ownership
-# backend (open-iov-vfio + gsp_phys_gpu=1 + gsp_phys_hazard_ack=1):
+# backend (vgsp + gsp_phys_gpu=1 + gsp_phys_hazard_ack=1):
 #
 #   start persistenced -> wait GPU+root port active -> power/control=on on
 #   GPU+port -> dmesg -C -> (stop persistenced && insmod) as ONE command ->
@@ -33,7 +33,7 @@
 #   --dryrun     also pass gsp_phys_fwsec_dryrun=1 (implies --layout): run the
 #                READ-ONLY stage-3c validation (VBIOS/BIT/FWSEC parse and the
 #                staging/placement plan, no device writes); expects the
-#                "gsp-phys-fwsec-dryrun:" and "stage 3c dry-run complete"
+#                "vgsp-fwsec-dryrun:" and "stage 3c dry-run complete"
 #                lines. It is also implied by --boot-dryrun (alias)
 #   --boot-dryrun implies --dryrun and also passes gsp_phys_boot_dryrun=1
 #                (implies --layout): host-memory-only stage-3d staging
@@ -60,13 +60,13 @@
 #                this fused part: it left WPR2 up and was not host-recoverable.
 #                It is refused immediately and never reaches insmod. Use
 #                --boot; never stop after FWSEC alone on this host.
-#   --ko PATH    module to insmod (default kernel/open-iov-vfio.ko)
+#   --ko PATH    module to insmod (default kernel/vgsp.ko)
 #   --fw NAME    GSP firmware to stage (request_firmware name under
 #                /lib/firmware; default: the module's own default, currently
 #                nvidia/570.211.01/gsp_tu10x.bin)
 #   --nocat      pass gsp_phys_nocat=1: during --boot, log every GSP-RM NOCAT
 #                journal record (status-queue function 0x1020) to dmesg with
-#                the "gsp-nocat:" prefix. The unique-record summary is
+#                the "vgsp-nocat:" prefix. The unique-record summary is
 #                printed at the end of stage 3e (success or failure) with or
 #                without this flag; per-record logging is verbose.
 #   --restore-power  restore power/control=auto and restart persistenced at
@@ -106,7 +106,7 @@ BOOT_DRYRUN=0
 NOCAT=0
 KEEP=0
 RESTORE_POWER=0
-KO="$REPO_ROOT/kernel/open-iov-vfio.ko"
+KO="$REPO_ROOT/kernel/vgsp.ko"
 FW=""
 
 GPU_BDF="${GPU_BDF:-0000:01:00.0}"
@@ -247,8 +247,8 @@ if [ -n "$WATCH_PIDS" ]; then
     pre_fail "stale watcher process(es) running; stop them first"
 fi
 
-if lsmod 2>/dev/null | awk '{print $1}' | grep -qx open_iov_vfio; then
-    pre_fail "open_iov_vfio is already loaded; rmmod it first"
+if lsmod 2>/dev/null | awk '{print $1}' | grep -qx vgsp; then
+    pre_fail "vgsp is already loaded; rmmod it first"
 fi
 
 command -v lspci >/dev/null 2>&1 || pre_fail "lspci not found"
@@ -380,10 +380,10 @@ for n in $(seq 1 "$CYCLES"); do
     sleep 1
     save_dmesg "$DLOG"
 
-    if grep -q "gsp-phys: refusing claim" "$DLOG" 2>/dev/null; then
+    if grep -q "vgsp: refusing claim" "$DLOG" 2>/dev/null; then
         echo "PRECONDITION FAIL: cycle $n: module refused the claim (GPU/port were already runtime-suspended)" >&2
         warn "no claim was taken; unloading the module is safe"
-        timeout 60 sudo rmmod open_iov_vfio 2>/dev/null || true
+        timeout 60 sudo rmmod vgsp 2>/dev/null || true
         save_dmesg "$DLOG"
         exit 3
     fi
@@ -405,7 +405,7 @@ for n in $(seq 1 "$CYCLES"); do
     OK_DRYRUN=1
     if [ "$DRYRUN" -eq 1 ]; then
         OK_DRYRUN=0
-        if grep -q "gsp-phys-fwsec-dryrun:" "$DLOG" && \
+        if grep -q "vgsp-fwsec-dryrun:" "$DLOG" && \
            grep -q "stage 3c dry-run complete" "$DLOG"; then
             OK_DRYRUN=1
         fi
@@ -437,7 +437,7 @@ for n in $(seq 1 "$CYCLES"); do
     if [ "$NR_LOCKS" -eq 0 ] && [ "$OK_CLAIM" -eq 0 ]; then
         echo "ABORT: cycle $n: no locks and no claim took effect" >&2
         warn "no D0 locks were taken; unloading the module is safe"
-        timeout 60 sudo rmmod open_iov_vfio 2>/dev/null || true
+        timeout 60 sudo rmmod vgsp 2>/dev/null || true
         save_dmesg "$DLOG"
         exit 2
     fi
@@ -454,7 +454,7 @@ for n in $(seq 1 "$CYCLES"); do
         warn "cycle $n: gsp_phys_layout=1 but no 'stage 3b complete' line"
     fi
     if [ "$DRYRUN" -eq 1 ] && [ "$OK_DRYRUN" -ne 1 ]; then
-        warn "cycle $n: gsp_phys_fwsec_dryrun=1 but the read-only dry-run did not complete (missing 'gsp-phys-fwsec-dryrun:'/'stage 3c dry-run complete')"
+        warn "cycle $n: gsp_phys_fwsec_dryrun=1 but the read-only dry-run did not complete (missing 'vgsp-fwsec-dryrun:'/'stage 3c dry-run complete')"
     fi
     if [ "$BOOT_DRYRUN" -eq 1 ] && [ "$OK_BOOTPRIME" -ne 1 ]; then
         warn "cycle $n: gsp_phys_boot_dryrun=1 but 'stage 3d prime complete' is missing (staging rehearsal did not complete)"
@@ -504,9 +504,9 @@ for n in $(seq 1 "$CYCLES"); do
   lspci: $LSPCI_NN
   driver=$DRV  gpu=$RSTAT_GPU  port=$RSTAT_PORT
   power/control=on (GPU $GPU_BDF and port $PORT_BDF)
-  nvidia-persistenced stopped; open_iov_vfio loaded and holding the claim.
+  nvidia-persistenced stopped; vgsp loaded and holding the claim.
 To end the claimed session:
-  sudo rmmod open_iov_vfio
+  sudo rmmod vgsp
   echo auto | sudo tee /sys/bus/pci/devices/$GPU_BDF/power/control
   echo auto | sudo tee /sys/bus/pci/devices/$PORT_BDF/power/control
   sudo systemctl start nvidia-persistenced
@@ -517,7 +517,7 @@ EOF
         exit 0
     fi
 
-    timeout 60 sudo rmmod open_iov_vfio >/dev/null 2>&1
+    timeout 60 sudo rmmod vgsp >/dev/null 2>&1
     RMMOD_RC=$?
     sleep 1
     save_dmesg "$DLOG"