Difference between revisions of "Graphics Execution"

From Open-IOV
Jump to navigation Jump to search
m (2026-11-09 evening refresh 2: forced GLX selects libnvidia-glcore; windowed glxgears hangs in the glcore kick wait; kernel-visible present completion is the wall)
m (2026-11-10 status refresh: guest GL draws forward and execute on the physical GPU; the 0-pixel wall is the constant-buffer (MVP) content)
Line 5: Line 5:
<blockquote>'''Scope.''' How the emulated vGPU runs '''3D graphics''' work — the OpenGL and Vulkan command streams a stock guest submits — on the physical GPU, and what is proven about it. This is the shared machinery behind [[OpenGL|<code>OpenGL.md</code>]], [[Vulkan|<code>Vulkan.md</code>]] and the Windows/DirectX target ([[DirectX|<code>DirectX.md</code>]]); CUDA compute uses the same submission and completion path for a different engine workload ([[The Execution Frontier|<code>Execution-Frontier.md</code>]]). Canonical sources: [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/05-graphics-execution-plan.md <code>../docs/04-implementation/05-graphics-execution-plan.md</code>] (the plan and milestone ladder) and [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/04-real-render-walls.md <code>../docs/04-implementation/04-real-render-walls.md</code>] (the measured walls); the docs tree wins on disagreement.</blockquote>
<blockquote>'''Scope.''' How the emulated vGPU runs '''3D graphics''' work — the OpenGL and Vulkan command streams a stock guest submits — on the physical GPU, and what is proven about it. This is the shared machinery behind [[OpenGL|<code>OpenGL.md</code>]], [[Vulkan|<code>Vulkan.md</code>]] and the Windows/DirectX target ([[DirectX|<code>DirectX.md</code>]]); CUDA compute uses the same submission and completion path for a different engine workload ([[The Execution Frontier|<code>Execution-Frontier.md</code>]]). Canonical sources: [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/05-graphics-execution-plan.md <code>../docs/04-implementation/05-graphics-execution-plan.md</code>] (the plan and milestone ladder) and [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/04-real-render-walls.md <code>../docs/04-implementation/04-real-render-walls.md</code>] (the measured walls); the docs tree wins on disagreement.</blockquote>


Status: 2026-11-09, tree <code>master @ 21e0d611</code>. Tags: <code>[live]</code> observed end to end; <code>[wip]</code> partially built; <code>[wall]</code> current blocker; <code>[target]</code> defined success state; <code>[planned]</code> designed, not built.
Status: 2026-11-09, tree <code>master @ cb8e822b</code>. Tags: <code>[live]</code> observed end to end; <code>[wip]</code> partially built; <code>[wall]</code> current blocker; <code>[target]</code> defined success state; <code>[planned]</code> designed, not built.


