[pve-devel] [PATCH docs 1/2] pci passthrough: add GPU passthrough notes

[Dominik Csapak]

to make it clear how to use a GPU inside the vm

Signed-off-by: Dominik Csapak <***@proxmox.com>
---
qm-pci-passthrough.adoc | 15 +++++++++++++++
1 file changed, 15 insertions(+)

diff --git a/qm-pci-passthrough.adoc b/qm-pci-passthrough.adoc
index 43b9ddc..0a5c63f 100644
--- a/qm-pci-passthrough.adoc
+++ b/qm-pci-passthrough.adoc
@@ -128,6 +128,21 @@ For this add the following line in a file ending with `.conf' file in
Please be aware that this option can make your system unstable.
====

+Notes for GPU passthrough
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When passing through a GPU (be it a full device, or a vGPU), if you want to use
+it for displaying, you have to either physically connect a monitor to the
+card (if possible), or configure a remote desktop software (e.g., VNC, RDP)
+inside the guest and use that.
+
+It is not possible to display the content of the GPU via NoVNC/SPICE on the
+{pve} web interface.
+
+If you want to use the GPU for things like OpenCL or CUDA, this is not an issue,
+since the application should be able to choose the hardware without using
+it as a display.
+
Host Device Passthrough
~~~~~~~~~~~~~~~~~~~~~~~

[Dominik Csapak]

Signed-off-by: Dominik Csapak <***@proxmox.com>
---
qm-pci-passthrough.adoc | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/qm-pci-passthrough.adoc b/qm-pci-passthrough.adoc
index 0a5c63f..7e00e2e 100644
--- a/qm-pci-passthrough.adoc
+++ b/qm-pci-passthrough.adoc
@@ -192,8 +192,8 @@ configuration, for example by executing:
# qm set VMID -hostpci0 00:02.0
----

-If your device has multiple functions, you can pass them through all together
-with the shortened syntax ``00:02`'
+If your device has multiple functions (e.g., ``00:02.0`' and ``00:02.1`'),
+you can pass them through all together with the shortened syntax ``00:02`'

There are some options to which may be necessary, depending on the device
and guest OS:

[Thomas Lamprecht]

Post by Dominik Csapak
---
qm-pci-passthrough.adoc | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/qm-pci-passthrough.adoc b/qm-pci-passthrough.adoc
index 0a5c63f..7e00e2e 100644
--- a/qm-pci-passthrough.adoc
+++ b/qm-pci-passthrough.adoc
# qm set VMID -hostpci0 00:02.0
----
-If your device has multiple functions, you can pass them through all together
-with the shortened syntax ``00:02`'
+If your device has multiple functions (e.g., ``00:02.0`' and ``00:02.1`'),
+you can pass them through all together with the shortened syntax ``00:02`'
There are some options to which may be necessary, depending on the device

applied, thanks!

[Thomas Lamprecht]

Post by Dominik Csapak
to make it clear how to use a GPU inside the vm
---
qm-pci-passthrough.adoc | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/qm-pci-passthrough.adoc b/qm-pci-passthrough.adoc
index 43b9ddc..0a5c63f 100644
--- a/qm-pci-passthrough.adoc
+++ b/qm-pci-passthrough.adoc
@@ -128,6 +128,21 @@ For this add the following line in a file ending with `.conf' file in
Please be aware that this option can make your system unstable.
====
+Notes for GPU passthrough
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When passing through a GPU (be it a full device, or a vGPU), if you want to use
+it for displaying, you have to either physically connect a monitor to the
+card (if possible), or configure a remote desktop software (e.g., VNC, RDP)
+inside the guest and use that.
+
+It is not possible to display the content of the GPU via NoVNC/SPICE on the
+{pve} web interface.
+
+If you want to use the GPU for things like OpenCL or CUDA, this is not an issue,
+since the application should be able to choose the hardware without using
+it as a display.
+
Host Device Passthrough
~~~~~~~~~~~~~~~~~~~~~~~

applied, with followup.