diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2014-09-10 16:20:52 +0100 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2014-10-13 15:16:56 +0100 |
commit | c88525f815d17933e2c00cb20f9eb3804a860257 (patch) | |
tree | 9fd21f11b3aea862f42bf4e97adab7b5207a8d7e /dbus | |
parent | eca46a23416202d635c3812146b91c9a04697b9f (diff) | |
download | dbus-c88525f815d17933e2c00cb20f9eb3804a860257.tar.gz |
dbus_shutdown: document its effect on shared connections
In practice, the sort of applications that call dbus_shutdown()
(e.g. regression tests) will want to either use private connections,
or turn off exit-on-disconnect on the shared connection, or both.
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=16924
Diffstat (limited to 'dbus')
-rw-r--r-- | dbus/dbus-memory.c | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/dbus/dbus-memory.c b/dbus/dbus-memory.c index 22e80727..67d5cb05 100644 --- a/dbus/dbus-memory.c +++ b/dbus/dbus-memory.c @@ -862,6 +862,13 @@ _dbus_register_shutdown_func_unlocked (DBusShutdownFunction func, * You MUST free all memory and release all reference counts * returned to you by libdbus prior to calling dbus_shutdown(). * + * If a shared connection is open, calling dbus_shutdown() will + * drain its queue of messages and disconnect it. In particular, + * this will result in processing of the special Disconnected + * signal, which may result in a call to _exit(), unless you + * have used dbus_connection_set_exit_on_disconnect() to disable + * that behaviour. + * * You can't continue to use any D-Bus objects, such as connections, * that were allocated prior to dbus_shutdown(). You can, however, * start over; call dbus_threads_init() again, create new connections, |