NuKVM/libvirt
3
0
Fork 0
mirror of https://github.com/libvirt/libvirt.git synced 2025-02-25 18:55:26 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs: document <graphics> type dbus

Browse Source 
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
This commit is contained in:
Marc-André Lureau 2022-05-13 20:38:20 +02:00 committed by Michal Privoznik
parent 3fa987cc42
commit 89d789670d
2 changed files with 47 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
NEWS.rst
View File

@ -17,6 +17,11 @@ v8.4.0 (unreleased)
* **New features** * **New features**
* qemu: D-Bus display
Libvirt is now able to setup a D-Bus display export, either with a private
bus or in p2p mode. This display is available in QEMU 7.0.0.
* **Improvements** * **Improvements**
* **Bug fixes** * **Bug fixes**

43
docs/formatdomain.rst
View File

@ -6086,6 +6086,39 @@ interaction with the admin.
<gl rendernode='/dev/dri/renderD128'/> <gl rendernode='/dev/dri/renderD128'/>
</graphics> </graphics>
``dbus``:since:`Since 8.4.0`
Export the display over D-Bus. By default, it will use a private bus,
except when ``p2p`` or ``address`` are specified.
::
<graphics type='dbus'/>
``p2p`` (accepts ``on`` or ``off``) enables peer-to-peer connections,
established through virDomainOpenGraphics() APIs.
``address`` (accepts a `D-Bus address
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses>`_),
will connect to the specified bus address.
This element accepts a ``<gl/>`` sub-element with an optional attribute
``rendernode`` which can be used to specify an absolute path to a host's
DRI device to be used for OpenGL rendering.
Copy & Paste functionality is provided thanks to the QEMU clipboard
manager and the SPICE vdagent protocol. See ``qemu-vdagent`` for more
details.
D-Bus can export an audio backend using the ``<audio>`` sub-element:
::
<graphics type='dbus' ...>
<audio id='1'>
</graphics>
Where ``1`` is an id of the `audio device <#elementsAudio>`__.
Graphics device uses a ``<listen>`` to set up where the device should listen for Graphics device uses a ``<listen>`` to set up where the device should listen for
clients. It has a mandatory attribute ``type`` which specifies the listen type. clients. It has a mandatory attribute ``type`` which specifies the listen type.
Only ``vnc``, ``spice`` and ``rdp`` supports ``<listen>`` element. :since:`Since Only ``vnc``, ``spice`` and ``rdp`` supports ``<listen>`` element. :since:`Since
@ -7002,7 +7035,7 @@ to the guest sound device.
``type`` ``type``
The required ``type`` attribute specifies audio backend type. The required ``type`` attribute specifies audio backend type.
Currently, the supported values are 'none', 'alsa', 'coreaudio', Currently, the supported values are 'none', 'alsa', 'coreaudio',
'jack', 'oss', 'pulseaudio', 'sdl', 'spice', 'file'. 'dbus', jack', 'oss', 'pulseaudio', 'sdl', 'spice', 'file'.
``id`` ``id``
Integer id of the audio device. Must be greater than 0. Integer id of the audio device. Must be greater than 0.
@ -7143,6 +7176,14 @@ and ``<output>`` elements
:since:`Since 7.2.0, qemu` :since:`Since 7.2.0, qemu`
D-Bus audio backend
^^^^^^^^^^^^^^^^^^^
The 'dbus' audio backend does not connect to any host audio framework. It
exports a D-Bus interface when associated with a D-Bus display.
:since:`Since 8.4.0, qemu`
Jack audio backend Jack audio backend
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^