core: in a container log to /dev/console if "debug" is specified

[elogind.git] / man / sd_bus_request_name.xml

diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml
index 6e61a88737a3fda177acf7748618d3314e5e804a..23d49fb4caa15305a92c723911e878ad8d5ef8c8 100644 (file)
--- a/man/sd_bus_request_name.xml
+++ b/man/sd_bus_request_name.xml
@@ -56,7 +56,7 @@
                                 <funcdef>int <function>sd_bus_request_name</function></funcdef>
                                 <paramdef>sd_bus* <parameter>bus</parameter></paramdef>
                                 <paramdef>const char *<parameter>name</parameter></paramdef>
-                                <paramdef>unsigned <parameter>flags</parameter></paramdef>
+                                <paramdef>uint64_t <parameter>flags</parameter></paramdef>
                         </funcprototype>
 
                         <funcprototype>
@@ -64,8 +64,6 @@
                                 <paramdef>sd_bus* <parameter>bus</parameter></paramdef>
                                 <paramdef>const char *<parameter>name</parameter></paramdef>
                         </funcprototype>
-
-
                 </funcsynopsis>
         </refsynopsisdiv>
 
@@ -106,9 +104,9 @@
                         </varlistentry>
 
                         <varlistentry>
-                                <term><varname>SD_BUS_NAME_DO_NOT_QUEUE</varname></term>
+                                <term><varname>SD_BUS_NAME_QUEUE</varname></term>
 
-                                <listitem><para>Do not queue name
+                                <listitem><para>Queue name
                                 acquisition when the name is already
                                 taken.</para></listitem>
                         </varlistentry>
@@ -126,16 +124,15 @@
                 integer. On failure, these calls return a negative
                 errno-style error code.</para>
 
-                <para><function>sd_bus_request_name()</function> will
-                return 0 when the name is already taken by another
-                peer and the client has been added to the queue for
-                the name, unless
-                <varname>SD_BUS_NAME_DO_NOT_QUEUE</varname> has been
-                set. The caller can subscribe to
-                <literal>NameOwnerChanged</literal> signals to be
-                notified when the name is successfully
-                acquired. <function>sd_bus_request_name()</function> returns
-                &gt; 0 when the name has been
+                <para>If <varname>SD_BUS_NAME_QUEUE</varname> is
+                specified <function>sd_bus_request_name()</function>
+                will return 0 when the name is already taken by
+                another peer and the client has been added to the
+                queue for the name. In that case the caller can
+                subscribe to <literal>NameOwnerChanged</literal>
+                signals to be notified when the name is successfully
+                acquired. <function>sd_bus_request_name()</function>
+                returns &gt; 0 when the name has immediately been
                 acquired successfully.</para>
         </refsect1>
 
@@ -165,6 +162,24 @@
                                 name.</para></listitem>
                         </varlistentry>
 
+                        <varlistentry>
+                                <term><varname>-ESRCH</varname></term>
+
+                                <listitem><para>It was attemted to
+                                release a name that is currently not
+                                registered on the
+                                bus.</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><varname>-EADDRINUSE</varname></term>
+
+                                <listitem><para>It was attemted to
+                                release a name that is owned by a
+                                different peer on the
+                                bus.</para></listitem>
+                        </varlistentry>
+
                         <varlistentry>
                                 <term><varname>-EINVAL</varname></term>