libaitrpc/inc/aitrpc.h - diff

Return to aitrpc.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / libaitrpc / inc

Diff for /libaitrpc/inc/aitrpc.h between versions 1.1.1.1.2.3 and 1.1.1.1.2.22

version 1.1.1.1.2.3, 2010/06/23 07:47:25	version 1.1.1.1.2.22, 2011/03/15 15:46:58
Line 19	Line 19
#include <sys/socket.h>	#include <sys/socket.h>


#define STRSIZ 256

#define RPC_VERSION 1	#define RPC_VERSION 1
#define RPC_DEFPORT 2611	#define RPC_DEFPORT 2611


/* RPC builtin registed calls */	/* RPC builtin registed calls */

	#define CALL_BLOBSHUTDOWN "rpcBLOBServerShutdown"
	#define CALL_BLOBCLIENTS "rpcBLOBServerClients"
	#define CALL_BLOBVARS "rpcBLOBServerVars"
	#define CALL_BLOBSTATE "rpcBLOBServerState"

#define CALL_SRVSHUTDOWN "rpcServerShutdown"	#define CALL_SRVSHUTDOWN "rpcServerShutdown"
#define CALL_SRVCLIENTS "rpcServerClients"	#define CALL_SRVCLIENTS "rpcServerClients"
#define CALL_SRVCALLS "rpcServerCalls"	#define CALL_SRVCALLS "rpcServerCalls"
Line 44 typedef enum {	Line 47 typedef enum {
i8, i16, i32, i64 // integers ...	i8, i16, i32, i64 // integers ...
} rpc_type_t;	} rpc_type_t;

	typedef enum {
	disable, enable, // for blob.state
	ok, error, // for blob reply
	get, set, unset // for blob request
	} cmd_type_t;

/* RPC value */	/* RPC value */

typedef struct {	typedef struct {
Line 52 typedef struct {	Line 61 typedef struct {
union {	union {
uint8_t *buffer;	uint8_t *buffer;
int8_t *string;	int8_t *string;
void *blob;	uint32_t blob;
size_t size;	size_t size;
off_t offset;	off_t offset;
time_t datetime;	time_t datetime;
Line 100 typedef struct {	Line 109 typedef struct {
if (val->val.string) { \	if (val->val.string) { \
val->val_type = string; val->val_len = strlen(v) + 1; \	val->val_type = string; val->val_len = strlen(v) + 1; \
} } while (0)	} } while (0)
#define RPC_SET_BLOB(vl, v, l) do { rpc_val_t *val = (vl); assert(val); val->val.blob = realloc(val->val.blob, l); \	#define RPC_SET_BLOB(vl, v, l) do { rpc_val_t *val = (vl); assert(val); val->val_type = blob; \
if (val->val.blob) { \	val->val.blob = v; val->val_len = l; } while (0)
val->val_type = blob; val->val_len = l; \	#define RPC_SET_BLOB2(vl, b) do { rpc_val_t *val = (vl); assert(val); assert(b); val->val_type = blob; \
memcpy(val->val.blob, v, l); \	val->val.blob = b->blob_var; val->val_len = b->blob_len; } while (0)
} } while (0)
#define RPC_SET_SIZE(vl, v) do { rpc_val_t *val = (vl); assert(val); val->val_type = size; val->val.size = v; \	#define RPC_SET_SIZE(vl, v) do { rpc_val_t *val = (vl); assert(val); val->val_type = size; val->val.size = v; \
val->val_len = sizeof(size_t); } while (0)	val->val_len = sizeof(size_t); } while (0)
#define RPC_SET_OFF(vl, v) do { rpc_val_t *val = (vl); assert(val); val->val_type = offset; val->val.offset = v; \	#define RPC_SET_OFF(vl, v) do { rpc_val_t *val = (vl); assert(val); val->val_type = offset; val->val.offset = v; \
Line 141 typedef struct {	Line 149 typedef struct {
free(val->val.string); \	free(val->val.string); \
val->val.string = NULL; \	val->val.string = NULL; \
} \	} \
if (val->val_type == array && val->val.array) { \
free(val->val.array); \
val->val.array = NULL; \
} \
val->val_type = val->val_len = 0; \	val->val_type = val->val_len = 0; \
} while (0)	} while (0)


