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
30   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       Functions described here are available as a shared library, which can
50       be compiled against and linked to with the libsystemd pkg-config(1)
51       file.
52
53       The code described here uses getenv(3), which is declared to be not
54       multi-thread-safe. This means that the code calling the functions
55       described here must not call setenv(3) from a parallel thread. It is
56       recommended to only do calls to setenv() from an early phase of the
57       program when no other threads have been started.
58

SEE ALSO

60       systemd(1), sd-bus(3), sd_bus_message_append(3),
61       sd_bus_message_append_array(3), The D-Bus specification[1]
62

NOTES

64        1. The D-Bus specification
65           https://dbus.freedesktop.org/doc/dbus-specification.html
66
67
68
69systemd 254                                      SD_BUS_MESSAGE_APPEND_STRV(3)
Impressum