--- libaitio/inc/aitio.h 2011/08/29 14:57:53 1.11.2.1 +++ libaitio/inc/aitio.h 2011/09/22 22:25:12 1.11.2.19 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitio.h,v 1.11.2.1 2011/08/29 14:57:53 misho Exp $ +* $Id: aitio.h,v 1.11.2.19 2011/09/22 22:25:12 misho Exp $ * ************************************************************************** The ELWIX and AITNET software is distributed under the following @@ -103,24 +103,27 @@ struct tagReqXML { url_Item_t xml_value; }; -/* RPC variables and managment */ +/* AIT RPC variables and managment */ typedef enum { empty, /* empty -> variable is not set */ - buffer, string, blob, array, /* buffer -> uint8_t*; string -> int8_t*; - blob -> void*(+socket); array -> array_t* */ + buffer, string, blob, /* buffer -> uint8_t*; string -> int8_t*; blob -> void*(+socket); */ + f32, f64, /* float -> f32; double -> f64 */ u8, u16, u32, u64, /* unsigned integers ... */ - i8, i16, i32, i64 /* integers ... */ + i8, i16, i32, i64, /* integers ... */ } ait_type_t; typedef struct { uint8_t val_type; uint32_t val_len; union { - uint8_t *buffer, - *array; + uint64_t net; + + uint8_t *buffer; int8_t *string; uint32_t blob; + float f32; + double f64; uint8_t u8; uint16_t u16; uint32_t u32; @@ -132,74 +135,79 @@ typedef struct { } val; } __packed ait_val_t; -#define AIT_TYPE(_vl) (assert((_vl)), ((ait_type_t) (_vl)->val_type)) -#define AIT_LEN(_vl) (assert((_vl)), (_vl)->val_len) -#define AIT_BLOB_CHUNKS(_vl, _n) (assert((_vl)), (_vl)->val_len / _n + ((_vl)->val_len % _n) ? 1 : 0) -#define AIT_ISEMPTY(_vl) (assert((_vl)), (_vl)->val_type == empty) +#define AIT_TYPE(_vl) ((ait_type_t) (_vl)->val_type) +#define AIT_LEN(_vl) (_vl)->val_len +#define AIT_BLOB_CHUNKS(_vl, _n) (assert((_vl)), AIT_LEN((_vl)) / _n + (AIT_LEN((_vl)) % _n) ? 1 : 0) +#define AIT_ISEMPTY(_vl) (assert((_vl)), AIT_TYPE((_vl)) == empty) -#define AIT_GET_ARRAY(_vl) (assert((_vl)), assert((_vl)->val_type == array), \ - ((array_t*) (_vl)->val.array)) -#define AIT_GET_BUF(_vl) (assert((_vl)), assert((_vl)->val_type == buffer), (_vl)->val.buffer) -#define AIT_GET_STR(_vl) (assert((_vl)), assert((_vl)->val_type == string), (_vl)->val.string) -#define AIT_GET_BLOB(_vl) (assert((_vl)), assert((_vl)->val_type == blob), (_vl)->val.blob) -#define AIT_GET_U8(_vl) (assert((_vl)), assert((_vl)->val_type == u8), (_vl)->val.u8) -#define AIT_GET_U16(_vl) (assert((_vl)), assert((_vl)->val_type == u16), (_vl)->val.u16) -#define AIT_GET_U32(_vl) (assert((_vl)), assert((_vl)->val_type == u32), (_vl)->val.u32) -#define AIT_GET_U64(_vl) (assert((_vl)), assert((_vl)->val_type == u64), (_vl)->val.u64) -#define AIT_GET_I8(_vl) (assert((_vl)), assert((_vl)->val_type == i8), (_vl)->val.i8) -#define AIT_GET_I16(_vl) (assert((_vl)), assert((_vl)->val_type == i16), (_vl)->val.i16) -#define AIT_GET_I32(_vl) (assert((_vl)), assert((_vl)->val_type == i32), (_vl)->val.i32) -#define AIT_GET_I64(_vl) (assert((_vl)), assert((_vl)->val_type == i64), (_vl)->val.i64) +#define AIT_GET_BUF(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == buffer), (_vl)->val.buffer) +#define AIT_GET_STR(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == string), (_vl)->val.string) +#define AIT_GET_BLOB(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == blob), (_vl)->val.blob) +#define AIT_GET_U8(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == u8), (_vl)->val.u8) +#define AIT_GET_U16(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == u16), (_vl)->val.u16) +#define AIT_GET_U32(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == u32), (_vl)->val.u32) +#define AIT_GET_U64(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == u64), (_vl)->val.u64) +#define AIT_GET_I8(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == i8), (_vl)->val.i8) +#define AIT_GET_I16(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == i16), (_vl)->val.i16) +#define AIT_GET_I32(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == i32), (_vl)->val.i32) +#define AIT_GET_I64(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == i64), (_vl)->val.i64) +#define AIT_GET_F32(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == f32), (_vl)->val.f32) +#define AIT_GET_F64(_vl) (assert((_vl)), assert(AIT_TYPE((_vl)) == f64), (_vl)->val.f64) #define AIT_SET_BUF(_vl, _v, _len) do { ait_val_t *__val = (_vl); assert(__val); assert((_v)); \ __val->val.buffer = malloc(_len); \ if (__val->val.buffer) { \ - AIT_TYPE(__val) = buffer; AIT_LEN(__val) = _len; \ + __val->val_type = buffer; AIT_LEN(__val) = _len; \ memcpy(__val->val.buffer, (_v), _len); \ } } while (0) #define AIT_SET_STR(_vl, _v) do { ait_val_t *__val = (_vl); assert(__val); assert((_v)); \ __val->val.string = (int8_t*) strdup((_v)); \ if (__val->val.string) { \ - AIT_TYPE(__val) = string; \ + __val->val_type = string; \ AIT_LEN(__val) = strlen((_v)) + 1; \ } } while (0) #define AIT_SET_BLOB(_vl, _n, _len) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = blob; AIT_LEN(__val) = _len; \ + __val->val_type = blob; AIT_LEN(__val) = _len; \ __val->val.blob = _n; } while (0) #define AIT_SET_BLOB2(_vl, _bv) do { ait_val_t *__val = (_vl); assert(__val); assert((_bv)); \ - AIT_TYPE(__val) = blob; AIT_LEN(__val) = (_bv)->blob_len; \ + __val->val_type = blob; AIT_LEN(__val) = (_bv)->blob_len; \ __val->val.blob = (_bv)->blob_var; } while (0) -#define AIT_SET_ARRAY(_vl, _arr) do { ait_val_t *__val = (_vl); assert(__val); assert((_arr)); \ - AIT_TYPE(__val) = array; AIT_LEN(__val) = io_arraySize((_arr)); \ - } while (0) +#define AIT_NEW_BLOB(_vl, _len) AIT_SET_BLOB((_vl), 0, _len) #define AIT_SET_U8(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = u8; __val->val.u8 = _n; \ + __val->val_type = u8; __val->val.u8 = _n; \ AIT_LEN(__val) = sizeof(uint8_t); } while (0) #define AIT_SET_U16(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = u16; __val->val.u16 = _n; \ + __val->val_type = u16; __val->val.u16 = _n; \ AIT_LEN(__val) = sizeof(uint16_t); } while (0) #define AIT_SET_U32(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = u32; __val->val.u32 = _n; \ + __val->val_type = u32; __val->val.u32 = _n; \ AIT_LEN(__val) = sizeof(uint32_t); } while (0) #define AIT_SET_U64(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = u64; __val->val.u64 = _n; \ + __val->val_type = u64; __val->val.u64 = _n; \ AIT_LEN(__val) = sizeof(uint64_t); } while (0) #define AIT_SET_I8(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = i8; __val->val.i8 = _n; \ + __val->val_type = i8; __val->val.i8 = _n; \ AIT_LEN(__val) = sizeof(int8_t); } while (0) #define AIT_SET_I16(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = i16; __val->val.i16 = _n; \ + __val->val_type = i16; __val->val.i16 = _n; \ AIT_LEN(__val) = sizeof(int16_t); } while (0) #define AIT_SET_I32(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = i32; __val->val.i32 = _n; \ + __val->val_type = i32; __val->val.i32 = _n; \ AIT_LEN(__val) = sizeof(int32_t); } while (0) #define AIT_SET_I64(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ - AIT_TYPE(__val) = i64; __val->val.i64 = _n; \ + __val->val_type = i64; __val->val.i64 = _n; \ AIT_LEN(__val) = sizeof(int64_t); } while (0) +#define AIT_SET_F32(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ + __val->val_type = f32; __val->val.f32 = _n; \ + AIT_LEN(__val) = sizeof(float); } while (0) +#define AIT_SET_F64(_vl, _n) do { ait_val_t *__val = (_vl); assert(__val); \ + __val->val_type = f64; __val->val.f64 = _n; \ + AIT_LEN(__val) = sizeof(double); } while (0) + /* if attribute zeroCopy is set not execute free() */ #define AIT_FREE_VAL(_vl) do { ait_val_t *__val = (_vl); assert(__val); \ - switch (AIT_TYPE(__val)) { \ + switch (__val->val_type) { \ case buffer: \ if (__val->val.buffer) { \ free(__val->val.buffer); \ @@ -212,11 +220,10 @@ typedef struct { __val->val.string = NULL; \ } \ break; \ - case array: \ - io_arrayDestroy(&AIT_GET_ARRAY(__val)); \ + default: \ break; \ } \ - AIT_TYPE(__val) = empty; \ + __val->val_type = empty; \ AIT_LEN(__val) = 0; \ } while (0) @@ -228,6 +235,43 @@ inline const char *io_GetError(); /* + * io_vals2buffer() Marshaling data from array with variables to buffer + * @buf = Buffer + * @buflen = Size of buffer + * @vars = Variable array + * return: -1 error, 0 nothing done or >0 size of marshaled data + */ +int io_vals2buffer(unsigned char *buf, int buflen, array_t *vars); +/* + * io_buffer2vals() De-marshaling data from buffer to array with variables + * @buf = Buffer + * @buflen = Size of buffer + * @vnum = Number of variables into buffer + * @zcpy = Zero-copy for variables, if !=0 don't use io_arrayFree() for free variables and + *DON'T MODIFY OR DESTROY BUFFER*. =0 call io_arrayFree() before io_arrayDestroy() + * return: =NULL error, !=NULL allocated variable array, after use must free with io_arrayDestroy() + */ +array_t *io_buffer2vals(unsigned char *buf, int buflen, int vnum, int zcpy); +/* + * io_vals2map() Marshaling data from array with variables to memory map + * @buf = Buffer + * @buflen = Size of buffer + * @vars = Variable array + * return: -1 error, 0 nothing done or >0 size of marshaled data + */ +int io_vals2map(u_char *buf, int buflen, array_t *vars); +/* + * io_map2vals() De-marshaling data from memory map to array with variables + * @buf = Buffer + * @buflen = Size of buffer + * @vnum = Number of variables into buffer + * @zcpy = Zero-copy for variables, if !=0 don't use io_arrayFree() for free variables and + *DON'T MODIFY OR DESTROY BUFFER*. =0 call io_arrayFree() before io_arrayDestroy() + * return: =NULL error, !=NULL allocated variable array, after use must free with io_arrayDestroy() + */ +array_t *io_map2vals(u_char *buf, int buflen, int vnum, int zcpy); + +/* * ioPromptRead() Read data from input h[0] with prompt to output h[1] * @h = file handles h[0] = input, h[1] = output, if NULL use stdin, stdout * @csPrompt = Prompt before input, may be NULL @@ -378,12 +422,20 @@ inline int io_arrayLen(array_t * __restrict arr); */ int io_arrayConcat(array_t * __restrict dest, array_t * __restrict src); /* + * io_arrayCopy() Copy source array to destination array + * @dest = Destination array, after use free with io_arrayDestroy() + * @src = Source array + * return: -1 error; >0 count of destination array + */ +int io_arrayCopy(array_t ** __restrict dest, array_t * __restrict src); +/* * io_arrayGrow() - Grow/Shrink dynamic array, Use with care when it shrink!!! * @arr = Array * @newNumItems = Number of Items + * @freeShrink = Free elements before shrink array * return: -1 error, 0 ok */ -int io_arrayGrow(array_t * __restrict arr, int newNumItems); +int io_arrayGrow(array_t * __restrict arr, int newNumItems, int freeShrink); /* * io_arrayVacuum() - Vacuum dynamic array, empty elements will be deleted * @arr = Array @@ -392,7 +444,9 @@ int io_arrayGrow(array_t * __restrict arr, int newNumI */ int io_arrayVacuum(array_t * __restrict arr, int fromWhere); -#define io_arraySize(_arr) (assert((_arr)), (_arr)->arr_num) +#define io_arraySize(_arr) ((_arr) ? (_arr)->arr_num : 0) +#define io_arrayZero(_arr) (assert((_arr)), memset((_arr)->arr_data, 0, \ + io_arraySize((_arr)) * sizeof(void*))) #define io_arrayGet(_arr, _d) (assert((_arr) && (_arr)->arr_num > _d), *((_arr)->arr_data + _d)) #define io_array(_arr, _d, _type) (assert((_arr) && (_arr)->arr_num > _d), \ @@ -483,8 +537,16 @@ int io_sarrGrow(sarr_t * __restrict arr, int newNumIte * return: -1 error, >-1 freed segments */ inline int io_sarrVacuum(sarr_t * __restrict arr); -#define io_sarrSize(_arr) (assert((_arr)), (_arr)->sarr_num) +#define io_sarrSize(_arr) ((_arr) ? (_arr)->sarr_num : 0) +#define io_sarrSeg(_arr) (assert((_arr)), (_arr)->sarr_seg) /* + * io_sarrCopy() Copy source split array to destination split array + * @dest = Destination split array, after use free with io_sarrDestroy() + * @src = Source split array + * return: -1 error; >0 count of destination split array + */ +int io_sarrCopy(sarr_t ** __restrict dest, sarr_t * __restrict src); +/* * io_sarrGet() - Get element from dynamic split-order array * @arr = Array * @idx = Index (warning 1st element is at position 1) @@ -687,6 +749,78 @@ int ioCipher(unsigned char *pInput, int inLen, unsigne */ int io_Blowfish(unsigned char *pInput, int inLen, unsigned char **ppOutput, unsigned char *pKey, unsigned char *pIV, int nMode); + + +/* + * ioAllocPTY() Allocate new PTY and TTY + * @ptyfd = master fd, pty + * @ttyfd = slave fd, tty + * @name = tty device name if not null + * @namesiz = name length, must be above 63 bytes. + * @term = termios for terminal + * @winz = winsize for terminal + * return: -1 error or 0 ok + */ +inline int ioAllocPTY(int *ptyfd, int *ttyfd, char * __restrict name, int namesiz, + struct termios * __restrict term, struct winsize * __restrict winz); +/* + * ioFreeTTY() Release PTY and TTY device + * @ptyfd = master fd, pty + * @ttyname = tty filename + * return: none + */ +inline void ioFreeTTY(int ptyfd, const char *ttyname); +/* + * ioChgWinPTY() Change window size of PTY + * @ptyfd = master fd, pty + * @row = row + * @col = col + * @xpxl = x pixels + * @ypxl = y pixels + * return: -1 error or 0 ok + */ +inline int ioChgWinPTY(int ptyfd, u_short row, u_short col, u_short xpxl, u_short ypxl); +/* + * ioSetOwnerTTY() Set owner to TTY + * @ttyname = tty filename + * @UID = uid + * @GID = gid + * return: -1 error or 0 ok + */ +int ioSetOwnerTTY(const char *ttyname, uid_t UID, gid_t GID); +/* + * ioSetSidTTY() Makes the process's controlling TTY and sets it to sane modes. + * @ttyfd = slave fd, tty + * @ttyname = tty filename + * return: -1 error or 0 ok + */ +int ioSetSidTTY(int *ttyfd, const char *ttyname); +/* + * ioSetRAWMode() Enter into RAW mode + * @fd = tty fd + * @otio = saved old termios for later restore if !=NULL + * return: -1 error or 0 ok + */ +inline int ioSetRAWMode(int fd, struct termios *otio); +/* + * ioRestoreMode() Restore termios to tty fd + * @fd = tty fd + * @tio = termios structure for restore + * return: -1 error or 0 ok + */ +inline int ioRestoreMode(int fd, struct termios tio); +/* + * ioForkPTY() Fork new process with session leader and new TTY + * @ptyfd = master fd, pty + * @name = tty device name if not null + * @namesiz = name length, must be above 63 bytes. + * @term = termios for terminal + * @winz = winsize for terminal + * @otio = old termios structure for restore + * return: -1 error, 0 child process or >0 parent: pid of child + */ +pid_t ioForkPTY(int *ptyfd, char * __restrict name, int namesiz, struct termios * __restrict term, + struct winsize * __restrict winz, struct termios * __restrict otio); #endif