sd_bus_message_append_strv(3)

1SD_BUS_MESSAGE_APPEND_STRV(s3d)_bus_message_append_stSrDv_BUS_MESSAGE_APPEND_STRV(3)
2
3
4

NAME

6       sd_bus_message_append_strv - Attach an array of strings to a message
7

SYNOPSIS

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

DESCRIPTION

14       The sd_bus_message_append function can be used to append an array of
15       strings to message m. The parameter l shall point to a NULL-terminated
16       array of pointers to NUL-terminated strings. Each string must satisfy
17       the same constraints as described for the "s" type in
18       sd_bus_message_append_basic(3).
19
20       The memory pointed at by p and the contents of the strings themselves
21       are copied into the memory area containing the message and may be
22       changed after this call. Note that the signature of l parameter is to
23       be treated as const char *const *, and the contents will not be
24       modified.
25

RETURN VALUE

27       On success, this call returns 0 or a positive integer. On failure, a
28       negative errno-style error code is returned.
29

ERRORS

31       Returned errors may indicate the following problems:
32
33       -EINVAL
34           Specified parameter is invalid.
35
36       -EPERM
37           Message has been sealed.
38
39       -ESTALE
40           Message is in invalid state.
41
42       -ENXIO
43           Message cannot be appended to.
44
45       -ENOMEM
46           Memory allocation failed.
47

NOTES

49       These APIs are implemented as a shared library, which can be compiled
50       and linked to with the libsystemd pkg-config(1) file.
51

NOTES

57        1. The D-Bus specification
58           http://dbus.freedesktop.org/doc/dbus-specification.html
59
60
61
62systemd 239                                      SD_BUS_MESSAGE_APPEND_STRV(3)