From f8cb8d6d7993770ee729a1b9db1d5a7b30b6705c Mon Sep 17 00:00:00 2001 From: Tom Gundersen Date: Tue, 25 Apr 2017 02:56:25 +0200 Subject: [PATCH 3/3] docs: message bus messages - describe generic error codes Describe the error codes given for invalid interface/method/signature. Also make it clear that the specified error codes are not exhaustive. Signed-off-by: Tom Gundersen --- doc/dbus-specification.xml | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index f730f580..76ce513f 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -5218,7 +5218,16 @@ 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. The message bus may return a + number of different error messages on failure, in particular, + org.freedesktop.DBus.Error.UnknownInterface if the + given interface is not known, + org.freedesktop.DBus.Error.UnknownMethod if the given + method is not known and + org.freedesktop.DBus.Error.InvalidArgs if the signature + is not as expected for the method. Individual methods may return further + error codes as indicated below. Additionally, clients should be prepared to + handle unexpected error codes, not documented in the specification. -- 2.12.2