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 u 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.

  .SH "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 The sd_bus_append_append_strv() function described here is available as a shared library, which can be compiled and linked to with the libsystemd pkg-config(1) file.

                      .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
    http://dbus.freedesktop.org/doc/dbus-specification.html