#define RPC_CALLBACK_CHK_NUM_ARGS(f, n) do { \	#define RPC_CALLBACK_CHECK_INPUT(x) do { \
if (f->func_args != n) { \	if (!x) { \
rpc_SetErr(22, "Error:: different number of arguments!\n"); \	rpc_SetErr(22, "Error:: invalid callback parameters ...\n"); \
return -1; \	return -1; \
} \	} \
} while (0)	} while (0)
#define RPC_CALLBACK_CHECK_INPUT(s, f) do { \	#define RPC_CALLBACK_CHK_ARGS(f, n) do { \
if (!s \|\| !f) { \	RPC_CALLBACK_CHECK_INPUT(f); \
rpc_SetErr(22, "Error:: invalid callback parameters ...\n"); \	if (f && f->func_args != n) { \
	rpc_SetErr(22, "Error:: different number of arguments!\n"); \
return -1; \	return -1; \
} \	} \
} while (0)	} while (0)
Line 184 typedef struct tagRPCFunc {	Line 189 typedef struct tagRPCFunc {
int8_t func_args;	int8_t func_args;
rpc_val_t *func_vals;	rpc_val_t *func_vals;

	void *func_parent;
struct tagRPCFunc *func_next;	struct tagRPCFunc *func_next;
} rpc_func_t;	} rpc_func_t;

Line 208 struct tagRPCRet {	Line 214 struct tagRPCRet {
uint8_t ret_argc;	uint8_t ret_argc;
} __packed;	} __packed;

	/* Network BLOB packet - Header */

	struct tagBLOBHdr {
	rpc_sess_t hdr_session;
	uint8_t hdr_cmd;
	uint32_t hdr_var;
	uint32_t hdr_len;
	uint32_t hdr_ret;
	} __packed;

/* Network RPC client & server elements */	/* Network RPC client & server elements */

