orte/include/orte/cdr.h

   1 /*
   2  *  $Id: cdr.h,v 0.0.0.1                2004/11/26
   3  *
   4  *  -------------------------------------------------------------------
   5  *                                ORTE
   6  *                      Open Real-Time Ethernet
   7  *
   8  *                      Copyright (C) 2001-2006
   9  *  Department of Control Engineering FEE CTU Prague, Czech Republic
  10  *                      http://dce.felk.cvut.cz
  11  *                      http://www.ocera.org
  12  *
  13  *  Author:              Petr Smolik    petr@smoliku.cz
  14  *  Advisor:             Pavel Pisa
  15  *  Project Responsible: Zdenek Hanzalek
  16  *  --------------------------------------------------------------------
  17  *
  18  *  This program is free software; you can redistribute it and/or modify
  19  *  it under the terms of the GNU General Public License as published by
  20  *  the Free Software Foundation; either version 2 of the License, or
  21  *  (at your option) any later version.
  22  *
  23  *  This program is distributed in the hope that it will be useful,
  24  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  25  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  26  *  GNU General Public License for more details.
  27  *
  28  *  Original of source was from ORBit: A CORBA v2.2 ORB
  29  */
  30 #ifndef _ORTE_CDR_H_
  31 #define _ORTE_CDR_H_
  32
  33 #include "basic_types.h"
  34
  35 /*
  36  * Alignment of CORBA types mapped to C.
  37  * These have *nothing* to do with CDR alignment.
  38  */
  39 #define ORTE_ALIGNOF_CORBA_OCTET        1
  40 #define ORTE_ALIGNOF_CORBA_BOOLEAN      1
  41 #define ORTE_ALIGNOF_CORBA_CHAR         1
  42 #define ORTE_ALIGNOF_CORBA_WCHAR        2
  43 #define ORTE_ALIGNOF_CORBA_SHORT        2
  44 #define ORTE_ALIGNOF_CORBA_LONG         4
  45 #define ORTE_ALIGNOF_CORBA_LONG_LONG    8
  46 #define ORTE_ALIGNOF_CORBA_FLOAT        4
  47 #define ORTE_ALIGNOF_CORBA_DOUBLE       8
  48 #define ORTE_ALIGNOF_CORBA_LONG_DOUBLE  16
  49 #define ORTE_ALIGNOF_CORBA_STRUCT       1
  50 #define ORTE_ALIGNOF_CORBA_POINTER      4
  51
  52 typedef enum {
  53         BigEndian=0,
  54         LittleEndian=1
  55 } CDR_Endianness;
  56
  57 /**
  58  * struct CDR_Codec - used for serialization/deserialization
  59  * @host_endian:
  60  * @data_endian:
  61  * @buffer: buffer for data
  62  * @buf_len: buffer length
  63  * @wptr_max: maximal size of writing data
  64  * @wptr: write pointer
  65  * @rptr: read pointer
  66  * @readonly: readonly attribute
  67  * @release_buffer: use CORBA_TRUE if is necessary to free buffer memory after destruction of structure
  68  *
  69  * Struct @CDR_Codec is used by serialization and deserialization functions.
  70  */
  71 typedef struct CDR_Codec {
  72         CDR_Endianness host_endian;
  73         CDR_Endianness data_endian;
  74         CORBA_octet *buffer;
  75         unsigned int buf_len;
  76         unsigned int wptr_max;
  77         unsigned int wptr;
  78         unsigned int rptr;
  79         CORBA_boolean readonly;
  80         CORBA_boolean release_buffer;
  81 } CDR_Codec;
  82
  83 #define HEXDIGIT(c) (isdigit((guchar)(c))?(c)-'0':tolower((guchar)(c))-'a'+10)
  84 #define HEXOCTET(a,b) ((HEXDIGIT((a)) << 4) | HEXDIGIT((b)))
  85
  86 extern CORBA_boolean CDR_buffer_init(CDR_Codec *codec, const unsigned int size);
  87 extern CDR_Codec *CDR_codec_init(void);
  88 extern CDR_Codec *CDR_codec_init_static(CDR_Codec *codec);
  89 extern void CDR_codec_release_buffer(CDR_Codec *codec);
  90 extern void CDR_codec_free(CDR_Codec *);
  91
  92 extern CORBA_boolean CDR_buffer_puts(CDR_Codec *codec, const void *data, const unsigned int len);
  93 extern CORBA_boolean CDR_buffer_gets(CDR_Codec *codec, void *dest, const unsigned int len);
  94
  95 extern CORBA_boolean CDR_put_short(CDR_Codec *codec, CORBA_short s);
  96 extern CORBA_boolean CDR_put_ushort(CDR_Codec *codec, CORBA_unsigned_short us);
  97 extern CORBA_boolean CDR_put_long(CDR_Codec *codec, CORBA_long l);
  98 extern CORBA_boolean CDR_put_ulong(CDR_Codec *codec, CORBA_unsigned_long ul);
  99 #ifdef HAVE_CORBA_LONG_LONG
 100 extern CORBA_boolean CDR_put_long_long(CDR_Codec *codec, CORBA_long_long ll);
 101 extern CORBA_boolean CDR_put_ulong_long(CDR_Codec *codec, CORBA_unsigned_long_long ull);
 102 extern CORBA_boolean CDR_get_ulong_long(CDR_Codec *codec, CORBA_unsigned_long_long *ul);
 103 extern CORBA_boolean CDR_get_long_long(CDR_Codec *codec, CORBA_long_long *ul);
 104 #endif
 105 extern CORBA_boolean CDR_put_float(CDR_Codec *codec, CORBA_float f);
 106 extern CORBA_boolean CDR_put_double(CDR_Codec *codec, CORBA_double d);
 107 extern CORBA_boolean CDR_put_long_double(CDR_Codec *codec, CORBA_long_double ld);
 108 extern CORBA_boolean CDR_put_octet(CDR_Codec *codec, CORBA_octet datum);
 109 extern CORBA_boolean CDR_put_octets(CDR_Codec *codec, void *data, unsigned long len);
 110 extern CORBA_boolean CDR_put_char(CDR_Codec *codec, CORBA_char c);
 111 extern CORBA_boolean CDR_put_boolean(CDR_Codec *codec, CORBA_boolean datum);
 112 extern CORBA_boolean CDR_put_string(CDR_Codec *codec, const char *str);
 113 extern CORBA_boolean CDR_buffer_gets(CDR_Codec *codec, void *dest, const unsigned int len);
 114 extern CORBA_boolean CDR_get_short(CDR_Codec *codec, CORBA_short *us);
 115 extern CORBA_boolean CDR_get_ushort(CDR_Codec *codec, CORBA_unsigned_short *us);
 116 extern CORBA_boolean CDR_get_long(CDR_Codec *codec, CORBA_long *l);
 117 extern CORBA_boolean CDR_get_ulong(CDR_Codec *codec, CORBA_unsigned_long *ul);
 118 extern CORBA_boolean CDR_get_octet(CDR_Codec *codec, CORBA_octet *datum);
 119 extern CORBA_boolean CDR_get_boolean(CDR_Codec *codec, CORBA_boolean *b);
 120 extern CORBA_boolean CDR_get_char(CDR_Codec *codec, CORBA_char *c);
 121 extern CORBA_boolean CDR_get_string(CDR_Codec *codec, CORBA_char **str);
 122 extern CORBA_boolean CDR_get_string_buff(CDR_Codec *codec, CORBA_char *str);
 123 extern CORBA_boolean CDR_get_string_static(CDR_Codec *codec, CORBA_char **str);
 124 extern CORBA_boolean CDR_get_seq_begin(CDR_Codec *codec, CORBA_unsigned_long *ul);
 125 extern CORBA_boolean CDR_get_float(CDR_Codec *codec, CORBA_float *f);
 126 extern CORBA_boolean CDR_get_double(CDR_Codec *codec, CORBA_double *d);
 127
 128
 129 /* serialization functions */
 130 #define CORBA_short_serialize(x,y)             CDR_put_short((x),*(y))
 131 #define CORBA_long_serialize(x,y)              CDR_put_long((x),*(y))
 132 #define CORBA_unsigned_short_serialize(x,y)    CDR_put_ushort((x),*(y))
 133 #define CORBA_unsigned_long_serialize(x,y)     CDR_put_ulong((x),*(y))
 134 #define CORBA_float_serialize(x,y)             CDR_put_float((x),*(y))
 135 #define CORBA_double_serialize(x,y)            CDR_put_double((x),*(y))
 136 #define CORBA_char_serialize(x,y)              CDR_put_char((x),*(y))
 137 #define CORBA_boolean_serialize(x,y)           CDR_put_boolean((x),*(y))
 138 #define CORBA_octet_serialize(x,y)             CDR_put_octet((x),*(y))
 139 #define CORBA_long_double_serialize(x,y)       CDR_put_long_double((x),*(y))
 140 #define CORBA_string_serialize(x,y)            CDR_put_string((x),*(y))
 141
 142 /* deserialization functions */
 143 #define CORBA_short_deserialize(x,y)           CDR_get_short((x),(y))
 144 #define CORBA_long_deserialize(x,y)            CDR_get_long((x),(y))
 145 #define CORBA_unsigned_short_deserialize(x,y)  CDR_get_ushort((x),(y))
 146 #define CORBA_unsigned_long_deserialize(x,y)   CDR_get_ulong((x),(y))
 147 #define CORBA_float_deserialize(x,y)           CDR_get_float((x),(y))
 148 #define CORBA_double_deserialize(x,y)          CDR_get_double((x),(y))
 149 #define CORBA_char_deserialize(x,y)            CDR_get_char((x),(y))
 150 #define CORBA_boolean_deserialize(x,y)         CDR_get_boolean((x),(y))
 151 #define CORBA_octet_deserialize(x,y)           CDR_get_octet((x),(y))
 152 #define CORBA_long_double_deserialize(x,y)     CDR_get_long_double((x),(y))
 153 #define CORBA_string_deserialize(x,y)          CDR_get_string((x),(y))
 154
 155 /* get_max_size functions */
 156 #define CORBA_short_get_max_size(x, num)            ((x)->csize=\
 157         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_SHORT)+(num)*ORTE_ALIGNOF_CORBA_SHORT)
 158 #define CORBA_long_get_max_size(x, num)             ((x)->csize=\
 159         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_LONG)+(num)*ORTE_ALIGNOF_CORBA_LONG)
 160 #define CORBA_unsigned_short_get_max_size(x, num)   ((x)->csize=\
 161         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_SHORT)+(num)*ORTE_ALIGNOF_CORBA_SHORT)
 162 #define CORBA_unsigned_long_get_max_size(x, num)    ((x)->csize=\
 163         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_LONG)+(num)*ORTE_ALIGNOF_CORBA_LONG)
 164 #define CORBA_float_get_max_size(x, num)            ((x)->csize=\
 165         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_FLOAT)+(num)*ORTE_ALIGNOF_CORBA_FLOAT)
 166 #define CORBA_double_get_max_size(x, num)           ((x)->csize=\
 167         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_DOUBLE)+(num)*ORTE_ALIGNOF_CORBA_DOUBLE)
 168 #define CORBA_char_get_max_size(x, num)             ((x)->csize=\
 169         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_CHAR)+(num)*ORTE_ALIGNOF_CORBA_CHAR)
 170 #define CORBA_boolean_get_max_size(x, num)          ((x)->csize=\
 171         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_BOOLEAN)+(num)*ORTE_ALIGNOF_CORBA_BOOLEAN)
 172 #define CORBA_octet_get_max_size(x, num)            ((x)->csize=\
 173         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_OCTET)+(num)*ORTE_ALIGNOF_CORBA_OCTET)
 174 #define CORBA_long_double_get_max_size(x, num)      ((x)->csize=\
 175         (unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_LONG_DOUBLE)+(num)*ORTE_ALIGNOF_CORBA_DOUBLE)
 176 #define CORBA_string_get_max_size(x,y)         \
 177         ((x)->csize=(unsigned long)ALIGN_ADDRESS((x)->csize,ORTE_ALIGNOF_CORBA_LONG) + ORTE_ALIGNOF_CORBA_LONG + y + 1)
 178
 179 #endif /* !_ORTE_CDR_H_ */