X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsd_bus_message_append_array.xml;h=746f9e3cc855576af0b8820ff298355166a6689d;hb=5686391b006ee82d8a4559067ad9818e3e631247;hp=034466bf9c1f4694d3ccaf2da29d8240771ad421;hpb=ca970016b7e5176e94eee3af24a70d5b3355018f;p=thirdparty%2Fsystemd.git diff --git a/man/sd_bus_message_append_array.xml b/man/sd_bus_message_append_array.xml index 034466bf9c1..746f9e3cc85 100644 --- a/man/sd_bus_message_append_array.xml +++ b/man/sd_bus_message_append_array.xml @@ -1,24 +1,9 @@ - + sd_bus_message_append_array systemd - - - - A monkey with a typewriter - Zbigniew - Jędrzejewski-Szmek - zbyszek@in.waw.pl - - @@ -49,7 +25,7 @@ sd_bus_message_append_array_iovec sd_bus_message_append_array_space - Appaned an array of fields to a D-Bus + Append an array of fields to a D-Bus message @@ -125,14 +101,14 @@ m, similar to sd_bus_message_append_array(). The contents of the memory file descriptor memfd - starting at the specified offset and and of the specified size is + starting at the specified offset and of the specified size is used as the contents of the array. The offset and size must be a multiple of the size of the type type. However, as a special exception, if the offset is specified as zero and the size specified as UINT64_MAX the full memory file descriptor contents is used. The - memory file descriptor is sealed by this call if it hasn't been - sealed yet, and cannot be modified a after this call. See + memory file descriptor is sealed by this call if it has not been + sealed yet, and cannot be modified after this call. See memfd_create2 for details about memory file descriptors. Appending arrays with @@ -142,7 +118,7 @@ process. Not all protocol transports support passing memory file descriptors between participants, in which case this call will automatically fall back to copying. Also, as memory file - descriptor passing is inefficient for smaller amounts of data + descriptor passing is inefficient for smaller amounts of data, copying might still be enforced even where memory file descriptor passing is supported. @@ -150,13 +126,13 @@ function appends an array of a trivial type to the message m, similar to sd_bus_message_append_array(). Contents of - the IO vector array iov are used as the + the I/O vector array iov are used as the contents of the array. The total size of iov payload (the sum of iov_len fields) must be a multiple of the size of the type type. The iov argument must point to - n IO vector structures. Each structure may + n I/O vector structures. Each structure may have the iov_base field set, in which case the memory pointed to will be copied into the message, or unset (set to zero), in which case a block of zeros of length @@ -171,9 +147,9 @@ copying items to the message, it returns a pointer to the destination area to the caller in pointer p. The caller should subsequently write the - array contents to this memory. Modifications of the memory + array contents to this memory. Modifications to the memory pointed to should only occur until the next operation on the bus - message is invoked, most imporantly the memory should not be + message is invoked. Most importantly, the memory should not be altered anymore when another field has been added to the message or the message has been sealed. @@ -182,20 +158,12 @@ Return Value On success, these calls return 0 or a positive integer. On - failure, they returns a negative errno-style error code. + failure, they return a negative errno-style error code. - - Notes - - sd_bus_append_array() and other - functions described here are available as a shared library, which - can be compiled and linked to with the - libsystemd pkg-config1 - file. - + See Also