X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_request_name.xml;h=c23bbb37bc5fa644af517a0844f42e0b6e4ff313;hb=fb7661a6020b5680d5647d3d85b0501a4f3a5042;hp=6e61a88737a3fda177acf7748618d3314e5e804a;hpb=e7176abbe818c75c6acd90227a7a84c3e05fee31;p=elogind.git
diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml
index 6e61a8873..c23bbb37b 100644
--- a/man/sd_bus_request_name.xml
+++ b/man/sd_bus_request_name.xml
@@ -21,7 +21,7 @@
along with systemd; If not, see .
-->
-
+
sd_bus_request_name
@@ -54,18 +54,16 @@
int sd_bus_request_name
- sd_bus* bus
+ sd_bus *bus
const char *name
- unsigned flags
+ uint64_t flags
int sd_bus_release_name
- sd_bus* bus
+ sd_bus *bus
const char *name
-
-
@@ -83,13 +81,13 @@
SD_BUS_NAME_ALLOW_REPLACEMENT
After acquiring the
- name successuflly, permit other peers
+ name successfully, permit other peers
to take over the name when they try to
acquire it with the
SD_BUS_NAME_REPLACE_EXISTING
flag set. If
SD_BUS_NAME_ALLOW_REPLACEMENT
- is not set on the original request
+ is not set on the original request,
such a request by other peers will be
denied.
@@ -97,19 +95,19 @@
SD_BUS_NAME_REPLACE_EXISTING
- Take over a the name
- if it is already acquired by a another
- peer, and that other peer permitted
- taking it over by setting
+ Take over the name
+ if it is already acquired by another
+ peer, and that other peer has permitted
+ takeover by setting
SD_BUS_NAME_ALLOW_REPLACEMENT
while acquiring it.
- SD_BUS_NAME_DO_NOT_QUEUE
+ SD_BUS_NAME_QUEUE
- Do not queue name
- acquisition when the name is already
+ Queue the acquisition
+ of the name when the name is already
taken.
@@ -126,16 +124,15 @@
integer. On failure, these calls return a negative
errno-style error code.
- sd_bus_request_name() 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
- SD_BUS_NAME_DO_NOT_QUEUE has been
- set. The caller can subscribe to
- NameOwnerChanged signals to be
- notified when the name is successfully
- acquired. sd_bus_request_name() returns
- > 0 when the name has been
+ If SD_BUS_NAME_QUEUE is
+ specified, sd_bus_request_name()
+ 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 NameOwnerChanged
+ signals to be notified when the name is successfully
+ acquired. sd_bus_request_name()
+ returns > 0 when the name has immediately been
acquired successfully.
@@ -165,6 +162,24 @@
name.
+
+ -ESRCH
+
+ It was attempted to
+ release a name that is currently not
+ registered on the
+ bus.
+
+
+
+ -EADDRINUSE
+
+ It was attempted to
+ release a name that is owned by a
+ different peer on the
+ bus.
+
+
-EINVAL
@@ -184,7 +199,7 @@
The bus connection has
been created in a different process
- than the current.
+ than the current one.
@@ -193,10 +208,10 @@
Notes
The sd_bus_acquire_name()
- and sd_bus_release_bame()
- interfaces are available as shared library, which can
+ and sd_bus_release_name()
+ interfaces are available as a shared library, which can
be compiled and linked to with the
- libsystemd-bus pkg-config1
+ libsystemd pkg-config1
file.