1 /* -*- mode: C; c-file-style: "gnu" -*- */
2 /* dbus-marshal.c Marshalling routines
4 * Copyright (C) 2002 CodeFactory AB
5 * Copyright (C) 2003 Red Hat, Inc.
7 * Licensed under the Academic Free License version 2.0
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25 #include "dbus-marshal.h"
26 #include "dbus-internals.h"
27 #define DBUS_CAN_USE_DBUS_STRING_PRIVATE 1
28 #include "dbus-string-private.h"
33 * @defgroup DBusMarshal marshaling and unmarshaling
34 * @ingroup DBusInternals
35 * @brief functions to marshal/unmarshal data from the wire
37 * Types and functions related to converting primitive data types from
38 * wire format to native machine format, and vice versa.
44 unpack_4_octets (int byte_order,
45 const unsigned char *data)
47 _dbus_assert (_DBUS_ALIGN_ADDRESS (data, 4) == data);
49 if (byte_order == DBUS_LITTLE_ENDIAN)
50 return DBUS_UINT32_FROM_LE (*(dbus_uint32_t*)data);
52 return DBUS_UINT32_FROM_BE (*(dbus_uint32_t*)data);
55 #ifndef DBUS_HAVE_INT64
58 swap_bytes (unsigned char *data,
61 unsigned char *p1 = data;
62 unsigned char *p2 = data + len - 1;
66 unsigned char tmp = *p1;
74 #endif /* !DBUS_HAVE_INT64 */
77 * Union used to manipulate 8 bytes as if they
82 #ifdef DBUS_HAVE_INT64
83 dbus_int64_t s; /**< 64-bit integer */
84 dbus_uint64_t u; /**< 64-bit unsinged integer */
86 double d; /**< double */
90 unpack_8_octets (int byte_order,
91 const unsigned char *data)
95 _dbus_assert (_DBUS_ALIGN_ADDRESS (data, 8) == data);
96 _dbus_assert (sizeof (r) == 8);
98 #ifdef DBUS_HAVE_INT64
99 if (byte_order == DBUS_LITTLE_ENDIAN)
100 r.u = DBUS_UINT64_FROM_LE (*(dbus_uint64_t*)data);
102 r.u = DBUS_UINT64_FROM_BE (*(dbus_uint64_t*)data);
104 r.d = *(double*)data;
105 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
106 swap_bytes ((unsigned char*) &r, sizeof (r));
113 * Unpacks a 32 bit unsigned integer from a data pointer
115 * @param byte_order The byte order to use
116 * @param data the data pointer
117 * @returns the integer
120 _dbus_unpack_uint32 (int byte_order,
121 const unsigned char *data)
123 return unpack_4_octets (byte_order, data);
127 * Unpacks a 32 bit signed integer from a data pointer
129 * @param byte_order The byte order to use
130 * @param data the data pointer
131 * @returns the integer
134 _dbus_unpack_int32 (int byte_order,
135 const unsigned char *data)
137 return (dbus_int32_t) unpack_4_octets (byte_order, data);
140 #ifdef DBUS_HAVE_INT64
142 * Unpacks a 64 bit unsigned integer from a data pointer
144 * @param byte_order The byte order to use
145 * @param data the data pointer
146 * @returns the integer
149 _dbus_unpack_uint64 (int byte_order,
150 const unsigned char *data)
154 r = unpack_8_octets (byte_order, data);
160 * Unpacks a 64 bit signed integer from a data pointer
162 * @param byte_order The byte order to use
163 * @param data the data pointer
164 * @returns the integer
167 _dbus_unpack_int64 (int byte_order,
168 const unsigned char *data)
172 r = unpack_8_octets (byte_order, data);
177 #endif /* DBUS_HAVE_INT64 */
180 pack_4_octets (dbus_uint32_t value,
184 _dbus_assert (_DBUS_ALIGN_ADDRESS (data, 4) == data);
186 if ((byte_order) == DBUS_LITTLE_ENDIAN)
187 *((dbus_uint32_t*)(data)) = DBUS_UINT32_TO_LE (value);
189 *((dbus_uint32_t*)(data)) = DBUS_UINT32_TO_BE (value);
193 pack_8_octets (DBusOctets8 value,
197 _dbus_assert (_DBUS_ALIGN_ADDRESS (data, 8) == data);
199 #ifdef DBUS_HAVE_INT64
200 if ((byte_order) == DBUS_LITTLE_ENDIAN)
201 *((dbus_uint64_t*)(data)) = DBUS_UINT64_TO_LE (value.u);
203 *((dbus_uint64_t*)(data)) = DBUS_UINT64_TO_BE (value.u);
205 memcpy (data, &value, 8);
206 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
207 swap_bytes ((unsigned char *)data, 8);
212 * Packs a 32 bit unsigned integer into a data pointer.
214 * @param value the value
215 * @param byte_order the byte order to use
216 * @param data the data pointer
219 _dbus_pack_uint32 (dbus_uint32_t value,
223 pack_4_octets (value, byte_order, data);
227 * Packs a 32 bit signed integer into a data pointer.
229 * @param value the value
230 * @param byte_order the byte order to use
231 * @param data the data pointer
234 _dbus_pack_int32 (dbus_int32_t value,
238 pack_4_octets ((dbus_uint32_t) value, byte_order, data);
241 #ifdef DBUS_HAVE_INT64
243 * Packs a 64 bit unsigned integer into a data pointer.
245 * @param value the value
246 * @param byte_order the byte order to use
247 * @param data the data pointer
250 _dbus_pack_uint64 (dbus_uint64_t value,
256 pack_8_octets (r, byte_order, data);
260 * Packs a 64 bit signed integer into a data pointer.
262 * @param value the value
263 * @param byte_order the byte order to use
264 * @param data the data pointer
267 _dbus_pack_int64 (dbus_int64_t value,
273 pack_8_octets (r, byte_order, data);
275 #endif /* DBUS_HAVE_INT64 */
278 set_4_octets (DBusString *str,
285 _dbus_assert (byte_order == DBUS_LITTLE_ENDIAN ||
286 byte_order == DBUS_BIG_ENDIAN);
288 data = _dbus_string_get_data_len (str, offset, 4);
290 _dbus_pack_uint32 (value, byte_order, data);
294 set_8_octets (DBusString *str,
301 _dbus_assert (byte_order == DBUS_LITTLE_ENDIAN ||
302 byte_order == DBUS_BIG_ENDIAN);
304 data = _dbus_string_get_data_len (str, offset, 8);
306 pack_8_octets (value, byte_order, data);
310 * Sets the 4 bytes at the given offset to a marshaled signed integer,
311 * replacing anything found there previously.
313 * @param str the string to write the marshalled int to
314 * @param offset the byte offset where int should be written
315 * @param byte_order the byte order to use
316 * @param value the value
320 _dbus_marshal_set_int32 (DBusString *str,
325 set_4_octets (str, byte_order, offset, (dbus_uint32_t) value);
329 * Sets the 4 bytes at the given offset to a marshaled unsigned
330 * integer, replacing anything found there previously.
332 * @param str the string to write the marshalled int to
333 * @param offset the byte offset where int should be written
334 * @param byte_order the byte order to use
335 * @param value the value
339 _dbus_marshal_set_uint32 (DBusString *str,
344 set_4_octets (str, byte_order, offset, value);
347 #ifdef DBUS_HAVE_INT64
350 * Sets the 8 bytes at the given offset to a marshaled signed integer,
351 * replacing anything found there previously.
353 * @param str the string to write the marshalled int to
354 * @param offset the byte offset where int should be written
355 * @param byte_order the byte order to use
356 * @param value the value
360 _dbus_marshal_set_int64 (DBusString *str,
367 set_8_octets (str, byte_order, offset, r);
371 * Sets the 8 bytes at the given offset to a marshaled unsigned
372 * integer, replacing anything found there previously.
374 * @param str the string to write the marshalled int to
375 * @param offset the byte offset where int should be written
376 * @param byte_order the byte order to use
377 * @param value the value
381 _dbus_marshal_set_uint64 (DBusString *str,
388 set_8_octets (str, byte_order, offset, r);
390 #endif /* DBUS_HAVE_INT64 */
393 * Sets the existing marshaled string at the given offset with
394 * a new marshaled string. The given offset must point to
395 * an existing string or the wrong length will be deleted
396 * and replaced with the new string.
398 * Note: no attempt is made by this function to re-align
399 * any data which has been already marshalled after this
400 * string. Use with caution.
402 * @param str the string to write the marshalled string to
403 * @param offset the byte offset where string should be written
404 * @param byte_order the byte order to use
405 * @param value the value
406 * @param len the length to use
407 * @returns #TRUE on success
411 _dbus_marshal_set_string (DBusString *str,
414 const DBusString *value,
419 _dbus_assert (byte_order == DBUS_LITTLE_ENDIAN ||
420 byte_order == DBUS_BIG_ENDIAN);
422 old_len = _dbus_demarshal_uint32 (str, byte_order,
425 if (!_dbus_string_replace_len (value, 0, len,
426 str, offset + 4, old_len))
429 _dbus_marshal_set_uint32 (str, byte_order,
436 * Sets the existing marshaled object path at the given offset to a new
437 * value. The given offset must point to an existing object path or this
438 * function doesn't make sense.
440 * @todo implement this function
442 * @param str the string to write the marshalled path to
443 * @param offset the byte offset where path should be written
444 * @param byte_order the byte order to use
445 * @param path the new path
446 * @param path_len number of elements in the path
449 _dbus_marshal_set_object_path (DBusString *str,
460 marshal_4_octets (DBusString *str,
464 _dbus_assert (sizeof (value) == 4);
466 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
467 value = DBUS_UINT32_SWAP_LE_BE (value);
469 return _dbus_string_append_4_aligned (str,
470 (const unsigned char *)&value);
474 marshal_8_octets (DBusString *str,
478 _dbus_assert (sizeof (value) == 8);
480 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
481 pack_8_octets (value, byte_order, (unsigned char*) &value); /* pack into self, swapping as we go */
483 return _dbus_string_append_8_aligned (str,
484 (const unsigned char *)&value);
488 * Marshals a double value.
490 * @param str the string to append the marshalled value to
491 * @param byte_order the byte order to use
492 * @param value the value
493 * @returns #TRUE on success
496 _dbus_marshal_double (DBusString *str,
502 return marshal_8_octets (str, byte_order, r);
506 * Marshals a 32 bit signed integer value.
508 * @param str the string to append the marshalled value to
509 * @param byte_order the byte order to use
510 * @param value the value
511 * @returns #TRUE on success
514 _dbus_marshal_int32 (DBusString *str,
518 return marshal_4_octets (str, byte_order, (dbus_uint32_t) value);
522 * Marshals a 32 bit unsigned integer value.
524 * @param str the string to append the marshalled value to
525 * @param byte_order the byte order to use
526 * @param value the value
527 * @returns #TRUE on success
530 _dbus_marshal_uint32 (DBusString *str,
534 return marshal_4_octets (str, byte_order, value);
538 #ifdef DBUS_HAVE_INT64
540 * Marshals a 64 bit signed integer value.
542 * @param str the string to append the marshalled value to
543 * @param byte_order the byte order to use
544 * @param value the value
545 * @returns #TRUE on success
548 _dbus_marshal_int64 (DBusString *str,
554 return marshal_8_octets (str, byte_order, r);
558 * Marshals a 64 bit unsigned integer value.
560 * @param str the string to append the marshalled value to
561 * @param byte_order the byte order to use
562 * @param value the value
563 * @returns #TRUE on success
566 _dbus_marshal_uint64 (DBusString *str,
572 return marshal_8_octets (str, byte_order, r);
575 #endif /* DBUS_HAVE_INT64 */
578 * Marshals a UTF-8 string
580 * @todo: If the string append fails we need to restore
581 * the old length. (also for other marshallers)
583 * @param str the string to append the marshalled value to
584 * @param byte_order the byte order to use
585 * @param value the string
586 * @returns #TRUE on success
589 _dbus_marshal_string (DBusString *str,
593 int len, old_string_len;
595 old_string_len = _dbus_string_get_length (str);
597 len = strlen (value);
599 if (!_dbus_marshal_uint32 (str, byte_order, len))
601 /* Restore the previous length */
602 _dbus_string_set_length (str, old_string_len);
607 return _dbus_string_append_len (str, value, len + 1);
611 * Marshals a byte array
613 * @param str the string to append the marshalled value to
614 * @param byte_order the byte order to use
615 * @param value the array
616 * @param len number of elements in the array
617 * @returns #TRUE on success
620 _dbus_marshal_byte_array (DBusString *str,
622 const unsigned char *value,
627 old_string_len = _dbus_string_get_length (str);
629 if (!_dbus_marshal_uint32 (str, byte_order, len))
631 /* Restore the previous length */
632 _dbus_string_set_length (str, old_string_len);
640 return _dbus_string_append_len (str, value, len);
644 marshal_4_octets_array (DBusString *str,
646 const dbus_uint32_t *value,
652 old_string_len = _dbus_string_get_length (str);
654 if (!_dbus_marshal_uint32 (str, byte_order, len * 4))
657 array_start = _dbus_string_get_length (str);
659 if (!_dbus_string_append_len (str, (const unsigned char*) value,
663 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
665 const unsigned char *d;
666 const unsigned char *end;
668 d = _dbus_string_get_data (str) + array_start;
672 *((dbus_uint32_t*)d) = DBUS_UINT32_SWAP_LE_BE (*((dbus_uint32_t*)d));
680 /* Restore previous length */
681 _dbus_string_set_length (str, old_string_len);
687 marshal_8_octets_array (DBusString *str,
689 const DBusOctets8 *value,
695 old_string_len = _dbus_string_get_length (str);
697 if (!_dbus_marshal_uint32 (str, byte_order, len * 8))
700 array_start = _dbus_string_get_length (str);
702 if (!_dbus_string_append_len (str, (const unsigned char*) value,
706 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
708 const unsigned char *d;
709 const unsigned char *end;
711 d = _dbus_string_get_data (str) + array_start;
715 #ifdef DBUS_HAVE_INT64
716 *((dbus_uint64_t*)d) = DBUS_UINT64_SWAP_LE_BE (*((dbus_uint64_t*)d));
718 swap_bytes ((unsigned char*) d, 8);
727 /* Restore previous length */
728 _dbus_string_set_length (str, old_string_len);
734 * Marshals a 32 bit signed integer array
736 * @param str the string to append the marshalled value to
737 * @param byte_order the byte order to use
738 * @param value the array
739 * @param len the length of the array
740 * @returns #TRUE on success
743 _dbus_marshal_int32_array (DBusString *str,
745 const dbus_int32_t *value,
748 return marshal_4_octets_array (str, byte_order,
749 (const dbus_uint32_t*) value,
754 * Marshals a 32 bit unsigned integer array
756 * @param str the string to append the marshalled value to
757 * @param byte_order the byte order to use
758 * @param value the array
759 * @param len the length of the array
760 * @returns #TRUE on success
763 _dbus_marshal_uint32_array (DBusString *str,
765 const dbus_uint32_t *value,
768 return marshal_4_octets_array (str, byte_order,
773 #ifdef DBUS_HAVE_INT64
776 * Marshals a 64 bit signed integer array
778 * @param str the string to append the marshalled value to
779 * @param byte_order the byte order to use
780 * @param value the array
781 * @param len the length of the array
782 * @returns #TRUE on success
785 _dbus_marshal_int64_array (DBusString *str,
787 const dbus_int64_t *value,
790 return marshal_8_octets_array (str, byte_order,
791 (const DBusOctets8*) value,
796 * Marshals a 64 bit unsigned integer array
798 * @param str the string to append the marshalled value to
799 * @param byte_order the byte order to use
800 * @param value the array
801 * @param len the length of the array
802 * @returns #TRUE on success
805 _dbus_marshal_uint64_array (DBusString *str,
807 const dbus_uint64_t *value,
810 return marshal_8_octets_array (str, byte_order,
811 (const DBusOctets8*) value,
815 #endif /* DBUS_HAVE_INT64 */
818 * Marshals a double array
820 * @param str the string to append the marshalled value to
821 * @param byte_order the byte order to use
822 * @param value the array
823 * @param len the length of the array
824 * @returns #TRUE on success
827 _dbus_marshal_double_array (DBusString *str,
832 return marshal_8_octets_array (str, byte_order,
833 (const DBusOctets8*) value,
838 * Marshals a string array
840 * @param str the string to append the marshalled value to
841 * @param byte_order the byte order to use
842 * @param value the array
843 * @param len the length of the array
844 * @returns #TRUE on success
847 _dbus_marshal_string_array (DBusString *str,
852 int i, old_string_len, array_start;
854 old_string_len = _dbus_string_get_length (str);
856 /* Set the length to 0 temporarily */
857 if (!_dbus_marshal_uint32 (str, byte_order, 0))
860 array_start = _dbus_string_get_length (str);
862 for (i = 0; i < len; i++)
863 if (!_dbus_marshal_string (str, byte_order, value[i]))
866 /* Write the length now that we know it */
867 _dbus_marshal_set_uint32 (str, byte_order,
868 _DBUS_ALIGN_VALUE (old_string_len, sizeof(dbus_uint32_t)),
869 _dbus_string_get_length (str) - array_start);
874 /* Restore previous length */
875 _dbus_string_set_length (str, old_string_len);
881 * Marshals an object path value.
883 * @param str the string to append the marshalled value to
884 * @param byte_order the byte order to use
885 * @param path the path
886 * @param path_len length of the path
887 * @returns #TRUE on success
890 _dbus_marshal_object_path (DBusString *str,
895 int array_start, old_string_len;
898 old_string_len = _dbus_string_get_length (str);
900 /* Set the length to 0 temporarily */
901 if (!_dbus_marshal_uint32 (str, byte_order, 0))
904 array_start = _dbus_string_get_length (str);
909 if (!_dbus_string_append_byte (str, '/'))
912 if (!_dbus_string_append (str, path[0]))
918 /* Write the length now that we know it */
919 _dbus_marshal_set_uint32 (str, byte_order,
920 _DBUS_ALIGN_VALUE (old_string_len, sizeof(dbus_uint32_t)),
921 _dbus_string_get_length (str) - array_start);
926 /* Restore the previous length */
927 _dbus_string_set_length (str, old_string_len);
933 demarshal_4_octets (const DBusString *str,
938 const DBusRealString *real = (const DBusRealString*) str;
940 pos = _DBUS_ALIGN_VALUE (pos, 4);
945 return unpack_4_octets (byte_order, real->str + pos);
949 demarshal_8_octets (const DBusString *str,
954 const DBusRealString *real = (const DBusRealString*) str;
956 pos = _DBUS_ALIGN_VALUE (pos, 8);
961 return unpack_8_octets (byte_order, real->str + pos);
965 * Demarshals a double.
967 * @param str the string containing the data
968 * @param byte_order the byte order
969 * @param pos the position in the string
970 * @param new_pos the new position of the string
971 * @returns the demarshaled double.
974 _dbus_demarshal_double (const DBusString *str,
981 r = demarshal_8_octets (str, byte_order, pos, new_pos);
987 * Demarshals a 32 bit signed integer.
989 * @param str the string containing the data
990 * @param byte_order the byte order
991 * @param pos the position in the string
992 * @param new_pos the new position of the string
993 * @returns the demarshaled integer.
996 _dbus_demarshal_int32 (const DBusString *str,
1001 return (dbus_int32_t) demarshal_4_octets (str, byte_order, pos, new_pos);
1005 * Demarshals a 32 bit unsigned integer.
1007 * @param str the string containing the data
1008 * @param byte_order the byte order
1009 * @param pos the position in the string
1010 * @param new_pos the new position of the string
1011 * @returns the demarshaled integer.
1014 _dbus_demarshal_uint32 (const DBusString *str,
1019 return demarshal_4_octets (str, byte_order, pos, new_pos);
1022 #ifdef DBUS_HAVE_INT64
1025 * Demarshals a 64 bit signed integer.
1027 * @param str the string containing the data
1028 * @param byte_order the byte order
1029 * @param pos the position in the string
1030 * @param new_pos the new position of the string
1031 * @returns the demarshaled integer.
1034 _dbus_demarshal_int64 (const DBusString *str,
1041 r = demarshal_8_octets (str, byte_order, pos, new_pos);
1047 * Demarshals a 64 bit unsigned integer.
1049 * @param str the string containing the data
1050 * @param byte_order the byte order
1051 * @param pos the position in the string
1052 * @param new_pos the new position of the string
1053 * @returns the demarshaled integer.
1056 _dbus_demarshal_uint64 (const DBusString *str,
1063 r = demarshal_8_octets (str, byte_order, pos, new_pos);
1068 #endif /* DBUS_HAVE_INT64 */
1071 * Demarshals a basic type
1073 * @param str the string containing the data
1074 * @param type type of value to demarshal
1075 * @param value pointer to return value data
1076 * @param byte_order the byte order
1077 * @param pos pointer to position in the string,
1078 * updated on return to new position
1081 _dbus_demarshal_basic_type (const DBusString *str,
1087 const char *str_data = _dbus_string_get_const_data (str);
1091 case DBUS_TYPE_BYTE:
1092 case DBUS_TYPE_BOOLEAN:
1093 *(unsigned char *) value = _dbus_string_get_byte (str, *pos);
1096 case DBUS_TYPE_INT32:
1097 case DBUS_TYPE_UINT32:
1098 *pos = _DBUS_ALIGN_VALUE (*pos, 4);
1099 *(dbus_uint32_t *) value = *(dbus_uint32_t *)(str_data + *pos);
1100 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
1101 *(dbus_uint32_t *) value = DBUS_UINT32_SWAP_LE_BE (*(dbus_uint32_t *) value);
1104 #ifdef DBUS_HAVE_INT64
1105 case DBUS_TYPE_INT64:
1106 case DBUS_TYPE_UINT64:
1107 #endif /* DBUS_HAVE_INT64 */
1108 case DBUS_TYPE_DOUBLE:
1109 *pos = _DBUS_ALIGN_VALUE (*pos, 8);
1110 memcpy (value, str_data + *pos, 8);
1111 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
1112 #ifdef DBUS_HAVE_INT64
1113 *(dbus_uint64_t *) value = DBUS_UINT64_SWAP_LE_BE (*(dbus_uint64_t *) value);
1115 swap_bytes (value, 8);
1120 _dbus_assert_not_reached ("not a basic type");
1126 * Demarshals an UTF-8 string.
1128 * @todo Should we check the string to make sure
1129 * that it's valid UTF-8, and maybe "fix" the string
1132 * @todo Should probably demarshal to a DBusString,
1133 * having memcpy() in here is Evil(tm).
1135 * @param str the string containing the data
1136 * @param byte_order the byte order
1137 * @param pos the position in the string
1138 * @param new_pos the new position of the string
1139 * @returns the demarshaled string.
1142 _dbus_demarshal_string (const DBusString *str,
1151 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1153 retval = dbus_malloc (len + 1);
1158 data = _dbus_string_get_const_data_len (str, pos, len + 1);
1163 memcpy (retval, data, len + 1);
1166 *new_pos = pos + len + 1;
1172 * Demarshals a byte array.
1174 * @todo Should probably demarshal to a DBusString,
1175 * having memcpy() in here is Evil(tm).
1177 * @param str the string containing the data
1178 * @param byte_order the byte order
1179 * @param pos the position in the string
1180 * @param new_pos the new position of the string
1181 * @param array the array
1182 * @param array_len length of the demarshaled data
1184 * @returns #TRUE on success
1187 _dbus_demarshal_byte_array (const DBusString *str,
1191 unsigned char **array,
1195 unsigned char *retval;
1198 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1211 retval = dbus_malloc (len);
1216 data = _dbus_string_get_const_data_len (str, pos, len);
1224 memcpy (retval, data, len);
1227 *new_pos = pos + len;
1236 demarshal_4_octets_array (const DBusString *str,
1240 dbus_uint32_t **array,
1244 dbus_uint32_t *retval;
1247 byte_len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1261 if (!_dbus_string_copy_data_len (str, (char**) &retval,
1265 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
1267 for (i = 0; i < len; i++)
1268 retval[i] = DBUS_UINT32_SWAP_LE_BE (retval[i]);
1272 *new_pos = pos + byte_len;
1281 demarshal_8_octets_array (const DBusString *str,
1285 DBusOctets8 **array,
1289 DBusOctets8 *retval;
1292 byte_len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1306 if (!_dbus_string_copy_data_len (str, (char**) &retval,
1310 if (byte_order != DBUS_COMPILER_BYTE_ORDER)
1312 for (i = 0; i < len; i++)
1314 #ifdef DBUS_HAVE_INT64
1315 retval[i].u = DBUS_UINT64_SWAP_LE_BE (retval[i].u);
1317 swap_bytes ((unsigned char *) &retval[i], 8);
1323 *new_pos = pos + byte_len;
1332 * Demarshals a 32 bit signed integer array.
1334 * @param str the string containing the data
1335 * @param byte_order the byte order
1336 * @param pos the position in the string
1337 * @param new_pos the new position of the string
1338 * @param array the array
1339 * @param array_len length of the demarshaled data
1340 * @returns #TRUE on success
1343 _dbus_demarshal_int32_array (const DBusString *str,
1347 dbus_int32_t **array,
1350 return demarshal_4_octets_array (str, byte_order, pos, new_pos,
1351 (dbus_uint32_t**) array, array_len);
1355 * Demarshals a 32 bit unsigned integer array.
1357 * @param str the string containing the data
1358 * @param byte_order the byte order
1359 * @param pos the position in the string
1360 * @param new_pos the new position of the string
1361 * @param array the array
1362 * @param array_len length of the demarshaled data
1363 * @returns #TRUE on success
1366 _dbus_demarshal_uint32_array (const DBusString *str,
1370 dbus_uint32_t **array,
1373 return demarshal_4_octets_array (str, byte_order, pos, new_pos,
1377 #ifdef DBUS_HAVE_INT64
1380 * Demarshals a 64 bit signed integer array.
1382 * @param str the string containing the data
1383 * @param byte_order the byte order
1384 * @param pos the position in the string
1385 * @param new_pos the new position of the string
1386 * @param array the array
1387 * @param array_len length of the demarshaled data
1388 * @returns #TRUE on success
1391 _dbus_demarshal_int64_array (const DBusString *str,
1395 dbus_int64_t **array,
1398 return demarshal_8_octets_array (str, byte_order, pos, new_pos,
1399 (DBusOctets8**) array, array_len);
1403 * Demarshals a 64 bit unsigned integer array.
1405 * @param str the string containing the data
1406 * @param byte_order the byte order
1407 * @param pos the position in the string
1408 * @param new_pos the new position of the string
1409 * @param array the array
1410 * @param array_len length of the demarshaled data
1411 * @returns #TRUE on success
1414 _dbus_demarshal_uint64_array (const DBusString *str,
1418 dbus_uint64_t **array,
1421 return demarshal_8_octets_array (str, byte_order, pos, new_pos,
1422 (DBusOctets8**) array, array_len);
1425 #endif /* DBUS_HAVE_INT64 */
1428 * Demarshals a double array.
1430 * @param str the string containing the data
1431 * @param byte_order the byte order
1432 * @param pos the position in the string
1433 * @param new_pos the new position of the string
1434 * @param array the array
1435 * @param array_len length of the demarshaled data
1436 * @returns #TRUE on success
1439 _dbus_demarshal_double_array (const DBusString *str,
1446 return demarshal_8_octets_array (str, byte_order, pos, new_pos,
1447 (DBusOctets8**) array, array_len);
1452 * Demarshals an array of basic types
1454 * @param str the string containing the data
1455 * @param element_type type of array elements to demarshal
1456 * @param array pointer to pointer to array data
1457 * @param array_len pointer to array length
1458 * @param byte_order the byte order
1459 * @param pos pointer to position in the string,
1460 * updated on return to new position
1463 _dbus_demarshal_basic_type_array (const DBusString *str,
1470 switch (element_type)
1472 case DBUS_TYPE_BOOLEAN:
1473 /* FIXME: do we want to post-normalize these ? */
1474 case DBUS_TYPE_BYTE:
1475 return _dbus_demarshal_byte_array (str, byte_order, *pos, pos,
1476 (unsigned char **)array, array_len);
1478 case DBUS_TYPE_INT32:
1479 case DBUS_TYPE_UINT32:
1480 return demarshal_4_octets_array (str, byte_order, *pos, pos,
1481 (dbus_uint32_t **)array, array_len);
1483 #ifdef DBUS_HAVE_INT64
1484 case DBUS_TYPE_INT64:
1485 case DBUS_TYPE_UINT64:
1486 #endif /* DBUS_HAVE_INT64 */
1487 case DBUS_TYPE_DOUBLE:
1488 return demarshal_8_octets_array (str, byte_order, *pos, pos,
1489 (DBusOctets8**) array, array_len);
1491 _dbus_assert_not_reached ("not a basic type");
1498 * Demarshals a string array.
1500 * @param str the string containing the data
1501 * @param byte_order the byte order
1502 * @param pos the position in the string
1503 * @param new_pos the new position of the string
1504 * @param array the array
1505 * @param array_len location for length of the demarshaled data or NULL
1506 * @returns #TRUE on success
1509 _dbus_demarshal_string_array (const DBusString *str,
1521 bytes_len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1536 end_pos = pos + bytes_len;
1538 retval = dbus_new (char *, allocated);
1543 while (pos < end_pos)
1545 retval[len] = _dbus_demarshal_string (str, byte_order, pos, &pos);
1547 if (retval[len] == NULL)
1552 if (len >= allocated - 1) /* -1 for NULL termination */
1555 newp = dbus_realloc (retval,
1556 sizeof (char*) * allocated * 2);
1576 for (i = 0; i < len; i++)
1577 dbus_free (retval[i]);
1583 /** Set to 1 to get a bunch of spew about disassembling the path string */
1584 #define VERBOSE_DECOMPOSE 0
1587 * Decompose an object path. A path of just "/" is
1588 * represented as an empty vector of strings.
1590 * @param data the path data
1591 * @param len the length of the path string
1592 * @param path address to store new object path
1593 * @param path_len length of stored path
1596 _dbus_decompose_path (const char* data,
1605 _dbus_assert (data != NULL);
1607 #if VERBOSE_DECOMPOSE
1608 _dbus_verbose ("Decomposing path \"%s\"\n",
1621 retval = dbus_new0 (char*, n_components + 1);
1634 while (j < len && data[j] != '/')
1637 /* Now [i, j) is the path component */
1638 _dbus_assert (i < j);
1639 _dbus_assert (data[i] != '/');
1640 _dbus_assert (j == len || data[j] == '/');
1642 #if VERBOSE_DECOMPOSE
1643 _dbus_verbose (" (component in [%d,%d))\n",
1647 retval[comp] = _dbus_memdup (&data[i], j - i + 1);
1648 if (retval[comp] == NULL)
1650 dbus_free_string_array (retval);
1653 retval[comp][j-i] = '\0';
1654 #if VERBOSE_DECOMPOSE
1655 _dbus_verbose (" (component %d = \"%s\")\n",
1656 comp, retval[comp]);
1662 _dbus_assert (i == len);
1666 *path_len = n_components;
1672 * Demarshals an object path. A path of just "/" is
1673 * represented as an empty vector of strings.
1675 * @param str the string containing the data
1676 * @param byte_order the byte order
1677 * @param pos the position in the string
1678 * @param new_pos the new position of the string
1679 * @param path address to store new object path
1680 * @param path_len length of stored path
1683 _dbus_demarshal_object_path (const DBusString *str,
1693 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1694 data = _dbus_string_get_const_data_len (str, pos, len + 1);
1696 if (!_dbus_decompose_path (data, len, path, path_len))
1700 *new_pos = pos + len + 1;
1706 * Returns the position right after the end of an argument. PERFORMS
1707 * NO VALIDATION WHATSOEVER. The message must have been previously
1710 * @param str a string
1711 * @param byte_order the byte order to use
1712 * @param type the type of the argument
1713 * @param pos the pos where the arg starts
1714 * @param end_pos pointer where the position right
1715 * after the end position will follow
1716 * @returns TRUE if more data exists after the arg
1719 _dbus_marshal_get_arg_end_pos (const DBusString *str,
1725 if (pos >= _dbus_string_get_length (str))
1730 case DBUS_TYPE_INVALID:
1738 case DBUS_TYPE_BYTE:
1742 case DBUS_TYPE_BOOLEAN:
1746 case DBUS_TYPE_INT32:
1747 case DBUS_TYPE_UINT32:
1748 *end_pos = _DBUS_ALIGN_VALUE (pos, 4) + 4;
1751 case DBUS_TYPE_INT64:
1752 case DBUS_TYPE_UINT64:
1753 case DBUS_TYPE_DOUBLE:
1755 *end_pos = _DBUS_ALIGN_VALUE (pos, 8) + 8;
1758 case DBUS_TYPE_OBJECT_PATH:
1759 case DBUS_TYPE_STRING:
1763 /* Demarshal the length */
1764 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1766 *end_pos = pos + len + 1;
1770 case DBUS_TYPE_CUSTOM:
1774 /* Demarshal the string length */
1775 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1779 /* Demarshal the data length */
1780 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1782 *end_pos = pos + len;
1786 case DBUS_TYPE_ARRAY:
1790 /* Demarshal the length */
1791 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1793 *end_pos = pos + len;
1797 case DBUS_TYPE_DICT:
1801 /* Demarshal the length */
1802 len = _dbus_demarshal_uint32 (str, byte_order, pos, &pos);
1804 *end_pos = pos + len;
1809 _dbus_warn ("Unknown message arg type %d\n", type);
1810 _dbus_assert_not_reached ("Unknown message argument type\n");
1814 if (*end_pos > _dbus_string_get_length (str))
1821 * Demarshals and validates a length; returns < 0 if the validation
1822 * fails. The length is required to be small enough that
1823 * len*sizeof(double) will not overflow, and small enough to fit in a
1824 * signed integer. DOES NOT check whether the length points
1825 * beyond the end of the string, because it doesn't know the
1826 * size of array elements.
1828 * @param str the string
1829 * @param byte_order the byte order
1830 * @param pos the unaligned string position (snap to next aligned)
1831 * @param new_pos return location for new position.
1834 demarshal_and_validate_len (const DBusString *str,
1839 int align_4 = _DBUS_ALIGN_VALUE (pos, 4);
1842 _dbus_assert (new_pos != NULL);
1844 if ((align_4 + 4) > _dbus_string_get_length (str))
1846 _dbus_verbose ("not enough room in message for array length\n");
1850 if (!_dbus_string_validate_nul (str, pos,
1853 _dbus_verbose ("array length alignment padding not initialized to nul at %d\n", pos);
1857 len = _dbus_demarshal_uint32 (str, byte_order, align_4, new_pos);
1859 /* note that the len is the number of bytes, so we need it to be
1860 * at least SIZE_T_MAX, but make it smaller just to keep things
1861 * sane. We end up using ints for most sizes to avoid unsigned mess
1862 * so limit to maximum 32-bit signed int divided by at least 8, more
1863 * for a bit of paranoia margin. INT_MAX/32 is about 65 megabytes.
1865 #define MAX_ARRAY_LENGTH (((unsigned int)_DBUS_INT_MAX) / 32)
1866 if (len > MAX_ARRAY_LENGTH)
1868 _dbus_verbose ("array length %u exceeds maximum of %u at pos %d\n",
1869 len, MAX_ARRAY_LENGTH, pos);
1877 validate_string (const DBusString *str,
1879 int len_without_nul,
1882 *end_pos = pos + len_without_nul + 1;
1884 if (*end_pos > _dbus_string_get_length (str))
1886 _dbus_verbose ("string length outside length of the message\n");
1890 if (_dbus_string_get_byte (str, pos + len_without_nul) != '\0')
1892 _dbus_verbose ("string arg not nul-terminated\n");
1896 if (!_dbus_string_validate_utf8 (str, pos, len_without_nul))
1898 _dbus_verbose ("string is not valid UTF-8\n");
1906 * Validates and returns a typecode at a specific position
1909 * @param str a string
1910 * @param type the type of the argument
1911 * @param pos the pos where the typecode starts
1912 * @param end_pos pointer where the position right
1913 * after the end position will follow
1914 * @returns #TRUE if the type is valid.
1917 _dbus_marshal_validate_type (const DBusString *str,
1924 if (pos >= _dbus_string_get_length (str))
1927 data = _dbus_string_get_const_data_len (str, pos, 1);
1929 if (_dbus_type_is_valid (*data))
1932 if (end_pos != NULL)
1937 _dbus_verbose ("'%c' %d invalid type code\n", (int) *data, (int) *data);
1942 /* Faster validator for array data that doesn't call
1943 * validate_arg for each value
1946 validate_array_data (const DBusString *str,
1957 case DBUS_TYPE_INVALID:
1964 case DBUS_TYPE_OBJECT_PATH:
1965 case DBUS_TYPE_STRING:
1966 case DBUS_TYPE_CUSTOM:
1967 case DBUS_TYPE_ARRAY:
1968 case DBUS_TYPE_DICT:
1969 /* This clean recursion to validate_arg is what we
1970 * are doing logically for all types, but we don't
1971 * really want to call validate_arg for every byte
1972 * in a byte array, so the primitive types are
1977 if (!_dbus_marshal_validate_arg (str, byte_order, depth,
1978 type, array_type_pos, pos, &pos))
1983 case DBUS_TYPE_BYTE:
1987 case DBUS_TYPE_BOOLEAN:
1992 c = _dbus_string_get_byte (str, pos);
1994 if (!(c == 0 || c == 1))
1996 _dbus_verbose ("boolean value must be either 0 or 1, not %d\n", c);
2004 case DBUS_TYPE_INT32:
2005 case DBUS_TYPE_UINT32:
2006 /* Call validate arg one time to check alignment padding
2009 if (!_dbus_marshal_validate_arg (str, byte_order, depth,
2010 type, array_type_pos, pos, &pos))
2012 pos = _DBUS_ALIGN_VALUE (end, 4);
2015 case DBUS_TYPE_INT64:
2016 case DBUS_TYPE_UINT64:
2017 case DBUS_TYPE_DOUBLE:
2018 /* Call validate arg one time to check alignment padding
2021 if (!_dbus_marshal_validate_arg (str, byte_order, depth,
2022 type, array_type_pos, pos, &pos))
2024 pos = _DBUS_ALIGN_VALUE (end, 8);
2028 _dbus_verbose ("Unknown message arg type %d\n", type);
2038 * Validates an argument of a specific type, checking that it
2039 * is well-formed, for example no ludicrous length fields, strings
2040 * are nul-terminated, etc.
2041 * Returns the end position of the argument in end_pos, and
2042 * returns #TRUE if a valid arg begins at "pos"
2044 * @todo security: need to audit this function.
2046 * @param str a string
2047 * @param byte_order the byte order to use
2048 * @param depth current recursion depth, to prevent excessive recursion
2049 * @param type the type of the argument
2050 * @param array_type_pos the position of the current array type, or
2051 * -1 if not in an array
2052 * @param pos the pos where the arg starts
2053 * @param end_pos pointer where the position right
2054 * after the end position will follow
2055 * @returns #TRUE if the arg is valid.
2058 _dbus_marshal_validate_arg (const DBusString *str,
2066 if (pos > _dbus_string_get_length (str))
2068 _dbus_verbose ("Validation went off the end of the message\n");
2072 #define MAX_VALIDATION_DEPTH 32
2074 if (depth > MAX_VALIDATION_DEPTH)
2076 _dbus_verbose ("Maximum recursion depth reached validating message\n");
2082 case DBUS_TYPE_INVALID:
2090 case DBUS_TYPE_BYTE:
2091 if (1 > _dbus_string_get_length (str) - pos)
2093 _dbus_verbose ("no room for byte value\n");
2100 case DBUS_TYPE_BOOLEAN:
2104 if (1 > _dbus_string_get_length (str) - pos)
2106 _dbus_verbose ("no room for boolean value\n");
2110 c = _dbus_string_get_byte (str, pos);
2112 if (!(c == 0 || c == 1))
2114 _dbus_verbose ("boolean value must be either 0 or 1, not %d\n", c);
2122 case DBUS_TYPE_INT32:
2123 case DBUS_TYPE_UINT32:
2125 int align_4 = _DBUS_ALIGN_VALUE (pos, 4);
2127 if (!_dbus_string_validate_nul (str, pos,
2130 _dbus_verbose ("int32/uint32 alignment padding not initialized to nul\n");
2134 *end_pos = align_4 + 4;
2138 case DBUS_TYPE_INT64:
2139 case DBUS_TYPE_UINT64:
2140 case DBUS_TYPE_DOUBLE:
2142 int align_8 = _DBUS_ALIGN_VALUE (pos, 8);
2144 _dbus_verbose_bytes_of_string (str, pos, (align_8 + 8 - pos));
2146 if (!_dbus_string_validate_nul (str, pos,
2149 _dbus_verbose ("double/int64/uint64/objid alignment padding not initialized to nul at %d\n", pos);
2153 *end_pos = align_8 + 8;
2157 case DBUS_TYPE_OBJECT_PATH:
2158 case DBUS_TYPE_STRING:
2162 /* Demarshal the length, which does NOT include
2165 len = demarshal_and_validate_len (str, byte_order, pos, &pos);
2169 if (!validate_string (str, pos, len, end_pos))
2172 if (type == DBUS_TYPE_OBJECT_PATH)
2174 if (!_dbus_string_validate_path (str, pos, len))
2180 case DBUS_TYPE_CUSTOM:
2184 /* Demarshal the string length, which does NOT include
2187 len = demarshal_and_validate_len (str, byte_order, pos, &pos);
2191 if (!validate_string (str, pos, len, &pos))
2195 len = demarshal_and_validate_len (str, byte_order, pos, &pos);
2199 *end_pos = pos + len;
2203 case DBUS_TYPE_ARRAY:
2209 if (array_type_pos == -1)
2211 array_type_pos = pos;
2215 if (!_dbus_marshal_validate_type (str, pos, &array_type, &pos))
2217 _dbus_verbose ("invalid array type\n");
2221 /* NIL values take up no space, so you couldn't iterate over an array of them.
2222 * array of nil seems useless anyway; the useful thing might be array of
2223 * (nil OR string) but we have no framework for that.
2225 if (array_type == DBUS_TYPE_NIL)
2227 _dbus_verbose ("array of NIL is not allowed\n");
2231 while (array_type == DBUS_TYPE_ARRAY);
2236 if (!_dbus_marshal_validate_type (str, array_type_pos, &array_type, NULL))
2238 _dbus_verbose ("invalid array type\n");
2242 len = demarshal_and_validate_len (str, byte_order, pos, &pos);
2245 _dbus_verbose ("invalid array length (<0)\n");
2249 if (len > _dbus_string_get_length (str) - pos)
2251 _dbus_verbose ("array length outside length of the message\n");
2257 if (len > 0 && !validate_array_data (str, byte_order, depth + 1,
2258 array_type, array_type_pos,
2261 _dbus_verbose ("invalid array data\n");
2267 /* This should not be able to happen, as long as validate_arg moves forward;
2268 * but the check is here just to be paranoid.
2270 _dbus_verbose ("array length %d specified was longer than actual array contents by %d\n",
2277 _dbus_verbose ("array contents exceeds array length %d by %d\n", len, pos - end);
2285 case DBUS_TYPE_DICT:
2291 len = demarshal_and_validate_len (str, byte_order, pos, &pos);
2295 if (len > _dbus_string_get_length (str) - pos)
2297 _dbus_verbose ("dict length outside length of the message\n");
2306 if (!_dbus_marshal_validate_arg (str, byte_order, depth + 1,
2307 DBUS_TYPE_STRING, -1, pos, &pos))
2310 if (!_dbus_marshal_validate_type (str, pos, &dict_type, &pos))
2312 _dbus_verbose ("invalid dict entry type at offset %d\n", pos);
2316 /* Validate element */
2317 if (!_dbus_marshal_validate_arg (str, byte_order, depth + 1,
2318 dict_type, -1, pos, &pos))
2320 _dbus_verbose ("dict arg invalid at offset %d\n", pos);
2327 _dbus_verbose ("dict contents exceed stated dict length\n");
2336 _dbus_verbose ("Unknown message arg type %d\n", type);
2340 if (*end_pos > _dbus_string_get_length (str))
2347 * Return #TRUE if the typecode is a valid typecode
2349 * @returns #TRUE if valid
2352 _dbus_type_is_valid (int typecode)
2357 case DBUS_TYPE_BYTE:
2358 case DBUS_TYPE_BOOLEAN:
2359 case DBUS_TYPE_INT32:
2360 case DBUS_TYPE_UINT32:
2361 case DBUS_TYPE_INT64:
2362 case DBUS_TYPE_UINT64:
2363 case DBUS_TYPE_DOUBLE:
2364 case DBUS_TYPE_STRING:
2365 case DBUS_TYPE_CUSTOM:
2366 case DBUS_TYPE_ARRAY:
2367 case DBUS_TYPE_DICT:
2368 case DBUS_TYPE_OBJECT_PATH:
2377 * If in verbose mode, print a block of binary data.
2379 * @todo right now it prints even if not in verbose mode
2381 * @param data the data
2382 * @param len the length of the data
2385 _dbus_verbose_bytes (const unsigned char *data,
2389 const unsigned char *aligned;
2391 _dbus_assert (len >= 0);
2393 /* Print blanks on first row if appropriate */
2394 aligned = _DBUS_ALIGN_ADDRESS (data, 4);
2397 _dbus_assert (aligned <= data);
2399 if (aligned != data)
2401 _dbus_verbose ("%4d\t%p: ", - (data - aligned), aligned);
2402 while (aligned != data)
2404 _dbus_verbose (" ");
2409 /* now print the bytes */
2413 if (_DBUS_ALIGN_ADDRESS (&data[i], 4) == &data[i])
2415 _dbus_verbose ("%4d\t%p: ",
2419 if (data[i] >= 32 &&
2421 _dbus_verbose (" '%c' ", data[i]);
2423 _dbus_verbose ("0x%s%x ",
2424 data[i] <= 0xf ? "0" : "", data[i]);
2428 if (_DBUS_ALIGN_ADDRESS (&data[i], 4) == &data[i])
2431 _dbus_verbose ("BE: %d LE: %d",
2432 _dbus_unpack_uint32 (DBUS_BIG_ENDIAN, &data[i-4]),
2433 _dbus_unpack_uint32 (DBUS_LITTLE_ENDIAN, &data[i-4]));
2436 _DBUS_ALIGN_ADDRESS (&data[i], 8) == &data[i])
2438 _dbus_verbose (" dbl: %g",
2439 *(double*)&data[i-8]);
2442 _dbus_verbose ("\n");
2446 _dbus_verbose ("\n");
2450 * Dump the given part of the string to verbose log.
2452 * @param str the string
2453 * @param start the start of range to dump
2454 * @param len length of range
2457 _dbus_verbose_bytes_of_string (const DBusString *str,
2464 real_len = _dbus_string_get_length (str);
2466 _dbus_assert (start >= 0);
2468 if (start > real_len)
2470 _dbus_verbose (" [%d,%d) is not inside string of length %d\n",
2471 start, len, real_len);
2475 if ((start + len) > real_len)
2477 _dbus_verbose (" [%d,%d) extends outside string of length %d\n",
2478 start, len, real_len);
2479 len = real_len - start;
2482 d = _dbus_string_get_const_data_len (str, start, len);
2484 _dbus_verbose_bytes (d, len);
2488 * Marshals a basic type
2490 * @param str string to marshal to
2491 * @param type type of value
2492 * @param value pointer to value
2493 * @param byte_order byte order
2494 * @returns #TRUE on success
2497 _dbus_marshal_basic_type (DBusString *str,
2506 case DBUS_TYPE_BYTE:
2507 case DBUS_TYPE_BOOLEAN:
2508 retval = _dbus_string_append_byte (str, *(unsigned char *)value);
2510 case DBUS_TYPE_INT32:
2511 case DBUS_TYPE_UINT32:
2512 return marshal_4_octets (str, byte_order, *(dbus_uint32_t *)value);
2514 #ifdef DBUS_HAVE_INT64
2515 case DBUS_TYPE_INT64:
2516 case DBUS_TYPE_UINT64:
2517 retval = _dbus_marshal_uint64 (str, byte_order, *(dbus_uint64_t *)value);
2519 #endif /* DBUS_HAVE_INT64 */
2520 case DBUS_TYPE_DOUBLE:
2521 retval = _dbus_marshal_double (str, byte_order, *(double *)value);
2524 _dbus_assert_not_reached ("not a basic type");
2532 * Marshals a basic type array
2534 * @param str string to marshal to
2535 * @param element_type type of array elements
2536 * @param value pointer to value
2537 * @param len length of value data in elements
2538 * @param byte_order byte order
2539 * @returns #TRUE on success
2542 _dbus_marshal_basic_type_array (DBusString *str,
2548 switch (element_type)
2550 case DBUS_TYPE_BOOLEAN:
2551 /* FIXME: we canonicalize to 0 or 1 for the single boolean case
2552 * should we here too ? */
2553 case DBUS_TYPE_BYTE:
2554 return _dbus_marshal_byte_array (str, byte_order, value, len);
2556 case DBUS_TYPE_INT32:
2557 case DBUS_TYPE_UINT32:
2558 return marshal_4_octets_array (str, byte_order, value, len);
2560 #ifdef DBUS_HAVE_INT64
2561 case DBUS_TYPE_INT64:
2562 case DBUS_TYPE_UINT64:
2563 #endif /* DBUS_HAVE_INT64 */
2564 case DBUS_TYPE_DOUBLE:
2565 return marshal_8_octets_array (str, byte_order, value, len);
2568 _dbus_assert_not_reached ("non basic type in array");
2576 #ifdef DBUS_BUILD_TESTS
2577 #include "dbus-test.h"
2581 _dbus_marshal_test (void)
2586 dbus_int32_t array1[3] = { 0x123, 0x456, 0x789 }, *array2;
2587 #ifdef DBUS_HAVE_INT64
2588 dbus_int64_t array3[3] = { DBUS_INT64_CONSTANT (0x123ffffffff),
2589 DBUS_INT64_CONSTANT (0x456ffffffff),
2590 DBUS_INT64_CONSTANT (0x789ffffffff) }, *array4;
2595 if (!_dbus_string_init (&str))
2596 _dbus_assert_not_reached ("failed to init string");
2598 /* Marshal doubles */
2599 if (!_dbus_marshal_double (&str, DBUS_BIG_ENDIAN, 3.14))
2600 _dbus_assert_not_reached ("could not marshal double value");
2601 if (!_dbus_demarshal_double (&str, DBUS_BIG_ENDIAN, pos, &pos) == 3.14)
2602 _dbus_assert_not_reached ("demarshal failed");
2604 if (!_dbus_marshal_double (&str, DBUS_LITTLE_ENDIAN, 3.14))
2605 _dbus_assert_not_reached ("could not marshal double value");
2606 if (!_dbus_demarshal_double (&str, DBUS_LITTLE_ENDIAN, pos, &pos) == 3.14)
2607 _dbus_assert_not_reached ("demarshal failed");
2609 /* Marshal signed integers */
2610 if (!_dbus_marshal_int32 (&str, DBUS_BIG_ENDIAN, -12345678))
2611 _dbus_assert_not_reached ("could not marshal signed integer value");
2612 if (!_dbus_demarshal_int32 (&str, DBUS_BIG_ENDIAN, pos, &pos) == -12345678)
2613 _dbus_assert_not_reached ("demarshal failed");
2615 if (!_dbus_marshal_int32 (&str, DBUS_LITTLE_ENDIAN, -12345678))
2616 _dbus_assert_not_reached ("could not marshal signed integer value");
2617 if (!_dbus_demarshal_int32 (&str, DBUS_LITTLE_ENDIAN, pos, &pos) == -12345678)
2618 _dbus_assert_not_reached ("demarshal failed");
2620 /* Marshal unsigned integers */
2621 if (!_dbus_marshal_uint32 (&str, DBUS_BIG_ENDIAN, 0x12345678))
2622 _dbus_assert_not_reached ("could not marshal signed integer value");
2623 if (!_dbus_demarshal_uint32 (&str, DBUS_BIG_ENDIAN, pos, &pos) == 0x12345678)
2624 _dbus_assert_not_reached ("demarshal failed");
2626 if (!_dbus_marshal_uint32 (&str, DBUS_LITTLE_ENDIAN, 0x12345678))
2627 _dbus_assert_not_reached ("could not marshal signed integer value");
2628 if (!_dbus_demarshal_uint32 (&str, DBUS_LITTLE_ENDIAN, pos, &pos) == 0x12345678)
2629 _dbus_assert_not_reached ("demarshal failed");
2631 #ifdef DBUS_HAVE_INT64
2632 /* Marshal signed integers */
2633 if (!_dbus_marshal_int64 (&str, DBUS_BIG_ENDIAN, DBUS_INT64_CONSTANT (-0x123456789abc7)))
2634 _dbus_assert_not_reached ("could not marshal signed integer value");
2635 if (_dbus_demarshal_int64 (&str, DBUS_BIG_ENDIAN, pos, &pos) != DBUS_INT64_CONSTANT (-0x123456789abc7))
2636 _dbus_assert_not_reached ("demarshal failed");
2638 if (!_dbus_marshal_int64 (&str, DBUS_LITTLE_ENDIAN, DBUS_INT64_CONSTANT (-0x123456789abc7)))
2639 _dbus_assert_not_reached ("could not marshal signed integer value");
2640 if (_dbus_demarshal_int64 (&str, DBUS_LITTLE_ENDIAN, pos, &pos) != DBUS_INT64_CONSTANT (-0x123456789abc7))
2641 _dbus_assert_not_reached ("demarshal failed");
2643 /* Marshal unsigned integers */
2644 if (!_dbus_marshal_uint64 (&str, DBUS_BIG_ENDIAN, DBUS_UINT64_CONSTANT (0x123456789abc7)))
2645 _dbus_assert_not_reached ("could not marshal signed integer value");
2646 if (!(_dbus_demarshal_uint64 (&str, DBUS_BIG_ENDIAN, pos, &pos) == DBUS_UINT64_CONSTANT (0x123456789abc7)))
2647 _dbus_assert_not_reached ("demarshal failed");
2649 if (!_dbus_marshal_uint64 (&str, DBUS_LITTLE_ENDIAN, DBUS_UINT64_CONSTANT (0x123456789abc7)))
2650 _dbus_assert_not_reached ("could not marshal signed integer value");
2651 if (!(_dbus_demarshal_uint64 (&str, DBUS_LITTLE_ENDIAN, pos, &pos) == DBUS_UINT64_CONSTANT (0x123456789abc7)))
2652 _dbus_assert_not_reached ("demarshal failed");
2653 #endif /* DBUS_HAVE_INT64 */
2655 /* Marshal strings */
2656 tmp1 = "This is the dbus test string";
2657 if (!_dbus_marshal_string (&str, DBUS_BIG_ENDIAN, tmp1))
2658 _dbus_assert_not_reached ("could not marshal string");
2659 tmp2 = _dbus_demarshal_string (&str, DBUS_BIG_ENDIAN, pos, &pos);
2660 if (!strcmp (tmp1, tmp2) == 0)
2661 _dbus_assert_not_reached ("demarshal failed");
2664 tmp1 = "This is the dbus test string";
2665 if (!_dbus_marshal_string (&str, DBUS_LITTLE_ENDIAN, tmp1))
2666 _dbus_assert_not_reached ("could not marshal string");
2667 tmp2 = _dbus_demarshal_string (&str, DBUS_LITTLE_ENDIAN, pos, &pos);
2668 if (!strcmp (tmp1, tmp2) == 0)
2669 _dbus_assert_not_reached ("demarshal failed");
2672 /* Marshal signed integer arrays */
2673 if (!_dbus_marshal_int32_array (&str, DBUS_BIG_ENDIAN, array1, 3))
2674 _dbus_assert_not_reached ("could not marshal integer array");
2675 if (!_dbus_demarshal_int32_array (&str, DBUS_BIG_ENDIAN, pos, &pos, &array2, &len))
2676 _dbus_assert_not_reached ("could not demarshal integer array");
2679 _dbus_assert_not_reached ("Signed integer array lengths differ!\n");
2682 #ifdef DBUS_HAVE_INT64
2683 /* Marshal 64-bit signed integer arrays */
2684 if (!_dbus_marshal_int64_array (&str, DBUS_BIG_ENDIAN, array3, 3))
2685 _dbus_assert_not_reached ("could not marshal integer array");
2686 if (!_dbus_demarshal_int64_array (&str, DBUS_BIG_ENDIAN, pos, &pos, &array4, &len))
2687 _dbus_assert_not_reached ("could not demarshal integer array");
2690 _dbus_assert_not_reached ("Signed integer array lengths differ!\n");
2693 /* set/pack 64-bit integers */
2694 _dbus_string_set_length (&str, 8);
2697 _dbus_marshal_set_int64 (&str, DBUS_LITTLE_ENDIAN,
2698 0, DBUS_INT64_CONSTANT (-0x123456789abc7));
2700 _dbus_assert (DBUS_INT64_CONSTANT (-0x123456789abc7) ==
2701 _dbus_unpack_int64 (DBUS_LITTLE_ENDIAN,
2702 _dbus_string_get_const_data (&str)));
2705 _dbus_marshal_set_int64 (&str, DBUS_BIG_ENDIAN,
2706 0, DBUS_INT64_CONSTANT (-0x123456789abc7));
2708 _dbus_assert (DBUS_INT64_CONSTANT (-0x123456789abc7) ==
2709 _dbus_unpack_int64 (DBUS_BIG_ENDIAN,
2710 _dbus_string_get_const_data (&str)));
2712 /* signed little pack */
2713 _dbus_pack_int64 (DBUS_INT64_CONSTANT (-0x123456789abc7),
2715 _dbus_string_get_data (&str));
2717 _dbus_assert (DBUS_INT64_CONSTANT (-0x123456789abc7) ==
2718 _dbus_unpack_int64 (DBUS_LITTLE_ENDIAN,
2719 _dbus_string_get_const_data (&str)));
2721 /* signed big pack */
2722 _dbus_pack_int64 (DBUS_INT64_CONSTANT (-0x123456789abc7),
2724 _dbus_string_get_data (&str));
2726 _dbus_assert (DBUS_INT64_CONSTANT (-0x123456789abc7) ==
2727 _dbus_unpack_int64 (DBUS_BIG_ENDIAN,
2728 _dbus_string_get_const_data (&str)));
2730 /* unsigned little */
2731 _dbus_marshal_set_uint64 (&str, DBUS_LITTLE_ENDIAN,
2732 0, DBUS_UINT64_CONSTANT (0x123456789abc7));
2734 _dbus_assert (DBUS_UINT64_CONSTANT (0x123456789abc7) ==
2735 _dbus_unpack_uint64 (DBUS_LITTLE_ENDIAN,
2736 _dbus_string_get_const_data (&str)));
2739 _dbus_marshal_set_uint64 (&str, DBUS_BIG_ENDIAN,
2740 0, DBUS_UINT64_CONSTANT (0x123456789abc7));
2742 _dbus_assert (DBUS_UINT64_CONSTANT (0x123456789abc7) ==
2743 _dbus_unpack_uint64 (DBUS_BIG_ENDIAN,
2744 _dbus_string_get_const_data (&str)));
2746 /* unsigned little pack */
2747 _dbus_pack_uint64 (DBUS_UINT64_CONSTANT (0x123456789abc7),
2749 _dbus_string_get_data (&str));
2751 _dbus_assert (DBUS_UINT64_CONSTANT (0x123456789abc7) ==
2752 _dbus_unpack_uint64 (DBUS_LITTLE_ENDIAN,
2753 _dbus_string_get_const_data (&str)));
2755 /* unsigned big pack */
2756 _dbus_pack_uint64 (DBUS_UINT64_CONSTANT (0x123456789abc7),
2758 _dbus_string_get_data (&str));
2760 _dbus_assert (DBUS_UINT64_CONSTANT (0x123456789abc7) ==
2761 _dbus_unpack_uint64 (DBUS_BIG_ENDIAN,
2762 _dbus_string_get_const_data (&str)));
2766 /* set/pack 32-bit integers */
2767 _dbus_string_set_length (&str, 4);
2770 _dbus_marshal_set_int32 (&str, DBUS_LITTLE_ENDIAN,
2773 _dbus_assert (-0x123456 ==
2774 _dbus_unpack_int32 (DBUS_LITTLE_ENDIAN,
2775 _dbus_string_get_const_data (&str)));
2778 _dbus_marshal_set_int32 (&str, DBUS_BIG_ENDIAN,
2781 _dbus_assert (-0x123456 ==
2782 _dbus_unpack_int32 (DBUS_BIG_ENDIAN,
2783 _dbus_string_get_const_data (&str)));
2785 /* signed little pack */
2786 _dbus_pack_int32 (-0x123456,
2788 _dbus_string_get_data (&str));
2790 _dbus_assert (-0x123456 ==
2791 _dbus_unpack_int32 (DBUS_LITTLE_ENDIAN,
2792 _dbus_string_get_const_data (&str)));
2794 /* signed big pack */
2795 _dbus_pack_int32 (-0x123456,
2797 _dbus_string_get_data (&str));
2799 _dbus_assert (-0x123456 ==
2800 _dbus_unpack_int32 (DBUS_BIG_ENDIAN,
2801 _dbus_string_get_const_data (&str)));
2803 /* unsigned little */
2804 _dbus_marshal_set_uint32 (&str, DBUS_LITTLE_ENDIAN,
2807 _dbus_assert (0x123456 ==
2808 _dbus_unpack_uint32 (DBUS_LITTLE_ENDIAN,
2809 _dbus_string_get_const_data (&str)));
2812 _dbus_marshal_set_uint32 (&str, DBUS_BIG_ENDIAN,
2815 _dbus_assert (0x123456 ==
2816 _dbus_unpack_uint32 (DBUS_BIG_ENDIAN,
2817 _dbus_string_get_const_data (&str)));
2819 /* unsigned little pack */
2820 _dbus_pack_uint32 (0x123456,
2822 _dbus_string_get_data (&str));
2824 _dbus_assert (0x123456 ==
2825 _dbus_unpack_uint32 (DBUS_LITTLE_ENDIAN,
2826 _dbus_string_get_const_data (&str)));
2828 /* unsigned big pack */
2829 _dbus_pack_uint32 (0x123456,
2831 _dbus_string_get_data (&str));
2833 _dbus_assert (0x123456 ==
2834 _dbus_unpack_uint32 (DBUS_BIG_ENDIAN,
2835 _dbus_string_get_const_data (&str)));
2840 _dbus_string_set_length (&str, 0);
2842 _dbus_marshal_string (&str, DBUS_LITTLE_ENDIAN,
2845 s = _dbus_demarshal_string (&str, DBUS_LITTLE_ENDIAN, 0, NULL);
2846 _dbus_assert (strcmp (s, "Hello world") == 0);
2849 _dbus_string_init_const (&t, "Hello world foo");
2851 _dbus_marshal_set_string (&str, DBUS_LITTLE_ENDIAN, 0,
2852 &t, _dbus_string_get_length (&t));
2854 s = _dbus_demarshal_string (&str, DBUS_LITTLE_ENDIAN, 0, NULL);
2855 _dbus_assert (strcmp (s, "Hello world foo") == 0);
2858 _dbus_string_init_const (&t, "Hello");
2860 _dbus_marshal_set_string (&str, DBUS_LITTLE_ENDIAN, 0,
2861 &t, _dbus_string_get_length (&t));
2863 s = _dbus_demarshal_string (&str, DBUS_LITTLE_ENDIAN, 0, NULL);
2864 _dbus_assert (strcmp (s, "Hello") == 0);
2867 /* Strings (big endian) */
2869 _dbus_string_set_length (&str, 0);
2871 _dbus_marshal_string (&str, DBUS_BIG_ENDIAN,
2874 s = _dbus_demarshal_string (&str, DBUS_BIG_ENDIAN, 0, NULL);
2875 _dbus_assert (strcmp (s, "Hello world") == 0);
2878 _dbus_string_init_const (&t, "Hello world foo");
2880 _dbus_marshal_set_string (&str, DBUS_BIG_ENDIAN, 0,
2881 &t, _dbus_string_get_length (&t));
2883 s = _dbus_demarshal_string (&str, DBUS_BIG_ENDIAN, 0, NULL);
2884 _dbus_assert (strcmp (s, "Hello world foo") == 0);
2887 _dbus_string_init_const (&t, "Hello");
2889 _dbus_marshal_set_string (&str, DBUS_BIG_ENDIAN, 0,
2890 &t, _dbus_string_get_length (&t));
2892 s = _dbus_demarshal_string (&str, DBUS_BIG_ENDIAN, 0, NULL);
2893 _dbus_assert (strcmp (s, "Hello") == 0);
2896 _dbus_string_free (&str);
2901 #endif /* DBUS_BUILD_TESTS */