<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://open-iov.org/index.php?action=history&amp;feed=atom&amp;title=Virtual_Display</id>
	<title>Virtual Display - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://open-iov.org/index.php?action=history&amp;feed=atom&amp;title=Virtual_Display"/>
	<link rel="alternate" type="text/html" href="https://open-iov.org/index.php?title=Virtual_Display&amp;action=history"/>
	<updated>2026-11-22T22:06:01Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.37.1</generator>
	<entry>
		<id>https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24296&amp;oldid=prev</id>
		<title>WikiBot: 2026-11-22: Virtual Display - clarify that the live cycle confirmed the class-list gate (host lane inert, no A08x control reached it)</title>
		<link rel="alternate" type="text/html" href="https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24296&amp;oldid=prev"/>
		<updated>2026-11-22T21:37:51Z</updated>

		<summary type="html">&lt;p&gt;2026-11-22: Virtual Display - clarify that the live cycle confirmed the class-list gate (host lane inert, no A08x control reached it)&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;en&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Older revision&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Revision as of 21:37, 22 November 2026&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l104&quot;&gt;Line 104:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 104:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;'''Current limitation (measured).''' The stock X driver's built-in virtual HAL is selected only when the guest kernel's class list advertises &amp;lt;code&amp;gt;NVA083_GRID_DISPLAYLESS&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;). That class list is answered inside the guest kernel from its compiled TU104 descriptor list, which carries the Kepler vGPU device and the &amp;lt;code&amp;gt;NVA081&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA084&amp;lt;/code&amp;gt; classes but not &amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;. The host's &amp;lt;code&amp;gt;GET_CLASSLIST_V2&amp;lt;/code&amp;gt; emulation therefore never sees the query, and the stock DDX cannot select the virtual HAL. The guest-side virtual-display program (§2) is the supported route; the host lane remains the interface for a guest program that chooses to use the vGPU display controls directly.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;'''Current limitation (measured).''' The stock X driver's built-in virtual HAL is selected only when the guest kernel's class list advertises &amp;lt;code&amp;gt;NVA083_GRID_DISPLAYLESS&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;). That class list is answered inside the guest kernel from its compiled TU104 descriptor list, which carries the Kepler vGPU device and the &amp;lt;code&amp;gt;NVA081&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA084&amp;lt;/code&amp;gt; classes but not &amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;. The host's &amp;lt;code&amp;gt;GET_CLASSLIST_V2&amp;lt;/code&amp;gt; emulation therefore never sees the query, and the stock DDX cannot select the virtual HAL. The guest-side virtual-display program (§2) is the supported route; the host lane remains the interface for a guest program that chooses to use the vGPU display controls directly.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;The &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;lane was validated for wire correctness in a &lt;/del&gt;live cycle: the guest-side virtual HAL did not run (&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;as expected from &lt;/del&gt;the class list), and the host lane &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;is &lt;/del&gt;inert &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;when the guest never sends the &lt;/del&gt;&amp;lt;code&amp;gt;0xA08x&amp;lt;/code&amp;gt; &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;controls&lt;/del&gt;.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;The live cycle &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;confirmed the expected path&lt;/ins&gt;: the guest-side virtual HAL did not run (the class&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;-&lt;/ins&gt;list &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;gate&lt;/ins&gt;), and the host lane &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;stayed &lt;/ins&gt;inert &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;— no &lt;/ins&gt;&amp;lt;code&amp;gt;0xA08x&amp;lt;/code&amp;gt; &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;control reached it&lt;/ins&gt;.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== 5. Current state and walls (2026-11-22) ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== 5. Current state and walls (2026-11-22) ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;

&lt;!-- diff cache key my_wiki:diff::1.12:old-24295:rev-24296 --&gt;
&lt;/table&gt;</summary>
		<author><name>WikiBot</name></author>
	</entry>
	<entry>
		<id>https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24295&amp;oldid=prev</id>
		<title>WikiBot: 2026-11-22: Virtual Display page (remove pre-merge repo link)</title>
		<link rel="alternate" type="text/html" href="https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24295&amp;oldid=prev"/>
		<updated>2026-11-22T21:35:12Z</updated>

		<summary type="html">&lt;p&gt;2026-11-22: Virtual Display page (remove pre-merge repo link)&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;en&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Older revision&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Revision as of 21:35, 22 November 2026&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l3&quot;&gt;Line 3:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 3:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;= Virtual Display =&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;= Virtual Display =&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;blockquote&amp;gt;'''Scope.''' How a guest's rendered frames are presented when there is no physical monitor attached to the GPU the guest is using — the '''guest virtual-display program''' that reads the real GL back buffer and streams it out, and the '''host vGPU display-control lane''' (&amp;lt;code&amp;gt;NVA080&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA083&amp;lt;/code&amp;gt;) that accepts a guest-supplied scanout surface. This page also records why a separate virtual-display path exists on a single emulated pDevice, and the gates that currently stand between a running GL client and captured frames. The shared 3D machinery is on [[Graphics Execution|&amp;lt;code&amp;gt;Graphics-Execution.md&amp;lt;/code&amp;gt;]]; the guest OpenGL stack is on [[OpenGL|&amp;lt;code&amp;gt;OpenGL.md&amp;lt;/code&amp;gt;]]. Canonical sources: [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/05-graphics-execution-plan.md &amp;lt;code&amp;gt;../docs/04-implementation/05-graphics-execution-plan.md&amp;lt;/code&amp;gt;] (the plan and the separate-scanout decision) and &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;[https://git.vgpu.io/open-iov.git/tree/tools/guest-diag/vdisp/README.md &lt;/del&gt;&amp;lt;code&amp;gt;&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;../&lt;/del&gt;tools/guest-diag/vdisp/&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;README.md&lt;/del&gt;&amp;lt;/code&amp;gt;&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;] (the &lt;/del&gt;guest program and its measured recipe&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;)&lt;/del&gt;.&amp;lt;/blockquote&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;blockquote&amp;gt;'''Scope.''' How a guest's rendered frames are presented when there is no physical monitor attached to the GPU the guest is using — the '''guest virtual-display program''' that reads the real GL back buffer and streams it out, and the '''host vGPU display-control lane''' (&amp;lt;code&amp;gt;NVA080&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA083&amp;lt;/code&amp;gt;) that accepts a guest-supplied scanout surface. This page also records why a separate virtual-display path exists on a single emulated pDevice, and the gates that currently stand between a running GL client and captured frames. The shared 3D machinery is on [[Graphics Execution|&amp;lt;code&amp;gt;Graphics-Execution.md&amp;lt;/code&amp;gt;]]; the guest OpenGL stack is on [[OpenGL|&amp;lt;code&amp;gt;OpenGL.md&amp;lt;/code&amp;gt;]]. Canonical sources: [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/05-graphics-execution-plan.md &amp;lt;code&amp;gt;../docs/04-implementation/05-graphics-execution-plan.md&amp;lt;/code&amp;gt;] (the plan and the separate-scanout decision) and &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;the tracked &lt;/ins&gt;&amp;lt;code&amp;gt;tools/guest-diag/vdisp/&amp;lt;/code&amp;gt; guest program and its measured recipe.&amp;lt;/blockquote&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Status: 2026-11-22, tree &amp;lt;code&amp;gt;vgpu/campaign/r76 @ 1c4c9bd2&amp;lt;/code&amp;gt;. Tags: &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; observed end to end; &amp;lt;code&amp;gt;[wip]&amp;lt;/code&amp;gt; partially built; &amp;lt;code&amp;gt;[wall]&amp;lt;/code&amp;gt; current blocker; &amp;lt;code&amp;gt;[target]&amp;lt;/code&amp;gt; defined success state.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Status: 2026-11-22, tree &amp;lt;code&amp;gt;vgpu/campaign/r76 @ 1c4c9bd2&amp;lt;/code&amp;gt;. Tags: &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; observed end to end; &amp;lt;code&amp;gt;[wip]&amp;lt;/code&amp;gt; partially built; &amp;lt;code&amp;gt;[wall]&amp;lt;/code&amp;gt; current blocker; &amp;lt;code&amp;gt;[target]&amp;lt;/code&amp;gt; defined success state.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l22&quot;&gt;Line 22:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 22:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== 2. The guest virtual-display program &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== 2. The guest virtual-display program &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;The supported presentation mechanism today is a '''guest userspace program''' that makes the real GL rendering observable without a second pDev and without a host display round-trip. It lives in &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;[https://git.vgpu.io/open-iov.git/tree/tools/guest-diag/vdisp/README.md &lt;/del&gt;&amp;lt;code&amp;gt;&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;../&lt;/del&gt;tools/guest-diag/vdisp/&amp;lt;/code&amp;gt;&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;]&lt;/del&gt;:&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;The supported presentation mechanism today is a '''guest userspace program''' that makes the real GL rendering observable without a second pDev and without a host display round-trip. It lives in &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;the tracked &lt;/ins&gt;&amp;lt;code&amp;gt;tools/guest-diag/vdisp/&amp;lt;/code&amp;gt; &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;package&lt;/ins&gt;:&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br/&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;

&lt;!-- diff cache key my_wiki:diff::1.12:old-24291:rev-24295 --&gt;
&lt;/table&gt;</summary>
		<author><name>WikiBot</name></author>
	</entry>
	<entry>
		<id>https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24291&amp;oldid=prev</id>
		<title>WikiBot: 2026-11-22 wiki refresh: add Virtual Display; host NVA080/NVA083 lane and guest virtual-display program; deterministic mode parity, VBO gate green, r1783/r1784; current wall is the partial MME pack; software-rendering references removed</title>
		<link rel="alternate" type="text/html" href="https://open-iov.org/index.php?title=Virtual_Display&amp;diff=24291&amp;oldid=prev"/>
		<updated>2026-11-22T21:33:37Z</updated>

		<summary type="html">&lt;p&gt;2026-11-22 wiki refresh: add Virtual Display; host NVA080/NVA083 lane and guest virtual-display program; deterministic mode parity, VBO gate green, r1783/r1784; current wall is the partial MME pack; software-rendering references removed&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{About message}}&lt;br /&gt;
&lt;br /&gt;
= Virtual Display =&lt;br /&gt;
&lt;br /&gt;
&amp;lt;blockquote&amp;gt;'''Scope.''' How a guest's rendered frames are presented when there is no physical monitor attached to the GPU the guest is using — the '''guest virtual-display program''' that reads the real GL back buffer and streams it out, and the '''host vGPU display-control lane''' (&amp;lt;code&amp;gt;NVA080&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA083&amp;lt;/code&amp;gt;) that accepts a guest-supplied scanout surface. This page also records why a separate virtual-display path exists on a single emulated pDevice, and the gates that currently stand between a running GL client and captured frames. The shared 3D machinery is on [[Graphics Execution|&amp;lt;code&amp;gt;Graphics-Execution.md&amp;lt;/code&amp;gt;]]; the guest OpenGL stack is on [[OpenGL|&amp;lt;code&amp;gt;OpenGL.md&amp;lt;/code&amp;gt;]]. Canonical sources: [https://git.vgpu.io/open-iov.git/tree/docs/04-implementation/05-graphics-execution-plan.md &amp;lt;code&amp;gt;../docs/04-implementation/05-graphics-execution-plan.md&amp;lt;/code&amp;gt;] (the plan and the separate-scanout decision) and [https://git.vgpu.io/open-iov.git/tree/tools/guest-diag/vdisp/README.md &amp;lt;code&amp;gt;../tools/guest-diag/vdisp/README.md&amp;lt;/code&amp;gt;] (the guest program and its measured recipe).&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Status: 2026-11-22, tree &amp;lt;code&amp;gt;vgpu/campaign/r76 @ 1c4c9bd2&amp;lt;/code&amp;gt;. Tags: &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; observed end to end; &amp;lt;code&amp;gt;[wip]&amp;lt;/code&amp;gt; partially built; &amp;lt;code&amp;gt;[wall]&amp;lt;/code&amp;gt; current blocker; &amp;lt;code&amp;gt;[target]&amp;lt;/code&amp;gt; defined success state.&lt;br /&gt;
&lt;br /&gt;
== 1. Why a virtual display ==&lt;br /&gt;
&lt;br /&gt;
The acceptance target is a stock guest application rendering through the emulated vGPU, with the image observable without trusting the guest to screenshot itself. On a normal desktop the last step is a physical scanout: the X driver sets a mode on a connected display head and the GPU scans the surface out. A virtualized GPU usually has no such head, and the project's requirement is stronger: the presentation path must not depend on attaching the emulated device to a host monitor, and it must not patch the guest driver.&lt;br /&gt;
&lt;br /&gt;
On a single vGPU pDevice the physical-display route also carries a specific structural cost. A native X11 GL client needs two things at once:&lt;br /&gt;
&lt;br /&gt;
* '''Buffer locations''' from the GLS adapter set, which require a bound GPU-screen/&amp;lt;code&amp;gt;GPUDevice&amp;lt;/code&amp;gt; association and a real-mode primary surface.&lt;br /&gt;
* '''An even &amp;lt;code&amp;gt;screens[0].modeNum&amp;lt;/code&amp;gt;''', the shared nvClip progress word the client's &amp;lt;code&amp;gt;__glNVStateInit&amp;lt;/code&amp;gt; tests. With an odd value the client clears its init bits, &amp;lt;code&amp;gt;BufferObjectExpandLocations&amp;lt;/code&amp;gt; returns nothing, and every buffer-object allocation fails (&amp;lt;code&amp;gt;GL_OUT_OF_MEMORY 0x505&amp;lt;/code&amp;gt;, a &amp;lt;code&amp;gt;NULL&amp;lt;/code&amp;gt; map).&lt;br /&gt;
&lt;br /&gt;
Binding the GPU screen closes/regenerates the master during &amp;lt;code&amp;gt;ScreenInit&amp;lt;/code&amp;gt;, and the screen-close path performs a raw &amp;lt;code&amp;gt;modeNum++&amp;lt;/code&amp;gt; — about 0.5-0.9 s after X starts, before any client can connect. Removing the association keeps the word even but leaves the GLS adapter set with no render device. With one pDevice the two requirements are mutually exclusive on the physical-display path. The DDX also refuses a GPU screen on a pDevice that already has a protocol screen, and VT switches only increment the counter further. Recorded in the graphics plan as the two-path deadlock (2026-11-22).&lt;br /&gt;
&lt;br /&gt;
The virtual-display route avoids the physical screen binding altogether: the guest hands the surface (or the rendered pixels) to a presentation path that does not own a display head. The project supports two independent halves of that route, described below.&lt;br /&gt;
&lt;br /&gt;
== 2. The guest virtual-display program &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; ==&lt;br /&gt;
&lt;br /&gt;
The supported presentation mechanism today is a '''guest userspace program''' that makes the real GL rendering observable without a second pDev and without a host display round-trip. It lives in [https://git.vgpu.io/open-iov.git/tree/tools/guest-diag/vdisp/README.md &amp;lt;code&amp;gt;../tools/guest-diag/vdisp/&amp;lt;/code&amp;gt;]:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! Piece&lt;br /&gt;
! Role&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sdl_cap.c&amp;lt;/code&amp;gt; -&amp;amp;gt; &amp;lt;code&amp;gt;sdl_cap.so&amp;lt;/code&amp;gt;&lt;br /&gt;
| LD_PRELOAD interposer on &amp;lt;code&amp;gt;glXSwapBuffers&amp;lt;/code&amp;gt;. Before the real swap it calls &amp;lt;code&amp;gt;glFinish()&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;glReadPixels(GL_BACK)&amp;lt;/code&amp;gt;, then streams raw RGBA frames to a FIFO. It is a '''sink''', not a renderer: the pixels come from the guest NVIDIA GL driver's real back buffer for the X11 GLX drawable.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;win-run.sh&amp;lt;/code&amp;gt;&lt;br /&gt;
| Guest driver: wait for a settled boot, start the accelerated NoScanout X, apply the mode-parity gate, probe the GL object path, run the application with the capture shim, encode with &amp;lt;code&amp;gt;ffmpeg&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;win-host.sh&amp;lt;/code&amp;gt;&lt;br /&gt;
| Host driver: flock-serialised cycle — module, one mdev, QEMU, guest asset push, guest gate, pull the &amp;lt;code&amp;gt;mp4&amp;lt;/code&amp;gt; and logs back through the QEMU user-net upload sink.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;mode-even-gate.sh&amp;lt;/code&amp;gt;&lt;br /&gt;
| Deterministic mode-parity gate: start X on its own VT, sample the shared word, restart X once if it is odd, re-verify, then run the client with &amp;lt;code&amp;gt;DISPLAY&amp;lt;/code&amp;gt; exported.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;globjprobe.c&amp;lt;/code&amp;gt;&lt;br /&gt;
| GLX gate: renderer check, non-&amp;lt;code&amp;gt;NULL&amp;lt;/code&amp;gt; &amp;lt;code&amp;gt;glBufferData(data)&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;glMapBufferRange&amp;lt;/code&amp;gt;, FBO completeness, non-black readback.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;glburn.c&amp;lt;/code&amp;gt;&lt;br /&gt;
| Keep-alive GLX client so the GLX screen device survives across clients.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;xorg.conf.guest-noscanout&amp;lt;/code&amp;gt;&lt;br /&gt;
| The proven accelerated headless X configuration (&amp;lt;code&amp;gt;UseDisplayDevice None&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;AllowEmptyInitialConfiguration&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;UseSysmemPixmapAccel False&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Virtual 1920x1080&amp;lt;/code&amp;gt;).&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;guest_upload.py&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;upload_sink.py&amp;lt;/code&amp;gt;&lt;br /&gt;
| Guest-to-host transfer (the guest reaches the host at &amp;lt;code&amp;gt;10.0.2.2&amp;lt;/code&amp;gt;).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Properties of this route:&lt;br /&gt;
&lt;br /&gt;
* '''One mdev, one guest, stock driver.''' No second pDevice, no guest-driver patch, no second VM.&lt;br /&gt;
* '''Native rendering.''' The application keeps its OpenGL renderer; the shim only reads the finished back buffer; the application itself renders it.&lt;br /&gt;
* '''Source-level capture.''' The sink observes the drawable the GL client actually rendered, not a host-side screen scrape; a capture is therefore evidence of the guest GL path, and the frame is checked for motion and colour offline.&lt;br /&gt;
&lt;br /&gt;
== 3. The mode-parity gate &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; ==&lt;br /&gt;
&lt;br /&gt;
The shared nvClip &amp;lt;code&amp;gt;screens[0].modeNum&amp;lt;/code&amp;gt; is the client's &amp;lt;code&amp;gt;__GL_DEV_MODESWITCH_TEST_COMPLETE&amp;lt;/code&amp;gt; word. On this stack its first generation has two writer classes in the X server process: the screen-close path does a raw &amp;lt;code&amp;gt;modeNum++&amp;lt;/code&amp;gt;, and the GLS server-device disable adds two and then sets the low bit. A 5 ms sampler on a clean boot shows the lifecycle:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! t (s)&lt;br /&gt;
! event&lt;br /&gt;
|-&lt;br /&gt;
| 242.850&lt;br /&gt;
| first X &amp;lt;code&amp;gt;ScreenInit&amp;lt;/code&amp;gt;: GLS server-device enable -&amp;amp;gt; '''2'''&lt;br /&gt;
|-&lt;br /&gt;
| 243.539&lt;br /&gt;
| first X: &amp;lt;code&amp;gt;+1&amp;lt;/code&amp;gt; -&amp;amp;gt; '''3''' (0.69 s after the enable, before GLX init)&lt;br /&gt;
|-&lt;br /&gt;
| 254.749&lt;br /&gt;
| first X killed: screen-close raw increment -&amp;amp;gt; '''4'''&lt;br /&gt;
|-&lt;br /&gt;
| 254.757&lt;br /&gt;
| same kill: GLS server-device disable -&amp;amp;gt; '''7'''&lt;br /&gt;
|-&lt;br /&gt;
| 255.108&lt;br /&gt;
| restarted X &amp;lt;code&amp;gt;ScreenInit&amp;lt;/code&amp;gt; -&amp;amp;gt; '''2''', and it stays even&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The &amp;lt;code&amp;gt;+1&amp;lt;/code&amp;gt; is a one-time first-generation event: it is independent of &amp;lt;code&amp;gt;AutoAddGPU&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;AutoBindGPU&amp;lt;/code&amp;gt;, of &amp;lt;code&amp;gt;-keeptty&amp;lt;/code&amp;gt;, and of &amp;lt;code&amp;gt;-noreset&amp;lt;/code&amp;gt;. A restarted X does not repeat it, including when GL clients connect. The deterministic recipe is therefore: start the accelerated NoScanout X, wait for it to settle, sample the word, restart X once if it is odd, re-verify, and only then start the application. &amp;lt;code&amp;gt;mode-even-gate.sh&amp;lt;/code&amp;gt; encodes this.&lt;br /&gt;
&lt;br /&gt;
Measured result: in the &amp;lt;code&amp;gt;vid1&amp;lt;/code&amp;gt; cycle the gate read &amp;lt;code&amp;gt;MODE 3&amp;lt;/code&amp;gt; on the first X, restarted, then held '''15,458/15,458 samples at &amp;lt;code&amp;gt;MODE 2&amp;lt;/code&amp;gt;''', including the whole GZDoom window. With the gate applied and the campaign module loaded, the VBO gate is green: &amp;lt;code&amp;gt;glBufferData(data)&amp;lt;/code&amp;gt; returns &amp;lt;code&amp;gt;err=0&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;glMapBufferRange&amp;lt;/code&amp;gt; returns a valid pointer, and the mapped content reads &amp;lt;code&amp;gt;0xa5&amp;lt;/code&amp;gt;. The FBO path still returns &amp;lt;code&amp;gt;0x8cdd&amp;lt;/code&amp;gt; (unsupported) but no longer blocks buffer objects.&lt;br /&gt;
&lt;br /&gt;
== 4. The host vGPU display-control lane &amp;lt;code&amp;gt;[live]&amp;lt;/code&amp;gt; (implemented, not selected by the stock DDX) ==&lt;br /&gt;
&lt;br /&gt;
The X driver contains a vGPU virtual-display HAL that hands the guest's scanout surface to the host instead of binding a physical GPU screen. It uses two control classes:&lt;br /&gt;
&lt;br /&gt;
* '''&amp;lt;code&amp;gt;NVA083&amp;lt;/code&amp;gt; (virtual-display head queries)''' — &amp;lt;code&amp;gt;GET_NUM_HEADS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;GET_MAX_RESOLUTION&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;GET_DEFAULT_EDID&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;IS_ACTIVE&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;IS_CONNECTED&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;GET_MAX_PIXELS&amp;lt;/code&amp;gt;.&lt;br /&gt;
* '''&amp;lt;code&amp;gt;NVA080&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;KEPLER_DEVICE_VGPU&amp;lt;/code&amp;gt;)''' — &amp;lt;code&amp;gt;VGPU_GET_CONFIG&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;VGPU_DISPLAY_SET_SURFACE_PROPERTIES&amp;lt;/code&amp;gt; (head index, primary flag, memory handle, offset, layout, block height, pitch, format, width, height, rect, size) and &amp;lt;code&amp;gt;VGPU_DISPLAY_CLEANUP_SURFACE_PARAMS&amp;lt;/code&amp;gt; on head teardown.&lt;br /&gt;
&lt;br /&gt;
The host module implements this lane:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;GET_CLASSLIST_V2&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;0x800292&amp;lt;/code&amp;gt;) advertises the TU104 class list plus &amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;; &amp;lt;code&amp;gt;GET_VIRTUALIZATION_MODE&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;0x800289&amp;lt;/code&amp;gt;) reports the vGPU mode; the &amp;lt;code&amp;gt;A083&amp;lt;/code&amp;gt; queries and the &amp;lt;code&amp;gt;A080&amp;lt;/code&amp;gt; config/set/cleanup controls are answered.&lt;br /&gt;
* A per-vgpu surface record is kept. The surface's &amp;lt;code&amp;gt;hMemory&amp;lt;/code&amp;gt; is resolved through the RM memory-object table (sysmem only); an unresolved kernel-local vidheap handle still succeeds and records the metadata, without synthesising a physical address.&lt;br /&gt;
* A '''pitch-linear present''' copies the registered surface into the emulated BAR1 scanout window (default offset &amp;lt;code&amp;gt;0x200000&amp;lt;/code&amp;gt;; no pixel synthesis; bounds 64 MiB / 4096 px). Module parameters: &amp;lt;code&amp;gt;disp_vgpu&amp;lt;/code&amp;gt; (enable), &amp;lt;code&amp;gt;disp_vgpu_present&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;disp_vgpu_surf_gpa&amp;lt;/code&amp;gt; (evidence override) and &amp;lt;code&amp;gt;disp_vgpu_scanout_off&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Current limitation (measured).''' The stock X driver's built-in virtual HAL is selected only when the guest kernel's class list advertises &amp;lt;code&amp;gt;NVA083_GRID_DISPLAYLESS&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;). That class list is answered inside the guest kernel from its compiled TU104 descriptor list, which carries the Kepler vGPU device and the &amp;lt;code&amp;gt;NVA081&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA084&amp;lt;/code&amp;gt; classes but not &amp;lt;code&amp;gt;0xA083&amp;lt;/code&amp;gt;. The host's &amp;lt;code&amp;gt;GET_CLASSLIST_V2&amp;lt;/code&amp;gt; emulation therefore never sees the query, and the stock DDX cannot select the virtual HAL. The guest-side virtual-display program (§2) is the supported route; the host lane remains the interface for a guest program that chooses to use the vGPU display controls directly.&lt;br /&gt;
&lt;br /&gt;
The lane was validated for wire correctness in a live cycle: the guest-side virtual HAL did not run (as expected from the class list), and the host lane is inert when the guest never sends the &amp;lt;code&amp;gt;0xA08x&amp;lt;/code&amp;gt; controls.&lt;br /&gt;
&lt;br /&gt;
== 5. Current state and walls (2026-11-22) ==&lt;br /&gt;
&lt;br /&gt;
Both old blockers on the path to a captured frame are closed:&lt;br /&gt;
&lt;br /&gt;
* '''mode parity''' is deterministic with the restarted-X gate (§3);&lt;br /&gt;
* '''the VBO path''' allocates and maps with an even word (§3);&lt;br /&gt;
* '''the engine no longer faults on the emitted replay window''': &amp;lt;code&amp;gt;r1783&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;3b7310e1&amp;lt;/code&amp;gt;) walks the emitted 3D window with the FIFO run grammar and cuts it at the last complete run boundary before any prepend. Measured: zero &amp;lt;code&amp;gt;Ch 00000001 ... Off 0x1654/0x1b34/0x2024/0x2294/0x2504/0x2774&amp;lt;/code&amp;gt; data faults, zero &amp;lt;code&amp;gt;ILLEGAL_OPCODE&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;GUEST GR LAUNCH OK&amp;lt;/code&amp;gt; on the direct-GL launch.&lt;br /&gt;
* '''the 4 GiB context-buffer class is gone''': &amp;lt;code&amp;gt;r1784&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;841b51b5&amp;lt;/code&amp;gt;) clamps the seven &amp;lt;code&amp;gt;NV_U32_MAX&amp;lt;/code&amp;gt; entries in the physical KGR context-buffer snapshot to 0 before it is served (&amp;lt;code&amp;gt;KGR ctxbuf snapshot: clamped 7 ...&amp;lt;/code&amp;gt;), removing the allocation/OOM class that killed earlier attempts.&lt;br /&gt;
&lt;br /&gt;
The remaining wall is '''MME pack residency on the second direct-GL window'''. In the &amp;lt;code&amp;gt;vid2c&amp;lt;/code&amp;gt; cycle the first &amp;lt;code&amp;gt;0xbeef0100&amp;lt;/code&amp;gt; carrier is load-only and reports &amp;lt;code&amp;gt;MME-PRELUDE pack-part ir_words=1608/2805 split=1&amp;lt;/code&amp;gt; with &amp;lt;code&amp;gt;pack_done_gen=0&amp;lt;/code&amp;gt;; the launch completes. The next carrier replays a shorter window (178 words) with no IR continuation, and the MME latches &amp;lt;code&amp;gt;esr=badf1201 pc_valid=1 pc=513 macro_addr=0xf1&amp;lt;/code&amp;gt;. The lane is poisoned, the hard re-arm cannot recover the context, and the launch ends in &amp;lt;code&amp;gt;GR LAUNCH FAILED&amp;lt;/code&amp;gt; timeouts. The guest's GL thread is then found spinning in &amp;lt;code&amp;gt;libnvidia-glcore&amp;lt;/code&amp;gt; (&amp;lt;code&amp;gt;sched_yield&amp;lt;/code&amp;gt;), waiting for a GPU-side completion, not in an X/GLX reply poll. The application stops at &amp;lt;code&amp;gt;V_Init: allocate screen&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;glXSwapBuffers&amp;lt;/code&amp;gt; is never reached, so the sink captures zero frames.&lt;br /&gt;
&lt;br /&gt;
A/B results (all one mdev, stock guest driver):&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! Arm&lt;br /&gt;
! Result&lt;br /&gt;
|-&lt;br /&gt;
| Baseline (prelude + split pack)&lt;br /&gt;
| Partial pack 1608/2805, second window poisons the MME (&amp;lt;code&amp;gt;esr=badf1201 pc=513&amp;lt;/code&amp;gt;), no draw, no swap&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sema_gl_mme_prelude=0&amp;lt;/code&amp;gt; (pack/golden off)&lt;br /&gt;
| 0 poison, 0 wedge, 301/301 GR OK, engine stable — but no draw admission (&amp;lt;code&amp;gt;has_draw=0&amp;lt;/code&amp;gt;)&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sema_gl_mme_partial_keep_window=0&amp;lt;/code&amp;gt;&lt;br /&gt;
| 0 poison/0 wedge, but 19 timeouts: the windowless pack-drain carriers themselves time out&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sema_gl_mme_block_cap=3968 sema_gl_mme_pack_split=0&amp;lt;/code&amp;gt;&lt;br /&gt;
| The &amp;amp;gt;2000-word block does not start; 3 poisons, 9 re-arms, 6 park recoveries&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;r1785&amp;lt;/code&amp;gt; diagnostics (BLOCKVAL with the hardware's 13-bit count, emitted-block dump)&lt;br /&gt;
| 0 bad words in every emitted block: the window grammar and the tail trim are correct; the poison is executing draw state while only 1608/2805 pack IR words are resident&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The negative result is itself useful: the window grammar is valid and the emitted window is not malformed. The failure is the '''pack drain''': the missing pack continuation was never emitted on the next launch (the cursor stayed at 1608, and no second &amp;lt;code&amp;gt;MME-PACK-EMIT&amp;lt;/code&amp;gt; appeared).&lt;br /&gt;
&lt;br /&gt;
Next steps, in order:&lt;br /&gt;
&lt;br /&gt;
# Make the pack drain mandatory before any window: keep &amp;lt;code&amp;gt;pack_done_gen=0&amp;lt;/code&amp;gt; launches windowless, or force the missing continuation onto the next launch, so the MME never executes draw state against a partial pack.&lt;br /&gt;
# Keep the RT0 colour-target admission independent of the MME prelude so the prelude-off arm can still admit the draw.&lt;br /&gt;
# Re-run the &amp;lt;code&amp;gt;vid1&amp;lt;/code&amp;gt; recipe (&amp;lt;code&amp;gt;HOME=/root&amp;lt;/code&amp;gt;, 1536x864, &amp;lt;code&amp;gt;sdl_cap.so&amp;lt;/code&amp;gt; + &amp;lt;code&amp;gt;ffmpeg&amp;lt;/code&amp;gt;) and require non-black captured frames with motion.&lt;br /&gt;
# Only then treat the virtual-display path as ready for the release video.&lt;br /&gt;
&lt;br /&gt;
== 6. How to run it ==&lt;br /&gt;
&lt;br /&gt;
Host (clean host: &amp;lt;code&amp;gt;vgsp&amp;lt;/code&amp;gt; unloaded, no QEMU, no mdev):&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;bash tools/guest-diag/vdisp/win-host.sh &amp;amp;lt;tag&amp;amp;gt;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
That command runs the flock-serialised cycle (module + one mdev + QEMU), pushes the guest package, applies the mode-parity gate, runs the GL object probe and then the application with the capture shim, and pulls the evidence back. The guest-side recipe (already encoded in &amp;lt;code&amp;gt;mode-even-gate.sh&amp;lt;/code&amp;gt;) is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;# guest, as root, after a settled boot (uptime &amp;amp;gt;= 240 s)&lt;br /&gt;
/tmp/mode-even-gate.sh &amp;amp;lt;tag&amp;amp;gt; /tmp/globjprobe&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Build the guest-side binaries:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;cc -O2 -o globjprobe globjprobe.c -lGL -lX11&lt;br /&gt;
cc -O2 -o glburn    glburn.c    -lGL -lX11&lt;br /&gt;
cc -shared -fPIC -O2 -o sdl_cap.so sdl_cap.c -lX11 -lGL -ldl&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 7. What is not claimed ==&lt;br /&gt;
&lt;br /&gt;
* This page does '''not''' claim a vGPU-rendered video yet. The mode parity, VBO and engine-fault gates are green, but no swap has been reached under the capture shim since those fixes, so &amp;lt;code&amp;gt;sdl_cap&amp;lt;/code&amp;gt; produced zero frames and &amp;lt;code&amp;gt;mp4=0&amp;lt;/code&amp;gt; in every cycle. No vGPU-rendered video exists yet.&lt;br /&gt;
* The host &amp;lt;code&amp;gt;NVA080&amp;lt;/code&amp;gt;/&amp;lt;code&amp;gt;NVA083&amp;lt;/code&amp;gt; lane is '''implemented and wire-correct''', but the stock DDX does not select its virtual HAL on the stock guest kernel's class list. It is not the mechanism the current sink uses.&lt;br /&gt;
* No frame-rate claim is made here; the X/GLX speed wall is tracked on [[OpenGL|&amp;lt;code&amp;gt;OpenGL.md&amp;lt;/code&amp;gt;]] and [[Graphics Execution|&amp;lt;code&amp;gt;Graphics-Execution.md&amp;lt;/code&amp;gt;]].&lt;br /&gt;
&lt;br /&gt;
== 8. Related pages ==&lt;br /&gt;
&lt;br /&gt;
* [[Graphics Execution|&amp;lt;code&amp;gt;Graphics-Execution.md&amp;lt;/code&amp;gt;]] — the 3D execution lanes, including the display engine that serves the guest's modeset push buffers.&lt;br /&gt;
* [[OpenGL|&amp;lt;code&amp;gt;OpenGL.md&amp;lt;/code&amp;gt;]] — the guest OpenGL stack and the X/GLX speed wall.&lt;br /&gt;
* [[Project Status|&amp;lt;code&amp;gt;Project-Status.md&amp;lt;/code&amp;gt;]] — the dated project state.&lt;br /&gt;
* [[Project Plan|&amp;lt;code&amp;gt;Project-Plan.md&amp;lt;/code&amp;gt;]] — the graphics phase and its gates.&lt;br /&gt;
* [[Physical GPU Backend and Guest Wiring|&amp;lt;code&amp;gt;Physical-GPU-Backend.md&amp;lt;/code&amp;gt;]] — how guest work reaches the physical GPU.&lt;br /&gt;
* [[The Host Module (vgsp.ko)|&amp;lt;code&amp;gt;Host-Module.md&amp;lt;/code&amp;gt;]] — where the display-control lane and the emulated scanout window live.&lt;/div&gt;</summary>
		<author><name>WikiBot</name></author>
	</entry>
</feed>