1SD_BUS_MESSAGE_READ_STRV(3)sd_bus_message_read_strvSD_BUS_MESSAGE_READ_STRV(3)
2
3
4

NAME

6       sd_bus_message_read_strv - Access an array of strings in a message
7

SYNOPSIS

9       #include <systemd/sd-bus.h>
10
11       int sd_bus_message_read_strv(sd_bus_message *m, char ***l);
12

DESCRIPTION

14       sd_bus_message_read_strv() gives access to an array of strings in
15       message m. The "read pointer" in the message must be right before an
16       array of strings. On success, a pointer to the NULL-terminated array of
17       strings is returned in the output parameter l. Note that ownership of
18       this array is transferred to the caller. Hence, the caller is
19       responsible for freeing this array and its contents.
20

RETURN VALUE

22       On success, sd_bus_message_read_strv() returns a non-negative integer.
23       On failure, it returns a negative errno-style error code.
24
25   Errors
26       Returned errors may indicate the following problems:
27
28       -EINVAL
29           m or l are NULL.
30
31       -EPERM
32           The message is not sealed.
33
34       -EBADMSG
35           The message cannot be parsed.
36

SEE ALSO

38       systemd(1), sd-bus(3), sd_bus_message_read(3)
39
40
41
42systemd 246                                        SD_BUS_MESSAGE_READ_STRV(3)
Impressum