X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_message_append_basic.xml;h=90abca8092f463d7e96f4ff534385cf1767de3e0;hb=d04b238170998e0cbcc86db0f8ae66c3ee4a14d6;hp=344b7791faaaad9a87881e3c3082bf663603512a;hpb=b975b0d514321f169b3c4599a8ea92e13741b4e4;p=elogind.git
diff --git a/man/sd_bus_message_append_basic.xml b/man/sd_bus_message_append_basic.xml
index 344b7791f..90abca809 100644
--- a/man/sd_bus_message_append_basic.xml
+++ b/man/sd_bus_message_append_basic.xml
@@ -21,7 +21,7 @@
along with systemd; If not, see .
-->
-
+
sd_bus_message_append_basic
@@ -45,7 +45,7 @@
sd_bus_message_append_basic
- Attach a single part to a message
+ Attach a single field to a message
@@ -56,7 +56,7 @@
int sd_bus_message_append_basic
sd_bus_message *m
char type
- char void *p
+ const void *p
@@ -64,31 +64,33 @@
Description
- sd_bus_message_append_basic appends a
- single item to the message m. Parameter
- type determines how pointer
+ sd_bus_message_append_basic() appends a
+ single field to the message m. The
+ parameter type determines how the pointer
p is interpreted.
- type must be one of the basic types
- as defined by the
-
- Basic Types
- section of the D-Bus specification, and listed in the table below.
+ type must be one of the basic types as
+ defined by the Basic
+ Types section of the D-Bus specification, and listed in
+ the table below.
- The value of the parameter is copied into the memory area
- containing the message and may be changed after this call. If
- type is h (UNIX file
- descriptor), it is always "consumed" by this call, and either
- successfully appended to the message or closed.
+ The value of the parameter is copied into a memory area held
+ by the message object, stays in the possession of the caller and
+ may hence be freely changed after this call without affecting the
+ bus message it has been added to. If type
+ is h (UNIX file descriptor), the descriptor is
+ duplicated by this call and the passed descriptor stays in
+ possession of the caller.
For types s, o, and
g, the parameter p is
@@ -260,7 +277,7 @@
The sd_bus_append_basic() function
described here is available as a shared library, which can be
compiled and linked to with the
- libsystemd pkg-config1
+ libelogind pkg-config1
file.