Home | History | Annotate | Download | only in dbus
      1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
      2 /* dbus-marshal-basic.h  Marshalling routines for basic (primitive) types
      3  *
      4  * Copyright (C) 2002  CodeFactory AB
      5  * Copyright (C) 2004, 2005  Red Hat, Inc.
      6  *
      7  * Licensed under the Academic Free License version 2.1
      8  *
      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.
     13  *
     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.
     18  *
     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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
     22  *
     23  */
     24 
     25 #ifndef DBUS_MARSHAL_BASIC_H
     26 #define DBUS_MARSHAL_BASIC_H
     27 
     28 #ifdef HAVE_BYTESWAP_H
     29 #include <byteswap.h>
     30 #endif
     31 
     32 #include <dbus/dbus-protocol.h>
     33 #include <dbus/dbus-types.h>
     34 #include <dbus/dbus-arch-deps.h>
     35 #include <dbus/dbus-string.h>
     36 
     37 #ifdef WORDS_BIGENDIAN
     38 #define DBUS_COMPILER_BYTE_ORDER DBUS_BIG_ENDIAN
     39 #else
     40 #define DBUS_COMPILER_BYTE_ORDER DBUS_LITTLE_ENDIAN
     41 #endif
     42 
     43 #ifdef HAVE_BYTESWAP_H
     44 #define DBUS_UINT16_SWAP_LE_BE_CONSTANT(val) bswap_16(val)
     45 #define DBUS_UINT32_SWAP_LE_BE_CONSTANT(val) bswap_32(val)
     46 #else /* HAVE_BYTESWAP_H */
     47 
     48 #define DBUS_UINT16_SWAP_LE_BE_CONSTANT(val)	((dbus_uint16_t) (      \
     49     (dbus_uint16_t) ((dbus_uint16_t) (val) >> 8) |                      \
     50     (dbus_uint16_t) ((dbus_uint16_t) (val) << 8)))
     51 
     52 #define DBUS_UINT32_SWAP_LE_BE_CONSTANT(val)	((dbus_uint32_t) (      \
     53     (((dbus_uint32_t) (val) & (dbus_uint32_t) 0x000000ffU) << 24) |     \
     54     (((dbus_uint32_t) (val) & (dbus_uint32_t) 0x0000ff00U) <<  8) |     \
     55     (((dbus_uint32_t) (val) & (dbus_uint32_t) 0x00ff0000U) >>  8) |     \
     56     (((dbus_uint32_t) (val) & (dbus_uint32_t) 0xff000000U) >> 24)))
     57 
     58 #endif /* HAVE_BYTESWAP_H */
     59 
     60 #ifdef DBUS_HAVE_INT64
     61 
     62 #ifdef HAVE_BYTESWAP_H
     63 #define DBUS_UINT64_SWAP_LE_BE_CONSTANT(val) bswap_64(val)
     64 #else /* HAVE_BYTESWAP_H */
     65 
     66 #define DBUS_UINT64_SWAP_LE_BE_CONSTANT(val)	((dbus_uint64_t) (              \
     67       (((dbus_uint64_t) (val) &                                                 \
     68 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x00000000000000ff)) << 56) |    \
     69       (((dbus_uint64_t) (val) &                                                 \
     70 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x000000000000ff00)) << 40) |    \
     71       (((dbus_uint64_t) (val) &                                                 \
     72 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x0000000000ff0000)) << 24) |    \
     73       (((dbus_uint64_t) (val) &                                                 \
     74 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x00000000ff000000)) <<  8) |    \
     75       (((dbus_uint64_t) (val) &                                                 \
     76 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x000000ff00000000)) >>  8) |    \
     77       (((dbus_uint64_t) (val) &                                                 \
     78 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x0000ff0000000000)) >> 24) |    \
     79       (((dbus_uint64_t) (val) &                                                 \
     80 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0x00ff000000000000)) >> 40) |    \
     81       (((dbus_uint64_t) (val) &                                                 \
     82 	(dbus_uint64_t) DBUS_UINT64_CONSTANT (0xff00000000000000)) >> 56)))
     83 #endif /* DBUS_HAVE_INT64 */
     84 
     85 #endif /* HAVE_BYTESWAP_H */
     86 
     87 #define DBUS_UINT16_SWAP_LE_BE(val) (DBUS_UINT16_SWAP_LE_BE_CONSTANT (val))
     88 #define DBUS_INT16_SWAP_LE_BE(val)  ((dbus_int16_t)DBUS_UINT16_SWAP_LE_BE_CONSTANT (val))
     89 
     90 #define DBUS_UINT32_SWAP_LE_BE(val) (DBUS_UINT32_SWAP_LE_BE_CONSTANT (val))
     91 #define DBUS_INT32_SWAP_LE_BE(val)  ((dbus_int32_t)DBUS_UINT32_SWAP_LE_BE_CONSTANT (val))
     92 
     93 #ifdef DBUS_HAVE_INT64
     94 #  define DBUS_UINT64_SWAP_LE_BE(val) (DBUS_UINT64_SWAP_LE_BE_CONSTANT (val))
     95 #  define DBUS_INT64_SWAP_LE_BE(val)  ((dbus_int64_t)DBUS_UINT64_SWAP_LE_BE_CONSTANT (val))
     96 #endif /* DBUS_HAVE_INT64 */
     97 
     98 #ifdef WORDS_BIGENDIAN
     99 
    100 #  define DBUS_INT16_TO_BE(val)	((dbus_int16_t) (val))
    101 #  define DBUS_UINT16_TO_BE(val)	((dbus_uint16_t) (val))
    102 #  define DBUS_INT16_TO_LE(val)	(DBUS_INT16_SWAP_LE_BE (val))
    103 #  define DBUS_UINT16_TO_LE(val)	(DBUS_UINT16_SWAP_LE_BE (val))
    104 #  define DBUS_INT32_TO_BE(val)	((dbus_int32_t) (val))
    105 #  define DBUS_UINT32_TO_BE(val)	((dbus_uint32_t) (val))
    106 #  define DBUS_INT32_TO_LE(val)	(DBUS_INT32_SWAP_LE_BE (val))
    107 #  define DBUS_UINT32_TO_LE(val)	(DBUS_UINT32_SWAP_LE_BE (val))
    108 #  ifdef DBUS_HAVE_INT64
    109 #    define DBUS_INT64_TO_BE(val)	((dbus_int64_t) (val))
    110 #    define DBUS_UINT64_TO_BE(val)	((dbus_uint64_t) (val))
    111 #    define DBUS_INT64_TO_LE(val)	(DBUS_INT64_SWAP_LE_BE (val))
    112 #    define DBUS_UINT64_TO_LE(val)	(DBUS_UINT64_SWAP_LE_BE (val))
    113 #  endif /* DBUS_HAVE_INT64 */
    114 
    115 #else /* WORDS_BIGENDIAN */
    116 
    117 #  define DBUS_INT16_TO_LE(val)	((dbus_int16_t) (val))
    118 #  define DBUS_UINT16_TO_LE(val)	((dbus_uint16_t) (val))
    119 #  define DBUS_INT16_TO_BE(val)	((dbus_int16_t) DBUS_UINT16_SWAP_LE_BE (val))
    120 #  define DBUS_UINT16_TO_BE(val)	(DBUS_UINT16_SWAP_LE_BE (val))
    121 #  define DBUS_INT32_TO_LE(val)	((dbus_int32_t) (val))
    122 #  define DBUS_UINT32_TO_LE(val)	((dbus_uint32_t) (val))
    123 #  define DBUS_INT32_TO_BE(val)	((dbus_int32_t) DBUS_UINT32_SWAP_LE_BE (val))
    124 #  define DBUS_UINT32_TO_BE(val)	(DBUS_UINT32_SWAP_LE_BE (val))
    125 #  ifdef DBUS_HAVE_INT64
    126 #    define DBUS_INT64_TO_LE(val)	((dbus_int64_t) (val))
    127 #    define DBUS_UINT64_TO_LE(val)	((dbus_uint64_t) (val))
    128 #    define DBUS_INT64_TO_BE(val)	((dbus_int64_t) DBUS_UINT64_SWAP_LE_BE (val))
    129 #    define DBUS_UINT64_TO_BE(val)	(DBUS_UINT64_SWAP_LE_BE (val))
    130 #  endif /* DBUS_HAVE_INT64 */
    131 #endif
    132 
    133 /* The transformation is symmetric, so the FROM just maps to the TO. */
    134 #define DBUS_INT16_FROM_LE(val)	 (DBUS_INT16_TO_LE (val))
    135 #define DBUS_UINT16_FROM_LE(val) (DBUS_UINT16_TO_LE (val))
    136 #define DBUS_INT16_FROM_BE(val)	 (DBUS_INT16_TO_BE (val))
    137 #define DBUS_UINT16_FROM_BE(val) (DBUS_UINT16_TO_BE (val))
    138 #define DBUS_INT32_FROM_LE(val)	 (DBUS_INT32_TO_LE (val))
    139 #define DBUS_UINT32_FROM_LE(val) (DBUS_UINT32_TO_LE (val))
    140 #define DBUS_INT32_FROM_BE(val)	 (DBUS_INT32_TO_BE (val))
    141 #define DBUS_UINT32_FROM_BE(val) (DBUS_UINT32_TO_BE (val))
    142 #ifdef DBUS_HAVE_INT64
    143 #  define DBUS_INT64_FROM_LE(val)	 (DBUS_INT64_TO_LE (val))
    144 #  define DBUS_UINT64_FROM_LE(val) (DBUS_UINT64_TO_LE (val))
    145 #  define DBUS_INT64_FROM_BE(val)	 (DBUS_INT64_TO_BE (val))
    146 #  define DBUS_UINT64_FROM_BE(val) (DBUS_UINT64_TO_BE (val))
    147 #endif /* DBUS_HAVE_INT64 */
    148 
    149 #ifndef DBUS_HAVE_INT64
    150 /**
    151  * An 8-byte struct you could use to access int64 without having
    152  * int64 support
    153  */
    154 typedef struct
    155 {
    156   dbus_uint32_t first32;  /**< first 32 bits in the 8 bytes (beware endian issues) */
    157   dbus_uint32_t second32; /**< second 32 bits in the 8 bytes (beware endian issues) */
    158 } DBus8ByteStruct;
    159 #endif /* DBUS_HAVE_INT64 */
    160 
    161 /**
    162  * A simple 8-byte value union that lets you access 8 bytes as if they
    163  * were various types; useful when dealing with basic types via
    164  * void pointers and varargs.
    165  */
    166 typedef union
    167 {
    168   dbus_int16_t  i16;   /**< as int16 */
    169   dbus_uint16_t u16;   /**< as int16 */
    170   dbus_int32_t  i32;   /**< as int32 */
    171   dbus_uint32_t u32;   /**< as int32 */
    172 #ifdef DBUS_HAVE_INT64
    173   dbus_int64_t  i64;   /**< as int64 */
    174   dbus_uint64_t u64;   /**< as int64 */
    175 #else
    176   DBus8ByteStruct u64; /**< as 8-byte-struct */
    177 #endif
    178   double dbl;          /**< as double */
    179   unsigned char byt;   /**< as byte */
    180   char *str;           /**< as char* */
    181 } DBusBasicValue;
    182 
    183 #ifdef DBUS_DISABLE_ASSERT
    184 #define _dbus_unpack_uint16(byte_order, data)           \
    185    (((byte_order) == DBUS_LITTLE_ENDIAN) ?              \
    186      DBUS_UINT16_FROM_LE (*(dbus_uint16_t*)(data)) :    \
    187      DBUS_UINT16_FROM_BE (*(dbus_uint16_t*)(data)))
    188 
    189 #define _dbus_unpack_uint32(byte_order, data)           \
    190    (((byte_order) == DBUS_LITTLE_ENDIAN) ?              \
    191      DBUS_UINT32_FROM_LE (*(dbus_uint32_t*)(data)) :    \
    192      DBUS_UINT32_FROM_BE (*(dbus_uint32_t*)(data)))
    193 #endif
    194 
    195 #ifndef _dbus_unpack_uint16
    196 dbus_uint16_t _dbus_unpack_uint16 (int                  byte_order,
    197                                    const unsigned char *data);
    198 #endif
    199 
    200 void          _dbus_pack_uint32   (dbus_uint32_t        value,
    201                                    int                  byte_order,
    202                                    unsigned char       *data);
    203 #ifndef _dbus_unpack_uint32
    204 dbus_uint32_t _dbus_unpack_uint32 (int                  byte_order,
    205                                    const unsigned char *data);
    206 #endif
    207 
    208 dbus_bool_t   _dbus_marshal_set_basic         (DBusString       *str,
    209                                                int               pos,
    210                                                int               type,
    211                                                const void       *value,
    212                                                int               byte_order,
    213                                                int              *old_end_pos,
    214                                                int              *new_end_pos);
    215 dbus_bool_t   _dbus_marshal_write_basic       (DBusString       *str,
    216                                                int               insert_at,
    217                                                int               type,
    218                                                const void       *value,
    219                                                int               byte_order,
    220                                                int              *pos_after);
    221 dbus_bool_t   _dbus_marshal_write_fixed_multi (DBusString       *str,
    222                                                int               insert_at,
    223                                                int               element_type,
    224                                                const void       *value,
    225                                                int               n_elements,
    226                                                int               byte_order,
    227                                                int              *pos_after);
    228 void          _dbus_marshal_read_basic        (const DBusString *str,
    229                                                int               pos,
    230                                                int               type,
    231                                                void             *value,
    232                                                int               byte_order,
    233                                                int              *new_pos);
    234 void          _dbus_marshal_read_fixed_multi  (const DBusString *str,
    235                                                int               pos,
    236                                                int               element_type,
    237                                                void             *value,
    238                                                int               n_elements,
    239                                                int               byte_order,
    240                                                int              *new_pos);
    241 void          _dbus_marshal_skip_basic        (const DBusString *str,
    242                                                int               type,
    243                                                int               byte_order,
    244                                                int              *pos);
    245 void          _dbus_marshal_skip_array        (const DBusString *str,
    246                                                int               element_type,
    247                                                int               byte_order,
    248                                                int              *pos);
    249 void          _dbus_marshal_set_uint32        (DBusString       *str,
    250                                                int               pos,
    251                                                dbus_uint32_t     value,
    252                                                int               byte_order);
    253 dbus_uint32_t _dbus_marshal_read_uint32       (const DBusString *str,
    254                                                int               pos,
    255                                                int               byte_order,
    256                                                int              *new_pos);
    257 dbus_bool_t   _dbus_type_is_valid             (int               typecode);
    258 int           _dbus_type_get_alignment        (int               typecode);
    259 dbus_bool_t   _dbus_type_is_fixed             (int               typecode);
    260 int           _dbus_type_get_alignment        (int               typecode);
    261 const char*   _dbus_type_to_string            (int               typecode);
    262 
    263 int           _dbus_first_type_in_signature   (const DBusString *str,
    264                                                int               pos);
    265 
    266 int           _dbus_first_type_in_signature_c_str   (const char       *str,
    267 						     int               pos);
    268 
    269 void _dbus_swap_array (unsigned char *data,
    270                        int            n_elements,
    271                        int            alignment);
    272 
    273 #endif /* DBUS_MARSHAL_BASIC_H */
    274