From: Luca Boccassi <bluca@debian.org>
Date: Sat, 22 Apr 2023 11:47:20 +0000 (+0100)
Subject: man: clarify sd_bus_default
X-Git-Tag: v254-rc1~662^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F27357%2Fhead;p=thirdparty%2Fsystemd.git

man: clarify sd_bus_default

It picks the bus based on the cgroup slice.
---

diff --git a/man/sd_bus_default.xml b/man/sd_bus_default.xml
index 48d9c9a1082..8be4254be11 100644
--- a/man/sd_bus_default.xml
+++ b/man/sd_bus_default.xml
@@ -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