fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-01-30 10:30:20 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

dbus_bus_add_match: improve error documentation.

Browse source 
It's simply not true that the only possible error is a lack of resources
in the bus.
This commit is contained in:
Will Thompson 2011-04-14 18:18:25 +01:00
parent 9a28fa6a4e
commit b52ad4a8e1
1 changed files with 9 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
dbus/dbus-bus.c
View file

@ -1434,11 +1434,17 @@ send_no_return_values (DBusConnection *connection,
* If you pass #NULL for the error, this function will not
* block; the match thus won't be added until you flush the
* connection, and if there's an error adding the match
* (only possible error is lack of resources in the bus),
* you won't find out about it.
* you won't find out about it. This is generally acceptable, since the
* possible errors (including a lack of resources in the bus, the connection
* having exceeded its quota of active match rules, or the match rule being
* unparseable) are generally unrecoverable.
*
* If you pass non-#NULL for the error this function will
* block until it gets a reply.
* block until it gets a reply. This may be useful when using match rule keys
* introduced in recent versions of D-Bus, like 'arg0namespace', to allow the
* application to fall back to less efficient match rules supported by older
* versions of the daemon if the running version is not new enough; or when
* using user-supplied rules rather than rules hard-coded at compile time.
*
* Normal API conventions would have the function return
* a boolean value indicating whether the error was set,