[libvirt PATCH 9/9] docs: document <graphics> type dbus

marcandre.lureau at redhat.com marcandre.lureau at redhat.com
Fri Nov 5 10:51:19 UTC 2021


From: Marc-André Lureau <marcandre.lureau at redhat.com>

Signed-off-by: Marc-André Lureau <marcandre.lureau at redhat.com>
---
 docs/formatdomain.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst
index eb8c973cf1fc..b477aec65f5c 100644
--- a/docs/formatdomain.rst
+++ b/docs/formatdomain.rst
@@ -6060,6 +6060,30 @@ interaction with the admin.
            <gl rendernode='/dev/dri/renderD128'/>
          </graphics>
 
+   ``dbus``:since:`Since X.X.X`
+      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 (via Spice agent) is set by the ``clipboard``
+      element. It is disabled by default, and can be disabled by setting the
+      ``copypaste`` property to ``yes``.
+
+
 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
-- 
2.33.0.721.g106298f7f9




More information about the libvir-list mailing list