From: Zbigniew Jędrzejewski-Szmek Date: Wed, 22 Apr 2020 07:43:54 +0000 (+0200) Subject: Merge pull request #15519 from DaanDeMeyer/sd-bus-message-read-strv-docs X-Git-Tag: v246-rc1~536 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9df91db5e09a53cffd9df846c113108d0bd9726f;p=thirdparty%2Fsystemd.git Merge pull request #15519 from DaanDeMeyer/sd-bus-message-read-strv-docs --- 9df91db5e09a53cffd9df846c113108d0bd9726f diff --cc man/sd_bus_message_read_strv.xml index 00000000000,73748438323..a86bbe45d89 mode 000000,100644..100644 --- a/man/sd_bus_message_read_strv.xml +++ b/man/sd_bus_message_read_strv.xml @@@ -1,0 -1,90 +1,90 @@@ + + + + + + + + sd_bus_message_read_strv + systemd + + + + sd_bus_message_read_strv + 3 + + + + sd_bus_message_read_strv + + Access an array of strings in a message + + + + + #include <systemd/sd-bus.h> + + + int sd_bus_message_read_strv + sd_bus_message *m + char ***l + + + + + + Description + + sd_bus_message_read_strv() gives access to an array of strings in message + m. The "read pointer" in the message must be right before an array of strings. On - success, A pointer to the NULL-terminated array of strings is returned in the output ++ success, a pointer to the NULL-terminated array of strings is returned in the output + parameter l. Note that ownership of this array is transferred to the caller. + Hence, the caller is responsible for freeing this array and its contents. + + + + Return Value + + On success, sd_bus_message_read_strv() returns a non-negative integer. On + failure, it returns a negative errno-style error code. + + + Errors + + Returned errors may indicate the following problems: + + + + -EINVAL + + m or l are NULL. + + + + + -EPERM + + The message is not sealed. + + + + -EBADMSG + + The message cannot be parsed. + + + + + + + See Also + + + systemd1, + sd-bus3, + sd_bus_message_read3 + + + +