summaryrefslogtreecommitdiffstats
path: root/man/sd_bus_request_name.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2013-12-12 22:01:40 +0100
committerLennart Poettering <lennart@poettering.net>2013-12-13 04:06:43 +0100
commitb408e2a8be6b87fd1796c45a767d00bbb00d7148 (patch)
treeb3673c564f6b4dcf5b3b446c15f2f9676c9bc5da /man/sd_bus_request_name.xml
parentbus: make sure exit-on-idle logic works on kdbus systems that do not generate... (diff)
downloadsystemd-b408e2a8be6b87fd1796c45a767d00bbb00d7148.tar.xz
systemd-b408e2a8be6b87fd1796c45a767d00bbb00d7148.zip
man: update sd_bus_request_name() man page
Diffstat (limited to 'man/sd_bus_request_name.xml')
-rw-r--r--man/sd_bus_request_name.xml23
1 files changed, 11 insertions, 12 deletions
diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml
index 6e61a88737..039b9627e3 100644
--- a/man/sd_bus_request_name.xml
+++ b/man/sd_bus_request_name.xml
@@ -106,9 +106,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 +126,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>