X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_request_name.xml;h=ca082183cca7e4f3719dd873bdcf4c002452d5e5;hb=38ce47e262fbb76b6f6514e8e80cacfc584bee5a;hp=039b9627e3ac00aa3b778c251ae0154ac76ad755;hpb=b408e2a8be6b87fd1796c45a767d00bbb00d7148;p=elogind.git
diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml
index 039b9627e..ca082183c 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,10 +95,10 @@
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.
@@ -108,8 +106,8 @@
SD_BUS_NAME_QUEUE
- Queue name
- acquisition when the name is already
+ Queue the acquisition
+ of the name when the name is already
taken.
@@ -127,10 +125,10 @@
errno-style error code.
If SD_BUS_NAME_QUEUE is
- specified sd_bus_request_name()
+ 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
+ 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()
@@ -145,7 +143,7 @@
- -EALREADY
+ -EALREADY
The caller already is
the owner of the specified
@@ -153,7 +151,7 @@
- -EEXIST
+ -EEXIST
The name has already
been acquired by a different peer, and
@@ -165,25 +163,43 @@
- -EINVAL
+ -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
A specified parameter
is invalid.
- -ENOTCONN
+ -ENOTCONN
The bus connection has
been disconnected.
- -ECHILD
+ -ECHILD
The bus connection has
been created in a different process
- than the current.
+ than the current one.
@@ -192,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.