Software/DBusBindingErrors

This page is for bindings authors to discuss what generic errors should be sent by the binding:

Name

Description

Comments

ServiceUnknown

The recipient bus name is not taken

In Core

UnknownObject

The sender has called a method on an object not exported on this connection (the service name is valid)

Used by Java

UnknownInterface

The sender has specified an interface this object does not implement (but the object is valid)

Requested by Thiago

UnknownMethod

The specified method is not implemented on this object (but the object and the interface names are valid)

In core

InvalidParameters

Method was called with an invalid number or type of parameters. (Comment: org.freedesktop.DBus.Error.InvalidArgs seems more suitable for this use, especially considering there is no "parameter" in D-Bus terminology -- alp)

Suggested by Matt

Please add other errors you think should, or could possibly, be useful

Other comments:

The format of error messages

The spec suggests that error messages can contain different arguments and aren't restricted to a single string. Do any core errors or binding errors make use of this? Would this be useful when mapping exceptions thrown by an object binding, say for the stack trace etc.?

The spec should specifically say whether the string is mandatory as the first parameter or not. It should also make it clear if more parameters are permitted or not.

Well-known core errors

This is a list of core errors for reference. They are usually kept in order because it seems the glib binding puts them in an enumeration. Are these documented anywhere?