1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2013 Lennart Poettering
8 systemd is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published by
10 the Free Software Foundation; either version 2.1 of the License, or
11 (at your option) any later version.
13 systemd is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with systemd; If not, see <http://www.gnu.org/licenses/>.
29 #include "time-util.h"
30 #include "cgroup-util.h"
33 #include "bus-message.h"
34 #include "bus-internal.h"
36 #include "bus-signature.h"
37 #include "bus-gvariant.h"
39 static int message_append_basic(sd_bus_message *m, char type, const void *p, const void **stored);
41 static void *adjust_pointer(const void *p, void *old_base, size_t sz, void *new_base) {
46 if (old_base == new_base)
49 if ((uint8_t*) p < (uint8_t*) old_base)
52 if ((uint8_t*) p >= (uint8_t*) old_base + sz)
55 return (uint8_t*) new_base + ((uint8_t*) p - (uint8_t*) old_base);
58 static void message_free_part(sd_bus_message *m, struct bus_body_part *part) {
62 if (part->memfd >= 0) {
63 /* If we can reuse the memfd, try that. For that it
64 * can't be sealed yet. */
67 bus_kernel_push_memfd(m->bus, part->memfd, part->data, part->mapped);
70 assert_se(munmap(part->data, part->mapped) == 0);
72 close_nointr_nofail(part->memfd);
75 } else if (part->munmap_this)
76 munmap(part->data, part->mapped);
77 else if (part->free_this)
84 static void message_reset_parts(sd_bus_message *m) {
85 struct bus_body_part *part;
90 while (m->n_body_parts > 0) {
91 struct bus_body_part *next = part->next;
92 message_free_part(m, part);
99 m->cached_rindex_part = NULL;
100 m->cached_rindex_part_begin = 0;
103 static void message_reset_containers(sd_bus_message *m) {
108 for (i = 0; i < m->n_containers; i++) {
109 free(m->containers[i].signature);
110 free(m->containers[i].offsets);
114 m->containers = NULL;
117 m->root_container.index = 0;
120 static void message_free(sd_bus_message *m) {
126 message_reset_parts(m);
131 if (m->release_kdbus) {
134 off = (uint8_t *)m->kdbus - (uint8_t *)m->bus->kdbus_buffer;
135 ioctl(m->bus->input_fd, KDBUS_CMD_FREE, &off);
139 sd_bus_unref(m->bus);
142 close_many(m->fds, m->n_fds);
146 if (m->iovec != m->iovec_fixed)
149 message_reset_containers(m);
150 free(m->root_container.signature);
151 free(m->root_container.offsets);
153 free(m->peeked_signature);
155 bus_creds_done(&m->creds);
159 static void *message_extend_fields(sd_bus_message *m, size_t align, size_t sz, bool add_offset) {
161 size_t old_size, new_size, start;
168 old_size = sizeof(struct bus_header) + m->header->fields_size;
169 start = ALIGN_TO(old_size, align);
170 new_size = start + sz;
172 if (old_size == new_size)
173 return (uint8_t*) m->header + old_size;
175 if (new_size > (size_t) ((uint32_t) -1))
178 if (m->free_header) {
179 np = realloc(m->header, ALIGN8(new_size));
183 /* Initially, the header is allocated as part of of
184 * the sd_bus_message itself, let's replace it by
187 np = malloc(ALIGN8(new_size));
191 memcpy(np, m->header, sizeof(struct bus_header));
194 /* Zero out padding */
195 if (start > old_size)
196 memset((uint8_t*) np + old_size, 0, start - old_size);
200 m->header->fields_size = new_size - sizeof(struct bus_header);
202 /* Adjust quick access pointers */
203 m->path = adjust_pointer(m->path, op, old_size, m->header);
204 m->interface = adjust_pointer(m->interface, op, old_size, m->header);
205 m->member = adjust_pointer(m->member, op, old_size, m->header);
206 m->destination = adjust_pointer(m->destination, op, old_size, m->header);
207 m->sender = adjust_pointer(m->sender, op, old_size, m->header);
208 m->error.name = adjust_pointer(m->error.name, op, old_size, m->header);
210 m->free_header = true;
213 if (m->n_header_offsets >= ELEMENTSOF(m->header_offsets))
216 m->header_offsets[m->n_header_offsets++] = new_size - sizeof(struct bus_header);
219 return (uint8_t*) np + start;
226 static int message_append_field_string(
238 /* dbus1 doesn't allow strings over 32bit, let's enforce this
239 * globally, to not risk convertability */
241 if (l > (size_t) (uint32_t) -1)
244 /* Signature "(yv)" where the variant contains "s" */
246 if (BUS_MESSAGE_IS_GVARIANT(m)) {
248 /* (field id byte + 7x padding, ((string + NUL) + NUL + signature string 's') */
249 p = message_extend_fields(m, 8, 1 + 7 + l + 1 + 1 + 1, true);
261 *ret = (char*) p + 8;
264 /* (field id byte + (signature length + signature 's' + NUL) + (string length + string + NUL)) */
265 p = message_extend_fields(m, 8, 4 + 4 + l + 1, false);
274 ((uint32_t*) p)[1] = l;
275 memcpy(p + 8, s, l + 1);
278 *ret = (char*) p + 8;
284 static int message_append_field_signature(
295 /* dbus1 doesn't allow signatures over 32bit, let's enforce
296 * this globally, to not risk convertability */
301 /* Signature "(yv)" where the variant contains "g" */
303 if (BUS_MESSAGE_IS_GVARIANT(m))
304 /* For gvariant the serialization is the same as for normal strings */
305 return message_append_field_string(m, h, 'g', s, ret);
307 /* (field id byte + (signature length + signature 'g' + NUL) + (string length + string + NUL)) */
308 p = message_extend_fields(m, 8, 4 + 1 + l + 1, false);
314 p[2] = SD_BUS_TYPE_SIGNATURE;
317 memcpy(p + 5, s, l + 1);
320 *ret = (const char*) p + 5;
326 static int message_append_field_uint32(sd_bus_message *m, uint8_t h, uint32_t x) {
331 if (BUS_MESSAGE_IS_GVARIANT(m)) {
332 /* (field id byte + 7x padding + ((value + NUL + signature string 'u') */
334 p = message_extend_fields(m, 8, 1 + 7 + 4 + 1 + 1, true);
340 *((uint32_t*) (p + 8)) = x;
344 /* (field id byte + (signature length + signature 'u' + NUL) + value) */
345 p = message_extend_fields(m, 8, 4 + 4, false);
351 p[2] = SD_BUS_TYPE_UINT32;
354 ((uint32_t*) p)[1] = x;
360 int bus_message_from_header(
366 const struct ucred *ucred,
369 sd_bus_message **ret) {
372 struct bus_header *h;
375 assert(buffer || length <= 0);
376 assert(fds || n_fds <= 0);
379 if (length < sizeof(struct bus_header))
383 if (h->version != 1 &&
390 if (h->type == _SD_BUS_MESSAGE_TYPE_INVALID)
393 if (h->endian != BUS_LITTLE_ENDIAN &&
394 h->endian != BUS_BIG_ENDIAN)
397 a = ALIGN(sizeof(sd_bus_message)) + ALIGN(extra);
400 label_sz = strlen(label);
415 m->creds.uid = ucred->uid;
416 m->creds.pid = ucred->pid;
417 m->creds.gid = ucred->gid;
418 m->creds.mask |= SD_BUS_CREDS_UID | SD_BUS_CREDS_PID | SD_BUS_CREDS_GID;
422 m->creds.label = (char*) m + ALIGN(sizeof(sd_bus_message)) + ALIGN(extra);
423 memcpy(m->creds.label, label, label_sz + 1);
425 m->creds.mask |= SD_BUS_CREDS_SELINUX_CONTEXT;
429 m->bus = sd_bus_ref(bus);
435 int bus_message_from_malloc(
441 const struct ucred *ucred,
443 sd_bus_message **ret) {
449 r = bus_message_from_header(bus, buffer, length, fds, n_fds, ucred, label, 0, &m);
453 if (length != BUS_MESSAGE_SIZE(m)) {
458 sz = length - sizeof(struct bus_header) - ALIGN8(BUS_MESSAGE_FIELDS_SIZE(m));
461 m->body.data = (uint8_t*) buffer + sizeof(struct bus_header) + ALIGN8(BUS_MESSAGE_FIELDS_SIZE(m));
463 m->body.sealed = true;
468 m->iovec = m->iovec_fixed;
469 m->iovec[0].iov_base = buffer;
470 m->iovec[0].iov_len = length;
472 r = bus_message_parse_fields(m);
476 /* We take possession of the memory and fds now */
477 m->free_header = true;
488 static sd_bus_message *message_new(sd_bus *bus, uint8_t type) {
491 m = malloc0(ALIGN(sizeof(sd_bus_message)) + sizeof(struct bus_header));
496 m->header = (struct bus_header*) ((uint8_t*) m + ALIGN(sizeof(struct sd_bus_message)));
497 m->header->endian = BUS_NATIVE_ENDIAN;
498 m->header->type = type;
499 m->header->version = bus ? bus->message_version : 1;
500 m->allow_fds = !bus || bus->can_fds || (bus->state != BUS_HELLO && bus->state != BUS_RUNNING);
501 m->root_container.need_offsets = BUS_MESSAGE_IS_GVARIANT(m);
504 m->bus = sd_bus_ref(bus);
509 _public_ int sd_bus_message_new_signal(
512 const char *interface,
514 sd_bus_message **m) {
519 assert_return(!bus || bus->state != BUS_UNSET, -ENOTCONN);
520 assert_return(object_path_is_valid(path), -EINVAL);
521 assert_return(interface_name_is_valid(interface), -EINVAL);
522 assert_return(member_name_is_valid(member), -EINVAL);
523 assert_return(m, -EINVAL);
525 t = message_new(bus, SD_BUS_MESSAGE_SIGNAL);
529 t->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
531 r = message_append_field_string(t, BUS_MESSAGE_HEADER_PATH, SD_BUS_TYPE_OBJECT_PATH, path, &t->path);
534 r = message_append_field_string(t, BUS_MESSAGE_HEADER_INTERFACE, SD_BUS_TYPE_STRING, interface, &t->interface);
537 r = message_append_field_string(t, BUS_MESSAGE_HEADER_MEMBER, SD_BUS_TYPE_STRING, member, &t->member);
545 sd_bus_message_unref(t);
549 _public_ int sd_bus_message_new_method_call(
551 const char *destination,
553 const char *interface,
555 sd_bus_message **m) {
560 assert_return(!bus || bus->state != BUS_UNSET, -ENOTCONN);
561 assert_return(!destination || service_name_is_valid(destination), -EINVAL);
562 assert_return(object_path_is_valid(path), -EINVAL);
563 assert_return(!interface || interface_name_is_valid(interface), -EINVAL);
564 assert_return(member_name_is_valid(member), -EINVAL);
565 assert_return(m, -EINVAL);
567 t = message_new(bus, SD_BUS_MESSAGE_METHOD_CALL);
571 r = message_append_field_string(t, BUS_MESSAGE_HEADER_PATH, SD_BUS_TYPE_OBJECT_PATH, path, &t->path);
574 r = message_append_field_string(t, BUS_MESSAGE_HEADER_MEMBER, SD_BUS_TYPE_STRING, member, &t->member);
579 r = message_append_field_string(t, BUS_MESSAGE_HEADER_INTERFACE, SD_BUS_TYPE_STRING, interface, &t->interface);
585 r = message_append_field_string(t, BUS_MESSAGE_HEADER_DESTINATION, SD_BUS_TYPE_STRING, destination, &t->destination);
598 static int message_new_reply(
599 sd_bus_message *call,
601 sd_bus_message **m) {
606 assert_return(call, -EINVAL);
607 assert_return(call->sealed, -EPERM);
608 assert_return(call->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL);
609 assert_return(!call->bus || call->bus->state != BUS_UNSET, -ENOTCONN);
610 assert_return(m, -EINVAL);
612 t = message_new(call->bus, type);
616 t->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
617 t->reply_serial = BUS_MESSAGE_SERIAL(call);
619 r = message_append_field_uint32(t, BUS_MESSAGE_HEADER_REPLY_SERIAL, t->reply_serial);
624 r = message_append_field_string(t, BUS_MESSAGE_HEADER_DESTINATION, SD_BUS_TYPE_STRING, call->sender, &t->destination);
629 t->dont_send = !!(call->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED);
630 t->enforced_reply_signature = call->enforced_reply_signature;
640 _public_ int sd_bus_message_new_method_return(
641 sd_bus_message *call,
642 sd_bus_message **m) {
644 return message_new_reply(call, SD_BUS_MESSAGE_METHOD_RETURN, m);
647 _public_ int sd_bus_message_new_method_error(
648 sd_bus_message *call,
649 const sd_bus_error *e,
650 sd_bus_message **m) {
655 assert_return(sd_bus_error_is_set(e), -EINVAL);
656 assert_return(m, -EINVAL);
658 r = message_new_reply(call, SD_BUS_MESSAGE_METHOD_ERROR, &t);
662 r = message_append_field_string(t, BUS_MESSAGE_HEADER_ERROR_NAME, SD_BUS_TYPE_STRING, e->name, &t->error.name);
667 r = message_append_basic(t, SD_BUS_TYPE_STRING, e->message, (const void**) &t->error.message);
672 t->error._need_free = -1;
682 _public_ int sd_bus_message_new_method_errorf(
683 sd_bus_message *call,
689 _cleanup_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
692 assert_return(name, -EINVAL);
693 assert_return(m, -EINVAL);
695 va_start(ap, format);
696 bus_error_setfv(&error, name, format, ap);
699 return sd_bus_message_new_method_error(call, &error, m);
702 _public_ int sd_bus_message_new_method_errno(
703 sd_bus_message *call,
705 const sd_bus_error *p,
706 sd_bus_message **m) {
708 _cleanup_free_ sd_bus_error berror = SD_BUS_ERROR_NULL;
710 if (sd_bus_error_is_set(p))
711 return sd_bus_message_new_method_error(call, p, m);
713 sd_bus_error_set_errno(&berror, error);
715 return sd_bus_message_new_method_error(call, &berror, m);
718 _public_ int sd_bus_message_new_method_errnof(
719 sd_bus_message *call,
725 _cleanup_free_ sd_bus_error berror = SD_BUS_ERROR_NULL;
728 va_start(ap, format);
729 bus_error_set_errnofv(&berror, error, format, ap);
732 return sd_bus_message_new_method_error(call, &berror, m);
735 int bus_message_new_synthetic_error(
738 const sd_bus_error *e,
739 sd_bus_message **m) {
744 assert(sd_bus_error_is_set(e));
747 t = message_new(bus, SD_BUS_MESSAGE_METHOD_ERROR);
751 t->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
752 t->reply_serial = serial;
754 r = message_append_field_uint32(t, BUS_MESSAGE_HEADER_REPLY_SERIAL, t->reply_serial);
758 if (bus && bus->unique_name) {
759 r = message_append_field_string(t, BUS_MESSAGE_HEADER_DESTINATION, SD_BUS_TYPE_STRING, bus->unique_name, &t->destination);
764 r = message_append_field_string(t, BUS_MESSAGE_HEADER_ERROR_NAME, SD_BUS_TYPE_STRING, e->name, &t->error.name);
769 r = message_append_basic(t, SD_BUS_TYPE_STRING, e->message, (const void**) &t->error.message);
774 t->error._need_free = -1;
784 _public_ sd_bus_message* sd_bus_message_ref(sd_bus_message *m) {
785 assert_return(m, NULL);
787 assert(m->n_ref > 0);
793 _public_ sd_bus_message* sd_bus_message_unref(sd_bus_message *m) {
794 assert_return(m, NULL);
796 assert(m->n_ref > 0);
805 _public_ int sd_bus_message_get_type(sd_bus_message *m, uint8_t *type) {
806 assert_return(m, -EINVAL);
807 assert_return(type, -EINVAL);
809 *type = m->header->type;
813 _public_ int sd_bus_message_get_serial(sd_bus_message *m, uint64_t *serial) {
814 assert_return(m, -EINVAL);
815 assert_return(serial, -EINVAL);
816 assert_return(m->header->serial != 0, -ENOENT);
818 *serial = BUS_MESSAGE_SERIAL(m);
822 _public_ int sd_bus_message_get_reply_serial(sd_bus_message *m, uint64_t *serial) {
823 assert_return(m, -EINVAL);
824 assert_return(serial, -EINVAL);
825 assert_return(m->reply_serial != 0, -ENOENT);
827 *serial = m->reply_serial;
831 _public_ int sd_bus_message_get_no_reply(sd_bus_message *m) {
832 assert_return(m, -EINVAL);
834 return m->header->type == SD_BUS_MESSAGE_METHOD_CALL ? !!(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED) : 0;
837 _public_ int sd_bus_message_get_no_auto_start(sd_bus_message *m) {
838 assert_return(m, -EINVAL);
840 return !!(m->header->flags & BUS_MESSAGE_NO_AUTO_START);
843 _public_ const char *sd_bus_message_get_path(sd_bus_message *m) {
844 assert_return(m, NULL);
849 _public_ const char *sd_bus_message_get_interface(sd_bus_message *m) {
850 assert_return(m, NULL);
855 _public_ const char *sd_bus_message_get_member(sd_bus_message *m) {
856 assert_return(m, NULL);
861 _public_ const char *sd_bus_message_get_destination(sd_bus_message *m) {
862 assert_return(m, NULL);
864 return m->destination;
867 _public_ const char *sd_bus_message_get_sender(sd_bus_message *m) {
868 assert_return(m, NULL);
873 _public_ const sd_bus_error *sd_bus_message_get_error(sd_bus_message *m) {
874 assert_return(m, NULL);
875 assert_return(sd_bus_error_is_set(&m->error), NULL);
880 _public_ int sd_bus_message_get_monotonic_timestamp(sd_bus_message *m, uint64_t *usec) {
881 assert_return(m, -EINVAL);
882 assert_return(usec, -EINVAL);
883 assert_return(m->monotonic > 0, -ENODATA);
885 *usec = m->monotonic;
889 _public_ int sd_bus_message_get_realtime_timestamp(sd_bus_message *m, uint64_t *usec) {
890 assert_return(m, -EINVAL);
891 assert_return(usec, -EINVAL);
892 assert_return(m->realtime > 0, -ENODATA);
898 _public_ sd_bus_creds *sd_bus_message_get_creds(sd_bus_message *m) {
899 assert_return(m, NULL);
901 if (m->creds.mask == 0)
907 _public_ int sd_bus_message_is_signal(sd_bus_message *m,
908 const char *interface,
909 const char *member) {
910 assert_return(m, -EINVAL);
912 if (m->header->type != SD_BUS_MESSAGE_SIGNAL)
915 if (interface && (!m->interface || !streq(m->interface, interface)))
918 if (member && (!m->member || !streq(m->member, member)))
924 _public_ int sd_bus_message_is_method_call(sd_bus_message *m,
925 const char *interface,
926 const char *member) {
927 assert_return(m, -EINVAL);
929 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
932 if (interface && (!m->interface || !streq(m->interface, interface)))
935 if (member && (!m->member || !streq(m->member, member)))
941 _public_ int sd_bus_message_is_method_error(sd_bus_message *m, const char *name) {
942 assert_return(m, -EINVAL);
944 if (m->header->type != SD_BUS_MESSAGE_METHOD_ERROR)
947 if (name && (!m->error.name || !streq(m->error.name, name)))
953 _public_ int sd_bus_message_set_no_reply(sd_bus_message *m, int b) {
954 assert_return(m, -EINVAL);
955 assert_return(!m->sealed, -EPERM);
956 assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EPERM);
959 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
961 m->header->flags &= ~BUS_MESSAGE_NO_REPLY_EXPECTED;
966 _public_ int sd_bus_message_set_no_auto_start(sd_bus_message *m, int b) {
967 assert_return(m, -EINVAL);
968 assert_return(!m->sealed, -EPERM);
971 m->header->flags |= BUS_MESSAGE_NO_AUTO_START;
973 m->header->flags &= ~BUS_MESSAGE_NO_AUTO_START;
978 static struct bus_container *message_get_container(sd_bus_message *m) {
981 if (m->n_containers == 0)
982 return &m->root_container;
984 assert(m->containers);
985 return m->containers + m->n_containers - 1;
988 struct bus_body_part *message_append_part(sd_bus_message *m) {
989 struct bus_body_part *part;
996 if (m->n_body_parts <= 0) {
1000 assert(m->body_end);
1002 part = new0(struct bus_body_part, 1);
1008 m->body_end->next = part;
1018 static void part_zero(struct bus_body_part *part, size_t sz) {
1023 /* All other fields can be left in their defaults */
1024 assert(!part->data);
1025 assert(part->memfd < 0);
1028 part->is_zero = true;
1029 part->sealed = true;
1032 static int part_make_space(
1033 struct sd_bus_message *m,
1034 struct bus_body_part *part,
1043 assert(!part->sealed);
1048 if (!part->data && part->memfd < 0)
1049 part->memfd = bus_kernel_pop_memfd(m->bus, &part->data, &part->mapped);
1051 if (part->memfd >= 0) {
1054 r = ioctl(part->memfd, KDBUS_CMD_MEMFD_SIZE_SET, &u);
1060 if (!part->data || sz > part->mapped) {
1061 size_t psz = PAGE_ALIGN(sz > 0 ? sz : 1);
1063 if (part->mapped <= 0)
1064 n = mmap(NULL, psz, PROT_READ|PROT_WRITE, MAP_SHARED, part->memfd, 0);
1066 n = mremap(part->data, part->mapped, psz, MREMAP_MAYMOVE);
1068 if (n == MAP_FAILED) {
1077 part->munmap_this = true;
1079 n = realloc(part->data, MAX(sz, 1u));
1086 part->free_this = true;
1090 *q = part->data ? (uint8_t*) part->data + part->size : NULL;
1096 static int message_add_offset(sd_bus_message *m, size_t offset) {
1097 struct bus_container *c;
1100 assert(BUS_MESSAGE_IS_GVARIANT(m));
1102 /* Add offset to current container, unless this is the first
1103 * item in it, which will have the 0 offset, which we can
1105 c = message_get_container(m);
1107 if (!c->need_offsets)
1110 if (!GREEDY_REALLOC(c->offsets, c->n_offsets_allocated, c->n_offsets + 1))
1113 c->offsets[c->n_offsets++] = offset;
1117 static void message_extend_containers(sd_bus_message *m, size_t expand) {
1118 struct bus_container *c;
1125 /* Update counters */
1126 for (c = m->containers; c < m->containers + m->n_containers; c++) {
1129 *c->array_size += expand;
1133 static void *message_extend_body(sd_bus_message *m, size_t align, size_t sz, bool add_offset) {
1134 size_t start_body, end_body, padding, added;
1145 start_body = ALIGN_TO((size_t) m->header->body_size, align);
1146 end_body = start_body + sz;
1148 padding = start_body - m->header->body_size;
1149 added = padding + sz;
1151 /* Check for 32bit overflows */
1152 if (end_body > (size_t) ((uint32_t) -1)) {
1158 struct bus_body_part *part = NULL;
1162 m->n_body_parts <= 0 ||
1163 m->body_end->sealed ||
1164 padding != ALIGN_TO(m->body_end->size, align) - m->body_end->size;
1168 part = message_append_part(m);
1172 part_zero(part, padding);
1175 part = message_append_part(m);
1179 r = part_make_space(m, part, sz, &p);
1183 struct bus_container *c;
1185 size_t os, start_part, end_part;
1191 start_part = ALIGN_TO(part->size, align);
1192 end_part = start_part + sz;
1194 r = part_make_space(m, part, end_part, &p);
1199 memset(p, 0, padding);
1200 p = (uint8_t*) p + padding;
1203 /* Readjust pointers */
1204 for (c = m->containers; c < m->containers + m->n_containers; c++)
1205 c->array_size = adjust_pointer(c->array_size, op, os, part->data);
1207 m->error.message = (const char*) adjust_pointer(m->error.message, op, os, part->data);
1210 /* Return something that is not NULL and is aligned */
1211 p = (uint8_t *) NULL + align;
1213 m->header->body_size = end_body;
1214 message_extend_containers(m, added);
1217 r = message_add_offset(m, end_body);
1227 static int message_push_fd(sd_bus_message *m, int fd) {
1238 copy = fcntl(fd, F_DUPFD_CLOEXEC, 3);
1242 f = realloc(m->fds, sizeof(int) * (m->n_fds + 1));
1245 close_nointr_nofail(copy);
1250 m->fds[m->n_fds] = copy;
1256 int message_append_basic(sd_bus_message *m, char type, const void *p, const void **stored) {
1257 _cleanup_close_ int fd = -1;
1258 struct bus_container *c;
1262 assert_return(m, -EINVAL);
1263 assert_return(!m->sealed, -EPERM);
1264 assert_return(bus_type_is_basic(type), -EINVAL);
1265 assert_return(!m->poisoned, -ESTALE);
1267 c = message_get_container(m);
1269 if (c->signature && c->signature[c->index]) {
1270 /* Container signature is already set */
1272 if (c->signature[c->index] != type)
1277 /* Maybe we can append to the signature? But only if this is the top-level container*/
1278 if (c->enclosing != 0)
1281 e = strextend(&c->signature, CHAR_TO_STR(type), NULL);
1288 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1294 case SD_BUS_TYPE_SIGNATURE:
1295 case SD_BUS_TYPE_STRING:
1298 /* Fall through... */
1299 case SD_BUS_TYPE_OBJECT_PATH:
1307 case SD_BUS_TYPE_BOOLEAN:
1309 u8 = p && *(int*) p;
1315 case SD_BUS_TYPE_UNIX_FD:
1320 fd = message_push_fd(m, *(int*) p);
1331 align = bus_gvariant_get_alignment(CHAR_TO_STR(type));
1332 sz = bus_gvariant_get_size(CHAR_TO_STR(type));
1339 a = message_extend_body(m, align, sz, true);
1346 *stored = (const uint8_t*) a;
1353 case SD_BUS_TYPE_STRING:
1354 /* To make things easy we'll serialize a NULL string
1355 * into the empty string */
1358 /* Fall through... */
1359 case SD_BUS_TYPE_OBJECT_PATH:
1365 sz = 4 + strlen(p) + 1;
1368 case SD_BUS_TYPE_SIGNATURE:
1373 sz = 1 + strlen(p) + 1;
1376 case SD_BUS_TYPE_BOOLEAN:
1378 u32 = p && *(int*) p;
1384 case SD_BUS_TYPE_UNIX_FD:
1389 fd = message_push_fd(m, *(int*) p);
1400 align = bus_type_get_alignment(type);
1401 sz = bus_type_get_size(type);
1408 a = message_extend_body(m, align, sz, false);
1412 if (type == SD_BUS_TYPE_STRING || type == SD_BUS_TYPE_OBJECT_PATH) {
1413 *(uint32_t*) a = sz - 5;
1414 memcpy((uint8_t*) a + 4, p, sz - 4);
1417 *stored = (const uint8_t*) a + 4;
1419 } else if (type == SD_BUS_TYPE_SIGNATURE) {
1420 *(uint8_t*) a = sz - 1;
1421 memcpy((uint8_t*) a + 1, p, sz - 1);
1424 *stored = (const uint8_t*) a + 1;
1433 if (type == SD_BUS_TYPE_UNIX_FD)
1436 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1443 _public_ int sd_bus_message_append_basic(sd_bus_message *m, char type, const void *p) {
1444 return message_append_basic(m, type, p, NULL);
1447 _public_ int sd_bus_message_append_string_space(
1452 struct bus_container *c;
1455 assert_return(m, -EINVAL);
1456 assert_return(s, -EINVAL);
1457 assert_return(!m->sealed, -EPERM);
1458 assert_return(!m->poisoned, -ESTALE);
1460 c = message_get_container(m);
1462 if (c->signature && c->signature[c->index]) {
1463 /* Container signature is already set */
1465 if (c->signature[c->index] != SD_BUS_TYPE_STRING)
1470 /* Maybe we can append to the signature? But only if this is the top-level container*/
1471 if (c->enclosing != 0)
1474 e = strextend(&c->signature, CHAR_TO_STR(SD_BUS_TYPE_STRING), NULL);
1481 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1482 a = message_extend_body(m, 1, size + 1, true);
1488 a = message_extend_body(m, 4, 4 + size + 1, false);
1492 *(uint32_t*) a = size;
1498 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1504 _public_ int sd_bus_message_append_string_iovec(
1506 const struct iovec *iov,
1514 assert_return(m, -EINVAL);
1515 assert_return(!m->sealed, -EPERM);
1516 assert_return(iov || n == 0, -EINVAL);
1517 assert_return(!m->poisoned, -ESTALE);
1519 size = IOVEC_TOTAL_SIZE(iov, n);
1521 r = sd_bus_message_append_string_space(m, size, &p);
1525 for (i = 0; i < n; i++) {
1527 if (iov[i].iov_base)
1528 memcpy(p, iov[i].iov_base, iov[i].iov_len);
1530 memset(p, ' ', iov[i].iov_len);
1532 p += iov[i].iov_len;
1538 static int bus_message_open_array(
1540 struct bus_container *c,
1541 const char *contents,
1542 uint32_t **array_size,
1544 bool *need_offsets) {
1554 assert(need_offsets);
1556 if (!signature_is_single(contents, true))
1559 if (c->signature && c->signature[c->index]) {
1561 /* Verify the existing signature */
1563 if (c->signature[c->index] != SD_BUS_TYPE_ARRAY)
1566 if (!startswith(c->signature + c->index + 1, contents))
1569 nindex = c->index + 1 + strlen(contents);
1573 if (c->enclosing != 0)
1576 /* Extend the existing signature */
1578 e = strextend(&c->signature, CHAR_TO_STR(SD_BUS_TYPE_ARRAY), contents, NULL);
1584 nindex = e - c->signature;
1587 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1588 alignment = bus_gvariant_get_alignment(contents);
1592 /* Add alignment padding and add to offset list */
1593 if (!message_extend_body(m, alignment, 0, false))
1596 r = bus_gvariant_is_fixed_size(contents);
1600 *begin = m->header->body_size;
1601 *need_offsets = r == 0;
1605 struct bus_body_part *o;
1607 alignment = bus_type_get_alignment(contents[0]);
1611 a = message_extend_body(m, 4, 4, false);
1616 op = m->body_end->data;
1617 os = m->body_end->size;
1619 /* Add alignment between size and first element */
1620 if (!message_extend_body(m, alignment, 0, false))
1623 /* location of array size might have changed so let's readjust a */
1624 if (o == m->body_end)
1625 a = adjust_pointer(a, op, os, m->body_end->data);
1631 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1637 static int bus_message_open_variant(
1639 struct bus_container *c,
1640 const char *contents) {
1646 if (!signature_is_single(contents, false))
1649 if (*contents == SD_BUS_TYPE_DICT_ENTRY_BEGIN)
1652 if (c->signature && c->signature[c->index]) {
1654 if (c->signature[c->index] != SD_BUS_TYPE_VARIANT)
1660 if (c->enclosing != 0)
1663 e = strextend(&c->signature, CHAR_TO_STR(SD_BUS_TYPE_VARIANT), NULL);
1670 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1671 /* Variants are always aligned to 8 */
1673 if (!message_extend_body(m, 8, 0, false))
1680 l = strlen(contents);
1681 a = message_extend_body(m, 1, 1 + l + 1, false);
1686 memcpy((uint8_t*) a + 1, contents, l + 1);
1689 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1695 static int bus_message_open_struct(
1697 struct bus_container *c,
1698 const char *contents,
1700 bool *need_offsets) {
1709 assert(need_offsets);
1711 if (!signature_is_valid(contents, false))
1714 if (c->signature && c->signature[c->index]) {
1717 l = strlen(contents);
1719 if (c->signature[c->index] != SD_BUS_TYPE_STRUCT_BEGIN ||
1720 !startswith(c->signature + c->index + 1, contents) ||
1721 c->signature[c->index + 1 + l] != SD_BUS_TYPE_STRUCT_END)
1724 nindex = c->index + 1 + l + 1;
1728 if (c->enclosing != 0)
1731 e = strextend(&c->signature, CHAR_TO_STR(SD_BUS_TYPE_STRUCT_BEGIN), contents, CHAR_TO_STR(SD_BUS_TYPE_STRUCT_END), NULL);
1737 nindex = e - c->signature;
1740 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1743 alignment = bus_gvariant_get_alignment(contents);
1747 if (!message_extend_body(m, alignment, 0, false))
1750 r = bus_gvariant_is_fixed_size(contents);
1754 *begin = m->header->body_size;
1755 *need_offsets = r == 0;
1757 /* Align contents to 8 byte boundary */
1758 if (!message_extend_body(m, 8, 0, false))
1762 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1768 static int bus_message_open_dict_entry(
1770 struct bus_container *c,
1771 const char *contents,
1773 bool *need_offsets) {
1781 assert(need_offsets);
1783 if (!signature_is_pair(contents))
1786 if (c->enclosing != SD_BUS_TYPE_ARRAY)
1789 if (c->signature && c->signature[c->index]) {
1792 l = strlen(contents);
1794 if (c->signature[c->index] != SD_BUS_TYPE_DICT_ENTRY_BEGIN ||
1795 !startswith(c->signature + c->index + 1, contents) ||
1796 c->signature[c->index + 1 + l] != SD_BUS_TYPE_DICT_ENTRY_END)
1801 if (BUS_MESSAGE_IS_GVARIANT(m)) {
1804 alignment = bus_gvariant_get_alignment(contents);
1808 if (!message_extend_body(m, alignment, 0, false))
1811 r = bus_gvariant_is_fixed_size(contents);
1815 *begin = m->header->body_size;
1816 *need_offsets = r == 0;
1818 /* Align contents to 8 byte boundary */
1819 if (!message_extend_body(m, 8, 0, false))
1826 _public_ int sd_bus_message_open_container(
1829 const char *contents) {
1831 struct bus_container *c, *w;
1832 uint32_t *array_size = NULL;
1834 size_t before, begin;
1835 bool need_offsets = false;
1838 assert_return(m, -EINVAL);
1839 assert_return(!m->sealed, -EPERM);
1840 assert_return(contents, -EINVAL);
1841 assert_return(!m->poisoned, -ESTALE);
1843 /* Make sure we have space for one more container */
1844 w = realloc(m->containers, sizeof(struct bus_container) * (m->n_containers + 1));
1852 c = message_get_container(m);
1854 signature = strdup(contents);
1860 /* Save old index in the parent container, in case we have to
1861 * abort this container */
1862 c->saved_index = c->index;
1863 before = m->header->body_size;
1865 if (type == SD_BUS_TYPE_ARRAY)
1866 r = bus_message_open_array(m, c, contents, &array_size, &begin, &need_offsets);
1867 else if (type == SD_BUS_TYPE_VARIANT)
1868 r = bus_message_open_variant(m, c, contents);
1869 else if (type == SD_BUS_TYPE_STRUCT)
1870 r = bus_message_open_struct(m, c, contents, &begin, &need_offsets);
1871 else if (type == SD_BUS_TYPE_DICT_ENTRY)
1872 r = bus_message_open_dict_entry(m, c, contents, &begin, &need_offsets);
1881 /* OK, let's fill it in */
1882 w += m->n_containers++;
1883 w->enclosing = type;
1884 w->signature = signature;
1886 w->array_size = array_size;
1889 w->n_offsets = w->n_offsets_allocated = 0;
1891 w->need_offsets = need_offsets;
1896 static size_t determine_word_size(size_t sz, size_t extra) {
1897 if (sz <= 0 && extra == 0)
1899 else if (sz + extra <= 0xFF)
1901 else if (sz + extra*2 <= 0xFFFF)
1903 else if (sz + extra*4 <= 0xFFFFFFFF)
1909 static size_t read_word_le(void *p, size_t sz) {
1919 return *(uint8_t*) p;
1924 return le16toh(x.u16);
1926 return le32toh(x.u32);
1928 return le64toh(x.u64);
1930 assert_not_reached("unknown word width");
1933 static void write_word_le(void *p, size_t sz, size_t value) {
1941 assert(sz == 8 || (value < (1ULL << (sz*8))));
1944 *(uint8_t*) p = value;
1947 x.u16 = htole16((uint16_t) value);
1949 x.u32 = htole32((uint32_t) value);
1951 x.u64 = htole64((uint64_t) value);
1953 assert_not_reached("unknown word width");
1958 static int bus_message_close_array(sd_bus_message *m, struct bus_container *c) {
1963 if (!BUS_MESSAGE_IS_GVARIANT(m))
1966 if (c->need_offsets) {
1967 size_t payload, sz, i;
1970 /* Variable-width arrays */
1972 payload = c->n_offsets > 0 ? c->offsets[c->n_offsets-1] - c->begin : 0;
1973 sz = determine_word_size(payload, c->n_offsets);
1975 a = message_extend_body(m, 1, sz * c->n_offsets, true);
1979 for (i = 0; i < c->n_offsets; i++)
1980 write_word_le(a + sz*i, sz, c->offsets[i] - c->begin);
1984 /* Fixed-width or empty arrays */
1986 a = message_extend_body(m, 1, 0, true); /* let's add offset to parent */
1994 static int bus_message_close_variant(sd_bus_message *m, struct bus_container *c) {
2001 if (!BUS_MESSAGE_IS_GVARIANT(m))
2004 l = strlen(c->signature);
2006 a = message_extend_body(m, 1, 1 + l, true);
2011 memcpy(a+1, c->signature, l);
2016 static int bus_message_close_struct(sd_bus_message *m, struct bus_container *c, bool add_offset) {
2017 size_t n_variable = 0;
2026 if (!BUS_MESSAGE_IS_GVARIANT(m))
2033 r = signature_element_length(p, &n);
2042 r = bus_gvariant_is_fixed_size(t);
2047 assert(i <= c->n_offsets);
2049 /* We need to add an offset for each item that has a
2050 * variable size and that is not the last one in the
2052 if (r == 0 && p[n] != 0)
2059 assert(i == c->n_offsets);
2061 if (n_variable <= 0) {
2062 a = message_extend_body(m, 1, 0, add_offset);
2069 assert(c->offsets[c->n_offsets-1] == m->header->body_size);
2071 sz = determine_word_size(m->header->body_size - c->begin, n_variable);
2073 a = message_extend_body(m, 1, sz * n_variable, add_offset);
2078 for (i = 0, j = 0; i < c->n_offsets; i++) {
2082 r = signature_element_length(p, &n);
2093 r = bus_gvariant_is_fixed_size(t);
2096 if (r > 0 || p[0] == 0)
2100 k = n_variable - 1 - j;
2102 write_word_le(a + k * sz, sz, c->offsets[i] - c->begin);
2111 _public_ int sd_bus_message_close_container(sd_bus_message *m) {
2112 struct bus_container *c;
2115 assert_return(m, -EINVAL);
2116 assert_return(!m->sealed, -EPERM);
2117 assert_return(m->n_containers > 0, -EINVAL);
2118 assert_return(!m->poisoned, -ESTALE);
2120 c = message_get_container(m);
2122 if (c->enclosing != SD_BUS_TYPE_ARRAY)
2123 if (c->signature && c->signature[c->index] != 0)
2128 if (c->enclosing == SD_BUS_TYPE_ARRAY)
2129 r = bus_message_close_array(m, c);
2130 else if (c->enclosing == SD_BUS_TYPE_VARIANT)
2131 r = bus_message_close_variant(m, c);
2132 else if (c->enclosing == SD_BUS_TYPE_STRUCT || c->enclosing == SD_BUS_TYPE_DICT_ENTRY)
2133 r = bus_message_close_struct(m, c, true);
2135 assert_not_reached("Unknown container type");
2149 static int type_stack_push(TypeStack *stack, unsigned max, unsigned *i, const char *types, unsigned n_struct, unsigned n_array) {
2156 stack[*i].types = types;
2157 stack[*i].n_struct = n_struct;
2158 stack[*i].n_array = n_array;
2164 static int type_stack_pop(TypeStack *stack, unsigned max, unsigned *i, const char **types, unsigned *n_struct, unsigned *n_array) {
2175 *types = stack[*i].types;
2176 *n_struct = stack[*i].n_struct;
2177 *n_array = stack[*i].n_array;
2182 int bus_message_append_ap(
2187 unsigned n_array, n_struct;
2188 TypeStack stack[BUS_CONTAINER_DEPTH];
2189 unsigned stack_ptr = 0;
2197 n_array = (unsigned) -1;
2198 n_struct = strlen(types);
2203 if (n_array == 0 || (n_array == (unsigned) -1 && n_struct == 0)) {
2204 r = type_stack_pop(stack, ELEMENTSOF(stack), &stack_ptr, &types, &n_struct, &n_array);
2210 r = sd_bus_message_close_container(m);
2218 if (n_array != (unsigned) -1)
2227 case SD_BUS_TYPE_BYTE: {
2230 x = (uint8_t) va_arg(ap, int);
2231 r = sd_bus_message_append_basic(m, *t, &x);
2235 case SD_BUS_TYPE_BOOLEAN:
2236 case SD_BUS_TYPE_INT32:
2237 case SD_BUS_TYPE_UINT32:
2238 case SD_BUS_TYPE_UNIX_FD: {
2241 /* We assume a boolean is the same as int32_t */
2242 assert_cc(sizeof(int32_t) == sizeof(int));
2244 x = va_arg(ap, uint32_t);
2245 r = sd_bus_message_append_basic(m, *t, &x);
2249 case SD_BUS_TYPE_INT16:
2250 case SD_BUS_TYPE_UINT16: {
2253 x = (uint16_t) va_arg(ap, int);
2254 r = sd_bus_message_append_basic(m, *t, &x);
2258 case SD_BUS_TYPE_INT64:
2259 case SD_BUS_TYPE_UINT64:
2260 case SD_BUS_TYPE_DOUBLE: {
2263 x = va_arg(ap, uint64_t);
2264 r = sd_bus_message_append_basic(m, *t, &x);
2268 case SD_BUS_TYPE_STRING:
2269 case SD_BUS_TYPE_OBJECT_PATH:
2270 case SD_BUS_TYPE_SIGNATURE: {
2273 x = va_arg(ap, const char*);
2274 r = sd_bus_message_append_basic(m, *t, x);
2278 case SD_BUS_TYPE_ARRAY: {
2281 r = signature_element_length(t + 1, &k);
2287 memcpy(s, t + 1, k);
2290 r = sd_bus_message_open_container(m, SD_BUS_TYPE_ARRAY, s);
2295 if (n_array == (unsigned) -1) {
2300 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
2306 n_array = va_arg(ap, unsigned);
2311 case SD_BUS_TYPE_VARIANT: {
2314 s = va_arg(ap, const char*);
2318 r = sd_bus_message_open_container(m, SD_BUS_TYPE_VARIANT, s);
2322 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
2327 n_struct = strlen(s);
2328 n_array = (unsigned) -1;
2333 case SD_BUS_TYPE_STRUCT_BEGIN:
2334 case SD_BUS_TYPE_DICT_ENTRY_BEGIN: {
2337 r = signature_element_length(t, &k);
2344 memcpy(s, t + 1, k - 2);
2347 r = sd_bus_message_open_container(m, *t == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY, s);
2352 if (n_array == (unsigned) -1) {
2357 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
2363 n_array = (unsigned) -1;
2379 _public_ int sd_bus_message_append(sd_bus_message *m, const char *types, ...) {
2383 assert_return(m, -EINVAL);
2384 assert_return(types, -EINVAL);
2385 assert_return(!m->sealed, -EPERM);
2386 assert_return(!m->poisoned, -ESTALE);
2388 va_start(ap, types);
2389 r = bus_message_append_ap(m, types, ap);
2395 _public_ int sd_bus_message_append_array_space(
2405 assert_return(m, -EINVAL);
2406 assert_return(!m->sealed, -EPERM);
2407 assert_return(bus_type_is_trivial(type), -EINVAL);
2408 assert_return(ptr || size == 0, -EINVAL);
2409 assert_return(!m->poisoned, -ESTALE);
2411 align = bus_type_get_alignment(type);
2412 sz = bus_type_get_size(type);
2414 assert_se(align > 0);
2420 r = sd_bus_message_open_container(m, SD_BUS_TYPE_ARRAY, CHAR_TO_STR(type));
2424 a = message_extend_body(m, align, size, false);
2428 r = sd_bus_message_close_container(m);
2436 _public_ int sd_bus_message_append_array(sd_bus_message *m,
2443 assert_return(m, -EINVAL);
2444 assert_return(!m->sealed, -EPERM);
2445 assert_return(bus_type_is_trivial(type), -EINVAL);
2446 assert_return(ptr || size == 0, -EINVAL);
2447 assert_return(!m->poisoned, -ESTALE);
2449 r = sd_bus_message_append_array_space(m, type, size, &p);
2454 memcpy(p, ptr, size);
2459 _public_ int sd_bus_message_append_array_iovec(
2462 const struct iovec *iov,
2470 assert_return(m, -EINVAL);
2471 assert_return(!m->sealed, -EPERM);
2472 assert_return(bus_type_is_trivial(type), -EINVAL);
2473 assert_return(iov || n == 0, -EINVAL);
2474 assert_return(!m->poisoned, -ESTALE);
2476 size = IOVEC_TOTAL_SIZE(iov, n);
2478 r = sd_bus_message_append_array_space(m, type, size, &p);
2482 for (i = 0; i < n; i++) {
2484 if (iov[i].iov_base)
2485 memcpy(p, iov[i].iov_base, iov[i].iov_len);
2487 memset(p, 0, iov[i].iov_len);
2489 p = (uint8_t*) p + iov[i].iov_len;
2495 _public_ int sd_bus_message_append_array_memfd(sd_bus_message *m,
2498 _cleanup_close_ int copy_fd = -1;
2499 struct bus_body_part *part;
2511 if (!bus_type_is_trivial(type))
2516 r = sd_memfd_set_sealed(memfd, true);
2520 copy_fd = sd_memfd_dup_fd(memfd);
2524 r = sd_memfd_get_size(memfd, &size);
2528 align = bus_type_get_alignment(type);
2529 sz = bus_type_get_size(type);
2531 assert_se(align > 0);
2537 if (size > (uint64_t) (uint32_t) -1)
2540 r = sd_bus_message_open_container(m, SD_BUS_TYPE_ARRAY, CHAR_TO_STR(type));
2544 a = message_extend_body(m, align, 0, false);
2548 part = message_append_part(m);
2552 part->memfd = copy_fd;
2553 part->sealed = true;
2557 message_extend_containers(m, size);
2558 m->header->body_size += size;
2560 return sd_bus_message_close_container(m);
2563 _public_ int sd_bus_message_append_string_memfd(sd_bus_message *m, sd_memfd *memfd) {
2564 _cleanup_close_ int copy_fd = -1;
2565 struct bus_body_part *part;
2566 struct bus_container *c;
2571 assert_return(m, -EINVAL);
2572 assert_return(memfd, -EINVAL);
2573 assert_return(!m->sealed, -EPERM);
2574 assert_return(!m->poisoned, -ESTALE);
2576 r = sd_memfd_set_sealed(memfd, true);
2580 copy_fd = sd_memfd_dup_fd(memfd);
2584 r = sd_memfd_get_size(memfd, &size);
2588 /* We require this to be NUL terminated */
2592 if (size > (uint64_t) (uint32_t) -1)
2595 c = message_get_container(m);
2596 if (c->signature && c->signature[c->index]) {
2597 /* Container signature is already set */
2599 if (c->signature[c->index] != SD_BUS_TYPE_STRING)
2604 /* Maybe we can append to the signature? But only if this is the top-level container*/
2605 if (c->enclosing != 0)
2608 e = strextend(&c->signature, CHAR_TO_STR(SD_BUS_TYPE_STRING), NULL);
2615 if (!BUS_MESSAGE_IS_GVARIANT(m)) {
2616 a = message_extend_body(m, 4, 4, false);
2620 *(uint32_t*) a = size - 1;
2623 part = message_append_part(m);
2627 part->memfd = copy_fd;
2628 part->sealed = true;
2632 m->header->body_size += size;
2633 message_extend_containers(m, size);
2635 if (BUS_MESSAGE_IS_GVARIANT(m)) {
2636 r = message_add_offset(m, m->header->body_size);
2643 if (c->enclosing != SD_BUS_TYPE_ARRAY)
2649 _public_ int sd_bus_message_append_strv(sd_bus_message *m, char **l) {
2653 assert_return(m, -EINVAL);
2654 assert_return(!m->sealed, -EPERM);
2655 assert_return(!m->poisoned, -ESTALE);
2657 r = sd_bus_message_open_container(m, 'a', "s");
2661 STRV_FOREACH(i, l) {
2662 r = sd_bus_message_append_basic(m, 's', *i);
2667 return sd_bus_message_close_container(m);
2670 static int bus_message_close_header(sd_bus_message *m) {
2676 if (!BUS_MESSAGE_IS_GVARIANT(m))
2679 if (m->n_header_offsets < 1)
2682 assert(m->header->fields_size == m->header_offsets[m->n_header_offsets-1]);
2684 sz = determine_word_size(m->header->fields_size, m->n_header_offsets);
2686 a = message_extend_fields(m, 1, sz * m->n_header_offsets, false);
2690 for (i = 0; i < m->n_header_offsets; i++)
2691 write_word_le(a + sz*i, sz, m->header_offsets[i]);
2696 int bus_message_seal(sd_bus_message *m, uint64_t serial) {
2697 struct bus_body_part *part;
2707 if (m->n_containers > 0)
2713 /* In vtables the return signature of method calls is listed,
2714 * let's check if they match if this is a response */
2715 if (m->header->type == SD_BUS_MESSAGE_METHOD_RETURN &&
2716 m->enforced_reply_signature &&
2717 !streq(strempty(m->root_container.signature), m->enforced_reply_signature))
2720 /* If gvariant marshalling is used we need to close the body structure */
2721 r = bus_message_close_struct(m, &m->root_container, false);
2725 /* If there's a non-trivial signature set, then add it in here */
2726 if (!isempty(m->root_container.signature)) {
2727 r = message_append_field_signature(m, BUS_MESSAGE_HEADER_SIGNATURE, m->root_container.signature, NULL);
2733 r = message_append_field_uint32(m, BUS_MESSAGE_HEADER_UNIX_FDS, m->n_fds);
2738 r = bus_message_close_header(m);
2742 m->header->serial = serial;
2744 /* Add padding at the end of the fields part, since we know
2745 * the body needs to start at an 8 byte alignment. We made
2746 * sure we allocated enough space for this, so all we need to
2747 * do here is to zero it out. */
2748 l = BUS_MESSAGE_FIELDS_SIZE(m);
2751 memset((uint8_t*) BUS_MESSAGE_FIELDS(m) + l, 0, a);
2753 /* If this is something we can send as memfd, then let's seal
2754 the memfd now. Note that we can send memfds as payload only
2755 for directed messages, and not for broadcasts. */
2756 if (m->destination && m->bus && m->bus->use_memfd) {
2757 MESSAGE_FOREACH_PART(part, i, m)
2758 if (part->memfd >= 0 && !part->sealed && (part->size > MEMFD_MIN_SIZE || m->bus->use_memfd < 0)) {
2759 bus_body_part_unmap(part);
2761 if (ioctl(part->memfd, KDBUS_CMD_MEMFD_SEAL_SET, 1) >= 0)
2762 part->sealed = true;
2766 m->root_container.end = BUS_MESSAGE_BODY_SIZE(m);
2767 m->root_container.index = 0;
2768 m->root_container.offset_index = 0;
2769 m->root_container.item_size = m->root_container.n_offsets > 0 ? m->root_container.offsets[0] : 0;
2776 int bus_body_part_map(struct bus_body_part *part) {
2785 if (part->size <= 0)
2788 /* For smaller zero parts (as used for padding) we don't need to map anything... */
2789 if (part->memfd < 0 && part->is_zero && part->size < 8) {
2790 static const uint8_t zeroes[7] = { };
2791 part->data = (void*) zeroes;
2795 psz = PAGE_ALIGN(part->size);
2797 if (part->memfd >= 0)
2798 p = mmap(NULL, psz, PROT_READ, MAP_SHARED, part->memfd, 0);
2799 else if (part->is_zero)
2800 p = mmap(NULL, psz, PROT_READ, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0);
2804 if (p == MAP_FAILED)
2809 part->munmap_this = true;
2814 void bus_body_part_unmap(struct bus_body_part *part) {
2818 if (part->memfd < 0)
2824 if (!part->munmap_this)
2827 assert_se(munmap(part->data, part->mapped) == 0);
2831 part->munmap_this = false;
2836 static int buffer_peek(const void *p, uint32_t sz, size_t *rindex, size_t align, size_t nbytes, void **r) {
2837 size_t k, start, end;
2842 start = ALIGN_TO((size_t) *rindex, align);
2843 end = start + nbytes;
2848 /* Verify that padding is 0 */
2849 for (k = *rindex; k < start; k++)
2850 if (((const uint8_t*) p)[k] != 0)
2854 *r = (uint8_t*) p + start;
2861 static bool message_end_of_signature(sd_bus_message *m) {
2862 struct bus_container *c;
2866 c = message_get_container(m);
2867 return !c->signature || c->signature[c->index] == 0;
2870 static bool message_end_of_array(sd_bus_message *m, size_t index) {
2871 struct bus_container *c;
2875 c = message_get_container(m);
2876 if (c->enclosing != SD_BUS_TYPE_ARRAY)
2879 if (BUS_MESSAGE_IS_GVARIANT(m))
2880 return index >= c->end;
2882 assert(c->array_size);
2883 return index >= c->begin + BUS_MESSAGE_BSWAP32(m, *c->array_size);
2887 _public_ int sd_bus_message_at_end(sd_bus_message *m, int complete) {
2888 assert_return(m, -EINVAL);
2889 assert_return(m->sealed, -EPERM);
2891 if (complete && m->n_containers > 0)
2894 if (message_end_of_signature(m))
2897 if (message_end_of_array(m, m->rindex))
2903 static struct bus_body_part* find_part(sd_bus_message *m, size_t index, size_t sz, void **p) {
2904 struct bus_body_part *part;
2910 if (m->cached_rindex_part && index >= m->cached_rindex_part_begin) {
2911 part = m->cached_rindex_part;
2912 begin = m->cached_rindex_part_begin;
2922 if (index + sz <= begin + part->size) {
2924 r = bus_body_part_map(part);
2929 *p = (uint8_t*) part->data + index - begin;
2931 m->cached_rindex_part = part;
2932 m->cached_rindex_part_begin = begin;
2937 begin += part->size;
2944 static int container_next_item(sd_bus_message *m, struct bus_container *c, size_t *rindex) {
2951 if (!BUS_MESSAGE_IS_GVARIANT(m))
2954 if (c->enclosing == SD_BUS_TYPE_ARRAY) {
2957 sz = bus_gvariant_get_size(c->signature);
2961 if (c->offset_index+1 >= c->n_offsets)
2964 /* Variable-size array */
2966 alignment = bus_gvariant_get_alignment(c->signature);
2967 assert(alignment > 0);
2969 *rindex = ALIGN_TO(c->offsets[c->offset_index], alignment);
2970 c->item_size = c->offsets[c->offset_index+1] - *rindex;
2972 /* Fixed-size array */
2979 } else if (c->enclosing == 0 ||
2980 c->enclosing == SD_BUS_TYPE_STRUCT ||
2981 c->enclosing == SD_BUS_TYPE_DICT_ENTRY) {
2986 if (c->offset_index+1 >= c->n_offsets)
2989 r = signature_element_length(c->signature + c->index, &n);
2993 r = signature_element_length(c->signature + c->index + n, &j);
2998 memcpy(t, c->signature + c->index + n, j);
3001 alignment = bus_gvariant_get_alignment(t);
3004 assert(alignment > 0);
3006 *rindex = ALIGN_TO(c->offsets[c->offset_index], alignment);
3007 c->item_size = c->offsets[c->offset_index+1] - *rindex;
3011 } else if (c->enclosing == SD_BUS_TYPE_VARIANT)
3014 assert_not_reached("Unknown container type");
3019 /* Reached the end */
3026 static int message_peek_body(
3033 size_t k, start, end, padding;
3034 struct bus_body_part *part;
3041 start = ALIGN_TO((size_t) *rindex, align);
3042 padding = start - *rindex;
3043 end = start + nbytes;
3045 if (end > BUS_MESSAGE_BODY_SIZE(m))
3048 part = find_part(m, *rindex, padding, (void**) &q);
3053 /* Verify padding */
3054 for (k = 0; k < padding; k++)
3059 part = find_part(m, start, nbytes, (void**) &q);
3071 static bool validate_nul(const char *s, size_t l) {
3073 /* Check for NUL chars in the string */
3074 if (memchr(s, 0, l))
3077 /* Check for NUL termination */
3084 static bool validate_string(const char *s, size_t l) {
3086 if (!validate_nul(s, l))
3089 /* Check if valid UTF8 */
3090 if (!utf8_is_valid(s))
3096 static bool validate_signature(const char *s, size_t l) {
3098 if (!validate_nul(s, l))
3101 /* Check if valid signature */
3102 if (!signature_is_valid(s, true))
3108 static bool validate_object_path(const char *s, size_t l) {
3110 if (!validate_nul(s, l))
3113 if (!object_path_is_valid(s))
3119 _public_ int sd_bus_message_read_basic(sd_bus_message *m, char type, void *p) {
3120 struct bus_container *c;
3125 assert_return(m, -EINVAL);
3126 assert_return(m->sealed, -EPERM);
3127 assert_return(bus_type_is_basic(type), -EINVAL);
3129 if (message_end_of_signature(m))
3132 if (message_end_of_array(m, m->rindex))
3135 c = message_get_container(m);
3136 if (c->signature[c->index] != type)
3141 if (BUS_MESSAGE_IS_GVARIANT(m)) {
3143 if (IN_SET(type, SD_BUS_TYPE_STRING, SD_BUS_TYPE_OBJECT_PATH, SD_BUS_TYPE_SIGNATURE)) {
3146 r = message_peek_body(m, &rindex, 1, c->item_size, &q);
3150 if (type == SD_BUS_TYPE_STRING)
3151 ok = validate_string(q, c->item_size-1);
3152 else if (type == SD_BUS_TYPE_OBJECT_PATH)
3153 ok = validate_object_path(q, c->item_size-1);
3155 ok = validate_signature(q, c->item_size-1);
3161 *(const char**) p = q;
3165 sz = bus_gvariant_get_size(CHAR_TO_STR(type));
3167 if ((size_t) sz != c->item_size)
3170 align = bus_gvariant_get_alignment(CHAR_TO_STR(type));
3173 r = message_peek_body(m, &rindex, align, c->item_size, &q);
3179 case SD_BUS_TYPE_BYTE:
3181 *(uint8_t*) p = *(uint8_t*) q;
3184 case SD_BUS_TYPE_BOOLEAN:
3186 *(int*) p = !!*(uint8_t*) q;
3189 case SD_BUS_TYPE_INT16:
3190 case SD_BUS_TYPE_UINT16:
3192 *(uint16_t*) p = BUS_MESSAGE_BSWAP16(m, *(uint16_t*) q);
3195 case SD_BUS_TYPE_INT32:
3196 case SD_BUS_TYPE_UINT32:
3198 *(uint32_t*) p = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
3201 case SD_BUS_TYPE_INT64:
3202 case SD_BUS_TYPE_UINT64:
3203 case SD_BUS_TYPE_DOUBLE:
3205 *(uint64_t*) p = BUS_MESSAGE_BSWAP64(m, *(uint64_t*) q);
3208 case SD_BUS_TYPE_UNIX_FD: {
3211 j = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
3216 *(int*) p = m->fds[j];
3222 assert_not_reached("unexpected type");
3226 r = container_next_item(m, c, &rindex);
3233 if (IN_SET(type, SD_BUS_TYPE_STRING, SD_BUS_TYPE_OBJECT_PATH)) {
3237 r = message_peek_body(m, &rindex, 4, 4, &q);
3241 l = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
3242 r = message_peek_body(m, &rindex, 1, l+1, &q);
3246 if (type == SD_BUS_TYPE_OBJECT_PATH)
3247 ok = validate_object_path(q, l);
3249 ok = validate_string(q, l);
3254 *(const char**) p = q;
3256 } else if (type == SD_BUS_TYPE_SIGNATURE) {
3259 r = message_peek_body(m, &rindex, 1, 1, &q);
3264 r = message_peek_body(m, &rindex, 1, l+1, &q);
3268 if (!validate_signature(q, l))
3272 *(const char**) p = q;
3277 align = bus_type_get_alignment(type);
3280 sz = bus_type_get_size(type);
3283 r = message_peek_body(m, &rindex, align, sz, &q);
3289 case SD_BUS_TYPE_BYTE:
3291 *(uint8_t*) p = *(uint8_t*) q;
3294 case SD_BUS_TYPE_BOOLEAN:
3296 *(int*) p = !!*(uint32_t*) q;
3299 case SD_BUS_TYPE_INT16:
3300 case SD_BUS_TYPE_UINT16:
3302 *(uint16_t*) p = BUS_MESSAGE_BSWAP16(m, *(uint16_t*) q);
3305 case SD_BUS_TYPE_INT32:
3306 case SD_BUS_TYPE_UINT32:
3308 *(uint32_t*) p = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
3311 case SD_BUS_TYPE_INT64:
3312 case SD_BUS_TYPE_UINT64:
3313 case SD_BUS_TYPE_DOUBLE:
3315 *(uint64_t*) p = BUS_MESSAGE_BSWAP64(m, *(uint64_t*) q);
3318 case SD_BUS_TYPE_UNIX_FD: {
3321 j = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
3326 *(int*) p = m->fds[j];
3331 assert_not_reached("Unknown basic type...");
3338 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3344 static int bus_message_enter_array(
3346 struct bus_container *c,
3347 const char *contents,
3348 uint32_t **array_size,
3351 size_t *n_offsets) {
3365 if (!signature_is_single(contents, true))
3368 if (!c->signature || c->signature[c->index] == 0)
3371 if (c->signature[c->index] != SD_BUS_TYPE_ARRAY)
3374 if (!startswith(c->signature + c->index + 1, contents))
3379 if (!BUS_MESSAGE_IS_GVARIANT(m)) {
3382 r = message_peek_body(m, &rindex, 4, 4, &q);
3386 if (BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q) > BUS_ARRAY_MAX_SIZE)
3389 alignment = bus_type_get_alignment(contents[0]);
3393 r = message_peek_body(m, &rindex, alignment, 0, NULL);
3397 *array_size = (uint32_t*) q;
3399 } else if (c->item_size <= 0) {
3401 /* gvariant: empty array */
3406 } else if (bus_gvariant_is_fixed_size(contents)) {
3408 /* gvariant: fixed length array */
3409 *item_size = bus_gvariant_get_size(contents);
3414 size_t where, p = 0, framing, sz;
3417 /* gvariant: variable length array */
3418 sz = determine_word_size(c->item_size, 0);
3420 where = rindex + c->item_size - sz;
3421 r = message_peek_body(m, &where, 1, sz, &q);
3425 framing = read_word_le(q, sz);
3426 if (framing > c->item_size - sz)
3428 if ((c->item_size - framing) % sz != 0)
3431 *n_offsets = (c->item_size - framing) / sz;
3433 where = rindex + framing;
3434 r = message_peek_body(m, &where, 1, *n_offsets * sz, &q);
3438 *offsets = new(size_t, *n_offsets);
3442 for (i = 0; i < *n_offsets; i++) {
3445 x = read_word_le((uint8_t*) q + i * sz, sz);
3446 if (x > c->item_size - sz)
3451 (*offsets)[i] = rindex + x;
3455 *item_size = (*offsets)[0] - rindex;
3460 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3461 c->index += 1 + strlen(contents);
3466 static int bus_message_enter_variant(
3468 struct bus_container *c,
3469 const char *contents,
3470 size_t *item_size) {
3482 if (!signature_is_single(contents, false))
3485 if (*contents == SD_BUS_TYPE_DICT_ENTRY_BEGIN)
3488 if (!c->signature || c->signature[c->index] == 0)
3491 if (c->signature[c->index] != SD_BUS_TYPE_VARIANT)
3496 if (BUS_MESSAGE_IS_GVARIANT(m)) {
3499 k = strlen(contents);
3500 if (1+k > c->item_size)
3503 where = rindex + c->item_size - (1+k);
3504 r = message_peek_body(m, &where, 1, 1+k, &q);
3508 if (*(char*) q != 0)
3511 if (memcmp((uint8_t*) q+1, contents, k))
3514 *item_size = c->item_size - (1+k);
3517 r = message_peek_body(m, &rindex, 1, 1, &q);
3522 r = message_peek_body(m, &rindex, 1, l+1, &q);
3526 if (!validate_signature(q, l))
3529 if (!streq(q, contents))
3535 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3541 static int build_struct_offsets(
3543 const char *signature,
3547 size_t *n_offsets) {
3549 unsigned n_variable = 0, n_total = 0, v;
3550 size_t previous = 0, where;
3562 sz = determine_word_size(size, 0);
3564 /* First, loop over signature and count variable elements and
3565 * elements in general. We use this to know how large the
3566 * offset array is at the end of the structure. Note that
3567 * GVariant only stores offsets for all variable size elements
3568 * that are not the last item. */
3574 r = signature_element_length(p, &n);
3583 r = bus_gvariant_is_fixed_size(t);
3588 if (r == 0 && p[n] != 0) /* except the last item */
3595 if (size < n_variable * sz)
3598 where = m->rindex + size - (n_variable * sz);
3599 r = message_peek_body(m, &where, 1, n_variable * sz, &q);
3605 *offsets = new(size_t, n_total);
3611 /* Second, loop again and build an offset table */
3617 r = signature_element_length(p, &n);
3626 k = bus_gvariant_get_size(t);
3634 x = read_word_le((uint8_t*) q + v*sz, sz);
3637 if (m->rindex + x < previous)
3640 /* The last item's end
3641 * is determined from
3644 x = size - (n_variable * sz);
3646 offset = m->rindex + x;
3652 align = bus_gvariant_get_alignment(t);
3655 offset = (*n_offsets == 0 ? m->rindex : ALIGN_TO((*offsets)[*n_offsets-1], align)) + k;
3659 previous = (*offsets)[(*n_offsets)++] = offset;
3664 assert(*n_offsets == n_total);
3666 *item_size = (*offsets)[0] - m->rindex;
3670 static int enter_struct_or_dict_entry(
3672 struct bus_container *c,
3673 const char *contents,
3676 size_t *n_offsets) {
3687 if (!BUS_MESSAGE_IS_GVARIANT(m)) {
3690 r = message_peek_body(m, &m->rindex, 8, 0, NULL);
3694 } else if (c->item_size <= 0) {
3696 /* gvariant empty struct */
3701 /* gvariant with contents */
3702 return build_struct_offsets(m, contents, c->item_size, item_size, offsets, n_offsets);
3707 static int bus_message_enter_struct(
3709 struct bus_container *c,
3710 const char *contents,
3713 size_t *n_offsets) {
3725 if (!signature_is_valid(contents, false))
3728 if (!c->signature || c->signature[c->index] == 0)
3731 l = strlen(contents);
3733 if (c->signature[c->index] != SD_BUS_TYPE_STRUCT_BEGIN ||
3734 !startswith(c->signature + c->index + 1, contents) ||
3735 c->signature[c->index + 1 + l] != SD_BUS_TYPE_STRUCT_END)
3738 r = enter_struct_or_dict_entry(m, c, contents, item_size, offsets, n_offsets);
3742 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3743 c->index += 1 + l + 1;
3748 static int bus_message_enter_dict_entry(
3750 struct bus_container *c,
3751 const char *contents,
3754 size_t *n_offsets) {
3763 if (!signature_is_pair(contents))
3766 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3769 if (!c->signature || c->signature[c->index] == 0)
3772 l = strlen(contents);
3774 if (c->signature[c->index] != SD_BUS_TYPE_DICT_ENTRY_BEGIN ||
3775 !startswith(c->signature + c->index + 1, contents) ||
3776 c->signature[c->index + 1 + l] != SD_BUS_TYPE_DICT_ENTRY_END)
3779 r = enter_struct_or_dict_entry(m, c, contents, item_size, offsets, n_offsets);
3783 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3784 c->index += 1 + l + 1;
3789 _public_ int sd_bus_message_enter_container(sd_bus_message *m,
3791 const char *contents) {
3792 struct bus_container *c, *w;
3793 uint32_t *array_size = NULL;
3796 size_t *offsets = NULL;
3797 size_t n_offsets = 0, item_size = 0;
3800 assert_return(m, -EINVAL);
3801 assert_return(m->sealed, -EPERM);
3802 assert_return(type != 0 || !contents, -EINVAL);
3804 if (type == 0 || !contents) {
3808 /* Allow entering into anonymous containers */
3809 r = sd_bus_message_peek_type(m, &tt, &cc);
3813 if (type != 0 && type != tt)
3816 if (contents && !streq(contents, cc))
3824 * We enforce a global limit on container depth, that is much
3825 * higher than the 32 structs and 32 arrays the specification
3826 * mandates. This is simpler to implement for us, and we need
3827 * this only to ensure our container array doesn't grow
3828 * without bounds. We are happy to return any data from a
3829 * message as long as the data itself is valid, even if the
3830 * overall message might be not.
3832 * Note that the message signature is validated when
3833 * parsing the headers, and that validation does check the
3836 * Note that the specification defines no limits on the depth
3837 * of stacked variants, but we do.
3839 if (m->n_containers >= BUS_CONTAINER_DEPTH)
3842 w = realloc(m->containers, sizeof(struct bus_container) * (m->n_containers + 1));
3847 if (message_end_of_signature(m))
3850 if (message_end_of_array(m, m->rindex))
3853 c = message_get_container(m);
3855 signature = strdup(contents);
3859 c->saved_index = c->index;
3862 if (type == SD_BUS_TYPE_ARRAY)
3863 r = bus_message_enter_array(m, c, contents, &array_size, &item_size, &offsets, &n_offsets);
3864 else if (type == SD_BUS_TYPE_VARIANT)
3865 r = bus_message_enter_variant(m, c, contents, &item_size);
3866 else if (type == SD_BUS_TYPE_STRUCT)
3867 r = bus_message_enter_struct(m, c, contents, &item_size, &offsets, &n_offsets);
3868 else if (type == SD_BUS_TYPE_DICT_ENTRY)
3869 r = bus_message_enter_dict_entry(m, c, contents, &item_size, &offsets, &n_offsets);
3879 /* OK, let's fill it in */
3880 w += m->n_containers++;
3881 w->enclosing = type;
3882 w->signature = signature;
3886 w->begin = m->rindex;
3887 w->end = m->rindex + c->item_size;
3889 w->array_size = array_size;
3890 w->item_size = item_size;
3891 w->offsets = offsets;
3892 w->n_offsets = n_offsets;
3893 w->offset_index = 0;
3898 _public_ int sd_bus_message_exit_container(sd_bus_message *m) {
3899 struct bus_container *c;
3902 assert_return(m, -EINVAL);
3903 assert_return(m->sealed, -EPERM);
3904 assert_return(m->n_containers > 0, -ENXIO);
3906 c = message_get_container(m);
3908 if (c->enclosing != SD_BUS_TYPE_ARRAY) {
3909 if (c->signature && c->signature[c->index] != 0)
3913 if (BUS_MESSAGE_IS_GVARIANT(m)) {
3914 if (m->rindex < c->end)
3917 } else if (c->enclosing == SD_BUS_TYPE_ARRAY) {
3920 l = BUS_MESSAGE_BSWAP32(m, *c->array_size);
3921 if (c->begin + l != m->rindex)
3929 c = message_get_container(m);
3931 r = container_next_item(m, c, &m->rindex);
3938 static void message_quit_container(sd_bus_message *m) {
3939 struct bus_container *c;
3943 assert(m->n_containers > 0);
3945 c = message_get_container(m);
3948 assert(m->rindex >= c->before);
3949 m->rindex = c->before;
3951 /* Free container */
3956 /* Correct index of new top-level container */
3957 c = message_get_container(m);
3958 c->index = c->saved_index;
3961 _public_ int sd_bus_message_peek_type(sd_bus_message *m, char *type, const char **contents) {
3962 struct bus_container *c;
3965 assert_return(m, -EINVAL);
3966 assert_return(m->sealed, -EPERM);
3968 if (message_end_of_signature(m))
3971 if (message_end_of_array(m, m->rindex))
3974 c = message_get_container(m);
3976 if (bus_type_is_basic(c->signature[c->index])) {
3980 *type = c->signature[c->index];
3984 if (c->signature[c->index] == SD_BUS_TYPE_ARRAY) {
3990 r = signature_element_length(c->signature+c->index+1, &l);
3996 sig = strndup(c->signature + c->index + 1, l);
4000 free(m->peeked_signature);
4001 m->peeked_signature = sig;
4007 *type = SD_BUS_TYPE_ARRAY;
4012 if (c->signature[c->index] == SD_BUS_TYPE_STRUCT_BEGIN ||
4013 c->signature[c->index] == SD_BUS_TYPE_DICT_ENTRY_BEGIN) {
4019 r = signature_element_length(c->signature+c->index, &l);
4024 sig = strndup(c->signature + c->index + 1, l - 2);
4028 free(m->peeked_signature);
4029 m->peeked_signature = sig;
4035 *type = c->signature[c->index] == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY;
4040 if (c->signature[c->index] == SD_BUS_TYPE_VARIANT) {
4044 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4047 if (c->item_size < 2)
4050 /* Look for the NUL delimiter that
4051 separates the payload from the
4052 signature. Since the body might be
4053 in a different part that then the
4054 signature we map byte by byte. */
4056 for (k = 2; k <= c->item_size; k++) {
4059 where = m->rindex + c->item_size - k;
4060 r = message_peek_body(m, &where, 1, k, &q);
4064 if (*(char*) q == 0)
4068 if (k > c->item_size)
4071 free(m->peeked_signature);
4072 m->peeked_signature = strndup((char*) q + 1, k - 1);
4073 if (!m->peeked_signature)
4076 if (!signature_is_valid(m->peeked_signature, true))
4079 *contents = m->peeked_signature;
4084 r = message_peek_body(m, &rindex, 1, 1, &q);
4089 r = message_peek_body(m, &rindex, 1, l+1, &q);
4093 if (!validate_signature(q, l))
4101 *type = SD_BUS_TYPE_VARIANT;
4116 _public_ int sd_bus_message_rewind(sd_bus_message *m, int complete) {
4117 struct bus_container *c;
4119 assert_return(m, -EINVAL);
4120 assert_return(m->sealed, -EPERM);
4123 message_reset_containers(m);
4126 c = message_get_container(m);
4128 c = message_get_container(m);
4130 c->offset_index = 0;
4132 m->rindex = c->begin;
4135 return !isempty(c->signature);
4138 static int message_read_ap(
4143 unsigned n_array, n_struct;
4144 TypeStack stack[BUS_CONTAINER_DEPTH];
4145 unsigned stack_ptr = 0;
4146 unsigned n_loop = 0;
4154 /* Ideally, we'd just call ourselves recursively on every
4155 * complex type. However, the state of a va_list that is
4156 * passed to a function is undefined after that function
4157 * returns. This means we need to docode the va_list linearly
4158 * in a single stackframe. We hence implement our own
4159 * home-grown stack in an array. */
4161 n_array = (unsigned) -1; /* lenght of current array entries */
4162 n_struct = strlen(types); /* length of current struct contents signature */
4169 if (n_array == 0 || (n_array == (unsigned) -1 && n_struct == 0)) {
4170 r = type_stack_pop(stack, ELEMENTSOF(stack), &stack_ptr, &types, &n_struct, &n_array);
4176 r = sd_bus_message_exit_container(m);
4184 if (n_array != (unsigned) -1)
4193 case SD_BUS_TYPE_BYTE:
4194 case SD_BUS_TYPE_BOOLEAN:
4195 case SD_BUS_TYPE_INT16:
4196 case SD_BUS_TYPE_UINT16:
4197 case SD_BUS_TYPE_INT32:
4198 case SD_BUS_TYPE_UINT32:
4199 case SD_BUS_TYPE_INT64:
4200 case SD_BUS_TYPE_UINT64:
4201 case SD_BUS_TYPE_DOUBLE:
4202 case SD_BUS_TYPE_STRING:
4203 case SD_BUS_TYPE_OBJECT_PATH:
4204 case SD_BUS_TYPE_SIGNATURE:
4205 case SD_BUS_TYPE_UNIX_FD: {
4208 p = va_arg(ap, void*);
4209 r = sd_bus_message_read_basic(m, *t, p);
4222 case SD_BUS_TYPE_ARRAY: {
4225 r = signature_element_length(t + 1, &k);
4231 memcpy(s, t + 1, k);
4234 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, s);
4245 if (n_array == (unsigned) -1) {
4250 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4256 n_array = va_arg(ap, unsigned);
4261 case SD_BUS_TYPE_VARIANT: {
4264 s = va_arg(ap, const char *);
4268 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_VARIANT, s);
4278 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4283 n_struct = strlen(s);
4284 n_array = (unsigned) -1;
4289 case SD_BUS_TYPE_STRUCT_BEGIN:
4290 case SD_BUS_TYPE_DICT_ENTRY_BEGIN: {
4293 r = signature_element_length(t, &k);
4299 memcpy(s, t + 1, k - 2);
4302 r = sd_bus_message_enter_container(m, *t == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY, s);
4312 if (n_array == (unsigned) -1) {
4317 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4323 n_array = (unsigned) -1;
4336 _public_ int sd_bus_message_read(sd_bus_message *m, const char *types, ...) {
4340 assert_return(m, -EINVAL);
4341 assert_return(m->sealed, -EPERM);
4342 assert_return(types, -EINVAL);
4344 va_start(ap, types);
4345 r = message_read_ap(m, types, ap);
4351 _public_ int sd_bus_message_skip(sd_bus_message *m, const char *types) {
4354 assert_return(m, -EINVAL);
4355 assert_return(m->sealed, -EPERM);
4356 assert_return(types, -EINVAL);
4363 case SD_BUS_TYPE_BYTE:
4364 case SD_BUS_TYPE_BOOLEAN:
4365 case SD_BUS_TYPE_INT16:
4366 case SD_BUS_TYPE_UINT16:
4367 case SD_BUS_TYPE_INT32:
4368 case SD_BUS_TYPE_UINT32:
4369 case SD_BUS_TYPE_INT64:
4370 case SD_BUS_TYPE_UINT64:
4371 case SD_BUS_TYPE_DOUBLE:
4372 case SD_BUS_TYPE_STRING:
4373 case SD_BUS_TYPE_OBJECT_PATH:
4374 case SD_BUS_TYPE_SIGNATURE:
4375 case SD_BUS_TYPE_UNIX_FD:
4377 r = sd_bus_message_read_basic(m, *types, NULL);
4381 r = sd_bus_message_skip(m, types + 1);
4387 case SD_BUS_TYPE_ARRAY: {
4390 r = signature_element_length(types + 1, &k);
4396 memcpy(s, types+1, k);
4399 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, s);
4404 r = sd_bus_message_skip(m, s);
4411 r = sd_bus_message_exit_container(m);
4416 r = sd_bus_message_skip(m, types + 1 + k);
4423 case SD_BUS_TYPE_VARIANT: {
4424 const char *contents;
4427 r = sd_bus_message_peek_type(m, &x, &contents);
4431 if (x != SD_BUS_TYPE_VARIANT)
4434 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_VARIANT, contents);
4438 r = sd_bus_message_skip(m, contents);
4443 r = sd_bus_message_exit_container(m);
4447 r = sd_bus_message_skip(m, types + 1);
4454 case SD_BUS_TYPE_STRUCT_BEGIN:
4455 case SD_BUS_TYPE_DICT_ENTRY_BEGIN: {
4458 r = signature_element_length(types, &k);
4464 memcpy(s, types+1, k-2);
4467 r = sd_bus_message_enter_container(m, *types == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY, s);
4471 r = sd_bus_message_skip(m, s);
4476 r = sd_bus_message_exit_container(m);
4481 r = sd_bus_message_skip(m, types + k);
4493 _public_ int sd_bus_message_read_array(sd_bus_message *m,
4497 struct bus_container *c;
4503 assert_return(m, -EINVAL);
4504 assert_return(m->sealed, -EPERM);
4505 assert_return(bus_type_is_trivial(type), -EINVAL);
4506 assert_return(ptr, -EINVAL);
4507 assert_return(size, -EINVAL);
4508 assert_return(!BUS_MESSAGE_NEED_BSWAP(m), -ENOTSUP);
4510 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, CHAR_TO_STR(type));
4514 c = message_get_container(m);
4516 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4517 align = bus_gvariant_get_alignment(CHAR_TO_STR(type));
4521 sz = c->end - c->begin;
4523 align = bus_type_get_alignment(type);
4527 sz = BUS_MESSAGE_BSWAP32(m, *c->array_size);
4531 /* Zero length array, let's return some aligned
4532 * pointer that is not NULL */
4533 p = (uint8_t*) NULL + align;
4535 r = message_peek_body(m, &m->rindex, align, sz, &p);
4540 r = sd_bus_message_exit_container(m);
4544 *ptr = (const void*) p;
4550 message_quit_container(m);
4554 static int message_peek_fields(
4565 return buffer_peek(BUS_MESSAGE_FIELDS(m), BUS_MESSAGE_FIELDS_SIZE(m), rindex, align, nbytes, ret);
4568 static int message_peek_field_uint32(
4580 if (BUS_MESSAGE_IS_GVARIANT(m) && item_size != 4)
4583 /* identical for gvariant and dbus1 */
4585 r = message_peek_fields(m, ri, 4, 4, &q);
4590 *ret = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
4595 static int message_peek_field_string(
4597 bool (*validate)(const char *p),
4609 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4614 r = message_peek_fields(m, ri, 1, item_size, &q);
4620 r = message_peek_field_uint32(m, ri, 4, &l);
4624 r = message_peek_fields(m, ri, 1, l+1, &q);
4630 if (!validate_nul(q, l))
4636 if (!validate_string(q, l))
4646 static int message_peek_field_signature(
4659 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4664 r = message_peek_fields(m, ri, 1, item_size, &q);
4670 r = message_peek_fields(m, ri, 1, 1, &q);
4675 r = message_peek_fields(m, ri, 1, l+1, &q);
4680 if (!validate_signature(q, l))
4689 static int message_skip_fields(
4692 uint32_t array_size,
4693 const char **signature) {
4695 size_t original_index;
4701 assert(!BUS_MESSAGE_IS_GVARIANT(m));
4703 original_index = *ri;
4709 if (array_size != (uint32_t) -1 &&
4710 array_size <= *ri - original_index)
4717 if (t == SD_BUS_TYPE_STRING) {
4719 r = message_peek_field_string(m, NULL, ri, 0, NULL);
4725 } else if (t == SD_BUS_TYPE_OBJECT_PATH) {
4727 r = message_peek_field_string(m, object_path_is_valid, ri, 0, NULL);
4733 } else if (t == SD_BUS_TYPE_SIGNATURE) {
4735 r = message_peek_field_signature(m, ri, 0, NULL);
4741 } else if (bus_type_is_basic(t)) {
4744 align = bus_type_get_alignment(t);
4745 k = bus_type_get_size(t);
4746 assert(align > 0 && k > 0);
4748 r = message_peek_fields(m, ri, align, k, NULL);
4754 } else if (t == SD_BUS_TYPE_ARRAY) {
4756 r = signature_element_length(*signature+1, &l);
4766 strncpy(sig, *signature + 1, l-1);
4769 alignment = bus_type_get_alignment(sig[0]);
4773 r = message_peek_field_uint32(m, ri, 0, &nas);
4776 if (nas > BUS_ARRAY_MAX_SIZE)
4779 r = message_peek_fields(m, ri, alignment, 0, NULL);
4783 r = message_skip_fields(m, ri, nas, (const char**) &s);
4788 (*signature) += 1 + l;
4790 } else if (t == SD_BUS_TYPE_VARIANT) {
4793 r = message_peek_field_signature(m, ri, 0, &s);
4797 r = message_skip_fields(m, ri, (uint32_t) -1, (const char**) &s);
4803 } else if (t == SD_BUS_TYPE_STRUCT ||
4804 t == SD_BUS_TYPE_DICT_ENTRY) {
4806 r = signature_element_length(*signature, &l);
4813 strncpy(sig, *signature + 1, l-1);
4816 r = message_skip_fields(m, ri, (uint32_t) -1, (const char**) &s);
4827 int bus_message_parse_fields(sd_bus_message *m) {
4830 uint32_t unix_fds = 0;
4831 void *offsets = NULL;
4832 unsigned n_offsets = 0;
4838 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4841 sz = determine_word_size(BUS_MESSAGE_FIELDS_SIZE(m), 0);
4845 ri = BUS_MESSAGE_FIELDS_SIZE(m) - sz;
4846 r = message_peek_fields(m, &ri, 1, sz, &q);
4850 framing = read_word_le(q, sz);
4851 if (framing >= BUS_MESSAGE_FIELDS_SIZE(m) - sz)
4853 if ((BUS_MESSAGE_FIELDS_SIZE(m) - framing) % sz != 0)
4857 r = message_peek_fields(m, &ri, 1, BUS_MESSAGE_FIELDS_SIZE(m) - framing, &offsets);
4861 n_offsets = (BUS_MESSAGE_FIELDS_SIZE(m) - framing) / sz;
4866 while (ri < BUS_MESSAGE_FIELDS_SIZE(m)) {
4867 _cleanup_free_ char *sig = NULL;
4868 const char *signature;
4870 size_t item_size = (size_t) -1;
4872 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4879 ri = ALIGN_TO(read_word_le((uint8_t*) offsets + (i-1)*sz, sz), 8);
4882 r = message_peek_fields(m, &ri, 8, 1, (void**) &header);
4886 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4891 end = read_word_le((uint8_t*) offsets + i*sz, sz);
4896 where = ri = ALIGN_TO(ri, 8);
4897 item_size = end - ri;
4898 r = message_peek_fields(m, &where, 1, item_size, &q);
4902 b = memrchr(q, 0, item_size);
4906 sig = strndup(b+1, item_size - (b+1-(char*) q));
4911 item_size = b - (char*) q;
4913 r = message_peek_field_signature(m, &ri, 0, &signature);
4919 case _BUS_MESSAGE_HEADER_INVALID:
4922 case BUS_MESSAGE_HEADER_PATH:
4927 if (!streq(signature, "o"))
4930 r = message_peek_field_string(m, object_path_is_valid, &ri, item_size, &m->path);
4933 case BUS_MESSAGE_HEADER_INTERFACE:
4938 if (!streq(signature, "s"))
4941 r = message_peek_field_string(m, interface_name_is_valid, &ri, item_size, &m->interface);
4944 case BUS_MESSAGE_HEADER_MEMBER:
4949 if (!streq(signature, "s"))
4952 r = message_peek_field_string(m, member_name_is_valid, &ri, item_size, &m->member);
4955 case BUS_MESSAGE_HEADER_ERROR_NAME:
4960 if (!streq(signature, "s"))
4963 r = message_peek_field_string(m, error_name_is_valid, &ri, item_size, &m->error.name);
4965 m->error._need_free = -1;
4969 case BUS_MESSAGE_HEADER_DESTINATION:
4974 if (!streq(signature, "s"))
4977 r = message_peek_field_string(m, service_name_is_valid, &ri, item_size, &m->destination);
4980 case BUS_MESSAGE_HEADER_SENDER:
4985 if (!streq(signature, "s"))
4988 r = message_peek_field_string(m, service_name_is_valid, &ri, item_size, &m->sender);
4990 if (r >= 0 && m->sender[0] == ':' && m->bus && m->bus->bus_client && !m->bus->is_kernel) {
4991 m->creds.unique_name = (char*) m->sender;
4992 m->creds.mask |= SD_BUS_CREDS_UNIQUE_NAME & m->bus->creds_mask;
4998 case BUS_MESSAGE_HEADER_SIGNATURE: {
5002 if (m->root_container.signature)
5005 if (!streq(signature, "g"))
5008 r = message_peek_field_signature(m, &ri, item_size, &s);
5016 free(m->root_container.signature);
5017 m->root_container.signature = c;
5021 case BUS_MESSAGE_HEADER_REPLY_SERIAL:
5022 if (m->reply_serial != 0)
5025 if (!streq(signature, "u"))
5028 r = message_peek_field_uint32(m, &ri, item_size, &m->reply_serial);
5032 if (m->reply_serial == 0)
5037 case BUS_MESSAGE_HEADER_UNIX_FDS:
5041 if (!streq(signature, "u"))
5044 r = message_peek_field_uint32(m, &ri, item_size, &unix_fds);
5054 if (!BUS_MESSAGE_IS_GVARIANT(m))
5055 r = message_skip_fields(m, &ri, (uint32_t) -1, (const char **) &signature);
5064 if (m->n_fds != unix_fds)
5067 if (isempty(m->root_container.signature) != (BUS_MESSAGE_BODY_SIZE(m) == 0))
5070 switch (m->header->type) {
5072 case SD_BUS_MESSAGE_SIGNAL:
5073 if (!m->path || !m->interface || !m->member)
5077 case SD_BUS_MESSAGE_METHOD_CALL:
5079 if (!m->path || !m->member)
5084 case SD_BUS_MESSAGE_METHOD_RETURN:
5086 if (m->reply_serial == 0)
5090 case SD_BUS_MESSAGE_METHOD_ERROR:
5092 if (m->reply_serial == 0 || !m->error.name)
5097 m->root_container.end = BUS_MESSAGE_BODY_SIZE(m);
5099 if (BUS_MESSAGE_IS_GVARIANT(m)) {
5100 r = build_struct_offsets(
5102 m->root_container.signature,
5103 BUS_MESSAGE_BODY_SIZE(m),
5104 &m->root_container.item_size,
5105 &m->root_container.offsets,
5106 &m->root_container.n_offsets);
5111 /* Try to read the error message, but if we can't it's a non-issue */
5112 if (m->header->type == SD_BUS_MESSAGE_METHOD_ERROR)
5113 sd_bus_message_read(m, "s", &m->error.message);
5118 _public_ int sd_bus_message_set_destination(sd_bus_message *m, const char *destination) {
5119 assert_return(m, -EINVAL);
5120 assert_return(destination, -EINVAL);
5121 assert_return(!m->sealed, -EPERM);
5122 assert_return(!m->destination, -EEXIST);
5124 return message_append_field_string(m, BUS_MESSAGE_HEADER_DESTINATION, SD_BUS_TYPE_STRING, destination, &m->destination);
5127 int bus_message_get_blob(sd_bus_message *m, void **buffer, size_t *sz) {
5131 struct bus_body_part *part;
5137 total = BUS_MESSAGE_SIZE(m);
5143 e = mempcpy(p, m->header, BUS_MESSAGE_BODY_BEGIN(m));
5144 MESSAGE_FOREACH_PART(part, i, m)
5145 e = mempcpy(e, part->data, part->size);
5147 assert(total == (size_t) ((uint8_t*) e - (uint8_t*) p));
5155 int bus_message_read_strv_extend(sd_bus_message *m, char ***l) {
5161 r = sd_bus_message_enter_container(m, 'a', "s");
5168 r = sd_bus_message_read_basic(m, 's', &s);
5174 r = strv_extend(l, s);
5179 r = sd_bus_message_exit_container(m);
5186 _public_ int sd_bus_message_read_strv(sd_bus_message *m, char ***l) {
5190 assert_return(m, -EINVAL);
5191 assert_return(m->sealed, -EPERM);
5192 assert_return(l, -EINVAL);
5194 r = bus_message_read_strv_extend(m, &strv);
5204 const char* bus_message_get_arg(sd_bus_message *m, unsigned i) {
5206 const char *t = NULL;
5211 r = sd_bus_message_rewind(m, true);
5215 for (j = 0; j <= i; j++) {
5218 r = sd_bus_message_peek_type(m, &type, NULL);
5222 if (type != SD_BUS_TYPE_STRING &&
5223 type != SD_BUS_TYPE_OBJECT_PATH &&
5224 type != SD_BUS_TYPE_SIGNATURE)
5227 r = sd_bus_message_read_basic(m, type, &t);
5235 bool bus_header_is_complete(struct bus_header *h, size_t size) {
5241 if (size < sizeof(struct bus_header))
5244 full = sizeof(struct bus_header) +
5245 (h->endian == BUS_NATIVE_ENDIAN ? h->fields_size : bswap_32(h->fields_size));
5247 return size >= full;
5250 int bus_header_message_size(struct bus_header *h, size_t *sum) {
5256 if (h->endian == BUS_NATIVE_ENDIAN) {
5257 fs = h->fields_size;
5259 } else if (h->endian == BUS_REVERSE_ENDIAN) {
5260 fs = bswap_32(h->fields_size);
5261 bs = bswap_32(h->body_size);
5265 *sum = sizeof(struct bus_header) + ALIGN8(fs) + bs;
5269 _public_ int sd_bus_message_get_errno(sd_bus_message *m) {
5270 assert_return(m, -EINVAL);
5272 if (m->header->type != SD_BUS_MESSAGE_METHOD_ERROR)
5275 return sd_bus_error_get_errno(&m->error);
5278 _public_ const char* sd_bus_message_get_signature(sd_bus_message *m, int complete) {
5279 struct bus_container *c;
5281 assert_return(m, NULL);
5283 c = complete ? &m->root_container : message_get_container(m);
5284 return c->signature ?: "";
5287 _public_ int sd_bus_message_copy(sd_bus_message *m, sd_bus_message *source, int all) {
5288 bool done_something = false;
5291 assert_return(m, -EINVAL);
5292 assert_return(source, -EINVAL);
5293 assert_return(!m->sealed, -EPERM);
5294 assert_return(source->sealed, -EPERM);
5297 const char *contents;
5312 r = sd_bus_message_peek_type(source, &type, &contents);
5318 done_something = true;
5320 if (bus_type_is_container(type) > 0) {
5322 r = sd_bus_message_enter_container(source, type, contents);
5326 r = sd_bus_message_open_container(m, type, contents);
5330 r = sd_bus_message_copy(m, source, true);
5334 r = sd_bus_message_close_container(m);
5338 r = sd_bus_message_exit_container(source);
5345 r = sd_bus_message_read_basic(source, type, &basic);
5351 if (type == SD_BUS_TYPE_OBJECT_PATH ||
5352 type == SD_BUS_TYPE_SIGNATURE ||
5353 type == SD_BUS_TYPE_STRING)
5354 r = sd_bus_message_append_basic(m, type, basic.string);
5356 r = sd_bus_message_append_basic(m, type, &basic);
5363 return done_something;
5366 _public_ int sd_bus_message_verify_type(sd_bus_message *m, char type, const char *contents) {
5371 assert_return(m, -EINVAL);
5372 assert_return(m->sealed, -EPERM);
5373 assert_return(!type || bus_type_is_valid(type), -EINVAL);
5374 assert_return(!contents || signature_is_valid(contents, true), -EINVAL);
5375 assert_return(type || contents, -EINVAL);
5376 assert_return(!contents || !type || bus_type_is_container(type), -EINVAL);
5378 r = sd_bus_message_peek_type(m, &t, &c);
5382 if (type != 0 && type != t)
5385 if (contents && !streq_ptr(contents, c))
5391 _public_ sd_bus *sd_bus_message_get_bus(sd_bus_message *m) {
5392 assert_return(m, NULL);