summaryrefslogtreecommitdiff
path: root/man/sd_bus_message_append.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2020-08-28 21:18:14 +0200
committerDaan De Meyer <daan.j.demeyer@gmail.com>2020-08-30 18:09:39 +0100
commite2b40db616b4e723036f72a726e2f2f31d35ffe1 (patch)
tree8b57d9179f15a67622b5fec14476127d129de6a4 /man/sd_bus_message_append.xml
parenta667ddf1327f55a5af5abef006b60fc42e998beb (diff)
downloadsystemd-e2b40db616b4e723036f72a726e2f2f31d35ffe1.tar.gz
man: document fd ownership for sd-bus fd marshalling
Fixes: #8003
Diffstat (limited to 'man/sd_bus_message_append.xml')
-rw-r--r--man/sd_bus_message_append.xml6
1 files changed, 4 insertions, 2 deletions
diff --git a/man/sd_bus_message_append.xml b/man/sd_bus_message_append.xml
index 5faadd603a..7f9235954f 100644
--- a/man/sd_bus_message_append.xml
+++ b/man/sd_bus_message_append.xml
@@ -146,8 +146,10 @@
</tgroup>
</table>
- <para>For types "s" and "g" (unicode string or signature), the pointer may be
- <constant>NULL</constant>, which is equivalent to an empty string. See
+ <para>For types <literal>s</literal> and <literal>g</literal> (unicode string or signature), the pointer
+ may be <constant>NULL</constant>, which is equivalent to an empty string. For <literal>h</literal> (UNIX
+ file descriptor), the descriptor is duplicated by this call and the passed descriptor stays in possession
+ of the caller. See
<citerefentry><refentrytitle>sd_bus_message_append_basic</refentrytitle><manvolnum>3</manvolnum></citerefentry>
for the precise interpretation of those and other types.</para>
</refsect1>