| SD_BUS_MESSAGE_APPEND_STRV(3) | sd_bus_message_append_strv | SD_BUS_MESSAGE_APPEND_STRV(3) |
.SH "NAME" sd_bus_message_append_strv - Attach an array of strings
to a message
.SH "SYNOPSIS"
#include <systemd/sd-bus.h>
.HP 744u int
sd_bus_message_append_strv(sd_bus_message *m,
char **l);
.SH "DESCRIPTION"
.PP The sd_bus_message_append() function can be used to append an
array of strings to message m. The parameter l shall point to
a NULL-terminated array of pointers to NUL-terminated strings.
Each string must satisfy the same constraints as described for the s type in
sd_bus_message_append_basic(3).
.PP The memory pointed at by p and the contents of the strings
themselves are copied into the memory area containing the message and may be
changed after this call. Note that the signature of l parameter is to
be treated as const char *const *, and the contents
will not be modified.
.SH "RETURN VALUE"
.PP On success, this call returns 0 or a positive integer. On failure, a
negative errno-style error code is returned.
.SS "Errors"
.PP Returned errors may indicate the following problems:
.PP -EINVAL
Specified parameter is invalid.
.RE
.PP -EPERM
Message has been sealed.
.RE
.PP -ESTALE
Message is in invalid state.
.RE
.PP -ENXIO
Message cannot be appended to.
.RE
.PP -ENOMEM
Memory allocation failed.
.RE
.SH "NOTES"
.PP Functions described here are available as a shared library, which can be
compiled against and linked to with the
libsystemd pkg-config(1) file.
.PP All functions listed here are thread-agnostic and only a single thread
may operate on a given object at any given time. Different threads may
access the same object at different times. Multiple independent objects may
be used from different threads in parallel.
.PP The code described here uses getenv(3), which is declared to be
not multi-thread-safe. This means that the code calling the functions
described here must not call setenv(3) from a parallel thread. It is
recommended to only do calls to setenv() from an early phase of the
program when no other threads have been started.
.SH "SEE ALSO"
.PP systemd(1), sd-bus(3), sd_bus_message_append(3),
sd_bus_message_append_array(3), The D-Bus specification[1]
NOTES
- 1.
- The D-Bus specification
| systemd 262.2 |