== 1. What "real pixels" means ==
== 1. What "real pixels" means ==
Line 33: Line 33:
# '''Verbatim 3D method-stream replay''' <code>[live]</code>. The emulation captures the X server's graphics-class (<code>0xC597</code>, <code>TURING_A</code>) section from its channel, relocates the operand addresses into host-built shadow pages the engine can reach, and submits the stream unchanged. The engine retires it: the uploads (<code>LINE_LENGTH_IN</code>/<code>LAUNCH_DMA</code>), the state, program and texture binds, and the release all execute with no MMU fault. This proves the ''mechanics'' of 3D execution — object bind, window placement, operand relocation, completion — on real hardware.
# '''Verbatim 3D method-stream replay''' <code>[live]</code>. The emulation captures the X server's graphics-class (<code>0xC597</code>, <code>TURING_A</code>) section from its channel, relocates the operand addresses into host-built shadow pages the engine can reach, and submits the stream unchanged. The engine retires it: the uploads (<code>LINE_LENGTH_IN</code>/<code>LAUNCH_DMA</code>), the state, program and texture binds, and the release all execute with no MMU fault. This proves the ''mechanics'' of 3D execution — object bind, window placement, operand relocation, completion — on real hardware.
# '''Synthesized launch from a captured section''' <code>[live]</code>. A compute-shaped launch built from the captured section (operand list, program, a 64-word launch descriptor) reaches the engine and retires real <code>sm_75</code> SASS; the Turing shader-program-header form (<code>V3</code>) is accepted with zero header faults across repeated launches. This proved engine-side dispatch before the verbatim lane existed. The program itself is still a development stand-in at this rung — execution proof, not pixels.
# '''Synthesized launch from a captured section''' <code>[live]</code>. A compute-shaped launch built from the captured section (operand list, program, a 64-word launch descriptor) reaches the engine and retires real <code>sm_75</code> SASS; the Turing shader-program-header form (<code>V3</code>) is accepted with zero header faults across repeated launches. This proved engine-side dispatch before the verbatim lane existed. The program itself is still a development stand-in at this rung — execution proof, not pixels.
# '''Forwarding the client's own pushes''' <code>[wip]</code>. The GL client's own channels now register, submit and retire: the direct-GL GR channel (<code>0xbeef0100</code>) and its CE siblings (<code>0xbeef0101</code>/<code>0xbeef0102</code>) are discovered, their rings and releases are decoded, and the X server's DDX kick channel (<code>0xbfef0002</code>) is decoded from its ring head with its class-2D notification authored. The X DDX waits are fixed (class-aware display arm, <code>0x8000 -&gt; 0</code> notification completion, decoded GL release applied), and with GLX forced (<code>SDL_VIDEO_X11_FORCE_EGL=0</code>) the windowed GL path selects <code>libnvidia-glcore</code>. What remains is the kernel-visible GL present/kick completion, the DDX get-word/notifier recycle, and physical dispatch of the client's draws (§6).
# '''Forwarding the client's own pushes''' <code>[wip]</code>. The GL client's own channels now register, submit and retire: the direct-GL GR channel (<code>0xbeef0100</code>) and its CE siblings (<code>0xbeef0101</code>/<code>0xbeef0102</code>) are discovered, their rings and releases are decoded, and the X server's DDX kick channel (<code>0xbfef0002</code>) is decoded from its ring head with its class-2D notification authored. The X DDX waits are fixed (class-aware display arm, <code>0x8000 -&gt; 0</code> notification completion, decoded GL release applied), forcing GLX selects <code>libnvidia-glcore</code>, and the event-IRQ fix (<code>a478f0b4</code>) lets the guest service the completion, so glxgears completes swaps and the guest's real GL draws now forward and execute on the physical GPU (<code>work_gr backend_ok=9</code>). What remains is the constant-buffer (MVP) content, the MME front-end defer and GR stale-wedge, and the DDX get-word/notifier completion (§6).


== 4. The channel and object picture ==
== 4. The channel and object picture ==
Line 47: Line 47:
The acceptance signal is the '''engine-authored release''': a semaphore the engine writes when the work completes. For GL, completion flows through the channel's semaphores/notifications to the X server and the app's swap wait; for Vulkan, the client's fence value is released; for CUDA, the launch's release group wakes the client. The emulation relays engine completions into guest-observable memory (MSI-X plus a poller), and the guest resumes from there.
The acceptance signal is the '''engine-authored release''': a semaphore the engine writes when the work completes. For GL, completion flows through the channel's semaphores/notifications to the X server and the app's swap wait; for Vulkan, the client's fence value is released; for CUDA, the launch's release group wakes the client. The emulation relays engine completions into guest-observable memory (MSI-X plus a poller), and the guest resumes from there.


For the display path, completion is the notifier write and <code>UPDATE -&gt; FINISHED</code>; a completion event deferred by the reply path is force-retried until it posts, so the X server's mode set finishes. For the X DDX's own 2D push buffers, completion also requires the GPU-written engine get word to advance and the notifier to be recycled to <code>0xffff</code> after a kick; both are host-side levers now, and a diagnostic write of the get word released the DDX's reserve loop. For a windowed GL client the present is a kick whose completion the guest kernel observes by polling its per-slot <code>/dev/nvidia-modeset</code> fd; the host must complete the exact notifier page the kernel watches and signal that event, not only write the notifier memory.
For the display path, completion is the notifier write and <code>UPDATE -&gt; FINISHED</code>; a completion event deferred by the reply path is force-retried until it posts, so the X server's mode set finishes. For the X DDX's own 2D push buffers, completion also requires the GPU-written engine get word to advance and the notifier to be recycled to <code>0xffff</code> after a kick; both are host-side levers now, and a diagnostic write of the get word released the DDX's reserve loop. For a windowed GL client the present is a kick; the GSP event-IRQ fix now sets the RISC-V SWGEN0 IRQSTAT/IRQMASK/IRQDEST and latches the CPU-tree leaf, so the guest services the event and glxgears completes swaps. The next completion step is the constant buffer: the draw's CB page must be resolved and copied into the seed page so the engine produces fragments.


