{"id":1571480,"url":"http://patchwork.ozlabs.org/api/patches/1571480/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20211221065855.142578-24-marcandre.lureau@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20211221065855.142578-24-marcandre.lureau@redhat.com>","list_archive_url":null,"date":"2021-12-21T06:58:42","name":"[PULL,v2,23/36] docs: add dbus-display documentation","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"7123c5fbf14844d1b09793bc09ed912babc93c99","submitter":{"id":66774,"url":"http://patchwork.ozlabs.org/api/people/66774/?format=json","name":"Marc-André Lureau","email":"marcandre.lureau@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20211221065855.142578-24-marcandre.lureau@redhat.com/mbox/","series":[{"id":277865,"url":"http://patchwork.ozlabs.org/api/series/277865/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=277865","date":"2021-12-21T06:58:19","name":"[PULL,v2,01/36] ui/vdagent: add CHECK_SPICE_PROTOCOL_VERSION","version":2,"mbox":"http://patchwork.ozlabs.org/series/277865/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/1571480/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/1571480/checks/","tags":{},"related":[],"headers":{"Return-Path":"<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["bilbo.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=Sccd9dCE;\n\tdkim-atps=neutral","ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=<UNKNOWN>)","relay.mimecast.com;\n auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=marcandre.lureau@redhat.com"],"Received":["from lists.gnu.org (lists.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby bilbo.ozlabs.org (Postfix) with ESMTPS id 4JJ7L81XyKz9s3q\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 21 Dec 2021 18:26:23 +1100 (AEDT)","from localhost ([::1]:57678 helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>)\n\tid 1mzZXP-0007zf-W8\n\tfor incoming@patchwork.ozlabs.org; Tue, 21 Dec 2021 02:26:20 -0500","from eggs.gnu.org ([209.51.188.92]:58884)\n by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <marcandre.lureau@redhat.com>)\n id 1mzZD8-0008Ck-Fp\n for qemu-devel@nongnu.org; Tue, 21 Dec 2021 02:05:22 -0500","from us-smtp-delivery-124.mimecast.com ([170.10.129.124]:57018)\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <marcandre.lureau@redhat.com>)\n id 1mzZD6-0002Dx-Sn\n for qemu-devel@nongnu.org; Tue, 21 Dec 2021 02:05:22 -0500","from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com\n [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS\n (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n us-mta-445-_dBvqSn0POaZiGLkLStm_A-1; Tue, 21 Dec 2021 02:05:16 -0500","from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com\n [10.5.11.14])\n (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n (No client certificate requested)\n by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 0EB061853020;\n Tue, 21 Dec 2021 07:05:15 +0000 (UTC)","from localhost (unknown [10.39.208.37])\n by smtp.corp.redhat.com (Postfix) with ESMTP id C8C5E7A426;\n Tue, 21 Dec 2021 07:05:00 +0000 (UTC)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1640070320;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=4i695WYQfKfo7JWS1MpuRVcRVmXZfC3kjxOk40FWxpY=;\n b=Sccd9dCETL+aiMsPKALch4wlNFUzITpzLVTowbWFizT2xLKKF1Z4PHuVayyGdjVNcp+tqH\n lFucOt/gWsXr2vYP71LDiN2tvS5S/6s6ayavf7TguxW8Zj50Ebx4Cp0TOyWlk+oJVNaifE\n XE9vemmpKCCleDicenoEsQQLqqv91hA=","X-MC-Unique":"_dBvqSn0POaZiGLkLStm_A-1","From":"marcandre.lureau@redhat.com","To":"qemu-devel@nongnu.org","Subject":"[PULL v2 23/36] docs: add dbus-display documentation","Date":"Tue, 21 Dec 2021 10:58:42 +0400","Message-Id":"<20211221065855.142578-24-marcandre.lureau@redhat.com>","In-Reply-To":"<20211221065855.142578-1-marcandre.lureau@redhat.com>","References":"<20211221065855.142578-1-marcandre.lureau@redhat.com>","MIME-Version":"1.0","X-Scanned-By":"MIMEDefang 2.79 on 10.5.11.14","X-Mimecast-Spam-Score":"0","X-Mimecast-Originator":"redhat.com","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"8bit","Received-SPF":"pass client-ip=170.10.129.124;\n envelope-from=marcandre.lureau@redhat.com;\n helo=us-smtp-delivery-124.mimecast.com","X-Spam_score_int":"-29","X-Spam_score":"-3.0","X-Spam_bar":"---","X-Spam_report":"(-3.0 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.203,\n DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001,\n SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no","X-Spam_action":"no action","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"<qemu-devel.nongnu.org>","List-Unsubscribe":"<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>","List-Archive":"<https://lists.nongnu.org/archive/html/qemu-devel>","List-Post":"<mailto:qemu-devel@nongnu.org>","List-Help":"<mailto:qemu-devel-request@nongnu.org?subject=help>","List-Subscribe":"<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>","Cc":"peter.maydell@linaro.org, richard.henderson@linaro.org, =?utf-8?q?Marc-A?=\n\t=?utf-8?q?ndr=C3=A9_Lureau?= <marcandre.lureau@redhat.com>","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n <qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>"},"content":"From: Marc-André Lureau <marcandre.lureau@redhat.com>\n\nWire up the dbus-display documentation. The interface and feature is\nimplemented next.\n\nSigned-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>\nAcked-by: Gerd Hoffmann <kraxel@redhat.com>\n---\n docs/interop/dbus-display.rst | 31 +++++++++++++++++++++++++++++++\n docs/interop/dbus.rst         |  2 ++\n docs/interop/index.rst        |  1 +\n ui/dbus-display1.xml          |  0\n 4 files changed, 34 insertions(+)\n create mode 100644 docs/interop/dbus-display.rst\n create mode 100644 ui/dbus-display1.xml","diff":"diff --git a/docs/interop/dbus-display.rst b/docs/interop/dbus-display.rst\nnew file mode 100644\nindex 000000000000..8c6e8e0f5a82\n--- /dev/null\n+++ b/docs/interop/dbus-display.rst\n@@ -0,0 +1,31 @@\n+D-Bus display\n+=============\n+\n+QEMU can export the VM display through D-Bus (when started with ``-display\n+dbus``), to allow out-of-process UIs, remote protocol servers or other\n+interactive display usages.\n+\n+Various specialized D-Bus interfaces are available on different object paths\n+under ``/org/qemu/Display1/``, depending on the VM configuration.\n+\n+QEMU also implements the standard interfaces, such as\n+`org.freedesktop.DBus.Introspectable\n+<https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces>`_.\n+\n+.. contents::\n+   :local:\n+   :depth: 1\n+\n+.. only:: sphinx4\n+\n+   .. dbus-doc:: ui/dbus-display1.xml\n+\n+.. only:: not sphinx4\n+\n+   .. warning::\n+      Sphinx 4 is required to build D-Bus documentation.\n+\n+      This is the content of ``ui/dbus-display1.xml``:\n+\n+   .. literalinclude:: ../../ui/dbus-display1.xml\n+      :language: xml\ndiff --git a/docs/interop/dbus.rst b/docs/interop/dbus.rst\nindex be596d3f418c..427debc9c504 100644\n--- a/docs/interop/dbus.rst\n+++ b/docs/interop/dbus.rst\n@@ -108,3 +108,5 @@ QEMU Interfaces\n ===============\n \n :doc:`dbus-vmstate`\n+\n+:doc:`dbus-display`\ndiff --git a/docs/interop/index.rst b/docs/interop/index.rst\nindex 47b9ed82bbc0..c59bac983407 100644\n--- a/docs/interop/index.rst\n+++ b/docs/interop/index.rst\n@@ -12,6 +12,7 @@ are useful for making QEMU interoperate with other software.\n    bitmaps\n    dbus\n    dbus-vmstate\n+   dbus-display\n    live-block-operations\n    pr-helper\n    qemu-ga\ndiff --git a/ui/dbus-display1.xml b/ui/dbus-display1.xml\nnew file mode 100644\nindex 000000000000..e69de29bb2d1\n","prefixes":["PULL","v2","23/36"]}