Commit b62a7711 authored by Simon McVittie's avatar Simon McVittie

spec: Document the canonical object path for the bus driver

Signed-off-by: Simon McVittie's avatarSimon McVittie <smcv@collabora.com>
Reviewed-by: Philip Withnall's avatarPhilip Withnall <withnall@endlessm.com>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101256
parent e3083cc2
......@@ -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">
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment