diff options
author | Umut Tezduyar Lindskog <umuttl@axis.com> | 2015-07-10 14:31:53 +0200 |
---|---|---|
committer | Umut Tezduyar Lindskog <umuttl@axis.com> | 2015-07-10 14:32:02 +0200 |
commit | db03761e16f945fdc639f88a0c316eeda665980b (patch) | |
tree | db991519c7d7fc01819d95b69e31d81216f14631 /man/sd_bus_default.xml | |
parent | 43694a8cc70667498f3ffc5d9325b7d0428558e5 (diff) |
man: sd_unref does not necessarily free the bus
Document that sd_unref() does not necessarily free the bus,
even if no part of the program explicitly refs it, due to
the queued messages.
Diffstat (limited to 'man/sd_bus_default.xml')
-rw-r--r-- | man/sd_bus_default.xml | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/man/sd_bus_default.xml b/man/sd_bus_default.xml index 95b347bdfd..782dfb5706 100644 --- a/man/sd_bus_default.xml +++ b/man/sd_bus_default.xml @@ -219,6 +219,12 @@ one. Use <citerefentry><refentrytitle>sd_bus_unref</refentrytitle><manvolnum>3</manvolnum></citerefentry> to drop the reference.</para> + + <para>Queued messages also keep a reference to the bus. For this reason, just + because no application is having a reference to the bus does not mean that + the bus object will be destroyed. Until all the messages are sent, the bus object + will stay alive. <function>sd_bus_flush</function> can be used to send all the + queued messages so they drop their references.</para> </refsect1> <refsect1> |