During bring-up the module also carries a '''diagnostics-only mirror''' for apps that spin on a shared progress word; it exists so a run can proceed while the natural completion path is being finished. The 60-fps milestone explicitly requires it switched off, along with any external poke.
During bring-up the module also carries a '''diagnostics-only mirror''' for apps that spin on a shared progress word; it exists so a run can proceed while the natural completion path is being finished. The 60-fps milestone explicitly requires it switched off, along with any external poke.
Line 53: Line 53:
== 6. Where the frontier is (ranked walls) ==
== 6. Where the frontier is (ranked walls) ==


# '''Kernel-visible GL present completion''' <code>[wall]</code>. With GLX forced the windowed client uses <code>libnvidia-glcore</code>; the minimal <code>glxgears</code> then hangs in the glcore kick wait: the client polls its per-slot <code>/dev/nvidia-modeset</code> fd (<code>poll(POLLIN, 1 s)</code>). The host's sweep completes the beef notifier memory, but the guest kernel never signals the event the poll waits on. The exact notifier page the kernel watches must be completed and the guest event signalled (the kick-notify executor), not just the memory written.
# '''The constant buffer (MVP) content''' <code>[wall]</code>. The guest's GL draws now execute on the physical GPU, but the engine writes 0 pages. The draw's constant-buffer source is forced to the seed page because <code>cb-copy src=0x0cd70000 ... first8=00000000 ... src=synthetic-id</code> reads all zeros; a guest-RAM scan found no MVP matrix and the <code>0x3f800000</code> vidmem hits are shader microcode immediates. With a zero MVP every vertex collapses to the origin, so there are no fragments. Decode the CB-bind method on the beef channel, resolve that VA through the channel VAS, and copy the real page into the seed page.
# '''The X DDX push-buffer completion''' <code>[wall]</code>. The DDX's 2D reserve loop exits only when the GPU-written engine get word advances (<code>get &lt;= put</code>) and the kick requires the notifier to be recycled to <code>0xffff</code> after completion. A diagnostic host write released the loop; the kernel levers to publish/advance the get word and recycle the notifier are next.
# '''Execution stability''' <code>[wall]</code>. The MME front-end is busy/deferred (<code>MME-FE-DEFER</code> then forced loads) and the GR channel stale-wedges (<code>GR-STALL-stale-wedge</code>, recovered), so the pipeline restarts mid-frame. Fixing the CB page may unstick the MME; the wedge recovery needs a durable fix.
# '''The X DDX push-buffer completion''' <code>[wall]</code>. The DDX's 2D reserve loop exits only when the GPU-written engine get word advances (<code>get &lt;= put</code>) and the kick requires the notifier to be recycled to <code>0xffff</code> after completion. <code>sema_vas_cand_ms=1</code> makes X green on attempt 1, but X can still die after a few forward frames into the RM-degraded state.
# '''The X DDX footprint''' <code>[wall]</code>. The DDX allocates 4 GB of system pages at startup; an 8 GB guest has no headroom once GZDoom's own footprint lands and both are OOM-killed. Current runs use a 12 GB guest; the allocation is a suspected emulation gap (a 512 MiB emulated VRAM falling back to a 4 GB sysmem allocation) to fix.
# '''The X DDX footprint''' <code>[wall]</code>. The DDX allocates 4 GB of system pages at startup; an 8 GB guest has no headroom once GZDoom's own footprint lands and both are OOM-killed. Current runs use a 12 GB guest; the allocation is a suspected emulation gap (a 512 MiB emulated VRAM falling back to a 4 GB sysmem allocation) to fix.
# '''Physical dispatch of the GL draws''' <code>[wall]</code>. The direct-GL channels submit and get host-completed releases, but the forwarding path reports no dispatch to the physical GR engine (<code>forwarded=0</code>); the draws are decoded and host-completed, not executed on hardware.
# '''Non-black frames and sustained rate''' <code>[wall]</code>/<code>[target]</code>. Once the constant buffer, the MME/wedge stability and the DDX get-word/notifier completion land, the capture must show motion, then 60 fps in one VM with no forcing, then two VMs on two mediated devices with non-black frames in both.
# '''Non-black frames and sustained rate''' <code>[wall]</code>/<code>[target]</code>. Once the kernel-visible present completion and the DDX get-word/notifier completion land, the capture must show motion, then 60 fps in one VM with no forcing, then two VMs on two mediated devices with non-black frames in both.


