Attachment 127657 Details for Bug 36190 – spec: Clarify behaviour of o.f.D.P.GetAll

[patch] spec: Clarify behaviour of o.f.D.P.GetAll

spec-Clarify-behaviour-of-ofDPGetAll.patch (text/plain), 2.17 KB, created by Philip Withnall on 2016-11-01 04:21:44 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Philip Withnall

Created: 2016-11-01 04:21:44 UTC

Size: 2.17 KB

patch

obsolete

>From 98a9fa7c3248673354367018b4a48af6637a7a58 Mon Sep 17 00:00:00 2001
>From: Philip Withnall <philip.withnall@collabora.co.uk>
>Date: Mon, 31 Oct 2016 21:17:54 -0700
>Subject: [PATCH] spec: Clarify behaviour of o.f.D.P.GetAll
>MIME-Version: 1.0
>Content-Type: text/plain; charset=UTF-8
>Content-Transfer-Encoding: 8bit
>
>Clarify its intended behaviour in two situations:
> â¢ For interfaces which have no properties.
> â¢ Where some properties are not visible to the caller (due to access
>   control, for example).
>
>The intention here is for this behaviour to be mandatory, but given that
>this is quite late on in the specificationâs life, and various D-Bus
>libraries like dbus-glib and telepathy-glib cannot support access
>control at a per-property level, for example. GDBus can, although itâs
>questionable whether this is a good idea. Deliberately leave the
>specification open to allow access control at a higher level as well
>(such as per-(object, interface)).
>
>https://bugs.freedesktop.org/show_bug.cgi?id=36190
>---
> doc/dbus-specification.xml | 11 +++++++++++
> 1 file changed, 11 insertions(+)
>
>diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
>index 64f561b..7fdeeb4 100644
>--- a/doc/dbus-specification.xml
>+++ b/doc/dbus-specification.xml
>@@ -3814,6 +3814,17 @@
>         possibilities).
>       </para>
>       <para>
>+        If <literal>org.freedesktop.DBus.Properties.GetAll</literal> is called
>+        with a valid interface name which contains no properties, an empty array
>+        should be returned. If it is called with a valid interface name for
>+        which some properties are not accessible to the caller (for example, due
>+        to per-property access control implemented in the service), those
>+        properties should be silently omitted from the result array.
>+        If <literal>org.freedesktop.DBus.Properties.Get</literal> is called for
>+        any such properties, an appropriate access control error should be
>+        returned.
>+      </para>
>+      <para>
>         If one or more properties change on an object, the
>         <literal>org.freedesktop.DBus.Properties.PropertiesChanged</literal>
>         signal may be emitted (this signal was added in 0.14):
>-- 
>2.7.4

Actions: View | Splinter Review

Attachments on bug 36190: 127657

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.