From mboxrd@z Thu Jan  1 00:00:00 1970
From: Pasi =?iso-8859-1?Q?K=E4rkk=E4inen?= <pasik@iki.fi>
Subject: [PATCH] xl.cfg: gfx_passthru documentation improvements
Date: Sun, 2 Sep 2012 08:35:49 +0300
Message-ID: <20120902053549.GF8912@reaktio.net>
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="neYutvxvOLaeuPCA"
Content-Transfer-Encoding: 8bit
Return-path: <xen-devel-bounces@lists.xen.org>
Content-Disposition: inline
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: xen-devel@lists.xen.org
List-Id: xen-devel@lists.xenproject.org


--neYutvxvOLaeuPCA
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit

Hello,

xl.cfg.pod.5 documentation improvements:

- gfx_passthru: Document gfx_passthru makes the GPU become primary in the guest
  and other generic info about gfx_passthru.


Signed-off-by: Pasi Kärkkäinen <pasik@iki.fi>

--- docs/man/xl.cfg.pod.5.orig1 2012-09-02 07:16:39.316782158 +0300
+++ docs/man/xl.cfg.pod.5       2012-09-02 08:26:40.081639087 +0300
@@ -968,7 +968,43 @@
 
 =item B<gfx_passthru=BOOLEAN>
 
-Enable graphics device PCI passthrough. XXX which device is passed through ?
+Enable graphics device PCI passthrough. This option makes the passthru
+graphics card become primary graphics card in the VM, so the Qemu emulated 
+graphics adapter is disabled, and the VNC console for the VM won't have
+any graphics output. All graphics output, including boot time Qemu BIOS
+messages from the VM, will go to the physical outputs of the passed thru
+physical graphics card.
+
+Graphics card PCI device to passthru is chosen with B<pci> option, 
+exactly in the same way as normal Xen PCI device passthru/assignment is done. 
+Note that gfx_passthru doesn't do any kind of sharing
+of the GPU, so you can only assign the GPU to one single VM at a time.
+
+gfx_passthru also enables various legacy VGA memory ranges, BARs, MMIOs, 
+and ioports to be passed thru to the VM, since those are required
+for correct operation of things like VGA BIOS, text mode, VBE, etc.
+
+Enabling gfx_passthru option also copies the physical graphics card 
+video bios to the guest memory, and executes the vbios in the guest 
+to get the graphics card initialized.
+
+Most graphics adapters require vendor specific tweaks for properly
+working graphics passthru. Xen currently includes necessary tweaks
+for Intel IGD (Integrated Graphics Device) GPUs.  
+
+Support for AMD/Nvidia gfx_passthru is not yet merged to Xen,
+but there are out-of-tree patches available.
+
+gfx_passthru is currently only supported with the qemu-xen-traditional
+device-model. Upstream qemu-xen device-model currently doesn't have
+support for gfx_passthru.
+
+Note that some graphics adapters (AMD/ATI cards, for example) don't
+necessarily require gfx_passthru option, so you can use the normal
+Xen PCI passthru to assign the graphics card as a secondary graphics card
+to the VM. Qemu emulated graphics card stays as the primary graphics card, 
+and you get VNC output from the Qemu-emulated primary adapter.
+
 
 =item B<nomigrate=BOOLEAN>


--neYutvxvOLaeuPCA
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="xl.cfg.pod.5-gfx_passthru.patch"

--- docs/man/xl.cfg.pod.5.orig1	2012-09-02 07:16:39.316782158 +0300
+++ docs/man/xl.cfg.pod.5	2012-09-02 08:26:40.081639087 +0300
@@ -968,7 +968,43 @@
 
 =item B<gfx_passthru=BOOLEAN>
 
-Enable graphics device PCI passthrough. XXX which device is passed through ?
+Enable graphics device PCI passthrough. This option makes the passthru
+graphics card become primary graphics card in the VM, so the Qemu emulated 
+graphics adapter is disabled, and the VNC console for the VM won't have
+any graphics output. All graphics output, including boot time Qemu BIOS
+messages from the VM, will go to the physical outputs of the passed thru
+physical graphics card.
+
+Graphics card PCI device to passthru is chosen with B<pci> option, 
+exactly in the same way as normal Xen PCI device passthru/assignment is done. 
+Note that gfx_passthru doesn't do any kind of sharing
+of the GPU, so you can only assign the GPU to one single VM at a time.
+
+gfx_passthru also enables various legacy VGA memory ranges, BARs, MMIOs, 
+and ioports to be passed thru to the VM, since those are required
+for correct operation of things like VGA BIOS, text mode, VBE, etc.
+
+Enabling gfx_passthru option also copies the physical graphics card 
+video bios to the guest memory, and executes the vbios in the guest 
+to get the graphics card initialized.
+
+Most graphics adapters require vendor specific tweaks for properly
+working graphics passthru. Xen currently includes necessary tweaks
+for Intel IGD (Integrated Graphics Device) GPUs.  
+
+Support for AMD/Nvidia gfx_passthru is not yet merged to Xen,
+but there are out-of-tree patches available.
+
+gfx_passthru is currently only supported with the qemu-xen-traditional
+device-model. Upstream qemu-xen device-model currently doesn't have
+support for gfx_passthru.
+
+Note that some graphics adapters (AMD/ATI cards, for example) don't
+necessarily require gfx_passthru option, so you can use the normal
+Xen PCI passthru to assign the graphics card as a secondary graphics card
+to the VM. Qemu emulated graphics card stays as the primary graphics card, 
+and you get VNC output from the Qemu-emulated primary adapter.
+
 
 =item B<nomigrate=BOOLEAN>
 

--neYutvxvOLaeuPCA
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xen.org
http://lists.xen.org/xen-devel

--neYutvxvOLaeuPCA--