summaryrefslogtreecommitdiff
path: root/man/sd_bus_default.xml
diff options
context:
space:
mode:
authorUmut Tezduyar Lindskog <umuttl@axis.com>2015-07-10 14:31:53 +0200
committerUmut Tezduyar Lindskog <umuttl@axis.com>2015-07-10 14:32:02 +0200
commitdb03761e16f945fdc639f88a0c316eeda665980b (patch)
treedb991519c7d7fc01819d95b69e31d81216f14631 /man/sd_bus_default.xml
parent43694a8cc70667498f3ffc5d9325b7d0428558e5 (diff)
downloadsystemd-db03761e16f945fdc639f88a0c316eeda665980b.tar.gz
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.xml6
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>