diff --git a/man/sd_bus_message_append_string_memfd.xml b/man/sd_bus_message_append_string_memfd.xml index 750a2eedca..3d18979556 100644 --- a/man/sd_bus_message_append_string_memfd.xml +++ b/man/sd_bus_message_append_string_memfd.xml @@ -32,6 +32,8 @@ int sd_bus_message_append_string_memfd sd_bus_message *m int memfd + uint64_t offset + uint64_t size @@ -45,7 +47,7 @@ int sd_bus_message_append_string_space sd_bus_message *m size_t size - char **s + char **ret @@ -59,11 +61,17 @@ used to append a single string (item of type s) to message m. - In case of - sd_bus_message_append_string_memfd(), the - contents of memfd are the string. They must - satisfy the same constraints as described for the - s type in + In case of sd_bus_message_append_string_memfd(), the contents of + memfd starting at the specified offset and of the specified + size are used as the string. size must include the + terminating NUL byte, i.e. the resulting string has length + size - 1. If offset is zero and size + is UINT64_MAX, the full contents of the memory file descriptor are used, and hence + must themselves end in a NUL byte. If offset plus + size exceeds the actual size of the memory file descriptor, this call fails with + -EMSGSIZE. The memory file descriptor is sealed by this call if it has not been + sealed yet, and cannot be modified after this call. The appended contents must satisfy the same + constraints as described for the s type in sd_bus_message_append_basic3. In case of @@ -89,7 +97,7 @@ similar to sd_bus_message_append_basic() with type s, but instead of copying a string into the message, it returns a pointer to the destination area to - the caller in pointer p. Space for the string + the caller in pointer ret. Space for the string of length size plus the terminating NUL is allocated.