version 1.1.1.1.2.10, 2010/06/24 11:01:46
|
version 1.1.1.1.2.20, 2010/07/08 09:18:51
|
Line 28
|
Line 28
|
#define CALL_BLOBSHUTDOWN "rpcBLOBServerShutdown" |
#define CALL_BLOBSHUTDOWN "rpcBLOBServerShutdown" |
#define CALL_BLOBCLIENTS "rpcBLOBServerClients" |
#define CALL_BLOBCLIENTS "rpcBLOBServerClients" |
#define CALL_BLOBVARS "rpcBLOBServerVars" |
#define CALL_BLOBVARS "rpcBLOBServerVars" |
|
#define CALL_BLOBSTATE "rpcBLOBServerState" |
|
|
#define CALL_SRVSHUTDOWN "rpcServerShutdown" |
#define CALL_SRVSHUTDOWN "rpcServerShutdown" |
#define CALL_SRVCLIENTS "rpcServerClients" |
#define CALL_SRVCLIENTS "rpcServerClients" |
Line 60 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 109 typedef struct {
|
Line 110 typedef struct {
|
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_type = blob; \ |
#define RPC_SET_BLOB(vl, v, l) do { rpc_val_t *val = (vl); assert(val); val->val_type = blob; \ |
val->val.blob = (void*) v; val->val_len = l; } while (0) | val->val.blob = v; val->val_len = l; } while (0) |
| #define RPC_SET_BLOB2(vl, b) do { rpc_val_t *val = (vl); assert(val); assert(b); val->val_type = blob; \ |
| val->val.blob = b->blob_var; val->val_len = b->blob_len; } 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 150 typedef struct {
|
Line 153 typedef struct {
|
} while (0) |
} while (0) |
|
|
|
|
#define RPC_CALLBACK_CHK_NUM_ARGS(f, n) do { \ | #define RPC_CALLBACK_CHK_RETARGS(f, n) do { \ |
if (f->func_args != n) { \ |
if (f->func_args != n) { \ |
rpc_SetErr(22, "Error:: different number of arguments!\n"); \ |
rpc_SetErr(22, "Error:: different number of arguments!\n"); \ |
return -1; \ |
return -1; \ |
} \ |
} \ |
} while (0) |
} while (0) |
#define RPC_CALLBACK_CHECK_INPUT(s, f) do { \ | #define RPC_CALLBACK_CHECK_INPUT(f) do { \ |
if (!s || !f) { \ | if (!f) { \ |
rpc_SetErr(22, "Error:: invalid callback parameters ...\n"); \ |
rpc_SetErr(22, "Error:: invalid callback parameters ...\n"); \ |
return -1; \ |
return -1; \ |
} \ |
} \ |
Line 185 typedef struct tagRPCFunc {
|
Line 188 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 215 struct tagBLOBHdr {
|
Line 219 struct tagBLOBHdr {
|
rpc_sess_t hdr_session; |
rpc_sess_t hdr_session; |
uint8_t hdr_cmd; |
uint8_t hdr_cmd; |
uint32_t hdr_var; |
uint32_t hdr_var; |
uint32_t hdr_seq; |
|
uint32_t hdr_len; |
uint32_t hdr_len; |
|
uint32_t hdr_ret; |
} __packed; |
} __packed; |
|
|
/* Network RPC client & server elements */ |
/* Network RPC client & server elements */ |
Line 265 typedef struct {
|
Line 269 typedef struct {
|
} 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 338 inline rpc_blob_t *rpc_srv_getBLOB(rpc_srv_t * __restr
|
Line 349 inline rpc_blob_t *rpc_srv_getBLOB(rpc_srv_t * __restr
|
* @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 369 rpc_func_t *rpc_srv_getFunc(rpc_srv_t * __restrict srv
|
Line 380 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 400 inline void rpc_srv_freeValsCall(rpc_func_t * __restri
|
Line 420 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 446 inline int rpc_srv_blobFree(rpc_srv_t * __restrict srv
|
Line 466 inline int rpc_srv_blobFree(rpc_srv_t * __restrict srv
|
* rpc_srv_registerBLOB() Register new BLOB to server |
* rpc_srv_registerBLOB() Register new BLOB to server |
* @srv = RPC Server instance |
* @srv = RPC Server instance |
* @len = BLOB length |
* @len = BLOB length |
* return: -1 error or 0 register ok | * return: NULL error or new registered BLOB |
*/ |
*/ |
rpc_blob_t *rpc_srv_registerBLOB(rpc_srv_t * __restrict srv, size_t len); |
rpc_blob_t *rpc_srv_registerBLOB(rpc_srv_t * __restrict srv, size_t len); |
/* |
/* |
Line 472 int rpc_srv_sendBLOB(rpc_cli_t * __restrict cli, rpc_b
|
Line 492 int rpc_srv_sendBLOB(rpc_cli_t * __restrict cli, rpc_b
|
*/ |
*/ |
int rpc_srv_recvBLOB(rpc_cli_t * __restrict cli, rpc_blob_t * __restrict blob); |
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 512 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 |