--- libaitrpc/inc/aitrpc.h 2011/08/19 07:39:29 1.2.4.5 +++ libaitrpc/inc/aitrpc.h 2011/08/19 12:51:50 1.2.4.8 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitrpc.h,v 1.2.4.5 2011/08/19 07:39:29 misho Exp $ +* $Id: aitrpc.h,v 1.2.4.8 2011/08/19 12:51:50 misho Exp $ * ************************************************************************** The ELWIX and AITNET software is distributed under the following @@ -226,7 +226,7 @@ typedef struct tagRPCFunc { int8_t func_name[UCHAR_MAX + 1]; int8_t func_args; - rpc_val_t *func_vals; + rpc_val_t *func_vars; void *func_parent; struct tagRPCFunc *func_next; @@ -268,7 +268,6 @@ struct tagBLOBHdr { typedef struct { struct sockaddr cli_sa; // host info int cli_sock; // socket fd - int cli_type; // socket type pthread_t cli_tid; // TID of thread void *cli_parent; // pointer to parent rpc_srv_t for server or to rpc_sess_t for client @@ -338,14 +337,13 @@ inline const char *rpc_GetError(); * @regProgID = ProgramID for authentication & recognition * @regProcID = ProcessID for authentication & recognition * @concurentClients = Concurent clients at same time to this server - * @sockType = Socket type, like SOCK_STREAM, SOCK_DGRAM or SOCK_RAW * @family = Family type, AF_INET, AF_INET6 or AF_LOCAL * @csHost = Host name or address for bind server, if NULL any address * @Port = Port for bind server, if Port == 0 default port is selected * return: NULL == error or !=NULL bind and created RPC server instance */ rpc_srv_t *rpc_srv_initServer(u_int regProgID, u_int regProcID, int concurentClients, - int sockType, u_short family, const char *csHost, u_short Port); + u_short family, const char *csHost, u_short Port); /* * rpc_srv_endServer() Destroy RPC server, close all opened sockets and free resources * @srv = RPC Server instance @@ -362,12 +360,11 @@ int rpc_srv_execServer(rpc_srv_t * __restrict srv); /* * rpc_srv_initBLOBServer() Init & create BLOB Server * @srv = RPC server instance - * @sockType = Socket type, like SOCK_STREAM, SOCK_DGRAM or SOCK_RAW * @Port = Port for bind server, if Port == 0 default port is selected * @diskDir = Disk place for BLOB file objects * return: -1 == error or 0 bind and created BLOB server instance */ -int rpc_srv_initBLOBServer(rpc_srv_t * __restrict srv, int sockType, u_short Port, const char *diskDir); +int rpc_srv_initBLOBServer(rpc_srv_t * __restrict srv, u_short Port, const char *diskDir); /* * rpc_srv_endBLOBServer() Destroy BLOB server, close all opened sockets and free resources * @srv = RPC Server instance @@ -427,48 +424,42 @@ int rpc_srv_execCall(rpc_func_t * __restrict call, str /* - * rpc_srv_retValsCall() Declare return variables for RPC call and zeroed values + * rpc_srv_returnVars() Init return variables for RPC call and zeroed values (for safe handling return values, use this!) * @call = RPC function call - * @return_vals = Number of return variables - * return: NULL error, !=NULL array with return values for RPC call with return_vals items + * @varnum = Number of return variables + * return: NULL error, !=NULL array with return values for RPC call with varnum items */ -inline rpc_val_t *rpc_srv_retValsCall(rpc_func_t * __restrict call, int return_vals); +inline rpc_val_t *rpc_srv_returnVars(rpc_func_t * __restrict call, int varnum); /* - * rpc_srv_declValsCall() Declare return variables for RPC call, - if already allocated memory for RPC call return values - function reallocate used space with return_vals count elements + * rpc_srv_allocVars() Allocate array for call variables, + if already allocated memory for RPC call reallocate used space * @call = RPC function call - * @return_vals = Number of return variables - * return: -1 error, !=-1 ok + * @varnum = Number of variables, if ==0 free previous allocated variables + * return: -1 error, !=-1 return varnum value */ -inline int rpc_srv_declValsCall(rpc_func_t * __restrict call, int return_vals); +inline int rpc_srv_allocVars(rpc_func_t * __restrict call, int varnum); +#define rpc_srv_freeVars(_call) (assert((_call)), rpc_srv_allocVars((_call), 0)) /* - * rpc_srv_freeValsCall() Free return variables for RPC call + * rpc_srv_zeroVars() Clean values from variables of RPC call * @call = RPC function call - * return: none + * return: -1 error, !=-1 Returned number of cleaned RPC variables */ -inline void rpc_srv_freeValsCall(rpc_func_t * __restrict call); +inline int rpc_srv_zeroVars(rpc_func_t * __restrict call); /* - * rpc_srv_copyValsCall() Copy return variables for RPC call to new variable + * rpc_srv_copyVars() Copy variables for RPC call to new variable array * @call = RPC function call - * @newvals = New allocated variables array, must be free after use + * @newvars = New allocated variables array, must be free after use * return: -1 error, !=-1 Returned number of copied RPC variables */ -inline int rpc_srv_copyValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict newvals); +inline int rpc_srv_copyVars(rpc_func_t * __restrict call, rpc_val_t ** __restrict newvars); /* - * rpc_srv_zeroValsCall() Clean values from return variables of RPC call + * rpc_srv_getVars() Get variables array for RPC call * @call = RPC function call - * return: -1 error, !=-1 Returned number of cleaned RPC variables - */ -inline int rpc_srv_zeroValsCall(rpc_func_t * __restrict call); -/* - * rpc_srv_getValsCall() Get return variables for RPC call - * @call = RPC function call - * @vals = Returned variables, may be NULL + * @vars = Returned variables array, may be NULL * return: -1 error, !=-1 Number of returned variables */ -inline int rpc_srv_getValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict vals); +inline int rpc_srv_getVars(rpc_func_t * __restrict call, rpc_val_t ** __restrict vars); /* @@ -581,8 +572,8 @@ inline int rpc_cli_getBLOB(rpc_cli_t * __restrict cli, * @Port = Port for bind server, if Port == 0 default port is selected * return: NULL == error or !=NULL connection to RPC server established */ -rpc_cli_t *rpc_cli_openClient(u_int ProgID, u_int ProcID, u_short family, - const char *csHost, u_short Port); +rpc_cli_t *rpc_cli_openClient(u_int ProgID, u_int ProcID, + u_short family, const char *csHost, u_short Port); /* * rpc_cli_closeClient() Close connection to RPC server and free resources * @cli = RPC Client session