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))
2029 p = strempty(c->signature);
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);
2077 p = strempty(c->signature);
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;
3561 if (isempty(signature)) {
3568 sz = determine_word_size(size, 0);
3572 /* First, loop over signature and count variable elements and
3573 * elements in general. We use this to know how large the
3574 * offset array is at the end of the structure. Note that
3575 * GVariant only stores offsets for all variable size elements
3576 * that are not the last item. */
3582 r = signature_element_length(p, &n);
3591 r = bus_gvariant_is_fixed_size(t);
3596 if (r == 0 && p[n] != 0) /* except the last item */
3603 if (size < n_variable * sz)
3606 where = m->rindex + size - (n_variable * sz);
3607 r = message_peek_body(m, &where, 1, n_variable * sz, &q);
3613 *offsets = new(size_t, n_total);
3619 /* Second, loop again and build an offset table */
3625 r = signature_element_length(p, &n);
3634 k = bus_gvariant_get_size(t);
3642 x = read_word_le((uint8_t*) q + v*sz, sz);
3645 if (m->rindex + x < previous)
3648 /* The last item's end
3649 * is determined from
3652 x = size - (n_variable * sz);
3654 offset = m->rindex + x;
3660 align = bus_gvariant_get_alignment(t);
3663 offset = (*n_offsets == 0 ? m->rindex : ALIGN_TO((*offsets)[*n_offsets-1], align)) + k;
3667 previous = (*offsets)[(*n_offsets)++] = offset;
3672 assert(*n_offsets == n_total);
3674 *item_size = (*offsets)[0] - m->rindex;
3678 static int enter_struct_or_dict_entry(
3680 struct bus_container *c,
3681 const char *contents,
3684 size_t *n_offsets) {
3695 if (!BUS_MESSAGE_IS_GVARIANT(m)) {
3698 r = message_peek_body(m, &m->rindex, 8, 0, NULL);
3702 } else if (c->item_size <= 0) {
3704 /* gvariant empty struct */
3709 /* gvariant with contents */
3710 return build_struct_offsets(m, contents, c->item_size, item_size, offsets, n_offsets);
3715 static int bus_message_enter_struct(
3717 struct bus_container *c,
3718 const char *contents,
3721 size_t *n_offsets) {
3733 if (!signature_is_valid(contents, false))
3736 if (!c->signature || c->signature[c->index] == 0)
3739 l = strlen(contents);
3741 if (c->signature[c->index] != SD_BUS_TYPE_STRUCT_BEGIN ||
3742 !startswith(c->signature + c->index + 1, contents) ||
3743 c->signature[c->index + 1 + l] != SD_BUS_TYPE_STRUCT_END)
3746 r = enter_struct_or_dict_entry(m, c, contents, item_size, offsets, n_offsets);
3750 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3751 c->index += 1 + l + 1;
3756 static int bus_message_enter_dict_entry(
3758 struct bus_container *c,
3759 const char *contents,
3762 size_t *n_offsets) {
3771 if (!signature_is_pair(contents))
3774 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3777 if (!c->signature || c->signature[c->index] == 0)
3780 l = strlen(contents);
3782 if (c->signature[c->index] != SD_BUS_TYPE_DICT_ENTRY_BEGIN ||
3783 !startswith(c->signature + c->index + 1, contents) ||
3784 c->signature[c->index + 1 + l] != SD_BUS_TYPE_DICT_ENTRY_END)
3787 r = enter_struct_or_dict_entry(m, c, contents, item_size, offsets, n_offsets);
3791 if (c->enclosing != SD_BUS_TYPE_ARRAY)
3792 c->index += 1 + l + 1;
3797 _public_ int sd_bus_message_enter_container(sd_bus_message *m,
3799 const char *contents) {
3800 struct bus_container *c, *w;
3801 uint32_t *array_size = NULL;
3804 size_t *offsets = NULL;
3805 size_t n_offsets = 0, item_size = 0;
3808 assert_return(m, -EINVAL);
3809 assert_return(m->sealed, -EPERM);
3810 assert_return(type != 0 || !contents, -EINVAL);
3812 if (type == 0 || !contents) {
3816 /* Allow entering into anonymous containers */
3817 r = sd_bus_message_peek_type(m, &tt, &cc);
3821 if (type != 0 && type != tt)
3824 if (contents && !streq(contents, cc))
3832 * We enforce a global limit on container depth, that is much
3833 * higher than the 32 structs and 32 arrays the specification
3834 * mandates. This is simpler to implement for us, and we need
3835 * this only to ensure our container array doesn't grow
3836 * without bounds. We are happy to return any data from a
3837 * message as long as the data itself is valid, even if the
3838 * overall message might be not.
3840 * Note that the message signature is validated when
3841 * parsing the headers, and that validation does check the
3844 * Note that the specification defines no limits on the depth
3845 * of stacked variants, but we do.
3847 if (m->n_containers >= BUS_CONTAINER_DEPTH)
3850 w = realloc(m->containers, sizeof(struct bus_container) * (m->n_containers + 1));
3855 if (message_end_of_signature(m))
3858 if (message_end_of_array(m, m->rindex))
3861 c = message_get_container(m);
3863 signature = strdup(contents);
3867 c->saved_index = c->index;
3870 if (type == SD_BUS_TYPE_ARRAY)
3871 r = bus_message_enter_array(m, c, contents, &array_size, &item_size, &offsets, &n_offsets);
3872 else if (type == SD_BUS_TYPE_VARIANT)
3873 r = bus_message_enter_variant(m, c, contents, &item_size);
3874 else if (type == SD_BUS_TYPE_STRUCT)
3875 r = bus_message_enter_struct(m, c, contents, &item_size, &offsets, &n_offsets);
3876 else if (type == SD_BUS_TYPE_DICT_ENTRY)
3877 r = bus_message_enter_dict_entry(m, c, contents, &item_size, &offsets, &n_offsets);
3887 /* OK, let's fill it in */
3888 w += m->n_containers++;
3889 w->enclosing = type;
3890 w->signature = signature;
3894 w->begin = m->rindex;
3895 w->end = m->rindex + c->item_size;
3897 w->array_size = array_size;
3898 w->item_size = item_size;
3899 w->offsets = offsets;
3900 w->n_offsets = n_offsets;
3901 w->offset_index = 0;
3906 _public_ int sd_bus_message_exit_container(sd_bus_message *m) {
3907 struct bus_container *c;
3910 assert_return(m, -EINVAL);
3911 assert_return(m->sealed, -EPERM);
3912 assert_return(m->n_containers > 0, -ENXIO);
3914 c = message_get_container(m);
3916 if (c->enclosing != SD_BUS_TYPE_ARRAY) {
3917 if (c->signature && c->signature[c->index] != 0)
3921 if (BUS_MESSAGE_IS_GVARIANT(m)) {
3922 if (m->rindex < c->end)
3925 } else if (c->enclosing == SD_BUS_TYPE_ARRAY) {
3928 l = BUS_MESSAGE_BSWAP32(m, *c->array_size);
3929 if (c->begin + l != m->rindex)
3937 c = message_get_container(m);
3939 r = container_next_item(m, c, &m->rindex);
3946 static void message_quit_container(sd_bus_message *m) {
3947 struct bus_container *c;
3951 assert(m->n_containers > 0);
3953 c = message_get_container(m);
3956 assert(m->rindex >= c->before);
3957 m->rindex = c->before;
3959 /* Free container */
3964 /* Correct index of new top-level container */
3965 c = message_get_container(m);
3966 c->index = c->saved_index;
3969 _public_ int sd_bus_message_peek_type(sd_bus_message *m, char *type, const char **contents) {
3970 struct bus_container *c;
3973 assert_return(m, -EINVAL);
3974 assert_return(m->sealed, -EPERM);
3976 if (message_end_of_signature(m))
3979 if (message_end_of_array(m, m->rindex))
3982 c = message_get_container(m);
3984 if (bus_type_is_basic(c->signature[c->index])) {
3988 *type = c->signature[c->index];
3992 if (c->signature[c->index] == SD_BUS_TYPE_ARRAY) {
3998 r = signature_element_length(c->signature+c->index+1, &l);
4004 sig = strndup(c->signature + c->index + 1, l);
4008 free(m->peeked_signature);
4009 m->peeked_signature = sig;
4015 *type = SD_BUS_TYPE_ARRAY;
4020 if (c->signature[c->index] == SD_BUS_TYPE_STRUCT_BEGIN ||
4021 c->signature[c->index] == SD_BUS_TYPE_DICT_ENTRY_BEGIN) {
4027 r = signature_element_length(c->signature+c->index, &l);
4032 sig = strndup(c->signature + c->index + 1, l - 2);
4036 free(m->peeked_signature);
4037 m->peeked_signature = sig;
4043 *type = c->signature[c->index] == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY;
4048 if (c->signature[c->index] == SD_BUS_TYPE_VARIANT) {
4052 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4055 if (c->item_size < 2)
4058 /* Look for the NUL delimiter that
4059 separates the payload from the
4060 signature. Since the body might be
4061 in a different part that then the
4062 signature we map byte by byte. */
4064 for (k = 2; k <= c->item_size; k++) {
4067 where = m->rindex + c->item_size - k;
4068 r = message_peek_body(m, &where, 1, k, &q);
4072 if (*(char*) q == 0)
4076 if (k > c->item_size)
4079 free(m->peeked_signature);
4080 m->peeked_signature = strndup((char*) q + 1, k - 1);
4081 if (!m->peeked_signature)
4084 if (!signature_is_valid(m->peeked_signature, true))
4087 *contents = m->peeked_signature;
4092 r = message_peek_body(m, &rindex, 1, 1, &q);
4097 r = message_peek_body(m, &rindex, 1, l+1, &q);
4101 if (!validate_signature(q, l))
4109 *type = SD_BUS_TYPE_VARIANT;
4124 _public_ int sd_bus_message_rewind(sd_bus_message *m, int complete) {
4125 struct bus_container *c;
4127 assert_return(m, -EINVAL);
4128 assert_return(m->sealed, -EPERM);
4131 message_reset_containers(m);
4134 c = message_get_container(m);
4136 c = message_get_container(m);
4138 c->offset_index = 0;
4140 m->rindex = c->begin;
4143 return !isempty(c->signature);
4146 static int message_read_ap(
4151 unsigned n_array, n_struct;
4152 TypeStack stack[BUS_CONTAINER_DEPTH];
4153 unsigned stack_ptr = 0;
4154 unsigned n_loop = 0;
4162 /* Ideally, we'd just call ourselves recursively on every
4163 * complex type. However, the state of a va_list that is
4164 * passed to a function is undefined after that function
4165 * returns. This means we need to docode the va_list linearly
4166 * in a single stackframe. We hence implement our own
4167 * home-grown stack in an array. */
4169 n_array = (unsigned) -1; /* lenght of current array entries */
4170 n_struct = strlen(types); /* length of current struct contents signature */
4177 if (n_array == 0 || (n_array == (unsigned) -1 && n_struct == 0)) {
4178 r = type_stack_pop(stack, ELEMENTSOF(stack), &stack_ptr, &types, &n_struct, &n_array);
4184 r = sd_bus_message_exit_container(m);
4192 if (n_array != (unsigned) -1)
4201 case SD_BUS_TYPE_BYTE:
4202 case SD_BUS_TYPE_BOOLEAN:
4203 case SD_BUS_TYPE_INT16:
4204 case SD_BUS_TYPE_UINT16:
4205 case SD_BUS_TYPE_INT32:
4206 case SD_BUS_TYPE_UINT32:
4207 case SD_BUS_TYPE_INT64:
4208 case SD_BUS_TYPE_UINT64:
4209 case SD_BUS_TYPE_DOUBLE:
4210 case SD_BUS_TYPE_STRING:
4211 case SD_BUS_TYPE_OBJECT_PATH:
4212 case SD_BUS_TYPE_SIGNATURE:
4213 case SD_BUS_TYPE_UNIX_FD: {
4216 p = va_arg(ap, void*);
4217 r = sd_bus_message_read_basic(m, *t, p);
4230 case SD_BUS_TYPE_ARRAY: {
4233 r = signature_element_length(t + 1, &k);
4239 memcpy(s, t + 1, k);
4242 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, s);
4253 if (n_array == (unsigned) -1) {
4258 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4264 n_array = va_arg(ap, unsigned);
4269 case SD_BUS_TYPE_VARIANT: {
4272 s = va_arg(ap, const char *);
4276 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_VARIANT, s);
4286 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4291 n_struct = strlen(s);
4292 n_array = (unsigned) -1;
4297 case SD_BUS_TYPE_STRUCT_BEGIN:
4298 case SD_BUS_TYPE_DICT_ENTRY_BEGIN: {
4301 r = signature_element_length(t, &k);
4307 memcpy(s, t + 1, k - 2);
4310 r = sd_bus_message_enter_container(m, *t == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY, s);
4320 if (n_array == (unsigned) -1) {
4325 r = type_stack_push(stack, ELEMENTSOF(stack), &stack_ptr, types, n_struct, n_array);
4331 n_array = (unsigned) -1;
4344 _public_ int sd_bus_message_read(sd_bus_message *m, const char *types, ...) {
4348 assert_return(m, -EINVAL);
4349 assert_return(m->sealed, -EPERM);
4350 assert_return(types, -EINVAL);
4352 va_start(ap, types);
4353 r = message_read_ap(m, types, ap);
4359 _public_ int sd_bus_message_skip(sd_bus_message *m, const char *types) {
4362 assert_return(m, -EINVAL);
4363 assert_return(m->sealed, -EPERM);
4364 assert_return(types, -EINVAL);
4371 case SD_BUS_TYPE_BYTE:
4372 case SD_BUS_TYPE_BOOLEAN:
4373 case SD_BUS_TYPE_INT16:
4374 case SD_BUS_TYPE_UINT16:
4375 case SD_BUS_TYPE_INT32:
4376 case SD_BUS_TYPE_UINT32:
4377 case SD_BUS_TYPE_INT64:
4378 case SD_BUS_TYPE_UINT64:
4379 case SD_BUS_TYPE_DOUBLE:
4380 case SD_BUS_TYPE_STRING:
4381 case SD_BUS_TYPE_OBJECT_PATH:
4382 case SD_BUS_TYPE_SIGNATURE:
4383 case SD_BUS_TYPE_UNIX_FD:
4385 r = sd_bus_message_read_basic(m, *types, NULL);
4389 r = sd_bus_message_skip(m, types + 1);
4395 case SD_BUS_TYPE_ARRAY: {
4398 r = signature_element_length(types + 1, &k);
4404 memcpy(s, types+1, k);
4407 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, s);
4412 r = sd_bus_message_skip(m, s);
4419 r = sd_bus_message_exit_container(m);
4424 r = sd_bus_message_skip(m, types + 1 + k);
4431 case SD_BUS_TYPE_VARIANT: {
4432 const char *contents;
4435 r = sd_bus_message_peek_type(m, &x, &contents);
4439 if (x != SD_BUS_TYPE_VARIANT)
4442 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_VARIANT, contents);
4446 r = sd_bus_message_skip(m, contents);
4451 r = sd_bus_message_exit_container(m);
4455 r = sd_bus_message_skip(m, types + 1);
4462 case SD_BUS_TYPE_STRUCT_BEGIN:
4463 case SD_BUS_TYPE_DICT_ENTRY_BEGIN: {
4466 r = signature_element_length(types, &k);
4472 memcpy(s, types+1, k-2);
4475 r = sd_bus_message_enter_container(m, *types == SD_BUS_TYPE_STRUCT_BEGIN ? SD_BUS_TYPE_STRUCT : SD_BUS_TYPE_DICT_ENTRY, s);
4479 r = sd_bus_message_skip(m, s);
4484 r = sd_bus_message_exit_container(m);
4489 r = sd_bus_message_skip(m, types + k);
4501 _public_ int sd_bus_message_read_array(sd_bus_message *m,
4505 struct bus_container *c;
4511 assert_return(m, -EINVAL);
4512 assert_return(m->sealed, -EPERM);
4513 assert_return(bus_type_is_trivial(type), -EINVAL);
4514 assert_return(ptr, -EINVAL);
4515 assert_return(size, -EINVAL);
4516 assert_return(!BUS_MESSAGE_NEED_BSWAP(m), -ENOTSUP);
4518 r = sd_bus_message_enter_container(m, SD_BUS_TYPE_ARRAY, CHAR_TO_STR(type));
4522 c = message_get_container(m);
4524 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4525 align = bus_gvariant_get_alignment(CHAR_TO_STR(type));
4529 sz = c->end - c->begin;
4531 align = bus_type_get_alignment(type);
4535 sz = BUS_MESSAGE_BSWAP32(m, *c->array_size);
4539 /* Zero length array, let's return some aligned
4540 * pointer that is not NULL */
4541 p = (uint8_t*) NULL + align;
4543 r = message_peek_body(m, &m->rindex, align, sz, &p);
4548 r = sd_bus_message_exit_container(m);
4552 *ptr = (const void*) p;
4558 message_quit_container(m);
4562 static int message_peek_fields(
4573 return buffer_peek(BUS_MESSAGE_FIELDS(m), BUS_MESSAGE_FIELDS_SIZE(m), rindex, align, nbytes, ret);
4576 static int message_peek_field_uint32(
4588 if (BUS_MESSAGE_IS_GVARIANT(m) && item_size != 4)
4591 /* identical for gvariant and dbus1 */
4593 r = message_peek_fields(m, ri, 4, 4, &q);
4598 *ret = BUS_MESSAGE_BSWAP32(m, *(uint32_t*) q);
4603 static int message_peek_field_string(
4605 bool (*validate)(const char *p),
4617 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4622 r = message_peek_fields(m, ri, 1, item_size, &q);
4628 r = message_peek_field_uint32(m, ri, 4, &l);
4632 r = message_peek_fields(m, ri, 1, l+1, &q);
4638 if (!validate_nul(q, l))
4644 if (!validate_string(q, l))
4654 static int message_peek_field_signature(
4667 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4672 r = message_peek_fields(m, ri, 1, item_size, &q);
4678 r = message_peek_fields(m, ri, 1, 1, &q);
4683 r = message_peek_fields(m, ri, 1, l+1, &q);
4688 if (!validate_signature(q, l))
4697 static int message_skip_fields(
4700 uint32_t array_size,
4701 const char **signature) {
4703 size_t original_index;
4709 assert(!BUS_MESSAGE_IS_GVARIANT(m));
4711 original_index = *ri;
4717 if (array_size != (uint32_t) -1 &&
4718 array_size <= *ri - original_index)
4725 if (t == SD_BUS_TYPE_STRING) {
4727 r = message_peek_field_string(m, NULL, ri, 0, NULL);
4733 } else if (t == SD_BUS_TYPE_OBJECT_PATH) {
4735 r = message_peek_field_string(m, object_path_is_valid, ri, 0, NULL);
4741 } else if (t == SD_BUS_TYPE_SIGNATURE) {
4743 r = message_peek_field_signature(m, ri, 0, NULL);
4749 } else if (bus_type_is_basic(t)) {
4752 align = bus_type_get_alignment(t);
4753 k = bus_type_get_size(t);
4754 assert(align > 0 && k > 0);
4756 r = message_peek_fields(m, ri, align, k, NULL);
4762 } else if (t == SD_BUS_TYPE_ARRAY) {
4764 r = signature_element_length(*signature+1, &l);
4774 strncpy(sig, *signature + 1, l-1);
4777 alignment = bus_type_get_alignment(sig[0]);
4781 r = message_peek_field_uint32(m, ri, 0, &nas);
4784 if (nas > BUS_ARRAY_MAX_SIZE)
4787 r = message_peek_fields(m, ri, alignment, 0, NULL);
4791 r = message_skip_fields(m, ri, nas, (const char**) &s);
4796 (*signature) += 1 + l;
4798 } else if (t == SD_BUS_TYPE_VARIANT) {
4801 r = message_peek_field_signature(m, ri, 0, &s);
4805 r = message_skip_fields(m, ri, (uint32_t) -1, (const char**) &s);
4811 } else if (t == SD_BUS_TYPE_STRUCT ||
4812 t == SD_BUS_TYPE_DICT_ENTRY) {
4814 r = signature_element_length(*signature, &l);
4821 strncpy(sig, *signature + 1, l-1);
4824 r = message_skip_fields(m, ri, (uint32_t) -1, (const char**) &s);
4835 int bus_message_parse_fields(sd_bus_message *m) {
4838 uint32_t unix_fds = 0;
4839 void *offsets = NULL;
4840 unsigned n_offsets = 0;
4846 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4849 sz = determine_word_size(BUS_MESSAGE_FIELDS_SIZE(m), 0);
4853 ri = BUS_MESSAGE_FIELDS_SIZE(m) - sz;
4854 r = message_peek_fields(m, &ri, 1, sz, &q);
4858 framing = read_word_le(q, sz);
4859 if (framing >= BUS_MESSAGE_FIELDS_SIZE(m) - sz)
4861 if ((BUS_MESSAGE_FIELDS_SIZE(m) - framing) % sz != 0)
4865 r = message_peek_fields(m, &ri, 1, BUS_MESSAGE_FIELDS_SIZE(m) - framing, &offsets);
4869 n_offsets = (BUS_MESSAGE_FIELDS_SIZE(m) - framing) / sz;
4874 while (ri < BUS_MESSAGE_FIELDS_SIZE(m)) {
4875 _cleanup_free_ char *sig = NULL;
4876 const char *signature;
4878 size_t item_size = (size_t) -1;
4880 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4887 ri = ALIGN_TO(read_word_le((uint8_t*) offsets + (i-1)*sz, sz), 8);
4890 r = message_peek_fields(m, &ri, 8, 1, (void**) &header);
4894 if (BUS_MESSAGE_IS_GVARIANT(m)) {
4899 end = read_word_le((uint8_t*) offsets + i*sz, sz);
4904 where = ri = ALIGN_TO(ri, 8);
4905 item_size = end - ri;
4906 r = message_peek_fields(m, &where, 1, item_size, &q);
4910 b = memrchr(q, 0, item_size);
4914 sig = strndup(b+1, item_size - (b+1-(char*) q));
4919 item_size = b - (char*) q;
4921 r = message_peek_field_signature(m, &ri, 0, &signature);
4927 case _BUS_MESSAGE_HEADER_INVALID:
4930 case BUS_MESSAGE_HEADER_PATH:
4935 if (!streq(signature, "o"))
4938 r = message_peek_field_string(m, object_path_is_valid, &ri, item_size, &m->path);
4941 case BUS_MESSAGE_HEADER_INTERFACE:
4946 if (!streq(signature, "s"))
4949 r = message_peek_field_string(m, interface_name_is_valid, &ri, item_size, &m->interface);
4952 case BUS_MESSAGE_HEADER_MEMBER:
4957 if (!streq(signature, "s"))
4960 r = message_peek_field_string(m, member_name_is_valid, &ri, item_size, &m->member);
4963 case BUS_MESSAGE_HEADER_ERROR_NAME:
4968 if (!streq(signature, "s"))
4971 r = message_peek_field_string(m, error_name_is_valid, &ri, item_size, &m->error.name);
4973 m->error._need_free = -1;
4977 case BUS_MESSAGE_HEADER_DESTINATION:
4982 if (!streq(signature, "s"))
4985 r = message_peek_field_string(m, service_name_is_valid, &ri, item_size, &m->destination);
4988 case BUS_MESSAGE_HEADER_SENDER:
4993 if (!streq(signature, "s"))
4996 r = message_peek_field_string(m, service_name_is_valid, &ri, item_size, &m->sender);
4998 if (r >= 0 && m->sender[0] == ':' && m->bus && m->bus->bus_client && !m->bus->is_kernel) {
4999 m->creds.unique_name = (char*) m->sender;
5000 m->creds.mask |= SD_BUS_CREDS_UNIQUE_NAME & m->bus->creds_mask;
5006 case BUS_MESSAGE_HEADER_SIGNATURE: {
5010 if (m->root_container.signature)
5013 if (!streq(signature, "g"))
5016 r = message_peek_field_signature(m, &ri, item_size, &s);
5024 free(m->root_container.signature);
5025 m->root_container.signature = c;
5029 case BUS_MESSAGE_HEADER_REPLY_SERIAL:
5030 if (m->reply_serial != 0)
5033 if (!streq(signature, "u"))
5036 r = message_peek_field_uint32(m, &ri, item_size, &m->reply_serial);
5040 if (m->reply_serial == 0)
5045 case BUS_MESSAGE_HEADER_UNIX_FDS:
5049 if (!streq(signature, "u"))
5052 r = message_peek_field_uint32(m, &ri, item_size, &unix_fds);
5062 if (!BUS_MESSAGE_IS_GVARIANT(m))
5063 r = message_skip_fields(m, &ri, (uint32_t) -1, (const char **) &signature);
5072 if (m->n_fds != unix_fds)
5075 if (isempty(m->root_container.signature) != (BUS_MESSAGE_BODY_SIZE(m) == 0))
5078 switch (m->header->type) {
5080 case SD_BUS_MESSAGE_SIGNAL:
5081 if (!m->path || !m->interface || !m->member)
5085 case SD_BUS_MESSAGE_METHOD_CALL:
5087 if (!m->path || !m->member)
5092 case SD_BUS_MESSAGE_METHOD_RETURN:
5094 if (m->reply_serial == 0)
5098 case SD_BUS_MESSAGE_METHOD_ERROR:
5100 if (m->reply_serial == 0 || !m->error.name)
5105 m->root_container.end = BUS_MESSAGE_BODY_SIZE(m);
5107 if (BUS_MESSAGE_IS_GVARIANT(m)) {
5108 r = build_struct_offsets(
5110 m->root_container.signature,
5111 BUS_MESSAGE_BODY_SIZE(m),
5112 &m->root_container.item_size,
5113 &m->root_container.offsets,
5114 &m->root_container.n_offsets);
5119 /* Try to read the error message, but if we can't it's a non-issue */
5120 if (m->header->type == SD_BUS_MESSAGE_METHOD_ERROR)
5121 sd_bus_message_read(m, "s", &m->error.message);
5126 _public_ int sd_bus_message_set_destination(sd_bus_message *m, const char *destination) {
5127 assert_return(m, -EINVAL);
5128 assert_return(destination, -EINVAL);
5129 assert_return(!m->sealed, -EPERM);
5130 assert_return(!m->destination, -EEXIST);
5132 return message_append_field_string(m, BUS_MESSAGE_HEADER_DESTINATION, SD_BUS_TYPE_STRING, destination, &m->destination);
5135 int bus_message_get_blob(sd_bus_message *m, void **buffer, size_t *sz) {
5139 struct bus_body_part *part;
5145 total = BUS_MESSAGE_SIZE(m);
5151 e = mempcpy(p, m->header, BUS_MESSAGE_BODY_BEGIN(m));
5152 MESSAGE_FOREACH_PART(part, i, m)
5153 e = mempcpy(e, part->data, part->size);
5155 assert(total == (size_t) ((uint8_t*) e - (uint8_t*) p));
5163 int bus_message_read_strv_extend(sd_bus_message *m, char ***l) {
5169 r = sd_bus_message_enter_container(m, 'a', "s");
5176 r = sd_bus_message_read_basic(m, 's', &s);
5182 r = strv_extend(l, s);
5187 r = sd_bus_message_exit_container(m);
5194 _public_ int sd_bus_message_read_strv(sd_bus_message *m, char ***l) {
5198 assert_return(m, -EINVAL);
5199 assert_return(m->sealed, -EPERM);
5200 assert_return(l, -EINVAL);
5202 r = bus_message_read_strv_extend(m, &strv);
5212 const char* bus_message_get_arg(sd_bus_message *m, unsigned i) {
5214 const char *t = NULL;
5219 r = sd_bus_message_rewind(m, true);
5223 for (j = 0; j <= i; j++) {
5226 r = sd_bus_message_peek_type(m, &type, NULL);
5230 if (type != SD_BUS_TYPE_STRING &&
5231 type != SD_BUS_TYPE_OBJECT_PATH &&
5232 type != SD_BUS_TYPE_SIGNATURE)
5235 r = sd_bus_message_read_basic(m, type, &t);
5243 bool bus_header_is_complete(struct bus_header *h, size_t size) {
5249 if (size < sizeof(struct bus_header))
5252 full = sizeof(struct bus_header) +
5253 (h->endian == BUS_NATIVE_ENDIAN ? h->fields_size : bswap_32(h->fields_size));
5255 return size >= full;
5258 int bus_header_message_size(struct bus_header *h, size_t *sum) {
5264 if (h->endian == BUS_NATIVE_ENDIAN) {
5265 fs = h->fields_size;
5267 } else if (h->endian == BUS_REVERSE_ENDIAN) {
5268 fs = bswap_32(h->fields_size);
5269 bs = bswap_32(h->body_size);
5273 *sum = sizeof(struct bus_header) + ALIGN8(fs) + bs;
5277 _public_ int sd_bus_message_get_errno(sd_bus_message *m) {
5278 assert_return(m, -EINVAL);
5280 if (m->header->type != SD_BUS_MESSAGE_METHOD_ERROR)
5283 return sd_bus_error_get_errno(&m->error);
5286 _public_ const char* sd_bus_message_get_signature(sd_bus_message *m, int complete) {
5287 struct bus_container *c;
5289 assert_return(m, NULL);
5291 c = complete ? &m->root_container : message_get_container(m);
5292 return strempty(c->signature);
5295 _public_ int sd_bus_message_copy(sd_bus_message *m, sd_bus_message *source, int all) {
5296 bool done_something = false;
5299 assert_return(m, -EINVAL);
5300 assert_return(source, -EINVAL);
5301 assert_return(!m->sealed, -EPERM);
5302 assert_return(source->sealed, -EPERM);
5305 const char *contents;
5320 r = sd_bus_message_peek_type(source, &type, &contents);
5326 done_something = true;
5328 if (bus_type_is_container(type) > 0) {
5330 r = sd_bus_message_enter_container(source, type, contents);
5334 r = sd_bus_message_open_container(m, type, contents);
5338 r = sd_bus_message_copy(m, source, true);
5342 r = sd_bus_message_close_container(m);
5346 r = sd_bus_message_exit_container(source);
5353 r = sd_bus_message_read_basic(source, type, &basic);
5359 if (type == SD_BUS_TYPE_OBJECT_PATH ||
5360 type == SD_BUS_TYPE_SIGNATURE ||
5361 type == SD_BUS_TYPE_STRING)
5362 r = sd_bus_message_append_basic(m, type, basic.string);
5364 r = sd_bus_message_append_basic(m, type, &basic);
5371 return done_something;
5374 _public_ int sd_bus_message_verify_type(sd_bus_message *m, char type, const char *contents) {
5379 assert_return(m, -EINVAL);
5380 assert_return(m->sealed, -EPERM);
5381 assert_return(!type || bus_type_is_valid(type), -EINVAL);
5382 assert_return(!contents || signature_is_valid(contents, true), -EINVAL);
5383 assert_return(type || contents, -EINVAL);
5384 assert_return(!contents || !type || bus_type_is_container(type), -EINVAL);
5386 r = sd_bus_message_peek_type(m, &t, &c);
5390 if (type != 0 && type != t)
5393 if (contents && !streq_ptr(contents, c))
5399 _public_ sd_bus *sd_bus_message_get_bus(sd_bus_message *m) {
5400 assert_return(m, NULL);