diff options
author | Philip Withnall <philip.withnall@collabora.co.uk> | 2016-10-31 21:17:54 -0700 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2016-11-22 11:26:46 +0000 |
commit | 8eca3f6ed945653aff8e81fde8141c64fdf9a3f4 (patch) | |
tree | a8072b18fbd2491285d00115909439d7d2d9fd4d /doc | |
parent | b51aa049c7db9a5acdc932e2d27639700c5091f0 (diff) | |
download | dbus-8eca3f6ed945653aff8e81fde8141c64fdf9a3f4.tar.gz |
spec: Clarify behaviour of o.f.D.P.GetAll
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)).
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=36190
Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dbus-specification.xml | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index fbb8f254..9f1527b6 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -3816,6 +3816,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): |