1SD_BUS_MESSAGE_APPEND_STRV(s3d)_bus_message_append_stSrDv_BUS_MESSAGE_APPEND_STRV(3)
2
3
4
6 sd_bus_message_append_strv - Attach an array of strings to a message
7
9 #include <systemd/sd-bus.h>
10
11 int sd_bus_message_append_strv(sd_bus_message *m, char **l);
12
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
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
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
60 systemd(1), sd-bus(3), sd_bus_message_append(3),
61 sd_bus_message_append_array(3), The D-Bus specification[1]
62
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)