== 7. What is proven today ==
== 7. What is proven today ==
Line 78: Line 78:
| <code>[live]</code>
| <code>[live]</code>
|-
|-
| GZDoom obtains a real GL context; windowed reaches renderer startup
| X server green with <code>sema_vas_cand_ms=1</code>; glxinfo 4.6.0 direct
| <code>[live]</code> (pixels frontier)
| <code>[live]</code>
|-
|-
| GZDoom reaches <code>MAP01</code> on Mesa llvmpipe (not the emulated vGPU path)
| GSP event-IRQ fix wakes the guest poll; glxgears completes swaps
| <code>[wip]</code>
| <code>[live]</code>
|-
|-
| Forced GLX (<code>SDL_VIDEO_X11_FORCE_EGL=0</code>) selects <code>libnvidia-glcore</code>
| 2D path end-to-end: accelerated X fills read back via <code>xwd</code>
| <code>[live]</code>
| <code>[live]</code>
|-
|-
| Windowed GL present/kick completion (minimal <code>glxgears</code>)
| Guest's real GL draws forward and execute on the physical GPU (<code>work_gr backend_ok=9</code>)
| <code>[wall]</code>
| <code>[live]</code>
|-
|-
| X server survives the GZDoom run on a 12 GB guest (the DDX's 4 GB sysmem allocation forces the size)
| Beef GR channel <code>0xbeef0100</code> captures real GL draw sections
| <code>[live]</code>
| <code>[live]</code>
|-
|-
| GL section capture: the X server's <code>0xC597</code> stream decoded
| GL section capture: the X channel's <code>0xC597</code> stream decoded
| <code>[live]</code>
| <code>[live]</code>
|-
|-
Line 102: Line 102:
| <code>[live]</code>
| <code>[live]</code>
|-
|-
| 2D screen fills and copy-engine present ops execute
| X server survives the run on a 12 GB guest (the DDX's 4 GB sysmem allocation forces the size)
| <code>[live]</code>
|-
| Direct GL client: device-init gate handled, channels allocate, readback path returns clean
| <code>[live]</code>
| <code>[live]</code>
|-
|-
| Direct GL client channels submit and retire (GR <code>0xbeef0100</code>, CE <code>0xbeef0101</code>/<code>0xbeef0102</code>); DDX kick channel decoded
| Constant-buffer (MVP) page resolves and the draw writes render-target pixels
| <code>[live]</code>
|-
| Guest kernel observes the kick completion and signals the modeset event
| <code>[wall]</code>
| <code>[wall]</code>
|-
|-
| NVIDIA Vulkan ICD creates a device
| MME front-end defer / GR stale-wedge stability
| <code>[wall]</code>
| <code>[wall]</code>
|-
|-
Line 120: Line 114:
| <code>[wall]</code>
| <code>[wall]</code>
|-
|-
| Physical dispatch of the direct-GL draws (<code>forwarded=0</code>)
| NVIDIA Vulkan ICD creates a device
| <code>[wall]</code>
| <code>[wall]</code>
|-
|-
Line 133: Line 127:


* No non-black pixel has been produced by the emulated vGPU's 3D pipeline yet.
* No non-black pixel has been produced by the emulated vGPU's 3D pipeline yet.
* Display/KMS bring-up (NvKms, <code>/dev/dri</code>, X, a real GL context) is not a rendered-frame claim; GZDoom reaching <code>MAP01</code> on Mesa llvmpipe is not the emulated-vGPU path, and the later forced-GLX run selects <code>libnvidia-glcore</code> but hangs in the present/kick wait. The kernel-visible present completion, the DDX get-word/notifier completion and the physical dispatch of the GL draws are the current walls.
* Display/KMS bring-up (NvKms, <code>/dev/dri</code>, X, a real GL context) is not a rendered-frame claim; the guest's GL draws now execute on the physical GPU and glxgears completes swaps, but the frames are black. The constant-buffer (MVP) content, the MME/wedge stability and the DDX get-word/notifier completion are the current walls.
* No frame-rate or latency numbers: the scheduled measurement is defined (60 fps over 60 s, no forcing) but not yet met.
* No frame-rate or latency numbers: the scheduled measurement is defined (60 fps over 60 s, no forcing) but not yet met.
* The <code>virgl</code>-based demo videos are a different, labelled path — not this one.
* The <code>virgl</code>-based demo videos are a different, labelled path — not this one.

Revision as of 10:23, 10 November 2026

An absence of critical technical documentation has historically slowed growth and adoption of developer ecosystems for GPU virtualization.

This CC-BY-4.0 licensed content can either be used with attribution, or used as inspiration for new documentation, created by GPU vendors for public commercial distribution as developer documentation.

Where possible, this documentation will clearly label dates and versions of observed-but-not-guaranteed behaviour vs. vendor-documented stable interfaces/behaviour with guarantees of forward or backward compatibility.

Graphics Execution

Scope. How the emulated vGPU runs 3D graphics work — the OpenGL and Vulkan command streams a stock guest submits — on the physical GPU, and what is proven about it. This is the shared machinery behind OpenGL.md, Vulkan.md and the Windows/DirectX target (DirectX.md); CUDA compute uses the same submission and completion path for a different engine workload (Execution-Frontier.md). Canonical sources: ../docs/04-implementation/05-graphics-execution-plan.md (the plan and milestone ladder) and ../docs/04-implementation/04-real-render-walls.md (the measured walls); the docs tree wins on disagreement.

Status: 2026-11-09, tree master @ cb8e822b. Tags: [live] observed end to end; [wip] partially built; [wall] current blocker; [target] defined success state; [planned] designed, not built.

1. What "real pixels" means

The acceptance target is strict: a stock guest GL or Vulkan application's draw commands are executed by the physical GPU's fixed-function 3D pipeline (vertex fetch, primitive assembly, rasterisation, fragment work, ROP), the render target is readable by the guest, and that image reaches the capture path through the emulated mdev. The pixels must not come from another GPU, a software rasteriser, or a host display round-trip.

(The project has also published two deliberately-labelled two-VM demo videos that use the standard virtio-gpu/virgl virtual GPU on a host integrated GPU, and a CUDA-animation video that does run on the emulated vGPU through the compute path. The virgl videos are honest demonstrations of the guest experience; they are not this execution path, and their captions say so.)

2. The path a graphics command takes

The graphics execution paths: guest OpenGL/Vulkan/CUDA commands to the physical engines, and completions back.
guest apps (GL / Vulkan / CUDA)
  -> guest user space (GLX client + GL core, Vulkan ICD, libcuda)
  -> guest X server (GLX module + NVIDIA DDX)           [OpenGL]
  -> nvidia.ko: channels, GPFIFO rings, doorbells       [all APIs]
  -> vgsp.ko: capture sections, decode pushes, forward
  -> physical GPU front-end -> GR engine (3D + compute) / copy engines
  <- engine-authored releases written into guest memory
  <- completion relay (MSI-X + wakes) back to the guest
ASCII fallback above; the diagram shows the three execution lanes.

3. The three execution lanes

Graphics work reaches the engines today in one of three shapes, in increasing fidelity:

  1. Verbatim 3D method-stream replay [live]. The emulation captures the X server's graphics-class (0xC597, TURING_A) section from its channel, relocates the operand addresses into host-built shadow pages the engine can reach, and submits the stream unchanged. The engine retires it: the uploads (LINE_LENGTH_IN/LAUNCH_DMA), the state, program and texture binds, and the release all execute with no MMU fault. This proves the mechanics of 3D execution — object bind, window placement, operand relocation, completion — on real hardware.
  2. Synthesized launch from a captured section [live]. A compute-shaped launch built from the captured section (operand list, program, a 64-word launch descriptor) reaches the engine and retires real sm_75 SASS; the Turing shader-program-header form (V3) is accepted with zero header faults across repeated launches. This proved engine-side dispatch before the verbatim lane existed. The program itself is still a development stand-in at this rung — execution proof, not pixels.
  3. Forwarding the client's own pushes [wip]. The GL client's own channels now register, submit and retire: the direct-GL GR channel (0xbeef0100) and its CE siblings (0xbeef0101/0xbeef0102) are discovered, their rings and releases are decoded, and the X server's DDX kick channel (0xbfef0002) is decoded from its ring head with its class-2D notification authored. The X DDX waits are fixed (class-aware display arm, 0x8000 -> 0 notification completion, decoded GL release applied), forcing GLX selects libnvidia-glcore, and the event-IRQ fix (a478f0b4) lets the guest service the completion, so glxgears completes swaps and the guest's real GL draws now forward and execute on the physical GPU (work_gr backend_ok=9). What remains is the constant-buffer (MVP) content, the MME front-end defer and GR stale-wedge, and the DDX get-word/notifier completion (§6).

4. The channel and object picture

  • Every submission lives on a channel: a GPFIFO ring plus engine objects, with a USERD the driver advances its put pointer in and a doorbell the host module traps. Channels are typed by engine: a graphics channel carries 3D state and draws; copy-class channels carry memory movements.
  • The graphics object class the guest's 3D stream binds is the Turing graphics class, 0xC597. Streams now come from both the X server's channel and the direct GL client's own channels (0xbeef0100 GR plus the 0xbeef0101/0xbeef0102 CE siblings); the 2D present/readback work rides lighter 2D-class and copy-engine shapes.
  • Display and modeset [live]. The guest's modeset path is served by an emulated display engine: the display push-buffer channels (core 0xc57d, window 0xc57e, immediate/window 0xc57b) are registered, their push buffers parsed, and the notifier/UPDATE completion authored. The arm is class-aware (the window class has no NOTIFY bit; a bound notifier is the arm), and the X DDX's 0x8000 -> 0 notification completion is authored. This is what lets nvidia-modeset/NvKms register (/dev/dri), X settle and GLX clients obtain a real GL context. The display-capability seam is parameterised in the campaign configuration.
  • Cells of state: 3D streams are long—hundreds of method words per draw — and mix state binds (viewport, render target, ZS, blend/ROP), program and constant binds, vertex/index streams and draw-issuing methods. The capture machinery recognises the init-shaped operands today; the per-draw state vocabulary is being extended ([G-B in the plan]( ../docs/04-implementation/05-graphics-execution-plan.md)).
  • Synchronisation: tracking semaphores, notifications and fence values written by the engine; the guest's swap/present waits sit on top of those.

5. Completion, fences and presents

The acceptance signal is the engine-authored release: a semaphore the engine writes when the work completes. For GL, completion flows through the channel's semaphores/notifications to the X server and the app's swap wait; for Vulkan, the client's fence value is released; for CUDA, the launch's release group wakes the client. The emulation relays engine completions into guest-observable memory (MSI-X plus a poller), and the guest resumes from there.

For the display path, completion is the notifier write and UPDATE -> FINISHED; a completion event deferred by the reply path is force-retried until it posts, so the X server's mode set finishes. For the X DDX's own 2D push buffers, completion also requires the GPU-written engine get word to advance and the notifier to be recycled to 0xffff after a kick; both are host-side levers now, and a diagnostic write of the get word released the DDX's reserve loop. For a windowed GL client the present is a kick; the GSP event-IRQ fix now sets the RISC-V SWGEN0 IRQSTAT/IRQMASK/IRQDEST and latches the CPU-tree leaf, so the guest services the event and glxgears completes swaps. The next completion step is the constant buffer: the draw's CB page must be resolved and copied into the seed page so the engine produces fragments.

During bring-up the module also carries a diagnostics-only mirror for apps that spin on a shared progress word; it exists so a run can proceed while the natural completion path is being finished. The 60-fps milestone explicitly requires it switched off, along with any external poke.

6. Where the frontier is (ranked walls)

  1. The constant buffer (MVP) content [wall]. The guest's GL draws now execute on the physical GPU, but the engine writes 0 pages. The draw's constant-buffer source is forced to the seed page because cb-copy src=0x0cd70000 ... first8=00000000 ... src=synthetic-id reads all zeros; a guest-RAM scan found no MVP matrix and the 0x3f800000 vidmem hits are shader microcode immediates. With a zero MVP every vertex collapses to the origin, so there are no fragments. Decode the CB-bind method on the beef channel, resolve that VA through the channel VAS, and copy the real page into the seed page.
  2. Execution stability [wall]. The MME front-end is busy/deferred (MME-FE-DEFER then forced loads) and the GR channel stale-wedges (GR-STALL-stale-wedge, recovered), so the pipeline restarts mid-frame. Fixing the CB page may unstick the MME; the wedge recovery needs a durable fix.
  3. The X DDX push-buffer completion [wall]. The DDX's 2D reserve loop exits only when the GPU-written engine get word advances (get <= put) and the kick requires the notifier to be recycled to 0xffff after completion. sema_vas_cand_ms=1 makes X green on attempt 1, but X can still die after a few forward frames into the RM-degraded state.
  4. The X DDX footprint [wall]. The DDX allocates 4 GB of system pages at startup; an 8 GB guest has no headroom once GZDoom's own footprint lands and both are OOM-killed. Current runs use a 12 GB guest; the allocation is a suspected emulation gap (a 512 MiB emulated VRAM falling back to a 4 GB sysmem allocation) to fix.
  5. Non-black frames and sustained rate [wall]/[target]. Once the constant buffer, the MME/wedge stability and the DDX get-word/notifier completion land, the capture must show motion, then 60 fps in one VM with no forcing, then two VMs on two mediated devices with non-black frames in both.

7. What is proven today

Capability State
X server initialises on the emulated vGPU (driver DMA sanity push, ScreenInit) [live]
Display engine serves the modeset push buffers; notifier plus UPDATE -> FINISHED [live] (campaign configuration)
nvidia-modeset/NvKms registers (/dev/dri/card0, renderD128, fb0); nvidia-smi -L enumerates [live]
glxinfo reports the emulated GPU with the NVIDIA renderer (OpenGL 4.6.0, direct rendering) [live]
X server green with sema_vas_cand_ms=1; glxinfo 4.6.0 direct [live]
GSP event-IRQ fix wakes the guest poll; glxgears completes swaps [live]
2D path end-to-end: accelerated X fills read back via xwd [live]
Guest's real GL draws forward and execute on the physical GPU (work_gr backend_ok=9) [live]
Beef GR channel 0xbeef0100 captures real GL draw sections [live]
GL section capture: the X channel's 0xC597 stream decoded [live]
Verbatim 3D method-stream replay retired by the engine (no MMU fault) [live]
Synthesized launch executes real sm_75 SASS; Turing V3 program header accepted [live]
X server survives the run on a 12 GB guest (the DDX's 4 GB sysmem allocation forces the size) [live]
Constant-buffer (MVP) page resolves and the draw writes render-target pixels [wall]
MME front-end defer / GR stale-wedge stability [wall]
DDX push-buffer get-word publish and notifier recycle [wall]
NVIDIA Vulkan ICD creates a device [wall]
Non-black pixels from the emulated vGPU's 3D pipeline [wall]
Windows/DirectX guests [planned]

8. What is not claimed

  • No non-black pixel has been produced by the emulated vGPU's 3D pipeline yet.
  • Display/KMS bring-up (NvKms, /dev/dri, X, a real GL context) is not a rendered-frame claim; the guest's GL draws now execute on the physical GPU and glxgears completes swaps, but the frames are black. The constant-buffer (MVP) content, the MME/wedge stability and the DDX get-word/notifier completion are the current walls.
  • No frame-rate or latency numbers: the scheduled measurement is defined (60 fps over 60 s, no forcing) but not yet met.
  • The virgl-based demo videos are a different, labelled path — not this one.

9. Related pages