typedef struct {	typedef struct {
Line 218 typedef struct {	Line 234 typedef struct {
void *cli_parent; // pointer to parent rpc_srv_t for server or to rpc_sess_t for client	void *cli_parent; // pointer to parent rpc_srv_t for server or to rpc_sess_t for client
} rpc_cli_t;	} rpc_cli_t;


	// BLOB registration element!
	typedef struct tagBLOB {
	uint32_t blob_var;

	size_t blob_len; // size of allocated BLOB data
	void *blob_data; // BLOB data

	struct tagBLOB *blob_next;
	} rpc_blob_t;

typedef struct {	typedef struct {
	rpc_sess_t srv_session; // RPC session registration info
int srv_numcli; // maximum concurent client connections	int srv_numcli; // maximum concurent client connections
rpc_cli_t srv_server; // server socket

rpc_sess_t srv_session; // RPC session registration info	rpc_cli_t srv_server; // RPC server socket
	rpc_cli_t *srv_clients; // connected rpc client sockets

rpc_cli_t *srv_clients; // connected client sockets

rpc_func_t *srv_funcs; // registered functions list	rpc_func_t *srv_funcs; // registered functions list

	pthread_mutex_t srv_mtx;

	struct {
	int state; // BLOB server state: ==0 disable \| !=0 enable
	char dir[UCHAR_MAX + 1];

	rpc_cli_t server; // BLOB server socket
	rpc_cli_t *clients; // connected blob client sockets

	rpc_blob_t *blobs; // registered blob variables list

	pthread_mutex_t mtx;
	} srv_blob;
} rpc_srv_t;	} rpc_srv_t;


typedef int (rpc_callback_t)(void const, rpc_func_t , int, rpc_val_t );	/*
	* (*rpc_callback_t)() Callback type definition for RPC call in server process
	* @arg1 = current execution RPC call function
	* @arg2 = number of items in input array from call request
	* @arg3 = input array with values from RPC call execution request
	* return: -1 error or >-1 success execution
	*/
	typedef int (rpc_callback_t)(rpc_func_t , int, rpc_val_t *);


// -----------------------------------------------------------------------	// -----------------------------------------------------------------------
Line 271 void rpc_srv_endServer(rpc_srv_t * __restrict srv);	Line 318 void rpc_srv_endServer(rpc_srv_t * __restrict srv);
int rpc_srv_execServer(rpc_srv_t * __restrict srv);	int rpc_srv_execServer(rpc_srv_t * __restrict srv);

/*	/*
	* rpc_srv_initBLOBServer() Init & create BLOB Server
	* @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, u_short Port, const char *diskDir);
	/*
	* rpc_srv_endBLOBServer() Destroy BLOB server, close all opened sockets and free resources
	* @srv = RPC Server instance
	* return: none
	*/
	void rpc_srv_endBLOBServer(rpc_srv_t * __restrict srv);
	/*
	* rpc_srv_execBLOBServer() Execute Main BLOB server loop and wait for clients requests
	* @srv = RPC Server instance
	* return: -1 error or 0 ok, infinite loop ...
	*/
	int rpc_srv_execBLOBServer(rpc_srv_t * __restrict srv);

	/*
* rpc_srv_registerCall() Register call to RPC server	* rpc_srv_registerCall() Register call to RPC server
* @srv = RPC Server instance	* @srv = RPC Server instance
* @csModule = Module name, if NULL self binary	* @csModule = Module name, if NULL self binary
* @csFunc = Function name	* @csFunc = Function name
* @args = Number of function arguments	* @args = Number of return function arguments, use for restriction case!
* return: -1 error or 0 register ok	* return: -1 error or 0 register ok
*/	*/
int rpc_srv_registerCall(rpc_srv_t * __restrict srv, const char csModule, const char csFunc,	int rpc_srv_registerCall(rpc_srv_t * __restrict srv, const char csModule, const char csFunc,
Line 306 rpc_func_t rpc_srv_getFunc(rpc_srv_t __restrict srv	Line 373 rpc_func_t rpc_srv_getFunc(rpc_srv_t __restrict srv
inline rpc_func_t rpc_srv_getCall(rpc_srv_t __restrict srv, uint16_t tag, uint32_t hash);	inline rpc_func_t rpc_srv_getCall(rpc_srv_t __restrict srv, uint16_t tag, uint32_t hash);
/*	/*
* rpc_srv_execCall() Execute registered call from RPC server	* rpc_srv_execCall() Execute registered call from RPC server
* @data = RPC const data
* @call = Register RPC call	* @call = Register RPC call
* @rpc = IN RPC call structure	* @rpc = IN RPC call structure
* @args = IN RPC call array of rpc values	* @args = IN RPC call array of rpc values
* return: -1 error, !=-1 ok	* return: -1 error, !=-1 ok
*/	*/
int rpc_srv_execCall(void * const data, rpc_func_t * __restrict call,	int rpc_srv_execCall(rpc_func_t * __restrict call, struct tagRPCCall * __restrict rpc,
struct tagRPCCall * __restrict rpc, rpc_val_t * __restrict args);	rpc_val_t * __restrict args);


/*	/*
* rpc_srv_declValsCall() Declare return variables for RPC call	* rpc_srv_retValsCall() Declare return variables for RPC call and zeroed values
	(for safe handling return values, use this!)
* @call = RPC function call	* @call = RPC function call
* @return_vals = Number of return variables	* @return_vals = Number of return variables
	* return: NULL error, !=NULL array with return values for RPC call with return_vals items
	*/
	inline rpc_val_t rpc_srv_retValsCall(rpc_func_t __restrict call, int return_vals);
	/*
	* 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
	* @call = RPC function call
	* @return_vals = Number of return variables
* return: -1 error, !=-1 ok	* return: -1 error, !=-1 ok
*/	*/
inline int rpc_srv_declValsCall(rpc_func_t * __restrict call, int return_vals);	inline int rpc_srv_declValsCall(rpc_func_t * __restrict call, int return_vals);
Line 337 inline void rpc_srv_freeValsCall(rpc_func_t * __restri	Line 413 inline void rpc_srv_freeValsCall(rpc_func_t * __restri
*/	*/
inline int rpc_srv_copyValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict newvals);	inline int rpc_srv_copyValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict newvals);
/*	/*
* rpc_srv_delValsCall() Clean values from return variables of RPC call	* rpc_srv_zeroValsCall() Clean values from return variables of RPC call
* @call = RPC function call	* @call = RPC function call
* return: -1 error, !=-1 Returned number of cleaned RPC variables	* return: -1 error, !=-1 Returned number of cleaned RPC variables
*/	*/
inline int rpc_srv_delValsCall(rpc_func_t * __restrict call);	inline int rpc_srv_zeroValsCall(rpc_func_t * __restrict call);
/*	/*
* rpc_srv_getValsCall() Get return variables for RPC call	* rpc_srv_getValsCall() Get return variables for RPC call
* @call = RPC function call	* @call = RPC function call
Line 351 inline int rpc_srv_delValsCall(rpc_func_t * __restrict	Line 427 inline int rpc_srv_delValsCall(rpc_func_t * __restrict
inline int rpc_srv_getValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict vals);	inline int rpc_srv_getValsCall(rpc_func_t * __restrict call, rpc_val_t ** __restrict vals);


	/*
	* rpc_srv_blobCreate() Create map blob to memory region and return object
	* @srv = RPC Server instance
	* @len = BLOB length object
	* return: NULL error or !=NULL allocated BLOB object
	*/
	inline rpc_blob_t rpc_srv_blobCreate(rpc_srv_t __restrict srv, int len);
	/*
	* rpc_srv_blobMap() Map blob to memory region
	* @srv = RPC Server instance
	* @blob = Map to this BLOB element
	* return: -1 error or 0 ok
	*/
	inline int rpc_srv_blobMap(rpc_srv_t * __restrict srv, rpc_blob_t * __restrict blob);
	/*
	* rpc_srv_blobUnmap() Unmap blob memory region
	* @blob = Mapped BLOB element
	* return: none
	*/
	inline void rpc_srv_blobUnmap(rpc_blob_t * __restrict blob);
	/*
	* rpc_srv_blobFree() Free blob from disk & memory
	* @srv = RPC Server instance
	* @blob = Mapped BLOB element
	* return: -1 error or 0 ok
	*/
	inline int rpc_srv_blobFree(rpc_srv_t * __restrict srv, rpc_blob_t * __restrict blob);

	/*
	* rpc_srv_registerBLOB() Register new BLOB to server
	* @srv = RPC Server instance
	* @len = BLOB length
	* return: NULL error or new registered BLOB
	*/
	rpc_blob_t rpc_srv_registerBLOB(rpc_srv_t __restrict srv, size_t len);
	/*
	* rpc_srv_unregisterBLOB() Unregister BLOB from server
	* @srv = RPC Server instance
	* @var = BLOB Variable for unregister
	* return: -1 error, 0 not found call, 1 unregister ok
	*/
	int rpc_srv_unregisterBLOB(rpc_srv_t * __restrict srv, uint32_t var);
	/*
	* rpc_srv_getBLOB() Get registered BLOB
	* @srv = RPC Server instance
	* @var = hash for variable
	* return: NULL not found, !=NULL return blob var
	*/
	inline rpc_blob_t rpc_srv_getBLOB(rpc_srv_t __restrict srv, uint32_t var);

	/*
	* rpc_srv_sendBLOB() Send mapped BLOB to client
	* @cli = Client instance
	* @blob = Mapped BLOB element
	* return: -1 error, 0 ok
	*/
	int rpc_srv_sendBLOB(rpc_cli_t * __restrict cli, rpc_blob_t * __restrict blob);
	/*
	* rpc_srv_recvBLOB() Receive BLOB from client
	* @cli = Client instance
	* @blob = Mapped BLOB element
	* return: -1 error, 0 ok, >0 unreceived data from client, may be error?
	*/
	int rpc_srv_recvBLOB(rpc_cli_t * __restrict cli, rpc_blob_t * __restrict blob);

	/*
	* rpc_cli_sendBLOB() Send BLOB to server
	* @cli = Client instance
	* @var = BLOB variable
	* @data = BLOB data
	* return: -1 error, 0 ok, 1 remote error
	*/
	int rpc_cli_sendBLOB(rpc_cli_t * __restrict cli, rpc_val_t * __restrict var, void * __restrict data);
	/*
	* rpc_cli_recvBLOB() Receive BLOB from server
	* @cli = Client instance
	* @var = BLOB variable
	* @data = BLOB data, must be free after use!
	* return: -1 error, 0 ok, 1 remote error
	*/
	int rpc_cli_recvBLOB(rpc_cli_t * __restrict cli, rpc_val_t * __restrict var, void ** data);
	/*
	* rpc_cli_delBLOB() Delete BLOB from server
	* @cli = Client instance
	* @var = BLOB variable
	* return: -1 error, 0 ok, 1 remote error
	*/
	int rpc_cli_delBLOB(rpc_cli_t * __restrict cli, rpc_val_t * __restrict var);
	/*
	* rpc_cli_getBLOB() Receive BLOB from server and Delete after that.
	* @cli = Client instance
	* @var = BLOB variable
	* @data = BLOB data, must be free after use!
	* return: -1 error, 0 ok, >0 remote error
	*/
	inline int rpc_cli_getBLOB(rpc_cli_t * __restrict cli, rpc_val_t * __restrict var, void ** data);



/* RPC Client side functions */	/* RPC Client side functions */

/*	/*
Line 390 int rpc_cli_execCall(rpc_cli_t cli, const char csMod	Line 565 int rpc_cli_execCall(rpc_cli_t cli, const char csMod
* return: none	* return: none
*/	*/
inline void rpc_cli_freeVals(int args, rpc_val_t *vals);	inline void rpc_cli_freeVals(int args, rpc_val_t *vals);


	/*
	* rpc_cli_openBLOBClient() Connect to BLOB Server
	* @rpccli = RPC Client session
	* @Port = Port for bind server, if Port == 0 default port is selected
	* return: NULL == error or !=NULL connection to BLOB server established
	*/
	rpc_cli_t rpc_cli_openBLOBClient(rpc_cli_t __restrict rpccli, u_short Port);
	/*
	* rpc_cli_closeBLOBClient() Close connection to BLOB server and free resources
	* @cli = BLOB Client session
	* return: none
	*/
	void rpc_cli_closeBLOBClient(rpc_cli_t * __restrict cli);


#endif	#endif

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.1.1.1.2.3
changed lines
	Added in v.1.1.1.1.2.22