git.sur5r.net Git - bacula/bacula/blob - bacula/src/lib/serial.h

   1 /*
   2  *
   3  *   Version $Id$
   4  */
   5
   6 /*
   7    Copyright (C) 2000, 2001, 2002 Kern Sibbald and John Walker
   8
   9    This program is free software; you can redistribute it and/or
  10    modify it under the terms of the GNU General Public License as
  11    published by the Free Software Foundation; either version 2 of
  12    the License, or (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 GNU
  17    General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public
  20    License along with this program; if not, write to the Free
  21    Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  22    MA 02111-1307, USA.
  23
  24  */
  25
  26 /*  Serialisation support functions from serial.c.  */
  27
  28 extern void serial_int16(uint8_t * * ptr, int16_t v);
  29 extern void serial_uint16(uint8_t * * ptr, uint16_t v);
  30 extern void serial_int32(uint8_t * * ptr, int32_t v);
  31 extern void serial_uint32(uint8_t * * ptr, uint32_t v);
  32 extern void serial_int64(uint8_t * * ptr, int64_t v);
  33 extern void serial_uint64(uint8_t * * ptr, uint64_t v);
  34 extern void serial_float64(uint8_t * * ptr, float64_t v);
  35 extern int  serial_string(uint8_t * ptr, char * str);
  36 extern int16_t unserial_int16(uint8_t * * ptr);
  37 extern uint16_t unserial_uint16(uint8_t * * ptr);
  38 extern int32_t unserial_int32(uint8_t * * ptr);
  39 extern uint32_t unserial_uint32(uint8_t * * ptr);
  40 extern int64_t unserial_int64(uint8_t * * ptr);
  41 extern uint64_t unserial_uint64(uint8_t * * ptr);
  42 extern float64_t unserial_float64(uint8_t * * ptr);
  43 extern int unserial_string(uint8_t * ptr, char * str);
  44
  45 /*
  46
  47                          Serialisation Macros
  48
  49     These macros use a uint8_t pointer, ser_ptr, which must be
  50     defined by the code which uses them.
  51
  52 */
  53
  54 #ifndef __SERIAL_H_
  55 #define __SERIAL_H_ 1
  56
  57 /*  ser_declare  --  Declare ser_ptr locally within a function.  */
  58 #define ser_declare     uint8_t *ser_ptr
  59 #define unser_declare   uint8_t *ser_ptr
  60
  61 /*  ser_begin(x, s)  --  Begin serialisation into a buffer x of size s.  */
  62 #define ser_begin(x, s) ser_ptr = ((uint8_t *)(x))
  63 #define unser_begin(x, s) ser_ptr = ((uint8_t *)(x))
  64
  65 /*  ser_length  --  Determine length in bytes of serialised into a
  66                     buffer x.  */
  67 #define ser_length(x)  (ser_ptr - (uint8_t *)(x))
  68 #define unser_length(x)  (ser_ptr - (uint8_t *)(x))
  69
  70 /*  ser_end(x, s)  --  End serialisation into a buffer x of size s.  */
  71 #define ser_end(x, s)   ASSERT(ser_length(x) <= (s))
  72 #define unser_end(x, s)   ASSERT(ser_length(x) <= (s))
  73
  74 /*  ser_check(x, s)  --  Verify length of serialised data in buffer x is
  75                          expected length s.  */
  76 #define ser_check(x, s) ASSERT(ser_length(x) == (s))
  77
  78 /*                          Serialisation                   */
  79
  80 /*  8 bit signed integer  */
  81 #define ser_int8(x)     *ser_ptr++ = (x)
  82 /*  8 bit unsigned integer  */
  83 #define ser_uint8(x)    *ser_ptr++ = (x)
  84
  85 /*  16 bit signed integer  */
  86 #define ser_int16(x)    serial_int16(&ser_ptr, x)
  87 /*  16 bit unsigned integer  */
  88 #define ser_uint16(x)   serial_uint16(&ser_ptr, x)
  89
  90 /*  32 bit signed integer  */
  91 #define ser_int32(x)    serial_int32(&ser_ptr, x)
  92 /*  32 bit unsigned integer  */
  93 #define ser_uint32(x)   serial_uint32(&ser_ptr, x)
  94
  95 /*  64 bit signed integer  */
  96 #define ser_int64(x)    serial_int64(&ser_ptr, x)
  97 /*  64 bit unsigned integer  */
  98 #define ser_uint64(x)   serial_uint64(&ser_ptr, x)
  99
 100
 101 /*  64 bit IEEE floating point number  */
 102 #define ser_float64(x)  serial_float64(&ser_ptr, x)
 103
 104 /*  128 bit signed integer  */
 105 #define ser_int128(x)   memcpy(ser_ptr, x, sizeof(int128_t)), ser_ptr += sizeof(int128_t)
 106
 107 /*  Binary byte stream len bytes not requiring serialisation  */
 108 #define ser_bytes(x, len) memcpy(ser_ptr, (x), (len)), ser_ptr += (len)
 109
 110 /*  Binary byte stream not requiring serialisation (length obtained by sizeof)  */
 111 #define ser_buffer(x)   ser_bytes((x), (sizeof (x)))
 112
 113 /* Binary string not requiring serialization */
 114 #define ser_string(x)   ser_ptr += serial_string(ser_ptr, (x))
 115
 116 /*                         Unserialisation                  */
 117
 118 /*  8 bit signed integer  */
 119 #define unser_int8(x)   (x) = *ser_ptr++
 120 /*  8 bit unsigned integer  */
 121 #define unser_uint8(x)  (x) = *ser_ptr++
 122
 123 /*  16 bit signed integer  */
 124 #define unser_int16(x)  (x) = unserial_int16(&ser_ptr)
 125 /*  16 bit unsigned integer  */
 126 #define unser_uint16(x) (x) = unserial_uint16(&ser_ptr)
 127
 128 /*  32 bit signed integer  */
 129 #define unser_int32(x)  (x) = unserial_int32(&ser_ptr)
 130 /*  32 bit unsigned integer  */
 131 #define unser_uint32(x) (x) = unserial_uint32(&ser_ptr)
 132
 133 /*  64 bit signed integer  */
 134 #define unser_int64(x)  (x) = unserial_int64(&ser_ptr)
 135 /*  64 bit unsigned integer  */
 136 #define unser_uint64(x) (x) = unserial_uint64(&ser_ptr)
 137
 138 /*  64 bit IEEE floating point number  */
 139 #define unser_float64(x)(x) = unserial_float64(&ser_ptr)
 140
 141 /*  128 bit signed integer  */
 142 #define unser_int128(x) memcpy(ser_ptr, x, sizeof(int128_t)), ser_ptr += sizeof(int128_t)
 143
 144 /*  Binary byte stream len bytes not requiring serialisation  */
 145 #define unser_bytes(x, len) memcpy((x), ser_ptr, (len)), ser_ptr += (len)
 146
 147 /*  Binary byte stream not requiring serialisation (length obtained by sizeof)  */
 148 #define unser_buffer(x)  unser_bytes((x), (sizeof (x)))
 149
 150 /* Binary string not requiring serialization */
 151 #define unser_string(x) ser_ptr += unserial_string(ser_ptr, (x))
 152
 153 #endif /* __SERIAL_H_ */