Annotation of libaitrpc/src/cli.c, revision 1.17.2.4
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.4! misho 6: * $Id: cli.c,v 1.17.2.3 2013/08/23 13:38:05 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: if (type == SOCK_STREAM)
304: ret = rpc_Read(sock, type, !estlen ? MSG_PEEK : 0, NULL, buf, blen);
305: else
306: ret = rpc_Read(sock, type, 0, sa, buf, AIT_LEN(pkt));
1.13 misho 307: if (ret < 1) {
1.17.2.1 misho 308: LOGERR;
1.10 misho 309: return -1;
310: }
1.13 misho 311:
1.14 misho 312: /* check for response from known address */
1.17.2.1 misho 313: if (type == SOCK_STREAM && !estlen) {
1.17 misho 314: /* 1st read for RPC header */
1.17.2.1 misho 315: if (ret < sizeof(struct tagRPCCall)) {
316: rpc_SetErr(ERPCMISMATCH, "Short RPC packet %d bytes", ret);
317: return -1;
318: }
319:
320: /* calc estimated length */
321: rpc = (struct tagRPCCall*) buf;
322: estlen = ntohl(rpc->call_len);
323: if (estlen > AIT_LEN(pkt))
324: AIT_RE_BUF(pkt, estlen);
325: buf = AIT_GET_BUF(pkt);
326: blen = estlen;
1.17.2.3 misho 327: rpc = (struct tagRPCCall*) buf;
1.17.2.1 misho 328: continue;
1.17 misho 329: }
1.17.2.1 misho 330:
1.17.2.4! misho 331: /* compiler optimize loop if while(0) and stop working 'continue' on some platforms */
1.17.2.1 misho 332: break;
333: } while (42);
1.17 misho 334:
1.7 misho 335: if (ret < sizeof(struct tagRPCCall)) {
1.10 misho 336: rpc_SetErr(ERPCMISMATCH, "Short RPC packet %d bytes", ret);
1.8 misho 337: return -1;
1.7 misho 338: }
1.8 misho 339:
1.14 misho 340: return ret;
341: }
342:
343: /*
344: * rpc_pkt_Request() - Build RPC Request packet
345: *
346: * @pkt = Packet buffer
347: * @sess = RPC session info
348: * @tag = Function tag for execution
349: * @vars = Function argument array of values, may be NULL
350: * @noreply = We not want RPC reply
1.15 misho 351: * @nocrc = Without CRC calculation
1.14 misho 352: * return: -1 error or != -1 prepared bytes into packet
353: */
354: int
355: rpc_pkt_Request(ait_val_t * __restrict pkt, rpc_sess_t * __restrict sess, u_short tag,
1.15 misho 356: array_t * __restrict vars, int noreply, int nocrc)
1.14 misho 357: {
358: struct tagRPCCall *rpc;
1.17 misho 359: int ret = 0, estlen, len = sizeof(struct tagRPCCall);
1.14 misho 360: u_char *buf;
361:
362: if (!pkt || !sess) {
363: rpc_SetErr(EINVAL, "Invalid argument(s)!");
364: return -1;
1.17 misho 365: }
366:
367: /* calc estimated length */
368: estlen = ait_resideVars(vars) + len;
369: if (estlen > AIT_LEN(pkt))
370: AIT_RE_BUF(pkt, estlen);
371: buf = AIT_GET_BUF(pkt);
1.14 misho 372:
373: /* prepare RPC call */
374: rpc = (struct tagRPCCall*) buf;
375: rpc_addPktSession(&rpc->call_session, sess);
376: rpc->call_tag = htons(tag);
377: if (!vars)
378: rpc->call_argc = 0;
379: else
380: rpc->call_argc = htons(array_Size(vars));
381:
382: /* set reply */
383: rpc->call_req.flags = noreply ? RPC_NOREPLY : RPC_REPLY;
384:
385: if (array_Size(vars)) {
386: /* marshaling variables */
387: ret = ait_vars2buffer(buf + len, AIT_LEN(pkt) - len, vars);
388: if (ret == -1) {
389: rpc_SetErr(EBADRPC, "Failed to prepare RPC packet values");
390: return -1;
391: } else
392: len += ret;
393: }
394:
395: /* total packet length */
1.17 misho 396: rpc->call_len = htonl(len);
1.14 misho 397:
1.15 misho 398: if (!nocrc) {
399: /* calculate CRC */
400: rpc->call_crc ^= rpc->call_crc;
401: rpc->call_crc = htons(crcFletcher16((u_short*) buf, len / 2));
402: }
1.14 misho 403:
404: return len;
405: }
406:
407: /*
408: * rpc_pkt_Replay() - Decode RPC Replay packet
409: *
410: * @pkt = Packet buffer
411: * @sess = RPC session info
412: * @tag = Function tag
413: * @vars = Function argument array of values, may be NULL
1.15 misho 414: * @nocrc = Without CRC calculation
1.14 misho 415: * return: -1 error or != -1 return value from function
416: */
417: int
418: rpc_pkt_Replay(ait_val_t * __restrict pkt, rpc_sess_t * __restrict sess, u_short tag,
1.15 misho 419: array_t ** __restrict vars, int nocrc)
1.14 misho 420: {
421: struct tagRPCCall *rpc;
422: int len;
423: u_char *buf;
424: uint16_t crc;
425:
426: if (!pkt || !sess) {
427: rpc_SetErr(EINVAL, "Invalid argument(s)!");
428: return -1;
429: } else
430: buf = AIT_GET_BUF(pkt);
431:
432: rpc = (struct tagRPCCall*) buf;
1.15 misho 433: if (!nocrc) {
434: /* calculate CRC */
435: crc = ntohs(rpc->call_crc);
436: rpc->call_crc ^= rpc->call_crc;
1.17 misho 437: if (crc != crcFletcher16((u_short*) buf, ntohl(rpc->call_len) / 2)) {
1.15 misho 438: rpc_SetErr(ERPCMISMATCH, "Bad CRC RPC packet");
439: return -1;
440: }
1.8 misho 441: }
442:
1.3 misho 443: /* check RPC packet session info */
1.14 misho 444: if (rpc_chkPktSession(&rpc->call_session, sess)) {
1.10 misho 445: rpc_SetErr(ERPCMISMATCH, "Get invalid RPC session");
1.8 misho 446: return -1;
1.14 misho 447: }
1.10 misho 448: if (ntohs(rpc->call_tag) != tag) {
449: rpc_SetErr(ERPCMISMATCH, "Get wrong RPC reply");
1.8 misho 450: return -1;
1.6 misho 451: }
1.10 misho 452: if (ntohl(rpc->call_rep.eno) && ntohl(rpc->call_rep.ret) == -1) {
1.8 misho 453: rpc_SetErr(ntohl(rpc->call_rep.eno), "Server side: retcode=%d #%d %s",
1.7 misho 454: ntohl(rpc->call_rep.ret), ntohl(rpc->call_rep.eno),
455: strerror(ntohl(rpc->call_rep.eno)));
1.8 misho 456: return -1;
1.1 misho 457: }
1.14 misho 458: len = ntohs(rpc->call_argc) * sizeof(ait_val_t);
459: if (len > AIT_LEN(pkt) - sizeof(struct tagRPCCall)) {
460: rpc_SetErr(EMSGSIZE, "Reply RPC packet not enough buffer space ...");
461: return -1;
462: }
1.17 misho 463: if (len > ntohl(rpc->call_len) - sizeof(struct tagRPCCall)) {
1.14 misho 464: rpc_SetErr(EMSGSIZE, "Reply RPC packet is too short ...");
1.8 misho 465: return -1;
1.5 misho 466: }
467:
468: /* RPC is OK! Go de-marshaling variables ... */
1.14 misho 469: if (vars && ntohs(rpc->call_argc)) {
1.12 misho 470: #ifdef CLI_RES_ZCOPY
1.14 misho 471: *vars = ait_buffer2vars(buf + sizeof(struct tagRPCCall), len,
1.12 misho 472: ntohs(rpc->call_argc), 42);
473: #else
1.14 misho 474: *vars = ait_buffer2vars(buf + sizeof(struct tagRPCCall), len,
1.7 misho 475: ntohs(rpc->call_argc), 0);
1.12 misho 476: #endif
1.14 misho 477: if (!*vars) {
478: rpc_SetErr(elwix_GetErrno(), "%s", elwix_GetError());
1.1 misho 479: return -1;
1.5 misho 480: }
1.1 misho 481: }
482:
1.14 misho 483: return ntohl(rpc->call_rep.ret);
484: }
485:
486: /*
487: * rpc_cli_execCall() - Execute RPC call
488: *
489: * @cli = RPC Client session
490: * @noreply = We not want RPC reply
491: * @tag = Function tag for execution
492: * @in_vars = IN function argument array of values, may be NULL
493: * @out_vars = OUT returned array of rpc values, if !=NULL must be free after use with ait_freeVars()
494: * return: -1 error or != -1 ok result
495: */
496: int
497: rpc_cli_execCall(rpc_cli_t *cli, int noreply, u_short tag,
498: array_t * __restrict in_vars, array_t ** __restrict out_vars)
499: {
1.15 misho 500: int type = 0, wlen;
1.14 misho 501: u_char *buf;
502:
503: if (!cli) {
504: rpc_SetErr(EINVAL, "Can`t execute call because parameter is null or invalid!");
505: return -1;
1.15 misho 506: } else {
507: if (cli->cli_id == SOCK_STREAM)
508: type = cli->cli_id;
1.14 misho 509: buf = AIT_GET_BUF(&cli->cli_buf);
1.15 misho 510: }
1.14 misho 511: if (out_vars)
512: *out_vars = NULL;
513:
1.15 misho 514: if ((wlen = rpc_pkt_Request(&cli->cli_buf, cli->cli_parent, tag, in_vars, noreply, type)) == -1)
1.14 misho 515: return -1;
516:
517: if (rpc_pkt_Send(cli->cli_sock, cli->cli_id, &cli->cli_sa, &cli->cli_buf, wlen) == -1)
518: return -1;
519:
520: if (noreply) /* we not want reply */
521: return 0;
522:
523: if (rpc_pkt_Receive(cli->cli_sock, cli->cli_id, &cli->cli_sa, &cli->cli_buf) == -1)
524: return -1;
525:
1.15 misho 526: if ((wlen = rpc_pkt_Replay(&cli->cli_buf, cli->cli_parent, tag, out_vars, type)) == -1)
1.14 misho 527: return -1;
528:
1.15 misho 529: return 0;
1.10 misho 530: }
531:
532: /*
1.12 misho 533: * rpc_cli_freeCall() - Free resouce allocated by RPC call
534: *
535: * @out_vars = Returned array with variables from RPC call
536: * return: none
537: */
1.16 misho 538: void
1.12 misho 539: rpc_cli_freeCall(array_t ** __restrict out_vars)
540: {
541: #ifdef CLI_RES_ZCOPY
1.14 misho 542: array_Destroy(out_vars);
1.12 misho 543: #else
1.14 misho 544: ait_freeVars(out_vars);
1.12 misho 545: #endif
546: }
547:
548: /*
1.10 misho 549: * rpc_cli_ping() - Ping RPC server
550: *
551: * @cli = connected client
552: * return: -1 error or !=-1 ping seq id
553: */
1.16 misho 554: int
1.10 misho 555: rpc_cli_ping(rpc_cli_t *cli)
556: {
557: int ret = 0;
558: array_t *arr = NULL;
559:
560: if (!cli)
561: return -1;
562:
563: if (rpc_cli_execCall(cli, RPC_REPLY, CALL_SRVPING, NULL, &arr))
564: return -1;
565: else
1.14 misho 566: ret = AIT_GET_U16(array(arr, 0, ait_val_t*));
1.12 misho 567: rpc_cli_freeCall(&arr);
1.10 misho 568:
1.5 misho 569: return ret;
1.1 misho 570: }
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>