1 /* -*- mode: C; c-file-style: "gnu" -*- */
2 /* dbus-marshal-recursive.c Marshalling routines for recursive types
4 * Copyright (C) 2004, 2005 Red Hat, Inc.
6 * Licensed under the Academic Free License version 2.1
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "dbus-marshal-recursive.h"
25 #include "dbus-marshal-basic.h"
26 #include "dbus-internals.h"
29 * @addtogroup DBusMarshal
32 #define RECURSIVE_MARSHAL_TRACE 1
34 struct DBusTypeReaderClass
37 int id; /* index in all_reader_classes */
38 dbus_bool_t types_only; /* only iterates over types, not values */
39 void (* recurse) (DBusTypeReader *sub,
40 DBusTypeReader *parent);
41 dbus_bool_t (* check_finished) (const DBusTypeReader *reader);
42 void (* next) (DBusTypeReader *reader,
44 void (* init_from_mark) (DBusTypeReader *reader,
45 const DBusTypeMark *mark);
49 first_type_in_signature (const DBusString *str,
54 t = _dbus_string_get_byte (str, pos);
56 if (t == DBUS_STRUCT_BEGIN_CHAR)
57 return DBUS_TYPE_STRUCT;
63 element_type_get_alignment (const DBusString *str,
66 return _dbus_type_get_alignment (first_type_in_signature (str, pos));
70 reader_init (DBusTypeReader *reader,
72 const DBusString *type_str,
74 const DBusString *value_str,
77 reader->byte_order = byte_order;
78 reader->finished = FALSE;
79 reader->type_str = type_str;
80 reader->type_pos = type_pos;
81 reader->value_str = value_str;
82 reader->value_pos = value_pos;
86 base_reader_recurse (DBusTypeReader *sub,
87 DBusTypeReader *parent)
89 /* point subreader at the same place as parent */
99 struct_types_only_reader_recurse (DBusTypeReader *sub,
100 DBusTypeReader *parent)
102 base_reader_recurse (sub, parent);
104 _dbus_assert (_dbus_string_get_byte (sub->type_str,
105 sub->type_pos) == DBUS_STRUCT_BEGIN_CHAR);
111 struct_reader_recurse (DBusTypeReader *sub,
112 DBusTypeReader *parent)
114 struct_types_only_reader_recurse (sub, parent);
116 /* struct has 8 byte alignment */
117 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
121 array_types_only_reader_recurse (DBusTypeReader *sub,
122 DBusTypeReader *parent)
124 base_reader_recurse (sub, parent);
126 /* point type_pos at the array element type */
129 /* Init with values likely to crash things if misused */
130 sub->u.array.start_pos = _DBUS_INT_MAX;
131 sub->array_len_offset = 7;
135 array_reader_get_array_len (const DBusTypeReader *reader)
137 dbus_uint32_t array_len;
140 /* array_len_offset is the offset back from start_pos to end of the len */
141 len_pos = reader->u.array.start_pos - ((int)reader->array_len_offset) - 4;
143 _dbus_marshal_read_basic (reader->value_str,
150 _dbus_verbose (" reader %p len_pos %d array len %u len_offset %d\n",
151 reader, len_pos, array_len, reader->array_len_offset);
153 _dbus_assert (reader->u.array.start_pos - len_pos - 4 < 8);
159 array_reader_recurse (DBusTypeReader *sub,
160 DBusTypeReader *parent)
165 array_types_only_reader_recurse (sub, parent);
167 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 4);
169 len_pos = sub->value_pos;
171 sub->value_pos += 4; /* for the length */
173 alignment = element_type_get_alignment (sub->type_str,
176 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, alignment);
178 sub->u.array.start_pos = sub->value_pos;
179 _dbus_assert ((sub->u.array.start_pos - (len_pos + 4)) < 8); /* only 3 bits in array_len_offset */
180 sub->array_len_offset = sub->u.array.start_pos - (len_pos + 4);
182 #if RECURSIVE_MARSHAL_TRACE
183 _dbus_verbose (" type reader %p array start = %d len_offset = %d array len = %d array element type = %s\n",
185 sub->u.array.start_pos,
186 sub->array_len_offset,
187 array_reader_get_array_len (sub),
188 _dbus_type_to_string (first_type_in_signature (sub->type_str,
194 variant_reader_recurse (DBusTypeReader *sub,
195 DBusTypeReader *parent)
199 base_reader_recurse (sub, parent);
201 /* Variant is 1 byte sig length (without nul), signature with nul,
202 * padding to 8-boundary, then values
205 sig_len = _dbus_string_get_byte (sub->value_str, sub->value_pos);
207 sub->type_str = sub->value_str;
208 sub->type_pos = sub->value_pos + 1;
210 sub->value_pos = sub->type_pos + sig_len + 1;
212 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
214 #if RECURSIVE_MARSHAL_TRACE
215 _dbus_verbose (" type reader %p variant containing '%s'\n",
217 _dbus_string_get_const_data_len (sub->type_str,
223 array_reader_check_finished (const DBusTypeReader *reader)
227 /* return the array element type if elements remain, and
228 * TYPE_INVALID otherwise
231 end_pos = reader->u.array.start_pos + array_reader_get_array_len (reader);
233 _dbus_assert (reader->value_pos <= end_pos);
234 _dbus_assert (reader->value_pos >= reader->u.array.start_pos);
236 return reader->value_pos == end_pos;
240 skip_one_complete_type (const DBusString *type_str,
243 while (_dbus_string_get_byte (type_str, *type_pos) == DBUS_TYPE_ARRAY)
246 if (_dbus_string_get_byte (type_str, *type_pos) == DBUS_STRUCT_BEGIN_CHAR)
253 switch (_dbus_string_get_byte (type_str, *type_pos))
255 case DBUS_STRUCT_BEGIN_CHAR:
258 case DBUS_STRUCT_END_CHAR:
261 case DBUS_TYPE_INVALID:
262 _dbus_assert_not_reached ("unbalanced parens in signature");
273 find_len_of_complete_type (const DBusString *type_str,
280 skip_one_complete_type (type_str, &end);
282 return end - type_pos;
286 base_reader_next (DBusTypeReader *reader,
289 switch (current_type)
291 case DBUS_TYPE_STRUCT:
292 case DBUS_TYPE_VARIANT:
293 /* Scan forward over the entire container contents */
297 /* Recurse into the struct or variant */
298 _dbus_type_reader_recurse (reader, &sub);
300 /* Skip everything in this subreader */
301 while (_dbus_type_reader_next (&sub))
306 /* Now we are at the end of this container; for variants, the
307 * subreader's type_pos is totally inapplicable (it's in the
308 * value string) but we know that we increment by one past the
311 if (current_type == DBUS_TYPE_VARIANT)
312 reader->type_pos += 1;
314 reader->type_pos = sub.type_pos;
316 if (!reader->klass->types_only)
317 reader->value_pos = sub.value_pos;
321 case DBUS_TYPE_ARRAY:
323 if (!reader->klass->types_only)
324 _dbus_marshal_skip_array (reader->value_str,
325 first_type_in_signature (reader->type_str,
326 reader->type_pos + 1),
330 skip_one_complete_type (reader->type_str, &reader->type_pos);
335 if (!reader->klass->types_only)
336 _dbus_marshal_skip_basic (reader->value_str,
337 current_type, reader->byte_order,
340 reader->type_pos += 1;
346 struct_reader_next (DBusTypeReader *reader,
351 base_reader_next (reader, current_type);
353 /* for STRUCT containers we return FALSE at the end of the struct,
354 * for INVALID we return FALSE at the end of the signature.
355 * In both cases we arrange for get_current_type() to return INVALID
356 * which is defined to happen iff we're at the end (no more next())
358 t = _dbus_string_get_byte (reader->type_str, reader->type_pos);
359 if (t == DBUS_STRUCT_END_CHAR)
361 reader->type_pos += 1;
362 reader->finished = TRUE;
367 array_types_only_reader_next (DBusTypeReader *reader,
370 /* We have one "element" to be iterated over
371 * in each array, which is its element type.
372 * So the finished flag indicates whether we've
373 * iterated over it yet or not.
375 reader->finished = TRUE;
379 array_reader_next (DBusTypeReader *reader,
382 /* Skip one array element */
385 end_pos = reader->u.array.start_pos + array_reader_get_array_len (reader);
387 _dbus_assert (reader->value_pos < end_pos);
388 _dbus_assert (reader->value_pos >= reader->u.array.start_pos);
390 switch (first_type_in_signature (reader->type_str,
393 case DBUS_TYPE_STRUCT:
394 case DBUS_TYPE_VARIANT:
398 /* Recurse into the struct or variant */
399 _dbus_type_reader_recurse (reader, &sub);
401 /* Skip everything in this element */
402 while (_dbus_type_reader_next (&sub))
407 /* Now we are at the end of this element */
408 reader->value_pos = sub.value_pos;
412 case DBUS_TYPE_ARRAY:
414 _dbus_marshal_skip_array (reader->value_str,
415 first_type_in_signature (reader->type_str,
416 reader->type_pos + 1),
424 _dbus_marshal_skip_basic (reader->value_str,
425 current_type, reader->byte_order,
431 _dbus_assert (reader->value_pos <= end_pos);
433 if (reader->value_pos == end_pos)
435 skip_one_complete_type (reader->type_str,
441 array_init_from_mark (DBusTypeReader *reader,
442 const DBusTypeMark *mark)
444 /* Fill in the array-specific fields from the mark. The general
445 * fields are already filled in.
447 reader->u.array.start_pos = mark->array_start_pos;
448 reader->array_len_offset = mark->array_len_offset;
451 static const DBusTypeReaderClass body_reader_class = {
454 NULL, /* body is always toplevel, so doesn't get recursed into */
460 static const DBusTypeReaderClass body_types_only_reader_class = {
463 NULL, /* body is always toplevel, so doesn't get recursed into */
469 static const DBusTypeReaderClass struct_reader_class = {
472 struct_reader_recurse,
478 static const DBusTypeReaderClass struct_types_only_reader_class = {
481 struct_types_only_reader_recurse,
487 static const DBusTypeReaderClass array_reader_class = {
490 array_reader_recurse,
491 array_reader_check_finished,
496 static const DBusTypeReaderClass array_types_only_reader_class = {
499 array_types_only_reader_recurse,
501 array_types_only_reader_next,
505 static const DBusTypeReaderClass variant_reader_class = {
508 variant_reader_recurse,
514 static const DBusTypeReaderClass const *
515 all_reader_classes[] = {
517 &body_types_only_reader_class,
518 &struct_reader_class,
519 &struct_types_only_reader_class,
521 &array_types_only_reader_class,
522 &variant_reader_class
526 _dbus_type_reader_init (DBusTypeReader *reader,
528 const DBusString *type_str,
530 const DBusString *value_str,
533 reader->klass = &body_reader_class;
535 reader_init (reader, byte_order, type_str, type_pos,
536 value_str, value_pos);
538 #if RECURSIVE_MARSHAL_TRACE
539 _dbus_verbose (" type reader %p init type_pos = %d value_pos = %d remaining sig '%s'\n",
540 reader, reader->type_pos, reader->value_pos,
541 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0));
546 _dbus_type_reader_init_from_mark (DBusTypeReader *reader,
548 const DBusString *type_str,
549 const DBusString *value_str,
550 const DBusTypeMark *mark)
552 reader->klass = all_reader_classes[mark->container_type];
554 reader_init (reader, byte_order,
555 mark->type_pos_in_value_str ? value_str : type_str,
557 value_str, mark->value_pos);
559 if (reader->klass->init_from_mark)
560 (* reader->klass->init_from_mark) (reader, mark);
562 #if RECURSIVE_MARSHAL_TRACE
563 _dbus_verbose (" type reader %p init from mark type_pos = %d value_pos = %d remaining sig '%s'\n",
564 reader, reader->type_pos, reader->value_pos,
565 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0));
570 _dbus_type_reader_init_types_only (DBusTypeReader *reader,
571 const DBusString *type_str,
574 reader->klass = &body_types_only_reader_class;
576 reader_init (reader, DBUS_COMPILER_BYTE_ORDER /* irrelevant */,
577 type_str, type_pos, NULL, _DBUS_INT_MAX /* crashes if we screw up */);
579 #if RECURSIVE_MARSHAL_TRACE
580 _dbus_verbose (" type reader %p init types only type_pos = %d remaining sig '%s'\n",
581 reader, reader->type_pos,
582 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0));
587 _dbus_type_reader_init_types_only_from_mark (DBusTypeReader *reader,
588 const DBusString *type_str,
589 const DBusTypeMark *mark)
591 reader->klass = all_reader_classes[mark->container_type];
592 _dbus_assert (reader->klass->types_only);
593 _dbus_assert (!mark->type_pos_in_value_str);
595 reader_init (reader, DBUS_COMPILER_BYTE_ORDER, /* irrelevant */
596 type_str, mark->type_pos,
597 NULL, _DBUS_INT_MAX /* crashes if we screw up */);
599 if (reader->klass->init_from_mark)
600 (* reader->klass->init_from_mark) (reader, mark);
602 #if RECURSIVE_MARSHAL_TRACE
603 _dbus_verbose (" type reader %p init types only from mark type_pos = %d remaining sig '%s'\n",
604 reader, reader->type_pos,
605 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0));
610 _dbus_type_reader_save_mark (const DBusTypeReader *reader,
613 mark->type_pos_in_value_str = (reader->type_str == reader->value_str);
614 mark->container_type = reader->klass->id;
615 _dbus_assert (all_reader_classes[reader->klass->id] == reader->klass);
617 mark->type_pos = reader->type_pos;
618 mark->value_pos = reader->value_pos;
620 /* these are just junk if the reader isn't really an array of course */
621 mark->array_len_offset = reader->array_len_offset;
622 mark->array_start_pos = reader->u.array.start_pos;
626 _dbus_type_reader_get_current_type (const DBusTypeReader *reader)
630 if (reader->finished ||
631 (reader->klass->check_finished &&
632 (* reader->klass->check_finished) (reader)))
633 t = DBUS_TYPE_INVALID;
635 t = first_type_in_signature (reader->type_str,
638 _dbus_assert (t != DBUS_STRUCT_END_CHAR);
639 _dbus_assert (t != DBUS_STRUCT_BEGIN_CHAR);
642 _dbus_verbose (" type reader %p current type_pos = %d type = %s\n",
643 reader, reader->type_pos,
644 _dbus_type_to_string (t));
651 _dbus_type_reader_array_is_empty (const DBusTypeReader *reader)
653 dbus_uint32_t array_len;
655 _dbus_assert (_dbus_type_reader_get_current_type (reader) == DBUS_TYPE_ARRAY);
656 _dbus_assert (!reader->klass->types_only);
658 /* reader is supposed to be at an array child */
659 #if RECURSIVE_MARSHAL_TRACE
660 _dbus_verbose ("checking array len at %d\n", reader->value_pos);
663 _dbus_marshal_read_basic (reader->value_str,
669 #if RECURSIVE_MARSHAL_TRACE
670 _dbus_verbose (" ... array len = %d\n", array_len);
673 return array_len == 0;
677 _dbus_type_reader_read_basic (const DBusTypeReader *reader,
682 _dbus_assert (!reader->klass->types_only);
684 t = _dbus_type_reader_get_current_type (reader);
686 _dbus_marshal_read_basic (reader->value_str,
693 #if RECURSIVE_MARSHAL_TRACE
694 _dbus_verbose (" type reader %p read basic type_pos = %d value_pos = %d remaining sig '%s'\n",
695 reader, reader->type_pos, reader->value_pos,
696 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0));
701 _dbus_type_reader_read_array_of_basic (const DBusTypeReader *reader,
706 _dbus_assert (!reader->klass->types_only);
711 * Initialize a new reader pointing to the first type and
712 * corresponding value that's a child of the current container. It's
713 * an error to call this if the current type is a non-container.
715 * Note that DBusTypeReader traverses values, not types. So if you
716 * have an empty array of array of int, you can't recurse into it. You
717 * can only recurse into each element.
719 * @param reader the reader
720 * @param sub a reader to init pointing to the first child
723 _dbus_type_reader_recurse (DBusTypeReader *reader,
728 t = first_type_in_signature (reader->type_str, reader->type_pos);
732 case DBUS_TYPE_STRUCT:
733 if (reader->klass->types_only)
734 sub->klass = &struct_types_only_reader_class;
736 sub->klass = &struct_reader_class;
738 case DBUS_TYPE_ARRAY:
739 if (reader->klass->types_only)
740 sub->klass = &array_types_only_reader_class;
742 sub->klass = &array_reader_class;
744 case DBUS_TYPE_VARIANT:
745 if (reader->klass->types_only)
746 _dbus_assert_not_reached ("can't recurse into variant typecode");
748 sub->klass = &variant_reader_class;
751 _dbus_verbose ("recursing into type %s\n", _dbus_type_to_string (t));
752 #ifndef DBUS_DISABLE_CHECKS
753 if (t == DBUS_TYPE_INVALID)
754 _dbus_warn ("You can't recurse into an empty array or off the end of a message body\n");
755 #endif /* DBUS_DISABLE_CHECKS */
757 _dbus_assert_not_reached ("don't yet handle recursing into this type");
760 _dbus_assert (sub->klass == all_reader_classes[sub->klass->id]);
762 (* sub->klass->recurse) (sub, reader);
764 #if RECURSIVE_MARSHAL_TRACE
765 _dbus_verbose (" type reader %p RECURSED type_pos = %d value_pos = %d remaining sig '%s'\n",
766 sub, sub->type_pos, sub->value_pos,
767 _dbus_string_get_const_data_len (sub->type_str, sub->type_pos, 0));
772 * Skip to the next value on this "level". e.g. the next field in a
773 * struct, the next value in an array. Returns FALSE at the end of the
776 * @param reader the reader
777 * @returns FALSE if nothing more to read at or below this level
780 _dbus_type_reader_next (DBusTypeReader *reader)
784 t = _dbus_type_reader_get_current_type (reader);
786 #if RECURSIVE_MARSHAL_TRACE
787 _dbus_verbose (" type reader %p START next() { type_pos = %d value_pos = %d remaining sig '%s' current_type = %s\n",
788 reader, reader->type_pos, reader->value_pos,
789 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0),
790 _dbus_type_to_string (t));
793 if (t == DBUS_TYPE_INVALID)
796 (* reader->klass->next) (reader, t);
798 #if RECURSIVE_MARSHAL_TRACE
799 _dbus_verbose (" type reader %p END next() type_pos = %d value_pos = %d remaining sig '%s' current_type = %s\n",
800 reader, reader->type_pos, reader->value_pos,
801 _dbus_string_get_const_data_len (reader->type_str, reader->type_pos, 0),
802 _dbus_type_to_string (_dbus_type_reader_get_current_type (reader)));
805 return _dbus_type_reader_get_current_type (reader) != DBUS_TYPE_INVALID;
809 * Check whether there's another value on this "level". e.g. the next
810 * field in a struct, the next value in an array. Returns FALSE at the
811 * end of the current container.
813 * You probably don't want to use this; it makes for an awkward for/while
814 * loop. A nicer one is "while ((current_type = get_current_type()) != INVALID)"
816 * @param reader the reader
817 * @returns FALSE if nothing more to read at or below this level
820 _dbus_type_reader_has_next (const DBusTypeReader *reader)
822 /* Not efficient but works for now. */
826 return _dbus_type_reader_next (©);
830 * Gets the string and range of said string containing the signature
831 * of the current value. Essentially a more complete version of
832 * _dbus_type_reader_get_current_type() (returns the full type
833 * rather than only the outside of the onion).
835 * Note though that the first byte in a struct signature is
836 * #DBUS_STRUCT_BEGIN_CHAR while the current type will be
837 * #DBUS_TYPE_STRUCT so it isn't true that the first byte of the
838 * signature is always the same as the current type. Another
839 * difference is that this function will still return a signature when
840 * inside an empty array; say you recurse into empty array of int32,
841 * the signature is "i" but the current type will always be
842 * #DBUS_TYPE_INVALID since there are no elements to be currently
845 * @param reader the reader
846 * @param str_p place to return the string with the type in it
847 * @param start_p place to return start of the type
848 * @param len_p place to return the length of the type
851 _dbus_type_reader_get_signature (const DBusTypeReader *reader,
852 const DBusString **str_p,
856 *str_p = reader->type_str;
857 *start_p = reader->type_pos;
858 *len_p = find_len_of_complete_type (reader->type_str, reader->type_pos);
862 reader_set_basic_fixed_length (DBusTypeReader *reader,
866 _dbus_marshal_set_basic ((DBusString*) reader->value_str,
875 * Sets a new value for the basic type pointed to by the reader,
876 * leaving the reader valid to continue reading. Any other readers may
877 * of course be invalidated if you set a variable-length type such as
880 * The provided realign_root is the reader to start from when
881 * realigning the data that follows the newly-set value. The reader
882 * parameter must point to a value below the realign_root parameter.
883 * If the type being set is fixed-length, then realign_root may be
884 * #NULL. Only values reachable from realign_root will be realigned,
885 * so if your string contains other values you will need to deal with
886 * those somehow yourself. It is OK if realign_root is the same
887 * reader as the reader parameter, though if you aren't setting the
888 * root it may not be such a good idea.
890 * @todo DBusTypeReader currently takes "const" versions of the type
891 * and value strings, and this function modifies those strings by
892 * casting away the const, which is of course bad if we want to get
893 * picky. (To be truly clean you'd have an object which contained the
894 * type and value strings and set_basic would be a method on that
895 * object... this would also make DBusTypeReader the same thing as
896 * DBusTypeMark. But since DBusMessage is effectively that object for
897 * D-BUS it doesn't seem worth creating some random object.)
899 * @param reader reader indicating where to set a new value
900 * @param value address of the value to set
901 * @param realign_root realign from here
902 * @returns #FALSE if not enough memory
905 _dbus_type_reader_set_basic (DBusTypeReader *reader,
907 const DBusTypeReader *realign_root)
914 current_type = _dbus_type_reader_get_current_type (reader);
916 _dbus_assert (_dbus_type_is_basic (current_type));
918 if (!_dbus_type_length_varies (current_type))
920 reader_set_basic_fixed_length (reader, current_type, value);
924 _dbus_assert (realign_root != NULL);
926 /* In the harder case, we have to fix alignment after we insert.
927 * The basic strategy is as follows:
929 * - pad a new string to have the same alignment as the
930 * start of the current basic value
931 * - write the new basic value
932 * - copy from the original reader to the new string,
933 * which will fix the alignment of types following
935 * - this copy has to start at realign_root,
936 * but not really write anything until it
937 * passes the value being set
938 * - as an optimization, we can stop copying
939 * when the source and dest values are both
940 * on an 8-boundary, since we know all following
941 * padding and alignment will be identical
942 * - copy the new string back to the original
943 * string, replacing the relevant part of the
947 /* FIXME I don't know how to implement this exactly, since
948 * DBusTypeWriter can't write children of a value without writing
949 * the entire parent value, and so we can't copy only the stuff
950 * following the new value.
953 * - add 'values only' mode to the writer (which essentially
954 * just sets type_pos_is_expectation on the toplevel)
955 * - add 'don't write for now' mode that can be toggled;
956 * - implement a write_reader that uses those things to
977 * Initialize a write iterator, which is used to write out values in
978 * serialized D-BUS format.
980 * The type_pos passed in is expected to be inside an already-valid,
981 * though potentially empty, type signature. This means that the byte
982 * after type_pos must be either #DBUS_TYPE_INVALID (aka nul) or some
983 * other valid type. #DBusTypeWriter won't enforce that the signature
984 * is already valid (you can append the nul byte at the end if you
985 * like), but just be aware that you need the nul byte eventually and
986 * #DBusTypeWriter isn't going to write it for you.
988 * @param writer the writer to init
989 * @param byte_order the byte order to marshal into
990 * @param type_str the string to write typecodes into
991 * @param type_pos where to insert typecodes
992 * @param value_str the string to write values into
993 * @param value_pos where to insert values
997 _dbus_type_writer_init (DBusTypeWriter *writer,
999 DBusString *type_str,
1001 DBusString *value_str,
1004 writer->byte_order = byte_order;
1005 writer->type_str = type_str;
1006 writer->type_pos = type_pos;
1007 writer->value_str = value_str;
1008 writer->value_pos = value_pos;
1009 writer->container_type = DBUS_TYPE_INVALID;
1010 writer->type_pos_is_expectation = FALSE;
1012 #if RECURSIVE_MARSHAL_TRACE
1013 _dbus_verbose ("writer %p init remaining sig '%s'\n", writer,
1014 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1019 * Like _dbus_type_writer_init(), except the type string
1020 * passed in should correspond to an existing signature that
1021 * matches what you're going to write out. The writer will
1022 * check what you write vs. this existing signature.
1024 * @param writer the writer to init
1025 * @param byte_order the byte order to marshal into
1026 * @param type_str the string with signature
1027 * @param type_pos start of signature
1028 * @param value_str the string to write values into
1029 * @param value_pos where to insert values
1033 _dbus_type_writer_init_values_only (DBusTypeWriter *writer,
1035 const DBusString *type_str,
1037 DBusString *value_str,
1040 _dbus_type_writer_init (writer, byte_order,
1041 (DBusString*)type_str, type_pos,
1042 value_str, value_pos);
1044 writer->type_pos_is_expectation = TRUE;
1048 _dbus_type_writer_write_basic_no_typecode (DBusTypeWriter *writer,
1052 return _dbus_marshal_write_basic (writer->value_str,
1057 &writer->value_pos);
1060 /* If our parent is an array, things are a little bit complicated.
1062 * The parent must have a complete element type, such as
1063 * "i" or "aai" or "(ii)" or "a(ii)". There can't be
1064 * unclosed parens, or an "a" with no following type.
1066 * To recurse, the only allowed operation is to recurse into the
1067 * first type in the element type. So for "i" you can't recurse, for
1068 * "ai" you can recurse into the array, for "(ii)" you can recurse
1071 * If you recurse into the array for "ai", then you must specify
1072 * "i" for the element type of the array you recurse into.
1074 * While inside an array at any level, we need to avoid writing to
1075 * type_str, since the type only appears once for the whole array,
1076 * it does not appear for each array element.
1078 * While inside an array type_pos points to the expected next
1079 * typecode, rather than the next place we could write a typecode.
1082 writer_recurse_init_and_check (DBusTypeWriter *writer,
1084 DBusTypeWriter *sub)
1086 _dbus_type_writer_init (sub,
1093 sub->container_type = container_type;
1095 if (writer->type_pos_is_expectation ||
1096 (sub->container_type == DBUS_TYPE_ARRAY || sub->container_type == DBUS_TYPE_VARIANT))
1097 sub->type_pos_is_expectation = TRUE;
1099 sub->type_pos_is_expectation = FALSE;
1101 #ifndef DBUS_DISABLE_CHECKS
1102 if (writer->type_pos_is_expectation)
1106 expected = first_type_in_signature (writer->type_str, writer->type_pos);
1108 if (expected != sub->container_type)
1110 _dbus_warn ("Writing an element of type %s, but the expected type here is %s\n",
1111 _dbus_type_to_string (sub->container_type),
1112 _dbus_type_to_string (expected));
1113 _dbus_assert_not_reached ("bad array element or variant content written");
1116 #endif /* DBUS_DISABLE_CHECKS */
1118 #if RECURSIVE_MARSHAL_TRACE
1119 _dbus_verbose (" type writer %p recurse parent %s type_pos = %d value_pos = %d is_expectation = %d remaining sig '%s'\n",
1121 _dbus_type_to_string (writer->container_type),
1122 writer->type_pos, writer->value_pos, writer->type_pos_is_expectation,
1123 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1124 _dbus_verbose (" type writer %p recurse sub %s type_pos = %d value_pos = %d is_expectation = %d\n",
1126 _dbus_type_to_string (sub->container_type),
1127 sub->type_pos, sub->value_pos,
1128 sub->type_pos_is_expectation);
1133 write_or_verify_typecode (DBusTypeWriter *writer,
1136 /* A subwriter inside an array or variant will have type_pos
1137 * pointing to the expected typecode; a writer not inside an array
1138 * or variant has type_pos pointing to the next place to insert a
1141 #if RECURSIVE_MARSHAL_TRACE
1142 _dbus_verbose (" type writer %p write_or_verify start type_pos = %d remaining sig '%s'\n",
1143 writer, writer->type_pos,
1144 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1147 if (writer->type_pos_is_expectation)
1149 #ifndef DBUS_DISABLE_CHECKS
1153 expected = _dbus_string_get_byte (writer->type_str, writer->type_pos);
1155 if (expected != typecode)
1157 _dbus_warn ("Array or variant type requires that type %s be written, but %s was written\n",
1158 _dbus_type_to_string (expected), _dbus_type_to_string (typecode));
1159 _dbus_assert_not_reached ("bad type inserted somewhere inside an array or variant");
1162 #endif /* DBUS_DISABLE_CHECKS */
1164 /* if immediately inside an array we'd always be appending an element,
1165 * so the expected type doesn't change; if inside a struct or something
1166 * below an array, we need to move through said struct or something.
1168 if (writer->container_type != DBUS_TYPE_ARRAY)
1169 writer->type_pos += 1;
1173 if (!_dbus_string_insert_byte (writer->type_str,
1178 writer->type_pos += 1;
1181 #if RECURSIVE_MARSHAL_TRACE
1182 _dbus_verbose (" type writer %p write_or_verify end type_pos = %d remaining sig '%s'\n",
1183 writer, writer->type_pos,
1184 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1191 writer_recurse_struct (DBusTypeWriter *writer,
1192 const DBusString *contained_type,
1193 int contained_type_start,
1194 int contained_type_len,
1195 DBusTypeWriter *sub)
1197 /* FIXME right now contained_type is ignored; we could probably
1198 * almost trivially fix the code so if it's present we
1199 * write it out and then set type_pos_is_expectation
1202 /* Ensure that we'll be able to add alignment padding and the typecode */
1203 if (!_dbus_string_alloc_space (sub->value_str, 8))
1206 if (!_dbus_string_alloc_space (sub->type_str, 1))
1209 if (!write_or_verify_typecode (sub, DBUS_STRUCT_BEGIN_CHAR))
1210 _dbus_assert_not_reached ("failed to insert struct typecode after prealloc");
1212 if (!_dbus_string_insert_bytes (sub->value_str,
1214 _DBUS_ALIGN_VALUE (sub->value_pos, 8) - sub->value_pos,
1216 _dbus_assert_not_reached ("should not have failed to insert alignment padding for struct");
1217 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
1224 writer_recurse_array (DBusTypeWriter *writer,
1225 const DBusString *contained_type,
1226 int contained_type_start,
1227 int contained_type_len,
1228 DBusTypeWriter *sub)
1230 dbus_uint32_t value = 0;
1234 #ifndef DBUS_DISABLE_CHECKS
1235 if (writer->container_type == DBUS_TYPE_ARRAY)
1237 if (!_dbus_string_equal_substring (contained_type,
1238 contained_type_start,
1241 writer->u.array.element_type_pos + 1))
1243 _dbus_warn ("Writing an array of '%s' but this is incompatible with the expected type of elements in the parent array\n",
1244 _dbus_string_get_const_data_len (contained_type,
1245 contained_type_start,
1246 contained_type_len));
1247 _dbus_assert_not_reached ("incompatible type for child array");
1250 #endif /* DBUS_DISABLE_CHECKS */
1252 /* 3 pad + 4 bytes for the array length, and 4 bytes possible padding
1253 * before array values
1255 if (!_dbus_string_alloc_space (sub->value_str, 3 + 4 + 4))
1258 sub->type_pos += 1; /* move to point to the element type, since type_pos
1259 * should be the expected type for further writes
1261 sub->u.array.element_type_pos = sub->type_pos;
1263 if (!writer->type_pos_is_expectation)
1265 /* sub is a toplevel/outermost array so we need to write the type data */
1267 /* alloc space for array typecode, element signature */
1268 if (!_dbus_string_alloc_space (writer->type_str, 1 + contained_type_len))
1271 if (!_dbus_string_insert_byte (writer->type_str,
1274 _dbus_assert_not_reached ("failed to insert array typecode after prealloc");
1276 if (!_dbus_string_copy_len (contained_type,
1277 contained_type_start, contained_type_len,
1279 sub->u.array.element_type_pos))
1280 _dbus_assert_not_reached ("should not have failed to insert array element typecodes");
1283 /* If the parent is an array, we hold type_pos pointing at the array element type;
1284 * otherwise advance it to reflect the array value we just recursed into
1286 if (writer->container_type != DBUS_TYPE_ARRAY)
1287 writer->type_pos += 1 + contained_type_len;
1289 _dbus_assert (writer->type_pos_is_expectation); /* because it's an array */
1291 /* Write the length */
1292 sub->u.array.len_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 4);
1294 if (!_dbus_type_writer_write_basic_no_typecode (sub, DBUS_TYPE_UINT32,
1296 _dbus_assert_not_reached ("should not have failed to insert array len");
1298 _dbus_assert (sub->u.array.len_pos == sub->value_pos - 4);
1300 /* Write alignment padding for array elements
1301 * Note that we write the padding *even for empty arrays*
1302 * to avoid wonky special cases
1304 alignment = element_type_get_alignment (contained_type, contained_type_start);
1306 aligned = _DBUS_ALIGN_VALUE (sub->value_pos, alignment);
1307 if (aligned != sub->value_pos)
1309 if (!_dbus_string_insert_bytes (sub->value_str,
1311 aligned - sub->value_pos,
1313 _dbus_assert_not_reached ("should not have failed to insert alignment padding");
1315 sub->value_pos = aligned;
1317 sub->u.array.start_pos = sub->value_pos;
1319 _dbus_assert (sub->u.array.start_pos == sub->value_pos);
1320 _dbus_assert (sub->u.array.len_pos < sub->u.array.start_pos);
1322 #if RECURSIVE_MARSHAL_TRACE
1323 _dbus_verbose (" type writer %p recurse array done remaining sig '%s' array start_pos = %d len_pos = %d\n", sub,
1324 _dbus_string_get_const_data_len (sub->type_str, sub->type_pos, 0),
1325 sub->u.array.start_pos, sub->u.array.len_pos);
1331 /* Variant value will normally have:
1332 * 1 byte signature length not including nul
1333 * signature typecodes (nul terminated)
1334 * padding to 8-boundary
1335 * body according to signature
1337 * The signature string can only have a single type
1338 * in it but that type may be complex/recursive.
1340 * So a typical variant type with the integer 3 will have these
1342 * 0x1 'i' '\0' [padding to 8-boundary] 0x0 0x0 0x0 0x3
1344 * For an array of 4-byte types stuffed into variants, the padding to
1345 * 8-boundary is only the 1 byte that is required for the 4-boundary
1346 * anyhow for all array elements after the first one. And for single
1347 * variants in isolation, wasting a few bytes is hardly a big deal.
1349 * The main world of hurt for writing out a variant is that the type
1350 * string is the same string as the value string. Which means
1351 * inserting to the type string will move the value_pos; and it means
1352 * that inserting to the type string could break type alignment.
1354 * This type alignment issue is why the body of the variant is always
1355 * 8-aligned. Then we know that re-8-aligning the start of the body
1356 * will always correctly align the full contents of the variant type.
1359 writer_recurse_variant (DBusTypeWriter *writer,
1360 const DBusString *contained_type,
1361 int contained_type_start,
1362 int contained_type_len,
1363 DBusTypeWriter *sub)
1365 /* Allocate space for the worst case, which is 1 byte sig
1366 * length, nul byte at end of sig, and 7 bytes padding to
1369 if (!_dbus_string_alloc_space (sub->value_str, contained_type_len + 9))
1372 /* write VARIANT typecode to the parent's type string */
1373 if (!write_or_verify_typecode (writer, DBUS_TYPE_VARIANT))
1376 if (!_dbus_string_insert_byte (sub->value_str,
1378 contained_type_len))
1379 _dbus_assert_not_reached ("should not have failed to insert variant type sig len");
1381 sub->value_pos += 1;
1383 /* Here we switch over to the expected type sig we're about to write */
1384 sub->type_str = sub->value_str;
1385 sub->type_pos = sub->value_pos;
1387 if (!_dbus_string_copy_len (contained_type, contained_type_start, contained_type_len,
1388 sub->value_str, sub->value_pos))
1389 _dbus_assert_not_reached ("should not have failed to insert variant type sig");
1391 sub->value_pos += contained_type_len;
1393 if (!_dbus_string_insert_byte (sub->value_str,
1396 _dbus_assert_not_reached ("should not have failed to insert variant type nul termination");
1398 sub->value_pos += 1;
1400 if (!_dbus_string_insert_bytes (sub->value_str,
1402 _DBUS_ALIGN_VALUE (sub->value_pos, 8) - sub->value_pos,
1404 _dbus_assert_not_reached ("should not have failed to insert alignment padding for variant body");
1405 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
1411 _dbus_type_writer_recurse_contained_len (DBusTypeWriter *writer,
1413 const DBusString *contained_type,
1414 int contained_type_start,
1415 int contained_type_len,
1416 DBusTypeWriter *sub)
1418 writer_recurse_init_and_check (writer, container_type, sub);
1420 switch (container_type)
1422 case DBUS_TYPE_STRUCT:
1423 return writer_recurse_struct (writer,
1424 contained_type, contained_type_start, contained_type_len,
1427 case DBUS_TYPE_ARRAY:
1428 return writer_recurse_array (writer,
1429 contained_type, contained_type_start, contained_type_len,
1432 case DBUS_TYPE_VARIANT:
1433 return writer_recurse_variant (writer,
1434 contained_type, contained_type_start, contained_type_len,
1438 _dbus_assert_not_reached ("tried to recurse into type that doesn't support that");
1445 _dbus_type_writer_recurse (DBusTypeWriter *writer,
1447 const DBusString *contained_type,
1448 int contained_type_start,
1449 DBusTypeWriter *sub)
1451 int contained_type_len;
1454 contained_type_len = find_len_of_complete_type (contained_type, contained_type_start);
1456 contained_type_len = 0;
1458 return _dbus_type_writer_recurse_contained_len (writer, container_type,
1460 contained_type_start,
1466 _dbus_type_writer_unrecurse (DBusTypeWriter *writer,
1467 DBusTypeWriter *sub)
1469 _dbus_assert (sub->type_pos > 0); /* can't be recursed if this fails */
1471 /* type_pos_is_expectation never gets unset once set, or we'd get all hosed */
1472 _dbus_assert (!writer->type_pos_is_expectation ||
1473 (writer->type_pos_is_expectation && sub->type_pos_is_expectation));
1475 #if RECURSIVE_MARSHAL_TRACE
1476 _dbus_verbose (" type writer %p unrecurse type_pos = %d value_pos = %d is_expectation = %d container_type = %s\n",
1477 writer, writer->type_pos, writer->value_pos, writer->type_pos_is_expectation,
1478 _dbus_type_to_string (writer->container_type));
1479 _dbus_verbose (" type writer %p unrecurse sub type_pos = %d value_pos = %d is_expectation = %d container_type = %s\n",
1480 sub, sub->type_pos, sub->value_pos,
1481 sub->type_pos_is_expectation,
1482 _dbus_type_to_string (sub->container_type));
1485 if (sub->container_type == DBUS_TYPE_STRUCT)
1487 if (!write_or_verify_typecode (sub, DBUS_STRUCT_END_CHAR))
1490 else if (sub->container_type == DBUS_TYPE_ARRAY)
1494 /* Set the array length */
1495 len = sub->value_pos - sub->u.array.start_pos;
1496 _dbus_marshal_set_uint32 (sub->value_str,
1497 sub->u.array.len_pos,
1500 #if RECURSIVE_MARSHAL_TRACE
1501 _dbus_verbose (" filled in sub array len to %u at len_pos %d\n",
1502 len, sub->u.array.len_pos);
1506 /* Now get type_pos right for the parent writer. Here are the cases:
1508 * Cases !writer->type_pos_is_expectation:
1509 * (in these cases we want to update to the new insertion point)
1511 * - if we recursed into a STRUCT then we didn't know in advance
1512 * what the types in the struct would be; so we have to fill in
1513 * that information now.
1514 * writer->type_pos = sub->type_pos
1516 * - if we recursed into anything else, we knew the full array
1517 * type, or knew the single typecode marking VARIANT, so
1518 * writer->type_pos is already correct.
1519 * writer->type_pos should remain as-is
1521 * - note that the parent is never an ARRAY or VARIANT, if it were
1522 * then type_pos_is_expectation would be TRUE. The parent
1523 * is thus known to be a toplevel or STRUCT.
1525 * Cases where writer->type_pos_is_expectation:
1526 * (in these cases we want to update to next expected type to write)
1528 * - we recursed from STRUCT into STRUCT and we didn't increment
1529 * type_pos in the parent just to stay consistent with the
1530 * !writer->type_pos_is_expectation case (though we could
1531 * special-case this in recurse_struct instead if we wanted)
1532 * writer->type_pos = sub->type_pos
1534 * - we recursed from STRUCT into ARRAY or VARIANT and type_pos
1535 * for parent should have been incremented already
1536 * writer->type_pos should remain as-is
1538 * - we recursed from ARRAY into a sub-element, so type_pos in the
1539 * parent is the element type and should remain the element type
1540 * for the benefit of the next child element
1541 * writer->type_pos should remain as-is
1543 * - we recursed from VARIANT into its value, so type_pos in the
1544 * parent makes no difference since there's only one value
1545 * and we just finished writing it and won't use type_pos again
1546 * writer->type_pos should remain as-is
1548 if (sub->container_type == DBUS_TYPE_STRUCT &&
1549 (writer->container_type == DBUS_TYPE_STRUCT ||
1550 writer->container_type == DBUS_TYPE_INVALID))
1552 /* Advance the parent to the next struct field */
1553 writer->type_pos = sub->type_pos;
1556 writer->value_pos = sub->value_pos;
1558 #if RECURSIVE_MARSHAL_TRACE
1559 _dbus_verbose (" type writer %p unrecursed type_pos = %d value_pos = %d remaining sig '%s'\n",
1560 writer, writer->type_pos, writer->value_pos,
1561 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1568 _dbus_type_writer_write_basic (DBusTypeWriter *writer,
1574 /* First ensure that our type realloc will succeed */
1575 if (!_dbus_string_alloc_space (writer->type_str, 1))
1580 if (!_dbus_type_writer_write_basic_no_typecode (writer, type, value))
1583 if (!write_or_verify_typecode (writer, type))
1584 _dbus_assert_not_reached ("failed to write typecode after prealloc");
1589 #if RECURSIVE_MARSHAL_TRACE
1590 _dbus_verbose (" type writer %p basic type_pos = %d value_pos = %d is_expectation = %d\n",
1591 writer, writer->type_pos, writer->value_pos, writer->type_pos_is_expectation);
1598 _dbus_type_writer_write_array (DBusTypeWriter *writer,
1608 * Iterate through all values in the given reader,
1609 * writing a copy of each value to the writer.
1610 * The reader will be moved forward to its end position.
1612 * @param writer the writer to copy to
1613 * @param reader the reader to copy from
1616 _dbus_type_writer_write_reader (DBusTypeWriter *writer,
1617 DBusTypeReader *reader)
1619 DBusTypeWriter orig;
1626 orig_type_len = _dbus_string_get_length (writer->type_str);
1627 orig_value_len = _dbus_string_get_length (writer->value_str);
1629 while ((current_type = _dbus_type_reader_get_current_type (reader)) != DBUS_TYPE_INVALID)
1631 if (_dbus_type_is_container (current_type))
1633 DBusTypeReader subreader;
1634 DBusTypeWriter subwriter;
1635 const DBusString *sig_str;
1639 _dbus_type_reader_recurse (reader, &subreader);
1641 _dbus_type_reader_get_signature (&subreader, &sig_str,
1642 &sig_start, &sig_len);
1644 if (!_dbus_type_writer_recurse_contained_len (writer, current_type,
1645 sig_str, sig_start, sig_len,
1649 if (!_dbus_type_writer_write_reader (&subwriter, &subreader))
1652 if (!_dbus_type_writer_unrecurse (writer, &subwriter))
1659 _dbus_assert (_dbus_type_is_basic (current_type));
1661 _dbus_type_reader_read_basic (reader, &val);
1663 if (!_dbus_type_writer_write_basic (writer, current_type, &val))
1667 _dbus_type_reader_next (reader);
1673 if (!writer->type_pos_is_expectation)
1675 new_bytes = _dbus_string_get_length (writer->type_str) - orig_type_len;
1676 _dbus_string_delete (writer->type_str, orig.type_pos, new_bytes);
1678 new_bytes = _dbus_string_get_length (writer->value_str) - orig_value_len;
1679 _dbus_string_delete (writer->value_str, orig.value_pos, new_bytes);
1686 /** @} */ /* end of DBusMarshal group */
1688 #ifdef DBUS_BUILD_TESTS
1689 #include "dbus-test.h"
1690 #include "dbus-list.h"
1694 /* Whether to do the OOM stuff */
1695 #define TEST_OOM_HANDLING 0
1696 /* We do start offset 0 through 9, to get various alignment cases. Still this
1697 * obviously makes the test suite run 10x as slow.
1699 #define MAX_INITIAL_OFFSET 9
1701 /* Largest iteration count to test copying, realignment,
1702 * etc. with. i.e. we only test this stuff with some of the smaller
1705 #define MAX_ITERATIONS_FOR_EXPENSIVE_TESTS 1000
1711 DBusString signature;
1721 #define N_FENCE_BYTES 5
1722 #define FENCE_BYTES_STR "abcde"
1723 #define INITIAL_PADDING_BYTE '\0'
1726 data_block_init (DataBlock *block,
1730 if (!_dbus_string_init (&block->signature))
1733 if (!_dbus_string_init (&block->body))
1735 _dbus_string_free (&block->signature);
1739 if (!_dbus_string_insert_bytes (&block->signature, 0, initial_offset,
1740 INITIAL_PADDING_BYTE) ||
1741 !_dbus_string_insert_bytes (&block->body, 0, initial_offset,
1742 INITIAL_PADDING_BYTE) ||
1743 !_dbus_string_append (&block->signature, FENCE_BYTES_STR) ||
1744 !_dbus_string_append (&block->body, FENCE_BYTES_STR))
1746 _dbus_string_free (&block->signature);
1747 _dbus_string_free (&block->body);
1751 block->byte_order = byte_order;
1752 block->initial_offset = initial_offset;
1758 data_block_save (DataBlock *block,
1759 DataBlockState *state)
1761 state->saved_sig_len = _dbus_string_get_length (&block->signature) - N_FENCE_BYTES;
1762 state->saved_body_len = _dbus_string_get_length (&block->body) - N_FENCE_BYTES;
1766 data_block_restore (DataBlock *block,
1767 DataBlockState *state)
1769 _dbus_string_delete (&block->signature,
1770 state->saved_sig_len,
1771 _dbus_string_get_length (&block->signature) - state->saved_sig_len - N_FENCE_BYTES);
1772 _dbus_string_delete (&block->body,
1773 state->saved_body_len,
1774 _dbus_string_get_length (&block->body) - state->saved_body_len - N_FENCE_BYTES);
1778 data_block_verify (DataBlock *block)
1780 if (!_dbus_string_ends_with_c_str (&block->signature,
1785 offset = _dbus_string_get_length (&block->signature) - N_FENCE_BYTES - 8;
1789 _dbus_verbose_bytes_of_string (&block->signature,
1791 _dbus_string_get_length (&block->signature) - offset);
1792 _dbus_assert_not_reached ("block did not verify: bad bytes at end of signature");
1794 if (!_dbus_string_ends_with_c_str (&block->body,
1799 offset = _dbus_string_get_length (&block->body) - N_FENCE_BYTES - 8;
1803 _dbus_verbose_bytes_of_string (&block->body,
1805 _dbus_string_get_length (&block->body) - offset);
1806 _dbus_assert_not_reached ("block did not verify: bad bytes at end of body");
1809 _dbus_assert (_dbus_string_validate_nul (&block->signature,
1810 0, block->initial_offset));
1811 _dbus_assert (_dbus_string_validate_nul (&block->body,
1812 0, block->initial_offset));
1816 data_block_free (DataBlock *block)
1818 data_block_verify (block);
1820 _dbus_string_free (&block->signature);
1821 _dbus_string_free (&block->body);
1825 data_block_reset (DataBlock *block)
1827 data_block_verify (block);
1829 _dbus_string_delete (&block->signature,
1830 block->initial_offset,
1831 _dbus_string_get_length (&block->signature) - N_FENCE_BYTES - block->initial_offset);
1832 _dbus_string_delete (&block->body,
1833 block->initial_offset,
1834 _dbus_string_get_length (&block->body) - N_FENCE_BYTES - block->initial_offset);
1836 data_block_verify (block);
1840 data_block_init_reader_writer (DataBlock *block,
1841 DBusTypeReader *reader,
1842 DBusTypeWriter *writer)
1845 _dbus_type_reader_init (reader,
1848 block->initial_offset,
1850 block->initial_offset);
1853 _dbus_type_writer_init (writer,
1856 _dbus_string_get_length (&block->signature) - N_FENCE_BYTES,
1858 _dbus_string_get_length (&block->body) - N_FENCE_BYTES);
1862 real_check_expected_type (DBusTypeReader *reader,
1864 const char *funcname,
1869 t = _dbus_type_reader_get_current_type (reader);
1873 _dbus_warn ("Read type %s while expecting %s at %s line %d\n",
1874 _dbus_type_to_string (t),
1875 _dbus_type_to_string (expected),
1878 _dbus_assert_not_reached ("read wrong type");
1882 #define check_expected_type(reader, expected) real_check_expected_type (reader, expected, _DBUS_FUNCTION_NAME, __LINE__)
1884 #define NEXT_EXPECTING_TRUE(reader) do { if (!_dbus_type_reader_next (reader)) \
1886 _dbus_warn ("_dbus_type_reader_next() should have returned TRUE at %s %d\n", \
1887 _DBUS_FUNCTION_NAME, __LINE__); \
1888 _dbus_assert_not_reached ("test failed"); \
1892 #define NEXT_EXPECTING_FALSE(reader) do { if (_dbus_type_reader_next (reader)) \
1894 _dbus_warn ("_dbus_type_reader_next() should have returned FALSE at %s %d\n", \
1895 _DBUS_FUNCTION_NAME, __LINE__); \
1896 _dbus_assert_not_reached ("test failed"); \
1898 check_expected_type (reader, DBUS_TYPE_INVALID); \
1901 typedef struct TestTypeNode TestTypeNode;
1902 typedef struct TestTypeNodeClass TestTypeNodeClass;
1903 typedef struct TestTypeNodeContainer TestTypeNodeContainer;
1904 typedef struct TestTypeNodeContainerClass TestTypeNodeContainerClass;
1908 const TestTypeNodeClass *klass;
1911 struct TestTypeNodeContainer
1917 struct TestTypeNodeClass
1923 int subclass_detail; /* a bad hack to avoid a bunch of subclass casting */
1925 dbus_bool_t (* construct) (TestTypeNode *node);
1926 void (* destroy) (TestTypeNode *node);
1928 dbus_bool_t (* write_value) (TestTypeNode *node,
1930 DBusTypeWriter *writer,
1932 dbus_bool_t (* read_value) (TestTypeNode *node,
1934 DBusTypeReader *reader,
1936 dbus_bool_t (* build_signature) (TestTypeNode *node,
1940 struct TestTypeNodeContainerClass
1942 TestTypeNodeClass base;
1945 static dbus_bool_t int32_write_value (TestTypeNode *node,
1947 DBusTypeWriter *writer,
1949 static dbus_bool_t int32_read_value (TestTypeNode *node,
1951 DBusTypeReader *reader,
1953 static dbus_bool_t int64_write_value (TestTypeNode *node,
1955 DBusTypeWriter *writer,
1957 static dbus_bool_t int64_read_value (TestTypeNode *node,
1959 DBusTypeReader *reader,
1961 static dbus_bool_t string_write_value (TestTypeNode *node,
1963 DBusTypeWriter *writer,
1965 static dbus_bool_t string_read_value (TestTypeNode *node,
1967 DBusTypeReader *reader,
1969 static dbus_bool_t bool_read_value (TestTypeNode *node,
1971 DBusTypeReader *reader,
1973 static dbus_bool_t bool_write_value (TestTypeNode *node,
1975 DBusTypeWriter *writer,
1977 static dbus_bool_t byte_read_value (TestTypeNode *node,
1979 DBusTypeReader *reader,
1981 static dbus_bool_t byte_write_value (TestTypeNode *node,
1983 DBusTypeWriter *writer,
1985 static dbus_bool_t double_read_value (TestTypeNode *node,
1987 DBusTypeReader *reader,
1989 static dbus_bool_t double_write_value (TestTypeNode *node,
1991 DBusTypeWriter *writer,
1993 static dbus_bool_t object_path_read_value (TestTypeNode *node,
1995 DBusTypeReader *reader,
1997 static dbus_bool_t object_path_write_value (TestTypeNode *node,
1999 DBusTypeWriter *writer,
2001 static dbus_bool_t signature_read_value (TestTypeNode *node,
2003 DBusTypeReader *reader,
2005 static dbus_bool_t signature_write_value (TestTypeNode *node,
2007 DBusTypeWriter *writer,
2009 static dbus_bool_t struct_write_value (TestTypeNode *node,
2011 DBusTypeWriter *writer,
2013 static dbus_bool_t struct_read_value (TestTypeNode *node,
2015 DBusTypeReader *reader,
2017 static dbus_bool_t struct_build_signature (TestTypeNode *node,
2019 static dbus_bool_t array_write_value (TestTypeNode *node,
2021 DBusTypeWriter *writer,
2023 static dbus_bool_t array_read_value (TestTypeNode *node,
2025 DBusTypeReader *reader,
2027 static dbus_bool_t array_build_signature (TestTypeNode *node,
2029 static dbus_bool_t variant_write_value (TestTypeNode *node,
2031 DBusTypeWriter *writer,
2033 static dbus_bool_t variant_read_value (TestTypeNode *node,
2035 DBusTypeReader *reader,
2037 static void container_destroy (TestTypeNode *node);
2040 static const TestTypeNodeClass int32_class = {
2042 sizeof (TestTypeNode),
2051 static const TestTypeNodeClass uint32_class = {
2053 sizeof (TestTypeNode),
2057 int32_write_value, /* recycle from int32 */
2058 int32_read_value, /* recycle from int32 */
2062 static const TestTypeNodeClass int64_class = {
2064 sizeof (TestTypeNode),
2073 static const TestTypeNodeClass uint64_class = {
2075 sizeof (TestTypeNode),
2079 int64_write_value, /* recycle from int64 */
2080 int64_read_value, /* recycle from int64 */
2084 static const TestTypeNodeClass string_0_class = {
2086 sizeof (TestTypeNode),
2087 0, /* string length */
2095 static const TestTypeNodeClass string_1_class = {
2097 sizeof (TestTypeNode),
2098 1, /* string length */
2106 /* with nul, a len 3 string should fill 4 bytes and thus is "special" */
2107 static const TestTypeNodeClass string_3_class = {
2109 sizeof (TestTypeNode),
2110 3, /* string length */
2118 /* with nul, a len 8 string should fill 9 bytes and thus is "special" (far-fetched I suppose) */
2119 static const TestTypeNodeClass string_8_class = {
2121 sizeof (TestTypeNode),
2122 8, /* string length */
2130 static const TestTypeNodeClass bool_class = {
2132 sizeof (TestTypeNode),
2141 static const TestTypeNodeClass byte_class = {
2143 sizeof (TestTypeNode),
2152 static const TestTypeNodeClass double_class = {
2154 sizeof (TestTypeNode),
2163 static const TestTypeNodeClass object_path_class = {
2164 DBUS_TYPE_OBJECT_PATH,
2165 sizeof (TestTypeNode),
2169 object_path_write_value,
2170 object_path_read_value,
2174 static const TestTypeNodeClass signature_class = {
2175 DBUS_TYPE_SIGNATURE,
2176 sizeof (TestTypeNode),
2180 signature_write_value,
2181 signature_read_value,
2185 static const TestTypeNodeClass struct_1_class = {
2187 sizeof (TestTypeNodeContainer),
2188 1, /* number of times children appear as fields */
2193 struct_build_signature
2196 static const TestTypeNodeClass struct_2_class = {
2198 sizeof (TestTypeNodeContainer),
2199 2, /* number of times children appear as fields */
2204 struct_build_signature
2207 static const TestTypeNodeClass array_0_class = {
2209 sizeof (TestTypeNodeContainer),
2210 0, /* number of array elements */
2215 array_build_signature
2218 static const TestTypeNodeClass array_1_class = {
2220 sizeof (TestTypeNodeContainer),
2221 1, /* number of array elements */
2226 array_build_signature
2229 static const TestTypeNodeClass array_2_class = {
2231 sizeof (TestTypeNodeContainer),
2232 2, /* number of array elements */
2237 array_build_signature
2240 static const TestTypeNodeClass array_9_class = {
2242 sizeof (TestTypeNodeContainer),
2243 9, /* number of array elements */
2248 array_build_signature
2251 static const TestTypeNodeClass variant_class = {
2253 sizeof (TestTypeNodeContainer),
2257 variant_write_value,
2262 static const TestTypeNodeClass* const
2278 #define N_BASICS (_DBUS_N_ELEMENTS (basic_nodes))
2280 static const TestTypeNodeClass* const
2281 container_nodes[] = {
2288 /* array_9_class is omitted on purpose, it's too slow;
2289 * we only use it in one hardcoded test below
2292 #define N_CONTAINERS (_DBUS_N_ELEMENTS (container_nodes))
2294 static TestTypeNode*
2295 node_new (const TestTypeNodeClass *klass)
2299 node = dbus_malloc0 (klass->instance_size);
2303 node->klass = klass;
2305 if (klass->construct)
2307 if (!(* klass->construct) (node))
2318 node_destroy (TestTypeNode *node)
2320 if (node->klass->destroy)
2321 (* node->klass->destroy) (node);
2326 node_write_value (TestTypeNode *node,
2328 DBusTypeWriter *writer,
2333 retval = (* node->klass->write_value) (node, block, writer, seed);
2336 /* Handy to see where things break, but too expensive to do all the time */
2337 data_block_verify (block);
2344 node_read_value (TestTypeNode *node,
2346 DBusTypeReader *reader,
2350 DBusTypeReader restored;
2352 _dbus_type_reader_save_mark (reader, &mark);
2354 if (!(* node->klass->read_value) (node, block, reader, seed))
2357 _dbus_type_reader_init_from_mark (&restored,
2363 if (!(* node->klass->read_value) (node, block, &restored, seed))
2370 node_build_signature (TestTypeNode *node,
2373 if (node->klass->build_signature)
2374 return (* node->klass->build_signature) (node, str);
2376 return _dbus_string_append_byte (str, node->klass->typecode);
2380 node_append_child (TestTypeNode *node,
2381 TestTypeNode *child)
2383 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2385 _dbus_assert (node->klass->instance_size >= (int) sizeof (TestTypeNodeContainer));
2387 if (!_dbus_list_append (&container->children, child))
2388 _dbus_assert_not_reached ("no memory"); /* we never check the return value on node_append_child anyhow - it's run from outside the malloc-failure test code */
2393 static int n_iterations_completed_total = 0;
2394 static int n_iterations_completed_this_test = 0;
2395 static int n_iterations_expected_this_test = 0;
2399 const DBusString *signature;
2402 TestTypeNode **nodes;
2404 } NodeIterationData;
2408 run_test_copy (NodeIterationData *nid)
2413 DBusTypeReader reader;
2414 DBusTypeWriter writer;
2416 _dbus_verbose ("%s\n", _DBUS_FUNCTION_NAME);
2422 if (!data_block_init (&dest, src->byte_order, src->initial_offset))
2425 data_block_init_reader_writer (src, &reader, NULL);
2426 data_block_init_reader_writer (&dest, NULL, &writer);
2428 /* DBusTypeWriter assumes it's writing into an existing signature,
2429 * so doesn't add nul on its own. We have to do that.
2431 if (!_dbus_string_insert_byte (&dest.signature,
2432 dest.initial_offset, '\0'))
2435 if (!_dbus_type_writer_write_reader (&writer, &reader))
2438 /* Data blocks should now be identical */
2439 if (!_dbus_string_equal (&src->signature, &dest.signature))
2441 _dbus_verbose ("SOURCE\n");
2442 _dbus_verbose_bytes_of_string (&src->signature, 0,
2443 _dbus_string_get_length (&src->signature));
2444 _dbus_verbose ("DEST\n");
2445 _dbus_verbose_bytes_of_string (&dest.signature, 0,
2446 _dbus_string_get_length (&dest.signature));
2447 _dbus_assert_not_reached ("signatures did not match");
2450 if (!_dbus_string_equal (&src->body, &dest.body))
2452 _dbus_verbose ("SOURCE\n");
2453 _dbus_verbose_bytes_of_string (&src->body, 0,
2454 _dbus_string_get_length (&src->body));
2455 _dbus_verbose ("DEST\n");
2456 _dbus_verbose_bytes_of_string (&dest.body, 0,
2457 _dbus_string_get_length (&dest.body));
2458 _dbus_assert_not_reached ("bodies did not match");
2465 data_block_free (&dest);
2471 run_test_values_only_write (NodeIterationData *nid)
2473 DBusTypeReader reader;
2474 DBusTypeWriter writer;
2479 _dbus_verbose ("%s\n", _DBUS_FUNCTION_NAME);
2483 data_block_reset (nid->block);
2485 sig_len = _dbus_string_get_length (nid->signature);
2487 _dbus_type_writer_init_values_only (&writer,
2488 nid->block->byte_order,
2491 _dbus_string_get_length (&nid->block->body) - N_FENCE_BYTES);
2492 _dbus_type_reader_init (&reader,
2493 nid->block->byte_order,
2496 nid->block->initial_offset);
2499 while (i < nid->n_nodes)
2501 if (!node_write_value (nid->nodes[i], nid->block, &writer, i))
2507 /* if we wrote any typecodes then this would fail */
2508 _dbus_assert (sig_len == _dbus_string_get_length (nid->signature));
2510 /* But be sure we wrote out the values correctly */
2512 while (i < nid->n_nodes)
2514 if (!node_read_value (nid->nodes[i], nid->block, &reader, i))
2517 if (i + 1 == nid->n_nodes)
2518 NEXT_EXPECTING_FALSE (&reader);
2520 NEXT_EXPECTING_TRUE (&reader);
2528 data_block_reset (nid->block);
2533 run_test_nodes_iteration (void *data)
2535 NodeIterationData *nid = data;
2536 DBusTypeReader reader;
2537 DBusTypeWriter writer;
2542 * 1. write the value
2543 * 2. strcmp-compare with the signature we built
2545 * 4. type-iterate the signature and the value and see if they are the same type-wise
2549 data_block_init_reader_writer (nid->block,
2552 /* DBusTypeWriter assumes it's writing into an existing signature,
2553 * so doesn't add nul on its own. We have to do that.
2555 if (!_dbus_string_insert_byte (&nid->block->signature,
2556 nid->type_offset, '\0'))
2560 while (i < nid->n_nodes)
2562 if (!node_write_value (nid->nodes[i], nid->block, &writer, i))
2568 if (!_dbus_string_equal_substring (nid->signature, 0, _dbus_string_get_length (nid->signature),
2569 &nid->block->signature, nid->type_offset))
2571 _dbus_warn ("Expected signature '%s' and got '%s' with initial offset %d\n",
2572 _dbus_string_get_const_data (nid->signature),
2573 _dbus_string_get_const_data_len (&nid->block->signature, nid->type_offset, 0),
2575 _dbus_assert_not_reached ("wrong signature");
2579 while (i < nid->n_nodes)
2581 if (!node_read_value (nid->nodes[i], nid->block, &reader, i))
2584 if (i + 1 == nid->n_nodes)
2585 NEXT_EXPECTING_FALSE (&reader);
2587 NEXT_EXPECTING_TRUE (&reader);
2592 if (n_iterations_expected_this_test <= MAX_ITERATIONS_FOR_EXPENSIVE_TESTS)
2594 if (!run_test_copy (nid))
2597 if (!run_test_values_only_write (nid))
2601 /* FIXME type-iterate both signature and value and compare the resulting
2602 * tree to the node tree perhaps
2609 data_block_reset (nid->block);
2615 run_test_nodes_in_one_configuration (TestTypeNode **nodes,
2617 const DBusString *signature,
2622 NodeIterationData nid;
2624 if (!data_block_init (&block, byte_order, initial_offset))
2625 _dbus_assert_not_reached ("no memory");
2627 nid.signature = signature;
2629 nid.type_offset = initial_offset;
2631 nid.n_nodes = n_nodes;
2633 #if TEST_OOM_HANDLING
2634 _dbus_test_oom_handling ("running test node",
2635 run_test_nodes_iteration,
2638 if (!run_test_nodes_iteration (&nid))
2639 _dbus_assert_not_reached ("no memory");
2642 data_block_free (&block);
2646 run_test_nodes (TestTypeNode **nodes,
2650 DBusString signature;
2652 if (!_dbus_string_init (&signature))
2653 _dbus_assert_not_reached ("no memory");
2658 if (! node_build_signature (nodes[i], &signature))
2659 _dbus_assert_not_reached ("no memory");
2664 _dbus_verbose (">>> test nodes with signature '%s'\n",
2665 _dbus_string_get_const_data (&signature));
2668 while (i <= MAX_INITIAL_OFFSET)
2670 run_test_nodes_in_one_configuration (nodes, n_nodes, &signature,
2671 DBUS_LITTLE_ENDIAN, i);
2672 run_test_nodes_in_one_configuration (nodes, n_nodes, &signature,
2673 DBUS_BIG_ENDIAN, i);
2678 n_iterations_completed_this_test += 1;
2679 n_iterations_completed_total += 1;
2681 if (n_iterations_completed_this_test == n_iterations_expected_this_test)
2683 fprintf (stderr, " 100%% %d this test (%d cumulative)\n",
2684 n_iterations_completed_this_test,
2685 n_iterations_completed_total);
2687 /* this happens to turn out well with mod == 1 */
2688 else if ((n_iterations_completed_this_test %
2689 (int)(n_iterations_expected_this_test / 10.0)) == 1)
2691 fprintf (stderr, " %d%% ", (int) (n_iterations_completed_this_test / (double) n_iterations_expected_this_test * 100));
2694 _dbus_string_free (&signature);
2697 #define N_VALUES (N_BASICS * N_CONTAINERS + N_BASICS)
2699 static TestTypeNode*
2700 value_generator (int *ip)
2703 const TestTypeNodeClass *child_klass;
2704 const TestTypeNodeClass *container_klass;
2705 TestTypeNode *child;
2708 _dbus_assert (i <= N_VALUES);
2714 else if (i < N_BASICS)
2716 node = node_new (basic_nodes[i]);
2720 /* imagine an array:
2721 * container 0 of basic 0
2722 * container 0 of basic 1
2723 * container 0 of basic 2
2724 * container 1 of basic 0
2725 * container 1 of basic 1
2726 * container 1 of basic 2
2730 container_klass = container_nodes[i / N_BASICS];
2731 child_klass = basic_nodes[i % N_BASICS];
2733 node = node_new (container_klass);
2734 child = node_new (child_klass);
2736 node_append_child (node, child);
2739 *ip += 1; /* increment the generator */
2745 make_and_run_values_inside_container (const TestTypeNodeClass *container_klass,
2749 TestTypeNode *container;
2750 TestTypeNode *child;
2753 root = node_new (container_klass);
2755 for (i = 1; i < n_nested; i++)
2757 child = node_new (container_klass);
2758 node_append_child (container, child);
2762 /* container should now be the most-nested container */
2765 while ((child = value_generator (&i)))
2767 node_append_child (container, child);
2769 run_test_nodes (&root, 1);
2771 _dbus_list_clear (&((TestTypeNodeContainer*)container)->children);
2772 node_destroy (child);
2775 node_destroy (root);
2779 start_next_test (const char *format,
2782 n_iterations_completed_this_test = 0;
2783 n_iterations_expected_this_test = expected;
2785 fprintf (stderr, ">>> >>> ");
2786 fprintf (stderr, format,
2787 n_iterations_expected_this_test);
2791 make_and_run_test_nodes (void)
2795 /* We try to do this in order of "complicatedness" so that test
2796 * failures tend to show up in the simplest test case that
2797 * demonstrates the failure. There are also some tests that run
2798 * more than once for this reason, first while going through simple
2799 * cases, second while going through a broader range of complex
2802 /* Each basic node. The basic nodes should include:
2804 * - each fixed-size type (in such a way that it has different values each time,
2805 * so we can tell if we mix two of them up)
2806 * - strings of various lengths
2810 /* Each container node. The container nodes should include:
2812 * struct with 1 and 2 copies of the contained item
2813 * array with 0, 1, 2 copies of the contained item
2816 /* Let a "value" be a basic node, or a container containing a single basic node.
2817 * Let n_values be the number of such values i.e. (n_container * n_basic + n_basic)
2818 * When iterating through all values to make combinations, do the basic types
2819 * first and the containers second.
2821 /* Each item is shown with its number of iterations to complete so
2822 * we can keep a handle on this unit test
2825 /* FIXME test just an empty body, no types at all */
2827 start_next_test ("Each value by itself %d iterations\n", N_VALUES);
2831 while ((node = value_generator (&i)))
2833 run_test_nodes (&node, 1);
2835 node_destroy (node);
2839 start_next_test ("All values in one big toplevel %d iteration\n", 1);
2841 TestTypeNode *nodes[N_VALUES];
2844 while ((nodes[i] = value_generator (&i)))
2847 run_test_nodes (nodes, N_VALUES);
2849 for (i = 0; i < N_VALUES; i++)
2850 node_destroy (nodes[i]);
2853 start_next_test ("Each value,value pair combination as toplevel, in both orders %d iterations\n",
2854 N_VALUES * N_VALUES);
2856 TestTypeNode *nodes[2];
2859 while ((nodes[0] = value_generator (&i)))
2862 while ((nodes[1] = value_generator (&j)))
2864 run_test_nodes (nodes, 2);
2866 node_destroy (nodes[1]);
2869 node_destroy (nodes[0]);
2873 start_next_test ("Each container containing each value %d iterations\n",
2874 N_CONTAINERS * N_VALUES);
2875 for (i = 0; i < N_CONTAINERS; i++)
2877 const TestTypeNodeClass *container_klass = container_nodes[i];
2879 make_and_run_values_inside_container (container_klass, 1);
2882 n_iterations_completed_this_test = 0;
2883 n_iterations_expected_this_test = N_CONTAINERS * N_VALUES;
2884 _dbus_verbose (">>> >>> Each container of same container of each value %d iterations\n",
2885 n_iterations_completed_this_test);
2886 for (i = 0; i < N_CONTAINERS; i++)
2888 const TestTypeNodeClass *container_klass = container_nodes[i];
2890 make_and_run_values_inside_container (container_klass, 2);
2893 start_next_test ("Each container of same container of same container of each value %d iterations\n",
2894 N_CONTAINERS * N_VALUES);
2895 for (i = 0; i < N_CONTAINERS; i++)
2897 const TestTypeNodeClass *container_klass = container_nodes[i];
2899 make_and_run_values_inside_container (container_klass, 3);
2902 start_next_test ("Each value,value pair inside a struct %d iterations\n",
2903 N_VALUES * N_VALUES);
2905 TestTypeNode *val1, *val2;
2908 node = node_new (&struct_1_class);
2911 while ((val1 = value_generator (&i)))
2914 while ((val2 = value_generator (&j)))
2916 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2918 node_append_child (node, val1);
2919 node_append_child (node, val2);
2921 run_test_nodes (&node, 1);
2923 _dbus_list_clear (&container->children);
2924 node_destroy (val2);
2926 node_destroy (val1);
2928 node_destroy (node);
2931 start_next_test ("All values in one big struct %d iteration\n",
2935 TestTypeNode *child;
2937 node = node_new (&struct_1_class);
2940 while ((child = value_generator (&i)))
2941 node_append_child (node, child);
2943 run_test_nodes (&node, 1);
2945 node_destroy (node);
2948 start_next_test ("Each value in a large array %d iterations\n",
2954 node = node_new (&array_9_class);
2957 while ((val = value_generator (&i)))
2959 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2961 node_append_child (node, val);
2963 run_test_nodes (&node, 1);
2965 _dbus_list_clear (&container->children);
2969 node_destroy (node);
2972 start_next_test ("Each container of each container of each value %d iterations\n",
2973 N_CONTAINERS * N_CONTAINERS * N_VALUES);
2974 for (i = 0; i < N_CONTAINERS; i++)
2976 const TestTypeNodeClass *outer_container_klass = container_nodes[i];
2977 TestTypeNode *outer_container = node_new (outer_container_klass);
2979 for (j = 0; j < N_CONTAINERS; j++)
2981 TestTypeNode *child;
2982 const TestTypeNodeClass *inner_container_klass = container_nodes[j];
2983 TestTypeNode *inner_container = node_new (inner_container_klass);
2985 node_append_child (outer_container, inner_container);
2988 while ((child = value_generator (&m)))
2990 node_append_child (inner_container, child);
2992 run_test_nodes (&outer_container, 1);
2994 _dbus_list_clear (&((TestTypeNodeContainer*)inner_container)->children);
2995 node_destroy (child);
2997 _dbus_list_clear (&((TestTypeNodeContainer*)outer_container)->children);
2998 node_destroy (inner_container);
3000 node_destroy (outer_container);
3003 start_next_test ("Each container of each container of each container of each value %d iterations\n",
3004 N_CONTAINERS * N_CONTAINERS * N_CONTAINERS * N_VALUES);
3005 for (i = 0; i < N_CONTAINERS; i++)
3007 const TestTypeNodeClass *outer_container_klass = container_nodes[i];
3008 TestTypeNode *outer_container = node_new (outer_container_klass);
3010 for (j = 0; j < N_CONTAINERS; j++)
3012 const TestTypeNodeClass *inner_container_klass = container_nodes[j];
3013 TestTypeNode *inner_container = node_new (inner_container_klass);
3015 node_append_child (outer_container, inner_container);
3017 for (k = 0; k < N_CONTAINERS; k++)
3019 TestTypeNode *child;
3020 const TestTypeNodeClass *center_container_klass = container_nodes[k];
3021 TestTypeNode *center_container = node_new (center_container_klass);
3023 node_append_child (inner_container, center_container);
3026 while ((child = value_generator (&m)))
3028 node_append_child (center_container, child);
3030 run_test_nodes (&outer_container, 1);
3032 _dbus_list_clear (&((TestTypeNodeContainer*)center_container)->children);
3033 node_destroy (child);
3035 _dbus_list_clear (&((TestTypeNodeContainer*)inner_container)->children);
3036 node_destroy (center_container);
3038 _dbus_list_clear (&((TestTypeNodeContainer*)outer_container)->children);
3039 node_destroy (inner_container);
3041 node_destroy (outer_container);
3045 /* This one takes a really long time, so comment it out for now */
3046 start_next_test ("Each value,value,value triplet combination as toplevel, in all orders %d iterations\n",
3047 N_VALUES * N_VALUES * N_VALUES);
3049 TestTypeNode *nodes[3];
3052 while ((nodes[0] = value_generator (&i)))
3055 while ((nodes[1] = value_generator (&j)))
3058 while ((nodes[2] = value_generator (&k)))
3060 run_test_nodes (nodes, 3);
3062 node_destroy (nodes[2]);
3064 node_destroy (nodes[1]);
3066 node_destroy (nodes[0]);
3069 #endif /* #if 0 expensive test */
3071 fprintf (stderr, "%d total iterations of recursive marshaling tests\n",
3072 n_iterations_completed_total);
3073 fprintf (stderr, "each iteration ran at initial offsets 0 through %d in both big and little endian\n",
3074 MAX_INITIAL_OFFSET);
3075 fprintf (stderr, "out of memory handling %s tested\n",
3076 TEST_OOM_HANDLING ? "was" : "was not");
3079 dbus_bool_t _dbus_marshal_recursive_test (void);
3082 _dbus_marshal_recursive_test (void)
3084 make_and_run_test_nodes ();
3090 dbus_bool_t _dbus_marshal_test (void);
3092 main (int argc, char **argv)
3094 _dbus_marshal_test ();
3096 _dbus_marshal_recursive_test ();
3106 * Implementations of each type node class
3113 #define SAMPLE_INT32 12345678
3114 #define SAMPLE_INT32_ALTERNATE 53781429
3116 int32_from_seed (int seed)
3118 /* Generate an integer value that's predictable from seed. We could
3119 * just use seed itself, but that would only ever touch one byte of
3120 * the int so would miss some kinds of bug.
3124 v = 42; /* just to quiet compiler afaik */
3131 v = SAMPLE_INT32_ALTERNATE;
3145 v *= seed; /* wraps around eventually, which is fine */
3151 int32_write_value (TestTypeNode *node,
3153 DBusTypeWriter *writer,
3156 /* also used for uint32 */
3159 v = int32_from_seed (seed);
3161 return _dbus_type_writer_write_basic (writer,
3162 node->klass->typecode,
3167 int32_read_value (TestTypeNode *node,
3169 DBusTypeReader *reader,
3172 /* also used for uint32 */
3175 check_expected_type (reader, node->klass->typecode);
3177 _dbus_type_reader_read_basic (reader,
3178 (dbus_int32_t*) &v);
3180 _dbus_assert (v == int32_from_seed (seed));
3185 #ifdef DBUS_HAVE_INT64
3187 int64_from_seed (int seed)
3192 v32 = int32_from_seed (seed);
3194 v = - (dbus_int32_t) ~ v32;
3195 v |= (((dbus_int64_t)v32) << 32);
3202 int64_write_value (TestTypeNode *node,
3204 DBusTypeWriter *writer,
3207 #ifdef DBUS_HAVE_INT64
3208 /* also used for uint64 */
3211 v = int64_from_seed (seed);
3213 return _dbus_type_writer_write_basic (writer,
3214 node->klass->typecode,
3222 int64_read_value (TestTypeNode *node,
3224 DBusTypeReader *reader,
3227 #ifdef DBUS_HAVE_INT64
3228 /* also used for uint64 */
3231 check_expected_type (reader, node->klass->typecode);
3233 _dbus_type_reader_read_basic (reader,
3234 (dbus_int64_t*) &v);
3236 _dbus_assert (v == int64_from_seed (seed));
3244 #define MAX_SAMPLE_STRING_LEN 10
3246 string_from_seed (char *buf,
3253 _dbus_assert (len < MAX_SAMPLE_STRING_LEN);
3255 v = (unsigned char) ('A' + seed);
3260 if (v < 'A' || v > 'z')
3273 string_write_value (TestTypeNode *node,
3275 DBusTypeWriter *writer,
3278 char buf[MAX_SAMPLE_STRING_LEN];
3279 const char *v_string = buf;
3281 string_from_seed (buf, node->klass->subclass_detail,
3284 return _dbus_type_writer_write_basic (writer,
3285 node->klass->typecode,
3290 string_read_value (TestTypeNode *node,
3292 DBusTypeReader *reader,
3296 char buf[MAX_SAMPLE_STRING_LEN];
3298 check_expected_type (reader, node->klass->typecode);
3300 _dbus_type_reader_read_basic (reader,
3301 (const char **) &v);
3303 string_from_seed (buf, node->klass->subclass_detail,
3306 if (strcmp (buf, v) != 0)
3308 _dbus_warn ("read string '%s' expected '%s'\n",
3310 _dbus_assert_not_reached ("test failed");
3316 #define BOOL_FROM_SEED(seed) (seed % 2)
3319 bool_write_value (TestTypeNode *node,
3321 DBusTypeWriter *writer,
3326 v = BOOL_FROM_SEED (seed);
3328 return _dbus_type_writer_write_basic (writer,
3329 node->klass->typecode,
3334 bool_read_value (TestTypeNode *node,
3336 DBusTypeReader *reader,
3341 check_expected_type (reader, node->klass->typecode);
3343 _dbus_type_reader_read_basic (reader,
3344 (unsigned char*) &v);
3346 _dbus_assert (v == BOOL_FROM_SEED (seed));
3351 #define BYTE_FROM_SEED(seed) ((unsigned char) int32_from_seed (seed))
3354 byte_write_value (TestTypeNode *node,
3356 DBusTypeWriter *writer,
3361 v = BYTE_FROM_SEED (seed);
3363 return _dbus_type_writer_write_basic (writer,
3364 node->klass->typecode,
3369 byte_read_value (TestTypeNode *node,
3371 DBusTypeReader *reader,
3376 check_expected_type (reader, node->klass->typecode);
3378 _dbus_type_reader_read_basic (reader,
3379 (unsigned char*) &v);
3381 _dbus_assert (v == BYTE_FROM_SEED (seed));
3387 double_from_seed (int seed)
3389 return SAMPLE_INT32 * (double) seed + 0.3;
3393 double_write_value (TestTypeNode *node,
3395 DBusTypeWriter *writer,
3400 v = double_from_seed (seed);
3402 return _dbus_type_writer_write_basic (writer,
3403 node->klass->typecode,
3408 double_read_value (TestTypeNode *node,
3410 DBusTypeReader *reader,
3416 check_expected_type (reader, node->klass->typecode);
3418 _dbus_type_reader_read_basic (reader,
3421 expected = double_from_seed (seed);
3423 if (!_DBUS_DOUBLES_BITWISE_EQUAL (v, expected))
3425 #ifdef DBUS_HAVE_INT64
3426 _dbus_warn ("Expected double %g got %g\n bits = 0x%llx vs.\n bits = 0x%llx)\n",
3428 *(dbus_uint64_t*)&expected,
3429 *(dbus_uint64_t*)&v);
3431 _dbus_assert_not_reached ("test failed");
3438 #define MAX_SAMPLE_OBJECT_PATH_LEN 10
3440 object_path_from_seed (char *buf,
3446 v = (unsigned char) ('A' + seed);
3451 if (v < 'A' || v > 'z')
3466 object_path_write_value (TestTypeNode *node,
3468 DBusTypeWriter *writer,
3471 char buf[MAX_SAMPLE_OBJECT_PATH_LEN];
3472 const char *v_string = buf;
3474 object_path_from_seed (buf, seed);
3476 return _dbus_type_writer_write_basic (writer,
3477 node->klass->typecode,
3482 object_path_read_value (TestTypeNode *node,
3484 DBusTypeReader *reader,
3488 char buf[MAX_SAMPLE_OBJECT_PATH_LEN];
3490 check_expected_type (reader, node->klass->typecode);
3492 _dbus_type_reader_read_basic (reader,
3493 (const char **) &v);
3495 object_path_from_seed (buf, seed);
3497 if (strcmp (buf, v) != 0)
3499 _dbus_warn ("read object path '%s' expected '%s'\n",
3501 _dbus_assert_not_reached ("test failed");
3508 #define MAX_SAMPLE_SIGNATURE_LEN 10
3510 signature_from_seed (char *buf,
3515 const char *sample_signatures[] = {
3523 s = sample_signatures[seed % _DBUS_N_ELEMENTS(sample_signatures)];
3525 for (i = 0; s[i]; i++)
3533 signature_write_value (TestTypeNode *node,
3535 DBusTypeWriter *writer,
3538 char buf[MAX_SAMPLE_SIGNATURE_LEN];
3539 const char *v_string = buf;
3541 signature_from_seed (buf, seed);
3543 return _dbus_type_writer_write_basic (writer,
3544 node->klass->typecode,
3549 signature_read_value (TestTypeNode *node,
3551 DBusTypeReader *reader,
3555 char buf[MAX_SAMPLE_SIGNATURE_LEN];
3557 check_expected_type (reader, node->klass->typecode);
3559 _dbus_type_reader_read_basic (reader,
3560 (const char **) &v);
3562 signature_from_seed (buf, seed);
3564 if (strcmp (buf, v) != 0)
3566 _dbus_warn ("read signature value '%s' expected '%s'\n",
3568 _dbus_assert_not_reached ("test failed");
3575 struct_write_value (TestTypeNode *node,
3577 DBusTypeWriter *writer,
3580 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3581 DataBlockState saved;
3586 n_copies = node->klass->subclass_detail;
3588 _dbus_assert (container->children != NULL);
3590 data_block_save (block, &saved);
3592 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_STRUCT,
3598 while (i < n_copies)
3602 link = _dbus_list_get_first_link (&container->children);
3603 while (link != NULL)
3605 TestTypeNode *child = link->data;
3606 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3608 if (!node_write_value (child, block, &sub, i))
3610 data_block_restore (block, &saved);
3620 if (!_dbus_type_writer_unrecurse (writer, &sub))
3622 data_block_restore (block, &saved);
3630 struct_read_value (TestTypeNode *node,
3632 DBusTypeReader *reader,
3635 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3640 n_copies = node->klass->subclass_detail;
3642 check_expected_type (reader, DBUS_TYPE_STRUCT);
3644 _dbus_type_reader_recurse (reader, &sub);
3647 while (i < n_copies)
3651 link = _dbus_list_get_first_link (&container->children);
3652 while (link != NULL)
3654 TestTypeNode *child = link->data;
3655 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3657 if (!node_read_value (child, block, &sub, i))
3660 if (i == (n_copies - 1) && next == NULL)
3661 NEXT_EXPECTING_FALSE (&sub);
3663 NEXT_EXPECTING_TRUE (&sub);
3675 struct_build_signature (TestTypeNode *node,
3678 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3683 n_copies = node->klass->subclass_detail;
3685 orig_len = _dbus_string_get_length (str);
3687 if (!_dbus_string_append_byte (str, DBUS_STRUCT_BEGIN_CHAR))
3691 while (i < n_copies)
3695 link = _dbus_list_get_first_link (&container->children);
3696 while (link != NULL)
3698 TestTypeNode *child = link->data;
3699 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3701 if (!node_build_signature (child, str))
3710 if (!_dbus_string_append_byte (str, DBUS_STRUCT_END_CHAR))
3716 _dbus_string_set_length (str, orig_len);
3721 array_write_value (TestTypeNode *node,
3723 DBusTypeWriter *writer,
3726 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3727 DataBlockState saved;
3729 DBusString element_signature;
3733 n_copies = node->klass->subclass_detail;
3735 _dbus_assert (container->children != NULL);
3737 data_block_save (block, &saved);
3739 if (!_dbus_string_init (&element_signature))
3742 if (!node_build_signature (_dbus_list_get_first (&container->children),
3743 &element_signature))
3746 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_ARRAY,
3747 &element_signature, 0,
3752 while (i < n_copies)
3756 link = _dbus_list_get_first_link (&container->children);
3757 while (link != NULL)
3759 TestTypeNode *child = link->data;
3760 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3762 if (!node_write_value (child, block, &sub, i))
3771 if (!_dbus_type_writer_unrecurse (writer, &sub))
3774 _dbus_string_free (&element_signature);
3778 data_block_restore (block, &saved);
3779 _dbus_string_free (&element_signature);
3784 array_read_value (TestTypeNode *node,
3786 DBusTypeReader *reader,
3789 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3794 n_copies = node->klass->subclass_detail;
3796 check_expected_type (reader, DBUS_TYPE_ARRAY);
3800 _dbus_assert (!_dbus_type_reader_array_is_empty (reader));
3802 _dbus_type_reader_recurse (reader, &sub);
3805 while (i < n_copies)
3809 link = _dbus_list_get_first_link (&container->children);
3810 while (link != NULL)
3812 TestTypeNode *child = link->data;
3813 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3815 if (!node_read_value (child, block, &sub, i))
3818 if (i == (n_copies - 1) && next == NULL)
3819 NEXT_EXPECTING_FALSE (&sub);
3821 NEXT_EXPECTING_TRUE (&sub);
3831 _dbus_assert (_dbus_type_reader_array_is_empty (reader));
3838 array_build_signature (TestTypeNode *node,
3841 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3844 orig_len = _dbus_string_get_length (str);
3846 if (!_dbus_string_append_byte (str, DBUS_TYPE_ARRAY))
3849 if (!node_build_signature (_dbus_list_get_first (&container->children),
3856 _dbus_string_set_length (str, orig_len);
3860 /* 10 is random just to add another seed that we use in the suite */
3861 #define VARIANT_SEED 10
3864 variant_write_value (TestTypeNode *node,
3866 DBusTypeWriter *writer,
3869 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3870 DataBlockState saved;
3872 DBusString content_signature;
3873 TestTypeNode *child;
3875 _dbus_assert (container->children != NULL);
3876 _dbus_assert (_dbus_list_length_is_one (&container->children));
3878 child = _dbus_list_get_first (&container->children);
3880 data_block_save (block, &saved);
3882 if (!_dbus_string_init (&content_signature))
3885 if (!node_build_signature (child,
3886 &content_signature))
3889 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_VARIANT,
3890 &content_signature, 0,
3894 if (!node_write_value (child, block, &sub, VARIANT_SEED))
3897 if (!_dbus_type_writer_unrecurse (writer, &sub))
3900 _dbus_string_free (&content_signature);
3904 data_block_restore (block, &saved);
3905 _dbus_string_free (&content_signature);
3910 variant_read_value (TestTypeNode *node,
3912 DBusTypeReader *reader,
3915 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3917 TestTypeNode *child;
3919 _dbus_assert (container->children != NULL);
3920 _dbus_assert (_dbus_list_length_is_one (&container->children));
3922 child = _dbus_list_get_first (&container->children);
3924 check_expected_type (reader, DBUS_TYPE_VARIANT);
3926 _dbus_type_reader_recurse (reader, &sub);
3928 if (!node_read_value (child, block, &sub, VARIANT_SEED))
3931 NEXT_EXPECTING_FALSE (&sub);
3937 container_destroy (TestTypeNode *node)
3939 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3942 link = _dbus_list_get_first_link (&container->children);
3943 while (link != NULL)
3945 TestTypeNode *child = link->data;
3946 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3948 node_destroy (child);
3950 _dbus_list_free_link (link);
3956 #endif /* DBUS_BUILD_TESTS */