1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2024-12-22 13:33:56 +03:00

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.
This commit is contained in:
Umut Tezduyar Lindskog 2015-07-10 14:31:53 +02:00
parent 43694a8cc7
commit db03761e16
2 changed files with 13 additions and 9 deletions

View File

@ -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>

View File

@ -77,8 +77,8 @@
<para><function>sd_bus_new()</function> creates a new bus
object. This object is reference-counted, and will be destroyed
when all references are gone. Initially, the caller of this
function owns the sole reference. The bus object will not be
connected to any bus initially. To connect it to a bus, make sure
function owns the sole reference and the bus object will not be
connected to any bus. To connect it to a bus, make sure
to set an address with
<citerefentry><refentrytitle>sd_bus_set_address</refentrytitle><manvolnum>3</manvolnum></citerefentry>
or a related call, and then start the connection with
@ -94,15 +94,13 @@
well-known bus in a single function invocation.</para>
<para><function>sd_bus_ref()</function> creates a new reference to
<parameter>bus</parameter>. This bus object will not be destroyed
until <function>sd_bus_unref()</function> has been called as many
times plus once more. Once the reference count has dropped to
zero, <parameter>bus</parameter> cannot be used anymore, so
further calls to <function>sd_bus_ref()</function> or
<function>sd_bus_unref()</function> are illegal.</para>
<parameter>bus</parameter>.</para>
<para><function>sd_bus_unref()</function> destroys a reference to
<parameter>bus</parameter>.</para>
<parameter>bus</parameter>. Once the reference count has dropped
to zero, <parameter>bus</parameter> cannot be used anymore, so
further calls to <function>sd_bus_ref()</function> or
<function>sd_bus_unref()</function> are illegal.</para>
</refsect1>
<refsect1>