From: Marc-André Lureau <marcandre.lureau@xxxxxxxxxx> Signed-off-by: Marc-André Lureau <marcandre.lureau@xxxxxxxxxx> --- NEWS.rst | 5 +++++ docs/formatdomain.rst | 43 ++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 47 insertions(+), 1 deletion(-) diff --git a/NEWS.rst b/NEWS.rst index 7903449f9b..b32fd26167 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -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** diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index c1e99951a6..7e31c6b303 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6080,6 +6080,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 @@ -6996,7 +7029,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. @@ -7137,6 +7170,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 ^^^^^^^^^^^^^^^^^^ -- 2.36.1