mirror of
https://github.com/gnif/LookingGlass.git
synced 2026-11-09 21:37:20 +00:00
[doc] requirements: Cleanup
This commit is contained in:
committed by
Geoffrey McRae
parent
eb120d3299
commit
de617eef73
@@ -11,28 +11,32 @@ Required
|
|||||||
Linux host
|
Linux host
|
||||||
A Linux system capable of running KVM/QEMU and building the Looking Glass
|
A Linux system capable of running KVM/QEMU and building the Looking Glass
|
||||||
Client. The client requires an EGL-capable graphics driver. X11 and Wayland
|
Client. The client requires an EGL-capable graphics driver. X11 and Wayland
|
||||||
are supported. For a responsive passthrough setup, use at least six CPU
|
are supported. For a responsive passthrough setup, at least six CPU cores
|
||||||
cores with twelve hardware threads.
|
with twelve hardware threads are required.
|
||||||
|
|
||||||
Windows guest
|
Windows guest
|
||||||
A Windows 10 version 1803 or newer, or Windows 11, virtual machine. The
|
A Windows 10 version 1803 or newer, or Windows 11, virtual machine. Looking
|
||||||
recommended IDD path can create its own virtual monitor and does not require
|
Glass can create its own virtual monitor and does not require a physical
|
||||||
a physical monitor or dummy plug.
|
monitor or dummy plug.
|
||||||
|
|
||||||
Shared memory
|
Shared memory
|
||||||
An IVSHMEM device large enough for the maximum guest resolution. The KVMFR
|
An IVSHMEM device large enough for the maximum guest resolution and refresh
|
||||||
kernel module is recommended and is required for direct GPU imports.
|
rate. The KVMFR kernel module is recommended and is required for direct GPU
|
||||||
|
imports.
|
||||||
|
|
||||||
Matching components
|
Matching components
|
||||||
Use the current client, IDD and OBS plugin from the same Looking Glass
|
The Looking Glass client, IDD, and OBS plugin (if used) must be of the same
|
||||||
release. A protocol version mismatch is not supported. Legacy Host users
|
version. Legacy Host users must use the B7 stack described below.
|
||||||
must use the complete matching B7 stack described below.
|
|
||||||
|
|
||||||
The IDD can fall back to software processing if the Windows guest has no
|
The IDD can fall back to software processing if the Windows guest has no
|
||||||
suitable render GPU. This is useful for compatibility, but hardware processing
|
suitable render GPU. This is useful for compatibility, but hardware processing
|
||||||
is strongly recommended for lower latency and higher frame rates. Software
|
is strongly recommended for lower latency and higher frame rates. Software
|
||||||
mode is SDR-only and does not provide the same performance as the GPU path.
|
mode is SDR-only and does not provide the same performance as the GPU path.
|
||||||
|
|
||||||
|
.. seealso::
|
||||||
|
|
||||||
|
:ref:`libvirt_determining_memory`
|
||||||
|
|
||||||
.. _recommended:
|
.. _recommended:
|
||||||
|
|
||||||
Recommended
|
Recommended
|
||||||
@@ -42,15 +46,13 @@ For a responsive high-resolution setup, use:
|
|||||||
|
|
||||||
* a host CPU with eight cores and sixteen threads or better, with full
|
* a host CPU with eight cores and sixteen threads or better, with full
|
||||||
performance cores around 3 GHz or faster;
|
performance cores around 3 GHz or faster;
|
||||||
* KVMFR rather than a plain shared-memory file;
|
* the KVMFR kernel module rather than a plain shared-memory file;
|
||||||
* a host GPU and driver that support direct DMA imports;
|
* a host GPU and driver that support direct DMA imports; and
|
||||||
* a hardware render adapter in the Windows guest; and
|
* a hardware render adapter in the Windows guest.
|
||||||
* enough memory bandwidth for the chosen resolution and refresh rate.
|
|
||||||
|
|
||||||
Do not assign every CPU core to the guest. Reserve at least two physical CPU
|
Reserve at least two physical CPU cores, or four threads, for Linux. Looking
|
||||||
cores, or four threads, for Linux. Looking Glass, QEMU, the Linux desktop and
|
Glass, QEMU, the Linux desktop and audio server all need host CPU time. High
|
||||||
audio server all need host CPU time. High refresh rates also raise
|
refresh rates also raise shared-memory and GPU bandwidth requirements.
|
||||||
shared-memory and GPU bandwidth requirements.
|
|
||||||
|
|
||||||
For a passed-through GPU, PCIe bandwidth can also limit performance. Use at
|
For a passed-through GPU, PCIe bandwidth can also limit performance. Use at
|
||||||
least eight PCIe 3.0 lanes or four PCIe 4.0 lanes where practical.
|
least eight PCIe 3.0 lanes or four PCIe 4.0 lanes where practical.
|
||||||
@@ -60,12 +62,11 @@ least eight PCIe 3.0 lanes or four PCIe 4.0 lanes where practical.
|
|||||||
Physical display and dummy plugs
|
Physical display and dummy plugs
|
||||||
--------------------------------
|
--------------------------------
|
||||||
|
|
||||||
The recommended IDD does not require a physical display or dummy plug. It
|
The IDD does not require a physical display or dummy plug: it creates a virtual
|
||||||
creates a virtual Windows monitor, including on systems without a
|
Windows monitor, including on systems without a passed-through display output.
|
||||||
passed-through display output.
|
|
||||||
|
|
||||||
A physical display, dummy plug or another virtual monitor is only required
|
A physical display, dummy plug or another virtual monitor is only required
|
||||||
when using the :doc:`legacy Host Application <install_host>`, because that
|
when using the :doc:`Legacy Host Application <legacy_host>`, because that
|
||||||
application captures an existing Windows display.
|
application captures an existing Windows display.
|
||||||
|
|
||||||
.. _igpu_kvmfr_recommended:
|
.. _igpu_kvmfr_recommended:
|
||||||
|
|||||||
Reference in New Issue
Block a user