fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-05-04 02:27:59 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

spec: Document the canonical object path for the bus driver

Browse source 
Signed-off-by: Simon McVittie <smcv@collabora.com>
Reviewed-by: Philip Withnall <withnall@endlessm.com>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101256
This commit is contained in:
Simon McVittie 2017-05-31 18:32:05 +01:00
parent e3083cc200
commit b62a77118a
1 changed files with 19 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
doc/dbus-specification.xml
View file

@ -5218,7 +5218,25 @@
<title>Message Bus Messages</title>
<para>
The special message bus name <literal>org.freedesktop.DBus</literal>
responds to a number of additional messages.
responds to a number of additional messages at the object path
<literal>/org/freedesktop/DBus</literal>.
That object path is also used when emitting the
<xref linkend='bus-messages-name-owner-changed'/> signal.
</para>
<para>
For historical reasons, some of the methods in the
<literal>org.freedesktop.DBus</literal> interface are available
on multiple object paths. Message bus implementations should
accept method calls that were added before specification version
0.26 on any object path. Message bus implementations should
not accept newer method calls on unexpected object paths,
and as a security hardening measure, older method calls
that are security-sensitive may be rejected with the error
<literal>org.freedesktop.DBus.Error.AccessDenied</literal> when
called on an unexpected object path. Client software should send
all method calls to <literal>/org/freedesktop/DBus</literal>
instead of relying on this.
</para>
<sect3 id="bus-messages-hello">