External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-31 10:05:31 +00: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**
* 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**
* **Bug fixes**

43
docs/formatdomain.rst
View File

@ -6086,6 +6086,39 @@ interaction with the admin.
<gl rendernode='/dev/dri/renderD128'/>
</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
clients. It has a mandatory attribute ``type`` which specifies the listen type.
Only ``vnc``, ``spice`` and ``rdp`` supports ``<listen>`` element. :since:`Since
@ -7002,7 +7035,7 @@ to the guest sound device.
``type``
The required ``type`` attribute specifies audio backend type.
Currently, the supported values are 'none', 'alsa', 'coreaudio',
'jack', 'oss', 'pulseaudio', 'sdl', 'spice', 'file'.
'dbus', jack', 'oss', 'pulseaudio', 'sdl', 'spice', 'file'.
``id``
Integer id of the audio device. Must be greater than 0.
@ -7143,6 +7176,14 @@ and ``<output>`` elements
: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
^^^^^^^^^^^^^^^^^^