From: Simon McVittie Date: Wed, 31 May 2017 17:32:05 +0000 (+0100) Subject: spec: Document the canonical object path for the bus driver X-Git-Tag: dbus-1.11.14~48 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b62a77118a2efb5d995322e71a1d5507428724ce;p=thirdparty%2Fdbus.git spec: Document the canonical object path for the bus driver Signed-off-by: Simon McVittie Reviewed-by: Philip Withnall Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101256 --- diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 20f9f1781..320a5c9ab 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -5218,7 +5218,25 @@ Message Bus Messages The special message bus name org.freedesktop.DBus - responds to a number of additional messages. + responds to a number of additional messages at the object path + /org/freedesktop/DBus. + That object path is also used when emitting the + signal. + + + + For historical reasons, some of the methods in the + org.freedesktop.DBus 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 + org.freedesktop.DBus.Error.AccessDenied when + called on an unexpected object path. Client software should send + all method calls to /org/freedesktop/DBus + instead of relying on this.