man: clarify sd_bus_default

It picks the bus based on the cgroup slice.
This commit is contained in:
Luca Boccassi 2023-04-22 12:47:20 +01:00
parent c6b8fffdfa
commit f0f7cbd488

View file

@ -110,13 +110,14 @@
<title>Description</title>
<para><function>sd_bus_default()</function> acquires a bus
connection object to the user bus when invoked in user context, or
to the system bus otherwise. The connection object is associated
with the calling thread. Each time the function is invoked from
the same thread, the same object is returned, but its reference
count is increased by one, as long as at least one reference is
kept. When the last reference to the connection is dropped (using
the
connection object to the user bus when invoked from within a user
slice (any session under <literal>user-*.slice</literal>, e.g.:
<literal>user@1000.service</literal>), or to the system bus
otherwise. The connection object is associated with the calling
thread. Each time the function is invoked from the same thread,
the same object is returned, but its reference count is increased
by one, as long as at least one reference is kept. When the last
reference to the connection is dropped (using the
<citerefentry><refentrytitle>sd_bus_unref</refentrytitle><manvolnum>3</manvolnum></citerefentry>
call), the connection is terminated. Note that the connection is
not automatically terminated when the associated thread ends. It