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 0
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_demarshal_basic_type (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_type (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_type (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_demarshal_basic_type (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_demarshal_basic_type (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_fixed_length_set_basic (DBusTypeReader *reader,
866 _dbus_marshal_set_basic_type ((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
877 * readers may of course be invalidated if you set a variable-length
878 * type such as a string.
880 * @todo DBusTypeReader currently takes "const" versions of the
881 * type and value strings, and this function modifies those strings
882 * by casting away the const, which is of course bad if we want to
883 * get picky. (To be truly clean you'd have an object which contained
884 * the type and value strings and set_basic would be a method on
885 * that object... this would also make DBusTypeReader the same thing
886 * as DBusTypeMark. But since DBusMessage is effectively that object
887 * for D-BUS it doesn't seem worth creating some random object.)
889 * @param reader reader indicating where to set a new value
890 * @param value address of the value to set
891 * @returns #FALSE if not enough memory
894 _dbus_type_reader_set_basic (DBusTypeReader *reader,
902 current_type = _dbus_type_reader_get_current_type (reader);
904 _dbus_assert (_dbus_type_is_basic (current_type));
906 if (!_dbus_type_length_varies (current_type))
908 reader_fixed_length_set_basic (reader, current_type, value);
931 * Initialize a write iterator, which is used to write out values in
932 * serialized D-BUS format. #DBusTypeWriter is a value iterator; it
933 * writes out values. You can't use it to write out only types.
935 * The type_pos passed in is expected to be inside an already-valid,
936 * though potentially empty, type signature. This means that the byte
937 * after type_pos must be either #DBUS_TYPE_INVALID (aka nul) or some
938 * other valid type. #DBusTypeWriter won't enforce that the signature
939 * is already valid (you can append the nul byte at the end if you
940 * like), but just be aware that you need the nul byte eventually and
941 * #DBusTypeWriter isn't going to write it for you.
943 * @param writer the writer to init
944 * @param byte_order the byte order to marshal into
945 * @param type_str the string to write typecodes into
946 * @param type_pos where to insert typecodes
947 * @param value_str the string to write values into
948 * @param value_pos where to insert values
952 _dbus_type_writer_init (DBusTypeWriter *writer,
954 DBusString *type_str,
956 DBusString *value_str,
959 writer->byte_order = byte_order;
960 writer->type_str = type_str;
961 writer->type_pos = type_pos;
962 writer->value_str = value_str;
963 writer->value_pos = value_pos;
964 writer->container_type = DBUS_TYPE_INVALID;
965 writer->type_pos_is_expectation = FALSE;
967 #if RECURSIVE_MARSHAL_TRACE
968 _dbus_verbose ("writer %p init remaining sig '%s'\n", writer,
969 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
974 _dbus_type_writer_write_basic_no_typecode (DBusTypeWriter *writer,
978 return _dbus_marshal_basic_type (writer->value_str,
986 /* If our parent is an array, things are a little bit complicated.
988 * The parent must have a complete element type, such as
989 * "i" or "aai" or "(ii)" or "a(ii)". There can't be
990 * unclosed parens, or an "a" with no following type.
992 * To recurse, the only allowed operation is to recurse into the
993 * first type in the element type. So for "i" you can't recurse, for
994 * "ai" you can recurse into the array, for "(ii)" you can recurse
997 * If you recurse into the array for "ai", then you must specify
998 * "i" for the element type of the array you recurse into.
1000 * While inside an array at any level, we need to avoid writing to
1001 * type_str, since the type only appears once for the whole array,
1002 * it does not appear for each array element.
1004 * While inside an array type_pos points to the expected next
1005 * typecode, rather than the next place we could write a typecode.
1008 writer_recurse_init_and_check (DBusTypeWriter *writer,
1010 DBusTypeWriter *sub)
1012 _dbus_type_writer_init (sub,
1019 sub->container_type = container_type;
1021 if (writer->type_pos_is_expectation ||
1022 (sub->container_type == DBUS_TYPE_ARRAY || sub->container_type == DBUS_TYPE_VARIANT))
1023 sub->type_pos_is_expectation = TRUE;
1025 sub->type_pos_is_expectation = FALSE;
1027 #ifndef DBUS_DISABLE_CHECKS
1028 if (writer->type_pos_is_expectation)
1032 expected = first_type_in_signature (writer->type_str, writer->type_pos);
1034 if (expected != sub->container_type)
1036 _dbus_warn ("Writing an element of type %s, but the expected type here is %s\n",
1037 _dbus_type_to_string (sub->container_type),
1038 _dbus_type_to_string (expected));
1039 _dbus_assert_not_reached ("bad array element or variant content written");
1042 #endif /* DBUS_DISABLE_CHECKS */
1044 #if RECURSIVE_MARSHAL_TRACE
1045 _dbus_verbose (" type writer %p recurse parent %s type_pos = %d value_pos = %d is_expectation = %d remaining sig '%s'\n",
1047 _dbus_type_to_string (writer->container_type),
1048 writer->type_pos, writer->value_pos, writer->type_pos_is_expectation,
1049 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1050 _dbus_verbose (" type writer %p recurse sub %s type_pos = %d value_pos = %d is_expectation = %d\n",
1052 _dbus_type_to_string (sub->container_type),
1053 sub->type_pos, sub->value_pos,
1054 sub->type_pos_is_expectation);
1059 write_or_verify_typecode (DBusTypeWriter *writer,
1062 /* A subwriter inside an array or variant will have type_pos
1063 * pointing to the expected typecode; a writer not inside an array
1064 * or variant has type_pos pointing to the next place to insert a
1067 #if RECURSIVE_MARSHAL_TRACE
1068 _dbus_verbose (" type writer %p write_or_verify start type_pos = %d remaining sig '%s'\n",
1069 writer, writer->type_pos,
1070 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1073 if (writer->type_pos_is_expectation)
1075 #ifndef DBUS_DISABLE_CHECKS
1079 expected = _dbus_string_get_byte (writer->type_str, writer->type_pos);
1081 if (expected != typecode)
1083 _dbus_warn ("Array or variant type requires that type %s be written, but %s was written\n",
1084 _dbus_type_to_string (expected), _dbus_type_to_string (typecode));
1085 _dbus_assert_not_reached ("bad type inserted somewhere inside an array or variant");
1088 #endif /* DBUS_DISABLE_CHECKS */
1090 /* if immediately inside an array we'd always be appending an element,
1091 * so the expected type doesn't change; if inside a struct or something
1092 * below an array, we need to move through said struct or something.
1094 if (writer->container_type != DBUS_TYPE_ARRAY)
1095 writer->type_pos += 1;
1099 if (!_dbus_string_insert_byte (writer->type_str,
1104 writer->type_pos += 1;
1107 #if RECURSIVE_MARSHAL_TRACE
1108 _dbus_verbose (" type writer %p write_or_verify end type_pos = %d remaining sig '%s'\n",
1109 writer, writer->type_pos,
1110 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1117 writer_recurse_struct (DBusTypeWriter *writer,
1118 const DBusString *contained_type,
1119 int contained_type_start,
1120 int contained_type_len,
1121 DBusTypeWriter *sub)
1123 /* FIXME right now contained_type is ignored; we could probably
1124 * almost trivially fix the code so if it's present we
1125 * write it out and then set type_pos_is_expectation
1128 /* Ensure that we'll be able to add alignment padding and the typecode */
1129 if (!_dbus_string_alloc_space (sub->value_str, 8))
1132 if (!_dbus_string_alloc_space (sub->type_str, 1))
1135 if (!write_or_verify_typecode (sub, DBUS_STRUCT_BEGIN_CHAR))
1136 _dbus_assert_not_reached ("failed to insert struct typecode after prealloc");
1138 if (!_dbus_string_insert_bytes (sub->value_str,
1140 _DBUS_ALIGN_VALUE (sub->value_pos, 8) - sub->value_pos,
1142 _dbus_assert_not_reached ("should not have failed to insert alignment padding for struct");
1143 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
1150 writer_recurse_array (DBusTypeWriter *writer,
1151 const DBusString *contained_type,
1152 int contained_type_start,
1153 int contained_type_len,
1154 DBusTypeWriter *sub)
1156 dbus_uint32_t value = 0;
1160 #ifndef DBUS_DISABLE_CHECKS
1161 if (writer->container_type == DBUS_TYPE_ARRAY)
1163 if (!_dbus_string_equal_substring (contained_type,
1164 contained_type_start,
1167 writer->u.array.element_type_pos + 1))
1169 _dbus_warn ("Writing an array of '%s' but this is incompatible with the expected type of elements in the parent array\n",
1170 _dbus_string_get_const_data_len (contained_type,
1171 contained_type_start,
1172 contained_type_len));
1173 _dbus_assert_not_reached ("incompatible type for child array");
1176 #endif /* DBUS_DISABLE_CHECKS */
1178 /* 3 pad + 4 bytes for the array length, and 4 bytes possible padding
1179 * before array values
1181 if (!_dbus_string_alloc_space (sub->value_str, 3 + 4 + 4))
1184 sub->type_pos += 1; /* move to point to the element type, since type_pos
1185 * should be the expected type for further writes
1187 sub->u.array.element_type_pos = sub->type_pos;
1189 if (!writer->type_pos_is_expectation)
1191 /* sub is a toplevel/outermost array so we need to write the type data */
1193 /* alloc space for array typecode, element signature */
1194 if (!_dbus_string_alloc_space (writer->type_str, 1 + contained_type_len))
1197 if (!_dbus_string_insert_byte (writer->type_str,
1200 _dbus_assert_not_reached ("failed to insert array typecode after prealloc");
1202 if (!_dbus_string_copy_len (contained_type,
1203 contained_type_start, contained_type_len,
1205 sub->u.array.element_type_pos))
1206 _dbus_assert_not_reached ("should not have failed to insert array element typecodes");
1209 /* If the parent is an array, we hold type_pos pointing at the array element type;
1210 * otherwise advance it to reflect the array value we just recursed into
1212 if (writer->container_type != DBUS_TYPE_ARRAY)
1213 writer->type_pos += 1 + contained_type_len;
1215 _dbus_assert (writer->type_pos_is_expectation); /* because it's an array */
1217 /* Write the length */
1218 sub->u.array.len_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 4);
1220 if (!_dbus_type_writer_write_basic_no_typecode (sub, DBUS_TYPE_UINT32,
1222 _dbus_assert_not_reached ("should not have failed to insert array len");
1224 _dbus_assert (sub->u.array.len_pos == sub->value_pos - 4);
1226 /* Write alignment padding for array elements
1227 * Note that we write the padding *even for empty arrays*
1228 * to avoid wonky special cases
1230 alignment = element_type_get_alignment (contained_type, contained_type_start);
1232 aligned = _DBUS_ALIGN_VALUE (sub->value_pos, alignment);
1233 if (aligned != sub->value_pos)
1235 if (!_dbus_string_insert_bytes (sub->value_str,
1237 aligned - sub->value_pos,
1239 _dbus_assert_not_reached ("should not have failed to insert alignment padding");
1241 sub->value_pos = aligned;
1243 sub->u.array.start_pos = sub->value_pos;
1245 _dbus_assert (sub->u.array.start_pos == sub->value_pos);
1246 _dbus_assert (sub->u.array.len_pos < sub->u.array.start_pos);
1248 #if RECURSIVE_MARSHAL_TRACE
1249 _dbus_verbose (" type writer %p recurse array done remaining sig '%s' array start_pos = %d len_pos = %d\n", sub,
1250 _dbus_string_get_const_data_len (sub->type_str, sub->type_pos, 0),
1251 sub->u.array.start_pos, sub->u.array.len_pos);
1257 /* Variant value will normally have:
1258 * 1 byte signature length not including nul
1259 * signature typecodes (nul terminated)
1260 * padding to 8-boundary
1261 * body according to signature
1263 * The signature string can only have a single type
1264 * in it but that type may be complex/recursive.
1266 * So a typical variant type with the integer 3 will have these
1268 * 0x1 'i' '\0' [padding to 8-boundary] 0x0 0x0 0x0 0x3
1270 * For an array of 4-byte types stuffed into variants, the padding to
1271 * 8-boundary is only the 1 byte that is required for the 4-boundary
1272 * anyhow for all array elements after the first one. And for single
1273 * variants in isolation, wasting a few bytes is hardly a big deal.
1275 * The main world of hurt for writing out a variant is that the type
1276 * string is the same string as the value string. Which means
1277 * inserting to the type string will move the value_pos; and it means
1278 * that inserting to the type string could break type alignment.
1280 * This type alignment issue is why the body of the variant is always
1281 * 8-aligned. Then we know that re-8-aligning the start of the body
1282 * will always correctly align the full contents of the variant type.
1285 writer_recurse_variant (DBusTypeWriter *writer,
1286 const DBusString *contained_type,
1287 int contained_type_start,
1288 int contained_type_len,
1289 DBusTypeWriter *sub)
1291 /* Allocate space for the worst case, which is 1 byte sig
1292 * length, nul byte at end of sig, and 7 bytes padding to
1295 if (!_dbus_string_alloc_space (sub->value_str, contained_type_len + 9))
1298 /* write VARIANT typecode to the parent's type string */
1299 if (!write_or_verify_typecode (writer, DBUS_TYPE_VARIANT))
1302 if (!_dbus_string_insert_byte (sub->value_str,
1304 contained_type_len))
1305 _dbus_assert_not_reached ("should not have failed to insert variant type sig len");
1307 sub->value_pos += 1;
1309 /* Here we switch over to the expected type sig we're about to write */
1310 sub->type_str = sub->value_str;
1311 sub->type_pos = sub->value_pos;
1313 if (!_dbus_string_copy_len (contained_type, contained_type_start, contained_type_len,
1314 sub->value_str, sub->value_pos))
1315 _dbus_assert_not_reached ("should not have failed to insert variant type sig");
1317 sub->value_pos += contained_type_len;
1319 if (!_dbus_string_insert_byte (sub->value_str,
1322 _dbus_assert_not_reached ("should not have failed to insert variant type nul termination");
1324 sub->value_pos += 1;
1326 if (!_dbus_string_insert_bytes (sub->value_str,
1328 _DBUS_ALIGN_VALUE (sub->value_pos, 8) - sub->value_pos,
1330 _dbus_assert_not_reached ("should not have failed to insert alignment padding for variant body");
1331 sub->value_pos = _DBUS_ALIGN_VALUE (sub->value_pos, 8);
1337 _dbus_type_writer_recurse_contained_len (DBusTypeWriter *writer,
1339 const DBusString *contained_type,
1340 int contained_type_start,
1341 int contained_type_len,
1342 DBusTypeWriter *sub)
1344 writer_recurse_init_and_check (writer, container_type, sub);
1346 switch (container_type)
1348 case DBUS_TYPE_STRUCT:
1349 return writer_recurse_struct (writer,
1350 contained_type, contained_type_start, contained_type_len,
1353 case DBUS_TYPE_ARRAY:
1354 return writer_recurse_array (writer,
1355 contained_type, contained_type_start, contained_type_len,
1358 case DBUS_TYPE_VARIANT:
1359 return writer_recurse_variant (writer,
1360 contained_type, contained_type_start, contained_type_len,
1364 _dbus_assert_not_reached ("tried to recurse into type that doesn't support that");
1371 _dbus_type_writer_recurse (DBusTypeWriter *writer,
1373 const DBusString *contained_type,
1374 int contained_type_start,
1375 DBusTypeWriter *sub)
1377 int contained_type_len;
1380 contained_type_len = find_len_of_complete_type (contained_type, contained_type_start);
1382 contained_type_len = 0;
1384 return _dbus_type_writer_recurse_contained_len (writer, container_type,
1386 contained_type_start,
1392 _dbus_type_writer_unrecurse (DBusTypeWriter *writer,
1393 DBusTypeWriter *sub)
1395 _dbus_assert (sub->type_pos > 0); /* can't be recursed if this fails */
1397 /* type_pos_is_expectation never gets unset once set, or we'd get all hosed */
1398 _dbus_assert (!writer->type_pos_is_expectation ||
1399 (writer->type_pos_is_expectation && sub->type_pos_is_expectation));
1401 #if RECURSIVE_MARSHAL_TRACE
1402 _dbus_verbose (" type writer %p unrecurse type_pos = %d value_pos = %d is_expectation = %d container_type = %s\n",
1403 writer, writer->type_pos, writer->value_pos, writer->type_pos_is_expectation,
1404 _dbus_type_to_string (writer->container_type));
1405 _dbus_verbose (" type writer %p unrecurse sub type_pos = %d value_pos = %d is_expectation = %d container_type = %s\n",
1406 sub, sub->type_pos, sub->value_pos,
1407 sub->type_pos_is_expectation,
1408 _dbus_type_to_string (sub->container_type));
1411 if (sub->container_type == DBUS_TYPE_STRUCT)
1413 if (!write_or_verify_typecode (sub, DBUS_STRUCT_END_CHAR))
1416 else if (sub->container_type == DBUS_TYPE_ARRAY)
1420 /* Set the array length */
1421 len = sub->value_pos - sub->u.array.start_pos;
1422 _dbus_marshal_set_uint32 (sub->value_str,
1423 sub->u.array.len_pos,
1426 #if RECURSIVE_MARSHAL_TRACE
1427 _dbus_verbose (" filled in sub array len to %u at len_pos %d\n",
1428 len, sub->u.array.len_pos);
1432 /* Now get type_pos right for the parent writer. Here are the cases:
1434 * Cases !writer->type_pos_is_expectation:
1435 * (in these cases we want to update to the new insertion point)
1437 * - if we recursed into a STRUCT then we didn't know in advance
1438 * what the types in the struct would be; so we have to fill in
1439 * that information now.
1440 * writer->type_pos = sub->type_pos
1442 * - if we recursed into anything else, we knew the full array
1443 * type, or knew the single typecode marking VARIANT, so
1444 * writer->type_pos is already correct.
1445 * writer->type_pos should remain as-is
1447 * - note that the parent is never an ARRAY or VARIANT, if it were
1448 * then type_pos_is_expectation would be TRUE. The parent
1449 * is thus known to be a toplevel or STRUCT.
1451 * Cases where writer->type_pos_is_expectation:
1452 * (in these cases we want to update to next expected type to write)
1454 * - we recursed from STRUCT into STRUCT and we didn't increment
1455 * type_pos in the parent just to stay consistent with the
1456 * !writer->type_pos_is_expectation case (though we could
1457 * special-case this in recurse_struct instead if we wanted)
1458 * writer->type_pos = sub->type_pos
1460 * - we recursed from STRUCT into ARRAY or VARIANT and type_pos
1461 * for parent should have been incremented already
1462 * writer->type_pos should remain as-is
1464 * - we recursed from ARRAY into a sub-element, so type_pos in the
1465 * parent is the element type and should remain the element type
1466 * for the benefit of the next child element
1467 * writer->type_pos should remain as-is
1469 * - we recursed from VARIANT into its value, so type_pos in the
1470 * parent makes no difference since there's only one value
1471 * and we just finished writing it and won't use type_pos again
1472 * writer->type_pos should remain as-is
1474 if (sub->container_type == DBUS_TYPE_STRUCT &&
1475 (writer->container_type == DBUS_TYPE_STRUCT ||
1476 writer->container_type == DBUS_TYPE_INVALID))
1478 /* Advance the parent to the next struct field */
1479 writer->type_pos = sub->type_pos;
1482 writer->value_pos = sub->value_pos;
1484 #if RECURSIVE_MARSHAL_TRACE
1485 _dbus_verbose (" type writer %p unrecursed type_pos = %d value_pos = %d remaining sig '%s'\n",
1486 writer, writer->type_pos, writer->value_pos,
1487 _dbus_string_get_const_data_len (writer->type_str, writer->type_pos, 0));
1494 _dbus_type_writer_write_basic (DBusTypeWriter *writer,
1500 /* First ensure that our type realloc will succeed */
1501 if (!_dbus_string_alloc_space (writer->type_str, 1))
1506 if (!_dbus_type_writer_write_basic_no_typecode (writer, type, value))
1509 if (!write_or_verify_typecode (writer, type))
1510 _dbus_assert_not_reached ("failed to write typecode after prealloc");
1515 #if RECURSIVE_MARSHAL_TRACE
1516 _dbus_verbose (" type writer %p basic type_pos = %d value_pos = %d is_expectation = %d\n",
1517 writer, writer->type_pos, writer->value_pos, writer->type_pos_is_expectation);
1524 _dbus_type_writer_write_array (DBusTypeWriter *writer,
1534 * Iterate through all values in the given reader,
1535 * writing a copy of each value to the writer.
1536 * The reader will be moved forward to its end position.
1538 * @param writer the writer to copy to
1539 * @param reader the reader to copy from
1542 _dbus_type_writer_write_reader (DBusTypeWriter *writer,
1543 DBusTypeReader *reader)
1545 DBusTypeWriter orig;
1552 orig_type_len = _dbus_string_get_length (writer->type_str);
1553 orig_value_len = _dbus_string_get_length (writer->value_str);
1555 while ((current_type = _dbus_type_reader_get_current_type (reader)) != DBUS_TYPE_INVALID)
1557 switch (current_type)
1559 case DBUS_TYPE_STRUCT:
1560 case DBUS_TYPE_VARIANT:
1561 case DBUS_TYPE_ARRAY:
1563 DBusTypeReader subreader;
1564 DBusTypeWriter subwriter;
1565 const DBusString *sig_str;
1569 _dbus_type_reader_recurse (reader, &subreader);
1571 _dbus_type_reader_get_signature (&subreader, &sig_str,
1572 &sig_start, &sig_len);
1574 if (!_dbus_type_writer_recurse_contained_len (writer, current_type,
1575 sig_str, sig_start, sig_len,
1579 if (!_dbus_type_writer_write_reader (&subwriter, &subreader))
1582 if (!_dbus_type_writer_unrecurse (writer, &subwriter))
1591 _dbus_type_reader_read_basic (reader, &val);
1593 if (!_dbus_type_writer_write_basic (writer, current_type, &val))
1599 _dbus_type_reader_next (reader);
1605 if (!writer->type_pos_is_expectation)
1607 new_bytes = _dbus_string_get_length (writer->type_str) - orig_type_len;
1608 _dbus_string_delete (writer->type_str, orig.type_pos, new_bytes);
1610 new_bytes = _dbus_string_get_length (writer->value_str) - orig_value_len;
1611 _dbus_string_delete (writer->value_str, orig.value_pos, new_bytes);
1618 /** @} */ /* end of DBusMarshal group */
1620 #ifdef DBUS_BUILD_TESTS
1621 #include "dbus-test.h"
1622 #include "dbus-list.h"
1626 /* Whether to do the OOM stuff */
1627 #define TEST_OOM_HANDLING 0
1628 /* We do start offset 0 through 9, to get various alignment cases. Still this
1629 * obviously makes the test suite run 10x as slow.
1631 #define MAX_INITIAL_OFFSET 9
1632 /* Largest iteration count to test copying with. i.e. we only test copying with
1633 * some of the smaller data sets.
1635 #define MAX_ITERATIONS_TO_TEST_COPYING 100
1641 DBusString signature;
1651 #define N_FENCE_BYTES 5
1652 #define FENCE_BYTES_STR "abcde"
1653 #define INITIAL_PADDING_BYTE '\0'
1656 data_block_init (DataBlock *block,
1660 if (!_dbus_string_init (&block->signature))
1663 if (!_dbus_string_init (&block->body))
1665 _dbus_string_free (&block->signature);
1669 if (!_dbus_string_insert_bytes (&block->signature, 0, initial_offset,
1670 INITIAL_PADDING_BYTE) ||
1671 !_dbus_string_insert_bytes (&block->body, 0, initial_offset,
1672 INITIAL_PADDING_BYTE) ||
1673 !_dbus_string_append (&block->signature, FENCE_BYTES_STR) ||
1674 !_dbus_string_append (&block->body, FENCE_BYTES_STR))
1676 _dbus_string_free (&block->signature);
1677 _dbus_string_free (&block->body);
1681 block->byte_order = byte_order;
1682 block->initial_offset = initial_offset;
1688 data_block_save (DataBlock *block,
1689 DataBlockState *state)
1691 state->saved_sig_len = _dbus_string_get_length (&block->signature) - N_FENCE_BYTES;
1692 state->saved_body_len = _dbus_string_get_length (&block->body) - N_FENCE_BYTES;
1696 data_block_restore (DataBlock *block,
1697 DataBlockState *state)
1699 _dbus_string_delete (&block->signature,
1700 state->saved_sig_len,
1701 _dbus_string_get_length (&block->signature) - state->saved_sig_len - N_FENCE_BYTES);
1702 _dbus_string_delete (&block->body,
1703 state->saved_body_len,
1704 _dbus_string_get_length (&block->body) - state->saved_body_len - N_FENCE_BYTES);
1708 data_block_verify (DataBlock *block)
1710 if (!_dbus_string_ends_with_c_str (&block->signature,
1715 offset = _dbus_string_get_length (&block->signature) - N_FENCE_BYTES - 8;
1719 _dbus_verbose_bytes_of_string (&block->signature,
1721 _dbus_string_get_length (&block->signature) - offset);
1722 _dbus_assert_not_reached ("block did not verify: bad bytes at end of signature");
1724 if (!_dbus_string_ends_with_c_str (&block->body,
1729 offset = _dbus_string_get_length (&block->body) - N_FENCE_BYTES - 8;
1733 _dbus_verbose_bytes_of_string (&block->body,
1735 _dbus_string_get_length (&block->body) - offset);
1736 _dbus_assert_not_reached ("block did not verify: bad bytes at end of body");
1739 _dbus_assert (_dbus_string_validate_nul (&block->signature,
1740 0, block->initial_offset));
1741 _dbus_assert (_dbus_string_validate_nul (&block->body,
1742 0, block->initial_offset));
1746 data_block_free (DataBlock *block)
1748 data_block_verify (block);
1750 _dbus_string_free (&block->signature);
1751 _dbus_string_free (&block->body);
1755 data_block_reset (DataBlock *block)
1757 data_block_verify (block);
1759 _dbus_string_delete (&block->signature,
1760 block->initial_offset,
1761 _dbus_string_get_length (&block->signature) - N_FENCE_BYTES - block->initial_offset);
1762 _dbus_string_delete (&block->body,
1763 block->initial_offset,
1764 _dbus_string_get_length (&block->body) - N_FENCE_BYTES - block->initial_offset);
1766 data_block_verify (block);
1770 data_block_init_reader_writer (DataBlock *block,
1771 DBusTypeReader *reader,
1772 DBusTypeWriter *writer)
1775 _dbus_type_reader_init (reader,
1778 block->initial_offset,
1780 block->initial_offset);
1783 _dbus_type_writer_init (writer,
1786 _dbus_string_get_length (&block->signature) - N_FENCE_BYTES,
1788 _dbus_string_get_length (&block->body) - N_FENCE_BYTES);
1792 real_check_expected_type (DBusTypeReader *reader,
1794 const char *funcname,
1799 t = _dbus_type_reader_get_current_type (reader);
1803 _dbus_warn ("Read type %s while expecting %s at %s line %d\n",
1804 _dbus_type_to_string (t),
1805 _dbus_type_to_string (expected),
1812 #define check_expected_type(reader, expected) real_check_expected_type (reader, expected, _DBUS_FUNCTION_NAME, __LINE__)
1814 #define NEXT_EXPECTING_TRUE(reader) do { if (!_dbus_type_reader_next (reader)) \
1816 _dbus_warn ("_dbus_type_reader_next() should have returned TRUE at %s %d\n", \
1817 _DBUS_FUNCTION_NAME, __LINE__); \
1818 _dbus_assert_not_reached ("test failed"); \
1822 #define NEXT_EXPECTING_FALSE(reader) do { if (_dbus_type_reader_next (reader)) \
1824 _dbus_warn ("_dbus_type_reader_next() should have returned FALSE at %s %d\n", \
1825 _DBUS_FUNCTION_NAME, __LINE__); \
1826 _dbus_assert_not_reached ("test failed"); \
1828 check_expected_type (reader, DBUS_TYPE_INVALID); \
1831 typedef struct TestTypeNode TestTypeNode;
1832 typedef struct TestTypeNodeClass TestTypeNodeClass;
1833 typedef struct TestTypeNodeContainer TestTypeNodeContainer;
1834 typedef struct TestTypeNodeContainerClass TestTypeNodeContainerClass;
1838 const TestTypeNodeClass *klass;
1841 struct TestTypeNodeContainer
1847 struct TestTypeNodeClass
1853 int subclass_detail; /* a bad hack to avoid a bunch of subclass casting */
1855 dbus_bool_t (* construct) (TestTypeNode *node);
1856 void (* destroy) (TestTypeNode *node);
1858 dbus_bool_t (* write_value) (TestTypeNode *node,
1860 DBusTypeWriter *writer,
1862 dbus_bool_t (* read_value) (TestTypeNode *node,
1864 DBusTypeReader *reader,
1866 dbus_bool_t (* build_signature) (TestTypeNode *node,
1870 struct TestTypeNodeContainerClass
1872 TestTypeNodeClass base;
1875 static dbus_bool_t int32_write_value (TestTypeNode *node,
1877 DBusTypeWriter *writer,
1879 static dbus_bool_t int32_read_value (TestTypeNode *node,
1881 DBusTypeReader *reader,
1883 static dbus_bool_t int64_write_value (TestTypeNode *node,
1885 DBusTypeWriter *writer,
1887 static dbus_bool_t int64_read_value (TestTypeNode *node,
1889 DBusTypeReader *reader,
1891 static dbus_bool_t string_write_value (TestTypeNode *node,
1893 DBusTypeWriter *writer,
1895 static dbus_bool_t string_read_value (TestTypeNode *node,
1897 DBusTypeReader *reader,
1899 static dbus_bool_t bool_read_value (TestTypeNode *node,
1901 DBusTypeReader *reader,
1903 static dbus_bool_t bool_write_value (TestTypeNode *node,
1905 DBusTypeWriter *writer,
1907 static dbus_bool_t byte_read_value (TestTypeNode *node,
1909 DBusTypeReader *reader,
1911 static dbus_bool_t byte_write_value (TestTypeNode *node,
1913 DBusTypeWriter *writer,
1915 static dbus_bool_t double_read_value (TestTypeNode *node,
1917 DBusTypeReader *reader,
1919 static dbus_bool_t double_write_value (TestTypeNode *node,
1921 DBusTypeWriter *writer,
1923 static dbus_bool_t object_path_read_value (TestTypeNode *node,
1925 DBusTypeReader *reader,
1927 static dbus_bool_t object_path_write_value (TestTypeNode *node,
1929 DBusTypeWriter *writer,
1931 static dbus_bool_t signature_read_value (TestTypeNode *node,
1933 DBusTypeReader *reader,
1935 static dbus_bool_t signature_write_value (TestTypeNode *node,
1937 DBusTypeWriter *writer,
1939 static dbus_bool_t struct_write_value (TestTypeNode *node,
1941 DBusTypeWriter *writer,
1943 static dbus_bool_t struct_read_value (TestTypeNode *node,
1945 DBusTypeReader *reader,
1947 static dbus_bool_t struct_build_signature (TestTypeNode *node,
1949 static dbus_bool_t array_write_value (TestTypeNode *node,
1951 DBusTypeWriter *writer,
1953 static dbus_bool_t array_read_value (TestTypeNode *node,
1955 DBusTypeReader *reader,
1957 static dbus_bool_t array_build_signature (TestTypeNode *node,
1959 static dbus_bool_t variant_write_value (TestTypeNode *node,
1961 DBusTypeWriter *writer,
1963 static dbus_bool_t variant_read_value (TestTypeNode *node,
1965 DBusTypeReader *reader,
1967 static void container_destroy (TestTypeNode *node);
1970 static const TestTypeNodeClass int32_class = {
1972 sizeof (TestTypeNode),
1981 static const TestTypeNodeClass uint32_class = {
1983 sizeof (TestTypeNode),
1987 int32_write_value, /* recycle from int32 */
1988 int32_read_value, /* recycle from int32 */
1992 static const TestTypeNodeClass int64_class = {
1994 sizeof (TestTypeNode),
2003 static const TestTypeNodeClass uint64_class = {
2005 sizeof (TestTypeNode),
2009 int64_write_value, /* recycle from int64 */
2010 int64_read_value, /* recycle from int64 */
2014 static const TestTypeNodeClass string_0_class = {
2016 sizeof (TestTypeNode),
2017 0, /* string length */
2025 static const TestTypeNodeClass string_1_class = {
2027 sizeof (TestTypeNode),
2028 1, /* string length */
2036 /* with nul, a len 3 string should fill 4 bytes and thus is "special" */
2037 static const TestTypeNodeClass string_3_class = {
2039 sizeof (TestTypeNode),
2040 3, /* string length */
2048 /* with nul, a len 8 string should fill 9 bytes and thus is "special" (far-fetched I suppose) */
2049 static const TestTypeNodeClass string_8_class = {
2051 sizeof (TestTypeNode),
2052 8, /* string length */
2060 static const TestTypeNodeClass bool_class = {
2062 sizeof (TestTypeNode),
2071 static const TestTypeNodeClass byte_class = {
2073 sizeof (TestTypeNode),
2082 static const TestTypeNodeClass double_class = {
2084 sizeof (TestTypeNode),
2093 static const TestTypeNodeClass object_path_class = {
2094 DBUS_TYPE_OBJECT_PATH,
2095 sizeof (TestTypeNode),
2099 object_path_write_value,
2100 object_path_read_value,
2104 static const TestTypeNodeClass signature_class = {
2105 DBUS_TYPE_SIGNATURE,
2106 sizeof (TestTypeNode),
2110 signature_write_value,
2111 signature_read_value,
2115 static const TestTypeNodeClass struct_1_class = {
2117 sizeof (TestTypeNodeContainer),
2118 1, /* number of times children appear as fields */
2123 struct_build_signature
2126 static const TestTypeNodeClass struct_2_class = {
2128 sizeof (TestTypeNodeContainer),
2129 2, /* number of times children appear as fields */
2134 struct_build_signature
2137 static const TestTypeNodeClass array_0_class = {
2139 sizeof (TestTypeNodeContainer),
2140 0, /* number of array elements */
2145 array_build_signature
2148 static const TestTypeNodeClass array_1_class = {
2150 sizeof (TestTypeNodeContainer),
2151 1, /* number of array elements */
2156 array_build_signature
2159 static const TestTypeNodeClass array_2_class = {
2161 sizeof (TestTypeNodeContainer),
2162 2, /* number of array elements */
2167 array_build_signature
2170 static const TestTypeNodeClass array_9_class = {
2172 sizeof (TestTypeNodeContainer),
2173 9, /* number of array elements */
2178 array_build_signature
2181 static const TestTypeNodeClass variant_class = {
2183 sizeof (TestTypeNodeContainer),
2187 variant_write_value,
2192 static const TestTypeNodeClass* const
2208 #define N_BASICS (_DBUS_N_ELEMENTS (basic_nodes))
2210 static const TestTypeNodeClass* const
2211 container_nodes[] = {
2218 /* array_9_class is omitted on purpose, it's too slow;
2219 * we only use it in one hardcoded test below
2222 #define N_CONTAINERS (_DBUS_N_ELEMENTS (container_nodes))
2224 static TestTypeNode*
2225 node_new (const TestTypeNodeClass *klass)
2229 node = dbus_malloc0 (klass->instance_size);
2233 node->klass = klass;
2235 if (klass->construct)
2237 if (!(* klass->construct) (node))
2248 node_destroy (TestTypeNode *node)
2250 if (node->klass->destroy)
2251 (* node->klass->destroy) (node);
2256 node_write_value (TestTypeNode *node,
2258 DBusTypeWriter *writer,
2263 retval = (* node->klass->write_value) (node, block, writer, seed);
2266 /* Handy to see where things break, but too expensive to do all the time */
2267 data_block_verify (block);
2274 node_read_value (TestTypeNode *node,
2276 DBusTypeReader *reader,
2280 DBusTypeReader restored;
2282 _dbus_type_reader_save_mark (reader, &mark);
2284 if (!(* node->klass->read_value) (node, block, reader, seed))
2287 _dbus_type_reader_init_from_mark (&restored,
2288 reader->byte_order, /* a bit of a cheat,
2289 * since we didn't bother
2290 * to store this in DataBlock
2296 if (!(* node->klass->read_value) (node, block, &restored, seed))
2303 node_build_signature (TestTypeNode *node,
2306 if (node->klass->build_signature)
2307 return (* node->klass->build_signature) (node, str);
2309 return _dbus_string_append_byte (str, node->klass->typecode);
2313 node_append_child (TestTypeNode *node,
2314 TestTypeNode *child)
2316 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2318 _dbus_assert (node->klass->instance_size >= (int) sizeof (TestTypeNodeContainer));
2320 if (!_dbus_list_append (&container->children, child))
2321 _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 */
2327 run_test_copy (DataBlock *src)
2331 DBusTypeReader reader;
2332 DBusTypeWriter writer;
2336 if (!data_block_init (&dest, src->byte_order, src->initial_offset))
2339 data_block_init_reader_writer (src, &reader, NULL);
2340 data_block_init_reader_writer (&dest, NULL, &writer);
2342 /* DBusTypeWriter assumes it's writing into an existing signature,
2343 * so doesn't add nul on its own. We have to do that.
2345 if (!_dbus_string_insert_byte (&dest.signature,
2346 dest.initial_offset, '\0'))
2349 if (!_dbus_type_writer_write_reader (&writer, &reader))
2352 /* Data blocks should now be identical */
2353 if (!_dbus_string_equal (&src->signature, &dest.signature))
2355 _dbus_verbose ("SOURCE\n");
2356 _dbus_verbose_bytes_of_string (&src->signature, 0,
2357 _dbus_string_get_length (&src->signature));
2358 _dbus_verbose ("DEST\n");
2359 _dbus_verbose_bytes_of_string (&dest.signature, 0,
2360 _dbus_string_get_length (&dest.signature));
2361 _dbus_assert_not_reached ("signatures did not match");
2364 if (!_dbus_string_equal (&src->body, &dest.body))
2366 _dbus_verbose ("SOURCE\n");
2367 _dbus_verbose_bytes_of_string (&src->body, 0,
2368 _dbus_string_get_length (&src->body));
2369 _dbus_verbose ("DEST\n");
2370 _dbus_verbose_bytes_of_string (&dest.body, 0,
2371 _dbus_string_get_length (&dest.body));
2372 _dbus_assert_not_reached ("bodies did not match");
2379 data_block_free (&dest);
2384 static int n_iterations_completed_total = 0;
2385 static int n_iterations_completed_this_test = 0;
2386 static int n_iterations_expected_this_test = 0;
2390 const DBusString *signature;
2393 TestTypeNode **nodes;
2395 } NodeIterationData;
2398 run_test_nodes_iteration (void *data)
2400 NodeIterationData *nid = data;
2401 DBusTypeReader reader;
2402 DBusTypeWriter writer;
2407 * 1. write the value
2408 * 2. strcmp-compare with the signature we built
2410 * 4. type-iterate the signature and the value and see if they are the same type-wise
2414 data_block_init_reader_writer (nid->block,
2417 /* DBusTypeWriter assumes it's writing into an existing signature,
2418 * so doesn't add nul on its own. We have to do that.
2420 if (!_dbus_string_insert_byte (&nid->block->signature,
2421 nid->type_offset, '\0'))
2425 while (i < nid->n_nodes)
2427 if (!node_write_value (nid->nodes[i], nid->block, &writer, i))
2433 if (!_dbus_string_equal_substring (nid->signature, 0, _dbus_string_get_length (nid->signature),
2434 &nid->block->signature, nid->type_offset))
2436 _dbus_warn ("Expected signature '%s' and got '%s' with initial offset %d\n",
2437 _dbus_string_get_const_data (nid->signature),
2438 _dbus_string_get_const_data_len (&nid->block->signature, nid->type_offset, 0),
2440 _dbus_assert_not_reached ("wrong signature");
2444 while (i < nid->n_nodes)
2446 if (!node_read_value (nid->nodes[i], nid->block, &reader, i))
2449 if (i + 1 == nid->n_nodes)
2450 NEXT_EXPECTING_FALSE (&reader);
2452 NEXT_EXPECTING_TRUE (&reader);
2457 if (n_iterations_expected_this_test <= MAX_ITERATIONS_TO_TEST_COPYING)
2458 run_test_copy (nid->block);
2460 /* FIXME type-iterate both signature and value and compare the resulting
2461 * tree to the node tree perhaps
2468 data_block_reset (nid->block);
2474 run_test_nodes_in_one_configuration (TestTypeNode **nodes,
2476 const DBusString *signature,
2481 NodeIterationData nid;
2483 if (!data_block_init (&block, byte_order, initial_offset))
2484 _dbus_assert_not_reached ("no memory");
2486 nid.signature = signature;
2488 nid.type_offset = initial_offset;
2490 nid.n_nodes = n_nodes;
2492 #if TEST_OOM_HANDLING
2493 _dbus_test_oom_handling ("running test node",
2494 run_test_nodes_iteration,
2497 if (!run_test_nodes_iteration (&nid))
2498 _dbus_assert_not_reached ("no memory");
2501 data_block_free (&block);
2505 run_test_nodes (TestTypeNode **nodes,
2509 DBusString signature;
2511 if (!_dbus_string_init (&signature))
2512 _dbus_assert_not_reached ("no memory");
2517 if (! node_build_signature (nodes[i], &signature))
2518 _dbus_assert_not_reached ("no memory");
2523 _dbus_verbose (">>> test nodes with signature '%s'\n",
2524 _dbus_string_get_const_data (&signature));
2527 while (i <= MAX_INITIAL_OFFSET)
2529 run_test_nodes_in_one_configuration (nodes, n_nodes, &signature,
2530 DBUS_LITTLE_ENDIAN, i);
2531 run_test_nodes_in_one_configuration (nodes, n_nodes, &signature,
2532 DBUS_BIG_ENDIAN, i);
2537 n_iterations_completed_this_test += 1;
2538 n_iterations_completed_total += 1;
2540 if (n_iterations_completed_this_test == n_iterations_expected_this_test)
2542 fprintf (stderr, " 100%% %d this test (%d cumulative)\n",
2543 n_iterations_completed_this_test,
2544 n_iterations_completed_total);
2546 /* this happens to turn out well with mod == 1 */
2547 else if ((n_iterations_completed_this_test %
2548 (int)(n_iterations_expected_this_test / 10.0)) == 1)
2550 fprintf (stderr, " %d%% ", (int) (n_iterations_completed_this_test / (double) n_iterations_expected_this_test * 100));
2553 _dbus_string_free (&signature);
2556 #define N_VALUES (N_BASICS * N_CONTAINERS + N_BASICS)
2558 static TestTypeNode*
2559 value_generator (int *ip)
2562 const TestTypeNodeClass *child_klass;
2563 const TestTypeNodeClass *container_klass;
2564 TestTypeNode *child;
2567 _dbus_assert (i <= N_VALUES);
2573 else if (i < N_BASICS)
2575 node = node_new (basic_nodes[i]);
2579 /* imagine an array:
2580 * container 0 of basic 0
2581 * container 0 of basic 1
2582 * container 0 of basic 2
2583 * container 1 of basic 0
2584 * container 1 of basic 1
2585 * container 1 of basic 2
2589 container_klass = container_nodes[i / N_BASICS];
2590 child_klass = basic_nodes[i % N_BASICS];
2592 node = node_new (container_klass);
2593 child = node_new (child_klass);
2595 node_append_child (node, child);
2598 *ip += 1; /* increment the generator */
2604 make_and_run_values_inside_container (const TestTypeNodeClass *container_klass,
2608 TestTypeNode *container;
2609 TestTypeNode *child;
2612 root = node_new (container_klass);
2614 for (i = 1; i < n_nested; i++)
2616 child = node_new (container_klass);
2617 node_append_child (container, child);
2621 /* container should now be the most-nested container */
2624 while ((child = value_generator (&i)))
2626 node_append_child (container, child);
2628 run_test_nodes (&root, 1);
2630 _dbus_list_clear (&((TestTypeNodeContainer*)container)->children);
2631 node_destroy (child);
2634 node_destroy (root);
2638 start_next_test (const char *format,
2641 n_iterations_completed_this_test = 0;
2642 n_iterations_expected_this_test = expected;
2644 fprintf (stderr, ">>> >>> ");
2645 fprintf (stderr, format,
2646 n_iterations_expected_this_test);
2650 make_and_run_test_nodes (void)
2654 /* We try to do this in order of "complicatedness" so that test
2655 * failures tend to show up in the simplest test case that
2656 * demonstrates the failure. There are also some tests that run
2657 * more than once for this reason, first while going through simple
2658 * cases, second while going through a broader range of complex
2661 /* Each basic node. The basic nodes should include:
2663 * - each fixed-size type (in such a way that it has different values each time,
2664 * so we can tell if we mix two of them up)
2665 * - strings of various lengths
2669 /* Each container node. The container nodes should include:
2671 * struct with 1 and 2 copies of the contained item
2672 * array with 0, 1, 2 copies of the contained item
2675 /* Let a "value" be a basic node, or a container containing a single basic node.
2676 * Let n_values be the number of such values i.e. (n_container * n_basic + n_basic)
2677 * When iterating through all values to make combinations, do the basic types
2678 * first and the containers second.
2680 /* Each item is shown with its number of iterations to complete so
2681 * we can keep a handle on this unit test
2684 /* FIXME test just an empty body, no types at all */
2686 start_next_test ("Each value by itself %d iterations\n", N_VALUES);
2690 while ((node = value_generator (&i)))
2692 run_test_nodes (&node, 1);
2694 node_destroy (node);
2698 start_next_test ("All values in one big toplevel %d iteration\n", 1);
2700 TestTypeNode *nodes[N_VALUES];
2703 while ((nodes[i] = value_generator (&i)))
2706 run_test_nodes (nodes, N_VALUES);
2708 for (i = 0; i < N_VALUES; i++)
2709 node_destroy (nodes[i]);
2712 start_next_test ("Each value,value pair combination as toplevel, in both orders %d iterations\n",
2713 N_VALUES * N_VALUES);
2715 TestTypeNode *nodes[2];
2718 while ((nodes[0] = value_generator (&i)))
2721 while ((nodes[1] = value_generator (&j)))
2723 run_test_nodes (nodes, 2);
2725 node_destroy (nodes[1]);
2728 node_destroy (nodes[0]);
2732 start_next_test ("Each container containing each value %d iterations\n",
2733 N_CONTAINERS * N_VALUES);
2734 for (i = 0; i < N_CONTAINERS; i++)
2736 const TestTypeNodeClass *container_klass = container_nodes[i];
2738 make_and_run_values_inside_container (container_klass, 1);
2741 n_iterations_completed_this_test = 0;
2742 n_iterations_expected_this_test = N_CONTAINERS * N_VALUES;
2743 _dbus_verbose (">>> >>> Each container of same container of each value %d iterations\n",
2744 n_iterations_completed_this_test);
2745 for (i = 0; i < N_CONTAINERS; i++)
2747 const TestTypeNodeClass *container_klass = container_nodes[i];
2749 make_and_run_values_inside_container (container_klass, 2);
2752 start_next_test ("Each container of same container of same container of each value %d iterations\n",
2753 N_CONTAINERS * N_VALUES);
2754 for (i = 0; i < N_CONTAINERS; i++)
2756 const TestTypeNodeClass *container_klass = container_nodes[i];
2758 make_and_run_values_inside_container (container_klass, 3);
2761 start_next_test ("Each value,value pair inside a struct %d iterations\n",
2762 N_VALUES * N_VALUES);
2764 TestTypeNode *val1, *val2;
2767 node = node_new (&struct_1_class);
2770 while ((val1 = value_generator (&i)))
2773 while ((val2 = value_generator (&j)))
2775 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2777 node_append_child (node, val1);
2778 node_append_child (node, val2);
2780 run_test_nodes (&node, 1);
2782 _dbus_list_clear (&container->children);
2783 node_destroy (val2);
2785 node_destroy (val1);
2787 node_destroy (node);
2790 start_next_test ("All values in one big struct %d iteration\n",
2794 TestTypeNode *child;
2796 node = node_new (&struct_1_class);
2799 while ((child = value_generator (&i)))
2800 node_append_child (node, child);
2802 run_test_nodes (&node, 1);
2804 node_destroy (node);
2807 start_next_test ("Each value in a large array %d iterations\n",
2813 node = node_new (&array_9_class);
2816 while ((val = value_generator (&i)))
2818 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
2820 node_append_child (node, val);
2822 run_test_nodes (&node, 1);
2824 _dbus_list_clear (&container->children);
2828 node_destroy (node);
2831 start_next_test ("Each container of each container of each value %d iterations\n",
2832 N_CONTAINERS * N_CONTAINERS * N_VALUES);
2833 for (i = 0; i < N_CONTAINERS; i++)
2835 const TestTypeNodeClass *outer_container_klass = container_nodes[i];
2836 TestTypeNode *outer_container = node_new (outer_container_klass);
2838 for (j = 0; j < N_CONTAINERS; j++)
2840 TestTypeNode *child;
2841 const TestTypeNodeClass *inner_container_klass = container_nodes[j];
2842 TestTypeNode *inner_container = node_new (inner_container_klass);
2844 node_append_child (outer_container, inner_container);
2847 while ((child = value_generator (&m)))
2849 node_append_child (inner_container, child);
2851 run_test_nodes (&outer_container, 1);
2853 _dbus_list_clear (&((TestTypeNodeContainer*)inner_container)->children);
2854 node_destroy (child);
2856 _dbus_list_clear (&((TestTypeNodeContainer*)outer_container)->children);
2857 node_destroy (inner_container);
2859 node_destroy (outer_container);
2862 start_next_test ("Each container of each container of each container of each value %d iterations\n",
2863 N_CONTAINERS * N_CONTAINERS * N_CONTAINERS * N_VALUES);
2864 for (i = 0; i < N_CONTAINERS; i++)
2866 const TestTypeNodeClass *outer_container_klass = container_nodes[i];
2867 TestTypeNode *outer_container = node_new (outer_container_klass);
2869 for (j = 0; j < N_CONTAINERS; j++)
2871 const TestTypeNodeClass *inner_container_klass = container_nodes[j];
2872 TestTypeNode *inner_container = node_new (inner_container_klass);
2874 node_append_child (outer_container, inner_container);
2876 for (k = 0; k < N_CONTAINERS; k++)
2878 TestTypeNode *child;
2879 const TestTypeNodeClass *center_container_klass = container_nodes[k];
2880 TestTypeNode *center_container = node_new (center_container_klass);
2882 node_append_child (inner_container, center_container);
2885 while ((child = value_generator (&m)))
2887 node_append_child (center_container, child);
2889 run_test_nodes (&outer_container, 1);
2891 _dbus_list_clear (&((TestTypeNodeContainer*)center_container)->children);
2892 node_destroy (child);
2894 _dbus_list_clear (&((TestTypeNodeContainer*)inner_container)->children);
2895 node_destroy (center_container);
2897 _dbus_list_clear (&((TestTypeNodeContainer*)outer_container)->children);
2898 node_destroy (inner_container);
2900 node_destroy (outer_container);
2904 /* This one takes a really long time, so comment it out for now */
2905 start_next_test ("Each value,value,value triplet combination as toplevel, in all orders %d iterations\n",
2906 N_VALUES * N_VALUES * N_VALUES);
2908 TestTypeNode *nodes[3];
2911 while ((nodes[0] = value_generator (&i)))
2914 while ((nodes[1] = value_generator (&j)))
2917 while ((nodes[2] = value_generator (&k)))
2919 run_test_nodes (nodes, 3);
2921 node_destroy (nodes[2]);
2923 node_destroy (nodes[1]);
2925 node_destroy (nodes[0]);
2928 #endif /* #if 0 expensive test */
2930 fprintf (stderr, "%d total iterations of recursive marshaling tests\n",
2931 n_iterations_completed_total);
2932 fprintf (stderr, "each iteration ran at initial offsets 0 through %d in both big and little endian\n",
2933 MAX_INITIAL_OFFSET);
2934 fprintf (stderr, "out of memory handling %s tested\n",
2935 TEST_OOM_HANDLING ? "was" : "was not");
2938 dbus_bool_t _dbus_marshal_recursive_test (void);
2941 _dbus_marshal_recursive_test (void)
2943 make_and_run_test_nodes ();
2949 dbus_bool_t _dbus_marshal_test (void);
2951 main (int argc, char **argv)
2953 _dbus_marshal_test ();
2955 _dbus_marshal_recursive_test ();
2965 * Implementations of each type node class
2972 #define SAMPLE_INT32 12345678
2973 #define SAMPLE_INT32_ALTERNATE 53781429
2975 int32_from_seed (int seed)
2977 /* Generate an integer value that's predictable from seed. We could
2978 * just use seed itself, but that would only ever touch one byte of
2979 * the int so would miss some kinds of bug.
2983 v = 42; /* just to quiet compiler afaik */
2990 v = SAMPLE_INT32_ALTERNATE;
3004 v *= seed; /* wraps around eventually, which is fine */
3010 int32_write_value (TestTypeNode *node,
3012 DBusTypeWriter *writer,
3015 /* also used for uint32 */
3018 v = int32_from_seed (seed);
3020 return _dbus_type_writer_write_basic (writer,
3021 node->klass->typecode,
3026 int32_read_value (TestTypeNode *node,
3028 DBusTypeReader *reader,
3031 /* also used for uint32 */
3034 check_expected_type (reader, node->klass->typecode);
3036 _dbus_type_reader_read_basic (reader,
3037 (dbus_int32_t*) &v);
3039 _dbus_assert (v == int32_from_seed (seed));
3044 #ifdef DBUS_HAVE_INT64
3046 int64_from_seed (int seed)
3051 v32 = int32_from_seed (seed);
3053 v = - (dbus_int32_t) ~ v32;
3054 v |= (((dbus_int64_t)v32) << 32);
3061 int64_write_value (TestTypeNode *node,
3063 DBusTypeWriter *writer,
3066 #ifdef DBUS_HAVE_INT64
3067 /* also used for uint64 */
3070 v = int64_from_seed (seed);
3072 return _dbus_type_writer_write_basic (writer,
3073 node->klass->typecode,
3081 int64_read_value (TestTypeNode *node,
3083 DBusTypeReader *reader,
3086 #ifdef DBUS_HAVE_INT64
3087 /* also used for uint64 */
3090 check_expected_type (reader, node->klass->typecode);
3092 _dbus_type_reader_read_basic (reader,
3093 (dbus_int64_t*) &v);
3095 _dbus_assert (v == int64_from_seed (seed));
3103 #define MAX_SAMPLE_STRING_LEN 10
3105 string_from_seed (char *buf,
3112 _dbus_assert (len < MAX_SAMPLE_STRING_LEN);
3114 v = (unsigned char) ('A' + seed);
3119 if (v < 'A' || v > 'z')
3132 string_write_value (TestTypeNode *node,
3134 DBusTypeWriter *writer,
3137 char buf[MAX_SAMPLE_STRING_LEN];
3138 const char *v_string = buf;
3140 string_from_seed (buf, node->klass->subclass_detail,
3143 return _dbus_type_writer_write_basic (writer,
3144 node->klass->typecode,
3149 string_read_value (TestTypeNode *node,
3151 DBusTypeReader *reader,
3155 char buf[MAX_SAMPLE_STRING_LEN];
3157 check_expected_type (reader, node->klass->typecode);
3159 _dbus_type_reader_read_basic (reader,
3160 (const char **) &v);
3162 string_from_seed (buf, node->klass->subclass_detail,
3165 if (strcmp (buf, v) != 0)
3167 _dbus_warn ("read string '%s' expected '%s'\n",
3169 _dbus_assert_not_reached ("test failed");
3175 #define BOOL_FROM_SEED(seed) (seed % 2)
3178 bool_write_value (TestTypeNode *node,
3180 DBusTypeWriter *writer,
3185 v = BOOL_FROM_SEED (seed);
3187 return _dbus_type_writer_write_basic (writer,
3188 node->klass->typecode,
3193 bool_read_value (TestTypeNode *node,
3195 DBusTypeReader *reader,
3200 check_expected_type (reader, node->klass->typecode);
3202 _dbus_type_reader_read_basic (reader,
3203 (unsigned char*) &v);
3205 _dbus_assert (v == BOOL_FROM_SEED (seed));
3210 #define BYTE_FROM_SEED(seed) ((unsigned char) int32_from_seed (seed))
3213 byte_write_value (TestTypeNode *node,
3215 DBusTypeWriter *writer,
3220 v = BYTE_FROM_SEED (seed);
3222 return _dbus_type_writer_write_basic (writer,
3223 node->klass->typecode,
3228 byte_read_value (TestTypeNode *node,
3230 DBusTypeReader *reader,
3235 check_expected_type (reader, node->klass->typecode);
3237 _dbus_type_reader_read_basic (reader,
3238 (unsigned char*) &v);
3240 _dbus_assert (v == BYTE_FROM_SEED (seed));
3246 double_from_seed (int seed)
3248 return SAMPLE_INT32 * (double) seed + 0.3;
3252 double_write_value (TestTypeNode *node,
3254 DBusTypeWriter *writer,
3259 v = double_from_seed (seed);
3261 return _dbus_type_writer_write_basic (writer,
3262 node->klass->typecode,
3267 double_read_value (TestTypeNode *node,
3269 DBusTypeReader *reader,
3275 check_expected_type (reader, node->klass->typecode);
3277 _dbus_type_reader_read_basic (reader,
3280 expected = double_from_seed (seed);
3282 if (!_DBUS_DOUBLES_BITWISE_EQUAL (v, expected))
3284 #ifdef DBUS_HAVE_INT64
3285 _dbus_warn ("Expected double %g got %g\n bits = 0x%llx vs.\n bits = 0x%llx)\n",
3287 *(dbus_uint64_t*)&expected,
3288 *(dbus_uint64_t*)&v);
3290 _dbus_assert_not_reached ("test failed");
3297 #define MAX_SAMPLE_OBJECT_PATH_LEN 10
3299 object_path_from_seed (char *buf,
3305 v = (unsigned char) ('A' + seed);
3310 if (v < 'A' || v > 'z')
3325 object_path_write_value (TestTypeNode *node,
3327 DBusTypeWriter *writer,
3330 char buf[MAX_SAMPLE_OBJECT_PATH_LEN];
3331 const char *v_string = buf;
3333 object_path_from_seed (buf, seed);
3335 return _dbus_type_writer_write_basic (writer,
3336 node->klass->typecode,
3341 object_path_read_value (TestTypeNode *node,
3343 DBusTypeReader *reader,
3347 char buf[MAX_SAMPLE_OBJECT_PATH_LEN];
3349 check_expected_type (reader, node->klass->typecode);
3351 _dbus_type_reader_read_basic (reader,
3352 (const char **) &v);
3354 object_path_from_seed (buf, seed);
3356 if (strcmp (buf, v) != 0)
3358 _dbus_warn ("read object path '%s' expected '%s'\n",
3360 _dbus_assert_not_reached ("test failed");
3367 #define MAX_SAMPLE_SIGNATURE_LEN 10
3369 signature_from_seed (char *buf,
3374 const char *sample_signatures[] = {
3382 s = sample_signatures[seed % _DBUS_N_ELEMENTS(sample_signatures)];
3384 for (i = 0; s[i]; i++)
3392 signature_write_value (TestTypeNode *node,
3394 DBusTypeWriter *writer,
3397 char buf[MAX_SAMPLE_SIGNATURE_LEN];
3398 const char *v_string = buf;
3400 signature_from_seed (buf, seed);
3402 return _dbus_type_writer_write_basic (writer,
3403 node->klass->typecode,
3408 signature_read_value (TestTypeNode *node,
3410 DBusTypeReader *reader,
3414 char buf[MAX_SAMPLE_SIGNATURE_LEN];
3416 check_expected_type (reader, node->klass->typecode);
3418 _dbus_type_reader_read_basic (reader,
3419 (const char **) &v);
3421 signature_from_seed (buf, seed);
3423 if (strcmp (buf, v) != 0)
3425 _dbus_warn ("read signature value '%s' expected '%s'\n",
3427 _dbus_assert_not_reached ("test failed");
3434 struct_write_value (TestTypeNode *node,
3436 DBusTypeWriter *writer,
3439 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3440 DataBlockState saved;
3445 n_copies = node->klass->subclass_detail;
3447 _dbus_assert (container->children != NULL);
3449 data_block_save (block, &saved);
3451 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_STRUCT,
3457 while (i < n_copies)
3461 link = _dbus_list_get_first_link (&container->children);
3462 while (link != NULL)
3464 TestTypeNode *child = link->data;
3465 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3467 if (!node_write_value (child, block, &sub, i))
3469 data_block_restore (block, &saved);
3479 if (!_dbus_type_writer_unrecurse (writer, &sub))
3481 data_block_restore (block, &saved);
3489 struct_read_value (TestTypeNode *node,
3491 DBusTypeReader *reader,
3494 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3499 n_copies = node->klass->subclass_detail;
3501 check_expected_type (reader, DBUS_TYPE_STRUCT);
3503 _dbus_type_reader_recurse (reader, &sub);
3506 while (i < n_copies)
3510 link = _dbus_list_get_first_link (&container->children);
3511 while (link != NULL)
3513 TestTypeNode *child = link->data;
3514 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3516 if (!node_read_value (child, block, &sub, i))
3519 if (i == (n_copies - 1) && next == NULL)
3520 NEXT_EXPECTING_FALSE (&sub);
3522 NEXT_EXPECTING_TRUE (&sub);
3534 struct_build_signature (TestTypeNode *node,
3537 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3542 n_copies = node->klass->subclass_detail;
3544 orig_len = _dbus_string_get_length (str);
3546 if (!_dbus_string_append_byte (str, DBUS_STRUCT_BEGIN_CHAR))
3550 while (i < n_copies)
3554 link = _dbus_list_get_first_link (&container->children);
3555 while (link != NULL)
3557 TestTypeNode *child = link->data;
3558 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3560 if (!node_build_signature (child, str))
3569 if (!_dbus_string_append_byte (str, DBUS_STRUCT_END_CHAR))
3575 _dbus_string_set_length (str, orig_len);
3580 array_write_value (TestTypeNode *node,
3582 DBusTypeWriter *writer,
3585 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3586 DataBlockState saved;
3588 DBusString element_signature;
3592 n_copies = node->klass->subclass_detail;
3594 _dbus_assert (container->children != NULL);
3596 data_block_save (block, &saved);
3598 if (!_dbus_string_init (&element_signature))
3601 if (!node_build_signature (_dbus_list_get_first (&container->children),
3602 &element_signature))
3605 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_ARRAY,
3606 &element_signature, 0,
3611 while (i < n_copies)
3615 link = _dbus_list_get_first_link (&container->children);
3616 while (link != NULL)
3618 TestTypeNode *child = link->data;
3619 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3621 if (!node_write_value (child, block, &sub, i))
3630 if (!_dbus_type_writer_unrecurse (writer, &sub))
3633 _dbus_string_free (&element_signature);
3637 data_block_restore (block, &saved);
3638 _dbus_string_free (&element_signature);
3643 array_read_value (TestTypeNode *node,
3645 DBusTypeReader *reader,
3648 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3653 n_copies = node->klass->subclass_detail;
3655 check_expected_type (reader, DBUS_TYPE_ARRAY);
3659 _dbus_assert (!_dbus_type_reader_array_is_empty (reader));
3661 _dbus_type_reader_recurse (reader, &sub);
3664 while (i < n_copies)
3668 link = _dbus_list_get_first_link (&container->children);
3669 while (link != NULL)
3671 TestTypeNode *child = link->data;
3672 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3674 if (!node_read_value (child, block, &sub, i))
3677 if (i == (n_copies - 1) && next == NULL)
3678 NEXT_EXPECTING_FALSE (&sub);
3680 NEXT_EXPECTING_TRUE (&sub);
3690 _dbus_assert (_dbus_type_reader_array_is_empty (reader));
3697 array_build_signature (TestTypeNode *node,
3700 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3703 orig_len = _dbus_string_get_length (str);
3705 if (!_dbus_string_append_byte (str, DBUS_TYPE_ARRAY))
3708 if (!node_build_signature (_dbus_list_get_first (&container->children),
3715 _dbus_string_set_length (str, orig_len);
3719 /* 10 is random just to add another seed that we use in the suite */
3720 #define VARIANT_SEED 10
3723 variant_write_value (TestTypeNode *node,
3725 DBusTypeWriter *writer,
3728 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3729 DataBlockState saved;
3731 DBusString content_signature;
3732 TestTypeNode *child;
3734 _dbus_assert (container->children != NULL);
3735 _dbus_assert (_dbus_list_length_is_one (&container->children));
3737 child = _dbus_list_get_first (&container->children);
3739 data_block_save (block, &saved);
3741 if (!_dbus_string_init (&content_signature))
3744 if (!node_build_signature (child,
3745 &content_signature))
3748 if (!_dbus_type_writer_recurse (writer, DBUS_TYPE_VARIANT,
3749 &content_signature, 0,
3753 if (!node_write_value (child, block, &sub, VARIANT_SEED))
3756 if (!_dbus_type_writer_unrecurse (writer, &sub))
3759 _dbus_string_free (&content_signature);
3763 data_block_restore (block, &saved);
3764 _dbus_string_free (&content_signature);
3769 variant_read_value (TestTypeNode *node,
3771 DBusTypeReader *reader,
3774 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3776 TestTypeNode *child;
3778 _dbus_assert (container->children != NULL);
3779 _dbus_assert (_dbus_list_length_is_one (&container->children));
3781 child = _dbus_list_get_first (&container->children);
3783 check_expected_type (reader, DBUS_TYPE_VARIANT);
3785 _dbus_type_reader_recurse (reader, &sub);
3787 if (!node_read_value (child, block, &sub, VARIANT_SEED))
3790 NEXT_EXPECTING_FALSE (&sub);
3796 container_destroy (TestTypeNode *node)
3798 TestTypeNodeContainer *container = (TestTypeNodeContainer*) node;
3801 link = _dbus_list_get_first_link (&container->children);
3802 while (link != NULL)
3804 TestTypeNode *child = link->data;
3805 DBusList *next = _dbus_list_get_next_link (&container->children, link);
3807 node_destroy (child);
3809 _dbus_list_free_link (link);
3815 #endif /* DBUS_BUILD_TESTS */