Annotation of libaitrpc/src/cli.c, revision 1.17.2.1
1.1 misho 1: /*************************************************************************
2: * (C) 2010 AITNET ltd - Sofia/Bulgaria - <misho@aitbg.com>
3: * by Michael Pounov <misho@openbsd-bg.org>
4: *
5: * $Author: misho $
1.17.2.1! misho 6: * $Id: cli.c,v 1.17 2013/08/22 15:31:09 misho Exp $
1.1 misho 7: *
1.2 misho 8: **************************************************************************
9: The ELWIX and AITNET software is distributed under the following
10: terms:
11:
12: All of the documentation and software included in the ELWIX and AITNET
13: Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org>
14:
1.14 misho 15: Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013
1.2 misho 16: by Michael Pounov <misho@elwix.org>. All rights reserved.
17:
18: Redistribution and use in source and binary forms, with or without
19: modification, are permitted provided that the following conditions
20: are met:
21: 1. Redistributions of source code must retain the above copyright
22: notice, this list of conditions and the following disclaimer.
23: 2. Redistributions in binary form must reproduce the above copyright
24: notice, this list of conditions and the following disclaimer in the
25: documentation and/or other materials provided with the distribution.
26: 3. All advertising materials mentioning features or use of this software
27: must display the following acknowledgement:
28: This product includes software developed by Michael Pounov <misho@elwix.org>
29: ELWIX - Embedded LightWeight unIX and its contributors.
30: 4. Neither the name of AITNET nor the names of its contributors
31: may be used to endorse or promote products derived from this software
32: without specific prior written permission.
33:
34: THIS SOFTWARE IS PROVIDED BY AITNET AND CONTRIBUTORS ``AS IS'' AND
35: ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
36: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
37: ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
38: FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
39: DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
40: OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
41: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
42: LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43: OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44: SUCH DAMAGE.
45: */
1.1 misho 46: #include "global.h"
47:
48:
49: /*
1.7 misho 50: * rpc_cli_openBLOBClient() - Connect to BLOB Server
51: *
1.2 misho 52: * @rpccli = RPC Client session
53: * @Port = Port for bind server, if Port == 0 default port is selected
54: * return: NULL == error or !=NULL connection to BLOB server established
55: */
56: rpc_cli_t *
57: rpc_cli_openBLOBClient(rpc_cli_t * __restrict rpccli, u_short Port)
58: {
59: rpc_cli_t *cli = NULL;
1.13 misho 60: int n;
1.4 misho 61:
1.10 misho 62: if (!rpccli) {
1.7 misho 63: rpc_SetErr(EINVAL, "Invalid parameters can`t connect to BLOB server");
1.2 misho 64: return NULL;
65: }
66:
1.14 misho 67: cli = e_malloc(sizeof(rpc_cli_t));
1.2 misho 68: if (!cli) {
69: LOGERR;
70: return NULL;
71: } else
72: memcpy(cli, rpccli, sizeof(rpc_cli_t));
73:
1.14 misho 74: memcpy(&cli->cli_sa, &rpccli->cli_sa, sizeof(sockaddr_t));
1.10 misho 75: switch (cli->cli_sa.sa.sa_family) {
1.4 misho 76: case AF_INET:
1.10 misho 77: cli->cli_sa.sin.sin_port =
78: htons(Port ? Port : ntohs(cli->cli_sa.sin.sin_port) + 1);
1.4 misho 79: break;
80: case AF_INET6:
1.10 misho 81: cli->cli_sa.sin6.sin6_port =
82: htons(Port ? Port : ntohs(cli->cli_sa.sin6.sin6_port) + 1);
1.4 misho 83: break;
84: case AF_LOCAL:
1.10 misho 85: strlcat(cli->cli_sa.sun.sun_path, ".blob", sizeof cli->cli_sa.sun.sun_path);
1.4 misho 86: break;
1.10 misho 87: default:
88: rpc_SetErr(EINVAL, "Invalid socket type %d", cli->cli_sa.sa.sa_family);
89: return NULL;
1.2 misho 90: }
1.10 misho 91:
92: AIT_COPY_VAL(&cli->cli_buf, &rpccli->cli_buf);
1.13 misho 93: n = AIT_LEN(&cli->cli_buf);
1.2 misho 94:
1.4 misho 95: /* connect to BLOB server */
1.6 misho 96: cli->cli_sock = socket(cli->cli_sa.sa.sa_family, SOCK_STREAM, 0);
1.2 misho 97: if (cli->cli_sock == -1) {
98: LOGERR;
1.14 misho 99: e_free(cli);
1.2 misho 100: return NULL;
101: }
1.13 misho 102: if (setsockopt(cli->cli_sock, SOL_SOCKET, SO_SNDBUF, &n, sizeof n) == -1) {
103: LOGERR;
104: close(cli->cli_sock);
1.14 misho 105: e_free(cli);
1.13 misho 106: return NULL;
107: }
108: if (setsockopt(cli->cli_sock, SOL_SOCKET, SO_RCVBUF, &n, sizeof n) == -1) {
109: LOGERR;
110: close(cli->cli_sock);
1.14 misho 111: e_free(cli);
1.13 misho 112: return NULL;
113: }
1.6 misho 114: if (connect(cli->cli_sock, &cli->cli_sa.sa, cli->cli_sa.sa.sa_len) == -1) {
1.2 misho 115: LOGERR;
1.5 misho 116: close(cli->cli_sock);
1.14 misho 117: e_free(cli);
1.2 misho 118: return NULL;
1.10 misho 119: } else
120: fcntl(cli->cli_sock, F_SETFL, fcntl(cli->cli_sock, F_GETFL) | O_NONBLOCK);
1.2 misho 121:
122: return cli;
123: }
124:
125: /*
1.7 misho 126: * rpc_cli_closeBLOBClient() - Close connection to BLOB server and free resources
127: *
1.2 misho 128: * @cli = BLOB Client session
129: * return: none
130: */
131: void
1.10 misho 132: rpc_cli_closeBLOBClient(rpc_cli_t ** __restrict cli)
1.2 misho 133: {
1.10 misho 134: if (!cli || !*cli)
1.2 misho 135: return;
136:
1.10 misho 137: shutdown((*cli)->cli_sock, SHUT_RDWR);
138: close((*cli)->cli_sock);
139:
140: AIT_FREE_VAL(&(*cli)->cli_buf);
1.2 misho 141:
1.14 misho 142: e_free(*cli);
1.10 misho 143: *cli = NULL;
1.2 misho 144: }
145:
1.10 misho 146: /* -------------------------------------------------------------- */
1.2 misho 147:
148: /*
1.7 misho 149: * rpc_cli_openClient() - Connect to RPC Server
150: *
1.15 misho 151: * @InstID = InstID for RPC session request
1.10 misho 152: * @netBuf = Network buffer length (min:512 bytes), if =0 == BUFSIZ (also meaning max RPC packet)
1.1 misho 153: * @csHost = Host name or IP address for bind server
154: * @Port = Port for bind server, if Port == 0 default port is selected
1.13 misho 155: * @proto = Protocol, if == 0 choose SOCK_STREAM
1.1 misho 156: * return: NULL == error or !=NULL connection to RPC server established
157: */
158: rpc_cli_t *
1.15 misho 159: rpc_cli_openClient(u_char InstID, int netBuf, const char *csHost, u_short Port, int proto)
1.1 misho 160: {
161: rpc_cli_t *cli = NULL;
1.14 misho 162: sockaddr_t sa = E_SOCKADDR_INIT;
1.1 misho 163:
1.14 misho 164: if (!e_gethostbyname(csHost, Port, &sa))
1.1 misho 165: return NULL;
166: if (!Port)
167: Port = RPC_DEFPORT;
1.13 misho 168: if (!proto)
169: proto = SOCK_STREAM;
1.10 misho 170: if (netBuf < RPC_MIN_BUFSIZ)
1.5 misho 171: netBuf = BUFSIZ;
1.10 misho 172: else
1.14 misho 173: netBuf = E_ALIGN(netBuf, 2); /* align netBuf length */
1.10 misho 174:
1.14 misho 175: cli = e_malloc(sizeof(rpc_cli_t));
1.1 misho 176: if (!cli) {
177: LOGERR;
178: return NULL;
179: } else
180: memset(cli, 0, sizeof(rpc_cli_t));
1.5 misho 181:
1.10 misho 182: /* build session */
1.14 misho 183: cli->cli_parent = e_malloc(sizeof(rpc_sess_t));
1.1 misho 184: if (!cli->cli_parent) {
185: LOGERR;
1.14 misho 186: e_free(cli);
1.1 misho 187: return NULL;
188: } else {
189: ((rpc_sess_t*) cli->cli_parent)->sess_version = RPC_VERSION;
1.15 misho 190: ((rpc_sess_t*) cli->cli_parent)->sess_instance = InstID;
1.1 misho 191: }
192:
1.13 misho 193: cli->cli_id = proto;
1.6 misho 194: memcpy(&cli->cli_sa, &sa, sizeof cli->cli_sa);
1.14 misho 195: AIT_SET_BUFSIZ(&cli->cli_buf, 0, netBuf);
1.4 misho 196:
197: /* connect to RPC server */
1.13 misho 198: cli->cli_sock = socket(cli->cli_sa.sa.sa_family, cli->cli_id, 0);
1.1 misho 199: if (cli->cli_sock == -1) {
200: LOGERR;
1.13 misho 201: goto err;
202: }
203: if (setsockopt(cli->cli_sock, SOL_SOCKET, SO_SNDBUF,
204: &netBuf, sizeof netBuf) == -1) {
205: LOGERR;
206: goto err;
1.5 misho 207: }
1.13 misho 208: if (setsockopt(cli->cli_sock, SOL_SOCKET, SO_RCVBUF,
209: &netBuf, sizeof netBuf) == -1) {
1.1 misho 210: LOGERR;
1.13 misho 211: goto err;
212: }
213: if (cli->cli_id == SOCK_STREAM)
214: if (connect(cli->cli_sock, &cli->cli_sa.sa, cli->cli_sa.sa.sa_len) == -1) {
215: LOGERR;
216: goto err;
217: }
1.1 misho 218:
1.13 misho 219: fcntl(cli->cli_sock, F_SETFL, fcntl(cli->cli_sock, F_GETFL) | O_NONBLOCK);
1.1 misho 220: return cli;
1.13 misho 221: err:
222: AIT_FREE_VAL(&cli->cli_buf);
223: if (cli->cli_sock > 2)
224: close(cli->cli_sock);
1.14 misho 225: e_free(cli->cli_parent);
226: e_free(cli);
1.13 misho 227: return NULL;
1.1 misho 228: }
229:
230: /*
1.7 misho 231: * rpc_cli_closeClient() - Close connection to RPC server and free resources
232: *
1.1 misho 233: * @cli = RPC Client session
234: * return: none
235: */
236: void
1.10 misho 237: rpc_cli_closeClient(rpc_cli_t ** __restrict cli)
1.1 misho 238: {
1.10 misho 239: if (!cli || !*cli)
1.1 misho 240: return;
241:
1.13 misho 242: if ((*cli)->cli_id == SOCK_STREAM)
243: shutdown((*cli)->cli_sock, SHUT_RDWR);
1.10 misho 244: close((*cli)->cli_sock);
245:
246: AIT_FREE_VAL(&(*cli)->cli_buf);
247:
248: if ((*cli)->cli_parent)
1.14 misho 249: e_free((*cli)->cli_parent);
1.1 misho 250:
1.14 misho 251: e_free(*cli);
1.10 misho 252: *cli = NULL;
1.1 misho 253: }
254:
255: /*
1.14 misho 256: * rpc_pkt_Send() - Send RPC packet
1.7 misho 257: *
1.14 misho 258: * @sock = Socket
259: * @type = Type of socket
260: * @sa = Server address
261: * @pkt = RPC packet
262: * @len = Length of packet
263: * return: -1 error or !=-1 sended bytes
1.1 misho 264: */
265: int
1.14 misho 266: rpc_pkt_Send(int sock, int type, sockaddr_t * __restrict sa, ait_val_t * __restrict pkt, int len)
1.1 misho 267: {
1.10 misho 268: u_char *buf;
1.1 misho 269:
1.14 misho 270: if (!pkt) {
271: rpc_SetErr(EINVAL, "Invalid argument(s)!");
1.1 misho 272: return -1;
1.10 misho 273: } else
1.14 misho 274: buf = AIT_GET_BUF(pkt);
1.7 misho 275:
1.17.2.1! misho 276: return rpc_Write(sock, type, MSG_NOSIGNAL, sa, buf, len);
1.14 misho 277: }
278:
279: /*
280: * rpc_pkt_Receive() - Receive RPC packet
281: *
282: * @sock = Socket
283: * @type = Type of socket
284: * @sa = Server address
285: * @pkt = RPC packet
286: * return: -1 error or !=-1 sended bytes
287: */
288: int
289: rpc_pkt_Receive(int sock, int type, sockaddr_t * __restrict sa, ait_val_t * __restrict pkt)
290: {
1.17.2.1! misho 291: int ret, estlen = 0, blen = sizeof(struct tagRPCCall);
1.14 misho 292: u_char *buf;
1.17 misho 293: struct tagRPCCall *rpc;
1.14 misho 294:
295: if (!pkt) {
296: rpc_SetErr(EINVAL, "Invalid argument(s)!");
297: return -1;
298: } else
299: buf = AIT_GET_BUF(pkt);
1.10 misho 300:
301: /* reply from RPC server */
302: do {
1.17.2.1! misho 303: printf("START estlen=%d blen=%d\n", estlen, blen);
! 304: if (type == SOCK_STREAM)
! 305: ret = rpc_Read(sock, type, !estlen ? MSG_PEEK : 0, NULL, buf, blen);
! 306: else
! 307: ret = rpc_Read(sock, type, 0, sa, buf, AIT_LEN(pkt));
! 308: printf("RET=%d\n", ret);
1.13 misho 309: if (ret < 1) {
1.17.2.1! misho 310: LOGERR;
1.10 misho 311: return -1;
312: }
1.13 misho 313:
1.14 misho 314: /* check for response from known address */
1.17.2.1! misho 315: if (type == SOCK_STREAM && !estlen) {
1.17 misho 316: /* 1st read for RPC header */
1.17.2.1! misho 317: if (ret < sizeof(struct tagRPCCall)) {
! 318: rpc_SetErr(ERPCMISMATCH, "Short RPC packet %d bytes", ret);
! 319: return -1;
! 320: }
! 321:
! 322: /* calc estimated length */
! 323: rpc = (struct tagRPCCall*) buf;
! 324: estlen = ntohl(rpc->call_len);
! 325: if (estlen > AIT_LEN(pkt))
! 326: AIT_RE_BUF(pkt, estlen);
! 327: buf = AIT_GET_BUF(pkt);
! 328: blen = estlen;
! 329: printf("estlen=%d blen=%d\n", estlen, blen);
! 330: continue;
1.17 misho 331: }
1.17.2.1! misho 332:
! 333: break;
! 334: } while (42);
1.17 misho 335:
1.7 misho 336: if (ret < sizeof(struct tagRPCCall)) {
1.10 misho 337: rpc_SetErr(ERPCMISMATCH, "Short RPC packet %d bytes", ret);
1.8 misho 338: return -1;
1.7 misho 339: }
1.8 misho 340:
1.14 misho 341: return ret;
342: }
343:
344: /*
345: * rpc_pkt_Request() - Build RPC Request packet
346: *
347: * @pkt = Packet buffer
348: * @sess = RPC session info
349: * @tag = Function tag for execution
350: * @vars = Function argument array of values, may be NULL
351: * @noreply = We not want RPC reply
1.15 misho 352: * @nocrc = Without CRC calculation
1.14 misho 353: * return: -1 error or != -1 prepared bytes into packet
354: */
355: int
356: rpc_pkt_Request(ait_val_t * __restrict pkt, rpc_sess_t * __restrict sess, u_short tag,
1.15 misho 357: array_t * __restrict vars, int noreply, int nocrc)
1.14 misho 358: {
359: struct tagRPCCall *rpc;
1.17 misho 360: int ret = 0, estlen, len = sizeof(struct tagRPCCall);
1.14 misho 361: u_char *buf;
362:
363: if (!pkt || !sess) {
364: rpc_SetErr(EINVAL, "Invalid argument(s)!");
365: return -1;
1.17 misho 366: }
367:
368: /* calc estimated length */
369: estlen = ait_resideVars(vars) + len;
370: if (estlen > AIT_LEN(pkt))
371: AIT_RE_BUF(pkt, estlen);
372: buf = AIT_GET_BUF(pkt);
1.14 misho 373:
374: /* prepare RPC call */
375: rpc = (struct tagRPCCall*) buf;
376: rpc_addPktSession(&rpc->call_session, sess);
377: rpc->call_tag = htons(tag);
378: if (!vars)
379: rpc->call_argc = 0;
380: else
381: rpc->call_argc = htons(array_Size(vars));
382:
383: /* set reply */
384: rpc->call_req.flags = noreply ? RPC_NOREPLY : RPC_REPLY;
385:
386: if (array_Size(vars)) {
387: /* marshaling variables */
388: ret = ait_vars2buffer(buf + len, AIT_LEN(pkt) - len, vars);
389: if (ret == -1) {
390: rpc_SetErr(EBADRPC, "Failed to prepare RPC packet values");
391: return -1;
392: } else
393: len += ret;
394: }
395:
396: /* total packet length */
1.17 misho 397: rpc->call_len = htonl(len);
1.14 misho 398:
1.15 misho 399: if (!nocrc) {
400: /* calculate CRC */
401: rpc->call_crc ^= rpc->call_crc;
402: rpc->call_crc = htons(crcFletcher16((u_short*) buf, len / 2));
403: }
1.14 misho 404:
405: return len;
406: }
407:
408: /*
409: * rpc_pkt_Replay() - Decode RPC Replay packet
410: *
411: * @pkt = Packet buffer
412: * @sess = RPC session info
413: * @tag = Function tag
414: * @vars = Function argument array of values, may be NULL
1.15 misho 415: * @nocrc = Without CRC calculation
1.14 misho 416: * return: -1 error or != -1 return value from function
417: */
418: int
419: rpc_pkt_Replay(ait_val_t * __restrict pkt, rpc_sess_t * __restrict sess, u_short tag,
1.15 misho 420: array_t ** __restrict vars, int nocrc)
1.14 misho 421: {
422: struct tagRPCCall *rpc;
423: int len;
424: u_char *buf;
425: uint16_t crc;
426:
427: if (!pkt || !sess) {
428: rpc_SetErr(EINVAL, "Invalid argument(s)!");
429: return -1;
430: } else
431: buf = AIT_GET_BUF(pkt);
432:
433: rpc = (struct tagRPCCall*) buf;
1.15 misho 434: if (!nocrc) {
435: /* calculate CRC */
436: crc = ntohs(rpc->call_crc);
437: rpc->call_crc ^= rpc->call_crc;
1.17 misho 438: if (crc != crcFletcher16((u_short*) buf, ntohl(rpc->call_len) / 2)) {
1.15 misho 439: rpc_SetErr(ERPCMISMATCH, "Bad CRC RPC packet");
440: return -1;
441: }
1.8 misho 442: }
443:
1.3 misho 444: /* check RPC packet session info */
1.14 misho 445: if (rpc_chkPktSession(&rpc->call_session, sess)) {
1.10 misho 446: rpc_SetErr(ERPCMISMATCH, "Get invalid RPC session");
1.8 misho 447: return -1;
1.14 misho 448: }
1.10 misho 449: if (ntohs(rpc->call_tag) != tag) {
450: rpc_SetErr(ERPCMISMATCH, "Get wrong RPC reply");
1.8 misho 451: return -1;
1.6 misho 452: }
1.10 misho 453: if (ntohl(rpc->call_rep.eno) && ntohl(rpc->call_rep.ret) == -1) {
1.8 misho 454: rpc_SetErr(ntohl(rpc->call_rep.eno), "Server side: retcode=%d #%d %s",
1.7 misho 455: ntohl(rpc->call_rep.ret), ntohl(rpc->call_rep.eno),
456: strerror(ntohl(rpc->call_rep.eno)));
1.8 misho 457: return -1;
1.1 misho 458: }
1.14 misho 459: len = ntohs(rpc->call_argc) * sizeof(ait_val_t);
460: if (len > AIT_LEN(pkt) - sizeof(struct tagRPCCall)) {
461: rpc_SetErr(EMSGSIZE, "Reply RPC packet not enough buffer space ...");
462: return -1;
463: }
1.17 misho 464: if (len > ntohl(rpc->call_len) - sizeof(struct tagRPCCall)) {
1.14 misho 465: rpc_SetErr(EMSGSIZE, "Reply RPC packet is too short ...");
1.8 misho 466: return -1;
1.5 misho 467: }
468:
469: /* RPC is OK! Go de-marshaling variables ... */
1.14 misho 470: if (vars && ntohs(rpc->call_argc)) {
1.12 misho 471: #ifdef CLI_RES_ZCOPY
1.14 misho 472: *vars = ait_buffer2vars(buf + sizeof(struct tagRPCCall), len,
1.12 misho 473: ntohs(rpc->call_argc), 42);
474: #else
1.14 misho 475: *vars = ait_buffer2vars(buf + sizeof(struct tagRPCCall), len,
1.7 misho 476: ntohs(rpc->call_argc), 0);
1.12 misho 477: #endif
1.14 misho 478: if (!*vars) {
479: rpc_SetErr(elwix_GetErrno(), "%s", elwix_GetError());
1.1 misho 480: return -1;
1.5 misho 481: }
1.1 misho 482: }
483:
1.14 misho 484: return ntohl(rpc->call_rep.ret);
485: }
486:
487: /*
488: * rpc_cli_execCall() - Execute RPC call
489: *
490: * @cli = RPC Client session
491: * @noreply = We not want RPC reply
492: * @tag = Function tag for execution
493: * @in_vars = IN function argument array of values, may be NULL
494: * @out_vars = OUT returned array of rpc values, if !=NULL must be free after use with ait_freeVars()
495: * return: -1 error or != -1 ok result
496: */
497: int
498: rpc_cli_execCall(rpc_cli_t *cli, int noreply, u_short tag,
499: array_t * __restrict in_vars, array_t ** __restrict out_vars)
500: {
1.15 misho 501: int type = 0, wlen;
1.14 misho 502: u_char *buf;
503:
504: if (!cli) {
505: rpc_SetErr(EINVAL, "Can`t execute call because parameter is null or invalid!");
506: return -1;
1.15 misho 507: } else {
508: if (cli->cli_id == SOCK_STREAM)
509: type = cli->cli_id;
1.14 misho 510: buf = AIT_GET_BUF(&cli->cli_buf);
1.15 misho 511: }
1.14 misho 512: if (out_vars)
513: *out_vars = NULL;
514:
1.15 misho 515: if ((wlen = rpc_pkt_Request(&cli->cli_buf, cli->cli_parent, tag, in_vars, noreply, type)) == -1)
1.14 misho 516: return -1;
517:
518: if (rpc_pkt_Send(cli->cli_sock, cli->cli_id, &cli->cli_sa, &cli->cli_buf, wlen) == -1)
519: return -1;
520:
521: if (noreply) /* we not want reply */
522: return 0;
523:
524: if (rpc_pkt_Receive(cli->cli_sock, cli->cli_id, &cli->cli_sa, &cli->cli_buf) == -1)
525: return -1;
526:
1.15 misho 527: if ((wlen = rpc_pkt_Replay(&cli->cli_buf, cli->cli_parent, tag, out_vars, type)) == -1)
1.14 misho 528: return -1;
529:
1.15 misho 530: return 0;
1.10 misho 531: }
532:
533: /*
1.12 misho 534: * rpc_cli_freeCall() - Free resouce allocated by RPC call
535: *
536: * @out_vars = Returned array with variables from RPC call
537: * return: none
538: */
1.16 misho 539: void
1.12 misho 540: rpc_cli_freeCall(array_t ** __restrict out_vars)
541: {
542: #ifdef CLI_RES_ZCOPY
1.14 misho 543: array_Destroy(out_vars);
1.12 misho 544: #else
1.14 misho 545: ait_freeVars(out_vars);
1.12 misho 546: #endif
547: }
548:
549: /*
1.10 misho 550: * rpc_cli_ping() - Ping RPC server
551: *
552: * @cli = connected client
553: * return: -1 error or !=-1 ping seq id
554: */
1.16 misho 555: int
1.10 misho 556: rpc_cli_ping(rpc_cli_t *cli)
557: {
558: int ret = 0;
559: array_t *arr = NULL;
560:
561: if (!cli)
562: return -1;
563:
564: if (rpc_cli_execCall(cli, RPC_REPLY, CALL_SRVPING, NULL, &arr))
565: return -1;
566: else
1.14 misho 567: ret = AIT_GET_U16(array(arr, 0, ait_val_t*));
1.12 misho 568: rpc_cli_freeCall(&arr);
1.10 misho 569:
1.5 misho 570: return ret;
1.1 misho 571: }
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to cli.c CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / libaitrpc / src