s3:libsmb: don't let cli_shutdown() segfault with a NULL cli_state
[Samba.git] / source3 / libsmb / clientgen.c
blob5dc43e93ad6927808928d47321ac848faa0c98ae
1 /*
2 Unix SMB/CIFS implementation.
3 SMB client generic functions
4 Copyright (C) Andrew Tridgell 1994-1998
5 Copyright (C) Jeremy Allison 2007.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "includes.h"
23 /*******************************************************************
24 Setup the word count and byte count for a client smb message.
25 ********************************************************************/
27 int cli_set_message(char *buf,int num_words,int num_bytes,bool zero)
29 if (zero && (num_words || num_bytes)) {
30 memset(buf + smb_size,'\0',num_words*2 + num_bytes);
32 SCVAL(buf,smb_wct,num_words);
33 SSVAL(buf,smb_vwv + num_words*SIZEOFWORD,num_bytes);
34 smb_setlen(buf,smb_size + num_words*2 + num_bytes - 4);
35 return (smb_size + num_words*2 + num_bytes);
38 /****************************************************************************
39 Change the timeout (in milliseconds).
40 ****************************************************************************/
42 unsigned int cli_set_timeout(struct cli_state *cli, unsigned int timeout)
44 unsigned int old_timeout = cli->timeout;
45 cli->timeout = timeout;
46 return old_timeout;
49 /****************************************************************************
50 Change the port number used to call on.
51 ****************************************************************************/
53 void cli_set_port(struct cli_state *cli, int port)
55 cli->port = port;
58 /****************************************************************************
59 convenience routine to find if we negotiated ucs2
60 ****************************************************************************/
62 bool cli_ucs2(struct cli_state *cli)
64 return ((cli->capabilities & CAP_UNICODE) != 0);
68 /****************************************************************************
69 Read an smb from a fd ignoring all keepalive packets.
70 The timeout is in milliseconds
72 This is exactly the same as receive_smb except that it never returns
73 a session keepalive packet (just as receive_smb used to do).
74 receive_smb was changed to return keepalives as the oplock processing means this call
75 should never go into a blocking read.
76 ****************************************************************************/
78 static ssize_t client_receive_smb(struct cli_state *cli, size_t maxlen)
80 size_t len;
82 for(;;) {
83 NTSTATUS status;
85 set_smb_read_error(&cli->smb_rw_error, SMB_READ_OK);
87 status = receive_smb_raw(cli->fd, cli->inbuf, cli->bufsize,
88 cli->timeout, maxlen, &len);
89 if (!NT_STATUS_IS_OK(status)) {
90 DEBUG(10,("client_receive_smb failed\n"));
91 show_msg(cli->inbuf);
93 if (NT_STATUS_EQUAL(status, NT_STATUS_END_OF_FILE)) {
94 set_smb_read_error(&cli->smb_rw_error,
95 SMB_READ_EOF);
96 return -1;
99 if (NT_STATUS_EQUAL(status, NT_STATUS_IO_TIMEOUT)) {
100 set_smb_read_error(&cli->smb_rw_error,
101 SMB_READ_TIMEOUT);
102 return -1;
105 set_smb_read_error(&cli->smb_rw_error, SMB_READ_ERROR);
106 return -1;
110 * I don't believe len can be < 0 with NT_STATUS_OK
111 * returned above, but this check doesn't hurt. JRA.
114 if ((ssize_t)len < 0) {
115 return len;
118 /* Ignore session keepalive packets. */
119 if(CVAL(cli->inbuf,0) != SMBkeepalive) {
120 break;
124 if (cli_encryption_on(cli)) {
125 NTSTATUS status = cli_decrypt_message(cli);
126 if (!NT_STATUS_IS_OK(status)) {
127 DEBUG(0, ("SMB decryption failed on incoming packet! Error %s\n",
128 nt_errstr(status)));
129 cli->smb_rw_error = SMB_READ_BAD_DECRYPT;
130 return -1;
134 show_msg(cli->inbuf);
135 return len;
138 /****************************************************************************
139 Recv an smb.
140 ****************************************************************************/
142 bool cli_receive_smb(struct cli_state *cli)
144 ssize_t len;
146 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
147 if (cli->fd == -1)
148 return false;
150 again:
151 len = client_receive_smb(cli, 0);
153 if (len > 0) {
154 /* it might be an oplock break request */
155 if (!(CVAL(cli->inbuf, smb_flg) & FLAG_REPLY) &&
156 CVAL(cli->inbuf,smb_com) == SMBlockingX &&
157 SVAL(cli->inbuf,smb_vwv6) == 0 &&
158 SVAL(cli->inbuf,smb_vwv7) == 0) {
159 if (cli->oplock_handler) {
160 int fnum = SVAL(cli->inbuf,smb_vwv2);
161 unsigned char level = CVAL(cli->inbuf,smb_vwv3+1);
162 if (!cli->oplock_handler(cli, fnum, level)) {
163 return false;
166 /* try to prevent loops */
167 SCVAL(cli->inbuf,smb_com,0xFF);
168 goto again;
172 /* If the server is not responding, note that now */
173 if (len < 0) {
174 DEBUG(0, ("Receiving SMB: Server stopped responding\n"));
175 close(cli->fd);
176 cli->fd = -1;
177 return false;
180 if (!cli_check_sign_mac(cli, cli->inbuf)) {
182 * If we get a signature failure in sessionsetup, then
183 * the server sometimes just reflects the sent signature
184 * back to us. Detect this and allow the upper layer to
185 * retrieve the correct Windows error message.
187 if (CVAL(cli->outbuf,smb_com) == SMBsesssetupX &&
188 (smb_len(cli->inbuf) > (smb_ss_field + 8 - 4)) &&
189 (SVAL(cli->inbuf,smb_flg2) & FLAGS2_SMB_SECURITY_SIGNATURES) &&
190 memcmp(&cli->outbuf[smb_ss_field],&cli->inbuf[smb_ss_field],8) == 0 &&
191 cli_is_error(cli)) {
194 * Reflected signature on login error.
195 * Set bad sig but don't close fd.
197 cli->smb_rw_error = SMB_READ_BAD_SIG;
198 return true;
201 DEBUG(0, ("SMB Signature verification failed on incoming packet!\n"));
202 cli->smb_rw_error = SMB_READ_BAD_SIG;
203 close(cli->fd);
204 cli->fd = -1;
205 return false;
207 return true;
210 /****************************************************************************
211 Read the data portion of a readX smb.
212 The timeout is in milliseconds
213 ****************************************************************************/
215 ssize_t cli_receive_smb_data(struct cli_state *cli, char *buffer, size_t len)
217 NTSTATUS status;
219 set_smb_read_error(&cli->smb_rw_error, SMB_READ_OK);
221 status = read_fd_with_timeout(
222 cli->fd, buffer, len, len, cli->timeout, NULL);
223 if (NT_STATUS_IS_OK(status)) {
224 return len;
227 if (NT_STATUS_EQUAL(status, NT_STATUS_END_OF_FILE)) {
228 set_smb_read_error(&cli->smb_rw_error, SMB_READ_EOF);
229 return -1;
232 if (NT_STATUS_EQUAL(status, NT_STATUS_IO_TIMEOUT)) {
233 set_smb_read_error(&cli->smb_rw_error, SMB_READ_TIMEOUT);
234 return -1;
237 set_smb_read_error(&cli->smb_rw_error, SMB_READ_ERROR);
238 return -1;
241 static ssize_t write_socket(int fd, const char *buf, size_t len)
243 ssize_t ret=0;
245 DEBUG(6,("write_socket(%d,%d)\n",fd,(int)len));
246 ret = write_data(fd,buf,len);
248 DEBUG(6,("write_socket(%d,%d) wrote %d\n",fd,(int)len,(int)ret));
249 if(ret <= 0)
250 DEBUG(0,("write_socket: Error writing %d bytes to socket %d: ERRNO = %s\n",
251 (int)len, fd, strerror(errno) ));
253 return(ret);
256 /****************************************************************************
257 Send an smb to a fd.
258 ****************************************************************************/
260 bool cli_send_smb(struct cli_state *cli)
262 size_t len;
263 size_t nwritten=0;
264 ssize_t ret;
265 char *buf_out = cli->outbuf;
266 bool enc_on = cli_encryption_on(cli);
268 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
269 if (cli->fd == -1)
270 return false;
272 cli_calculate_sign_mac(cli, cli->outbuf);
274 if (enc_on) {
275 NTSTATUS status = cli_encrypt_message(cli, cli->outbuf,
276 &buf_out);
277 if (!NT_STATUS_IS_OK(status)) {
278 close(cli->fd);
279 cli->fd = -1;
280 cli->smb_rw_error = SMB_WRITE_ERROR;
281 DEBUG(0,("Error in encrypting client message. Error %s\n",
282 nt_errstr(status) ));
283 return false;
287 len = smb_len(buf_out) + 4;
289 while (nwritten < len) {
290 ret = write_socket(cli->fd,buf_out+nwritten,len - nwritten);
291 if (ret <= 0) {
292 if (enc_on) {
293 cli_free_enc_buffer(cli, buf_out);
295 close(cli->fd);
296 cli->fd = -1;
297 cli->smb_rw_error = SMB_WRITE_ERROR;
298 DEBUG(0,("Error writing %d bytes to client. %d (%s)\n",
299 (int)len,(int)ret, strerror(errno) ));
300 return false;
302 nwritten += ret;
305 if (enc_on) {
306 cli_free_enc_buffer(cli, buf_out);
309 /* Increment the mid so we can tell between responses. */
310 cli->mid++;
311 if (!cli->mid)
312 cli->mid++;
313 return true;
316 /****************************************************************************
317 Send a "direct" writeX smb to a fd.
318 ****************************************************************************/
320 bool cli_send_smb_direct_writeX(struct cli_state *cli,
321 const char *p,
322 size_t extradata)
324 /* First length to send is the offset to the data. */
325 size_t len = SVAL(cli->outbuf,smb_vwv11) + 4;
326 size_t nwritten=0;
327 struct iovec iov[2];
329 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
330 if (cli->fd == -1) {
331 return false;
334 if (client_is_signing_on(cli)) {
335 DEBUG(0,("cli_send_smb_large: cannot send signed packet.\n"));
336 return false;
339 iov[0].iov_base = cli->outbuf;
340 iov[0].iov_len = len;
341 iov[1].iov_base = CONST_DISCARD(char *, p);
342 iov[1].iov_len = extradata;
344 nwritten = write_data_iov(cli->fd, iov, 2);
345 if (nwritten < (len + extradata)) {
346 close(cli->fd);
347 cli->fd = -1;
348 cli->smb_rw_error = SMB_WRITE_ERROR;
349 DEBUG(0,("Error writing %d bytes to client. (%s)\n",
350 (int)(len+extradata), strerror(errno)));
351 return false;
354 /* Increment the mid so we can tell between responses. */
355 cli->mid++;
356 if (!cli->mid)
357 cli->mid++;
358 return true;
361 /****************************************************************************
362 Setup basics in a outgoing packet.
363 ****************************************************************************/
365 void cli_setup_packet_buf(struct cli_state *cli, char *buf)
367 uint16 flags2;
368 cli->rap_error = 0;
369 SIVAL(buf,smb_rcls,0);
370 SSVAL(buf,smb_pid,cli->pid);
371 memset(buf+smb_pidhigh, 0, 12);
372 SSVAL(buf,smb_uid,cli->vuid);
373 SSVAL(buf,smb_mid,cli->mid);
375 if (cli->protocol <= PROTOCOL_CORE) {
376 return;
379 if (cli->case_sensitive) {
380 SCVAL(buf,smb_flg,0x0);
381 } else {
382 /* Default setting, case insensitive. */
383 SCVAL(buf,smb_flg,0x8);
385 flags2 = FLAGS2_LONG_PATH_COMPONENTS;
386 if (cli->capabilities & CAP_UNICODE)
387 flags2 |= FLAGS2_UNICODE_STRINGS;
388 if ((cli->capabilities & CAP_DFS) && cli->dfsroot)
389 flags2 |= FLAGS2_DFS_PATHNAMES;
390 if (cli->capabilities & CAP_STATUS32)
391 flags2 |= FLAGS2_32_BIT_ERROR_CODES;
392 if (cli->use_spnego)
393 flags2 |= FLAGS2_EXTENDED_SECURITY;
394 SSVAL(buf,smb_flg2, flags2);
397 void cli_setup_packet(struct cli_state *cli)
399 cli_setup_packet_buf(cli, cli->outbuf);
402 /****************************************************************************
403 Setup the bcc length of the packet from a pointer to the end of the data.
404 ****************************************************************************/
406 void cli_setup_bcc(struct cli_state *cli, void *p)
408 set_message_bcc(cli->outbuf, PTR_DIFF(p, smb_buf(cli->outbuf)));
411 /****************************************************************************
412 Initialize Domain, user or password.
413 ****************************************************************************/
415 NTSTATUS cli_set_domain(struct cli_state *cli, const char *domain)
417 TALLOC_FREE(cli->domain);
418 cli->domain = talloc_strdup(cli, domain ? domain : "");
419 if (cli->domain == NULL) {
420 return NT_STATUS_NO_MEMORY;
422 return NT_STATUS_OK;
425 NTSTATUS cli_set_username(struct cli_state *cli, const char *username)
427 TALLOC_FREE(cli->user_name);
428 cli->user_name = talloc_strdup(cli, username ? username : "");
429 if (cli->user_name == NULL) {
430 return NT_STATUS_NO_MEMORY;
432 return NT_STATUS_OK;
435 NTSTATUS cli_set_password(struct cli_state *cli, const char *password)
437 TALLOC_FREE(cli->password);
439 /* Password can be NULL. */
440 if (password) {
441 cli->password = talloc_strdup(cli, password);
442 if (cli->password == NULL) {
443 return NT_STATUS_NO_MEMORY;
445 } else {
446 /* Use zero NTLMSSP hashes and session key. */
447 cli->password = NULL;
450 return NT_STATUS_OK;
453 /****************************************************************************
454 Initialise credentials of a client structure.
455 ****************************************************************************/
457 NTSTATUS cli_init_creds(struct cli_state *cli, const char *username, const char *domain, const char *password)
459 NTSTATUS status = cli_set_username(cli, username);
460 if (!NT_STATUS_IS_OK(status)) {
461 return status;
463 status = cli_set_domain(cli, domain);
464 if (!NT_STATUS_IS_OK(status)) {
465 return status;
467 DEBUG(10,("cli_init_creds: user %s domain %s\n", cli->user_name, cli->domain));
469 return cli_set_password(cli, password);
472 /****************************************************************************
473 Initialise a client structure. Always returns a talloc'ed struct.
474 Set the signing state (used from the command line).
475 ****************************************************************************/
477 struct cli_state *cli_initialise_ex(int signing_state)
479 struct cli_state *cli = NULL;
480 bool allow_smb_signing = false;
481 bool mandatory_signing = false;
483 /* Check the effective uid - make sure we are not setuid */
484 if (is_setuid_root()) {
485 DEBUG(0,("libsmb based programs must *NOT* be setuid root.\n"));
486 return NULL;
489 cli = TALLOC_ZERO_P(NULL, struct cli_state);
490 if (!cli) {
491 return NULL;
494 cli->dfs_mountpoint = talloc_strdup(cli, "");
495 if (!cli->dfs_mountpoint) {
496 goto error;
498 cli->port = 0;
499 cli->fd = -1;
500 cli->cnum = -1;
501 cli->pid = (uint16)sys_getpid();
502 cli->mid = 1;
503 cli->vuid = UID_FIELD_INVALID;
504 cli->protocol = PROTOCOL_NT1;
505 cli->timeout = 20000; /* Timeout is in milliseconds. */
506 cli->bufsize = CLI_BUFFER_SIZE+4;
507 cli->max_xmit = cli->bufsize;
508 cli->outbuf = (char *)SMB_MALLOC(cli->bufsize+SAFETY_MARGIN);
509 cli->inbuf = (char *)SMB_MALLOC(cli->bufsize+SAFETY_MARGIN);
510 cli->oplock_handler = cli_oplock_ack;
511 cli->case_sensitive = false;
512 cli->smb_rw_error = SMB_READ_OK;
514 cli->use_spnego = lp_client_use_spnego();
516 cli->capabilities = CAP_UNICODE | CAP_STATUS32 | CAP_DFS;
518 /* Set the CLI_FORCE_DOSERR environment variable to test
519 client routines using DOS errors instead of STATUS32
520 ones. This intended only as a temporary hack. */
521 if (getenv("CLI_FORCE_DOSERR"))
522 cli->force_dos_errors = true;
524 if (lp_client_signing()) {
525 allow_smb_signing = true;
528 if (lp_client_signing() == Required) {
529 mandatory_signing = true;
532 if (signing_state != Undefined) {
533 allow_smb_signing = true;
536 if (signing_state == false) {
537 allow_smb_signing = false;
538 mandatory_signing = false;
541 if (signing_state == Required) {
542 mandatory_signing = true;
545 if (!cli->outbuf || !cli->inbuf)
546 goto error;
548 memset(cli->outbuf, 0, cli->bufsize);
549 memset(cli->inbuf, 0, cli->bufsize);
552 #if defined(DEVELOPER)
553 /* just because we over-allocate, doesn't mean it's right to use it */
554 clobber_region(FUNCTION_MACRO, __LINE__, cli->outbuf+cli->bufsize, SAFETY_MARGIN);
555 clobber_region(FUNCTION_MACRO, __LINE__, cli->inbuf+cli->bufsize, SAFETY_MARGIN);
556 #endif
558 /* initialise signing */
559 cli->sign_info.allow_smb_signing = allow_smb_signing;
560 cli->sign_info.mandatory_signing = mandatory_signing;
561 cli_null_set_signing(cli);
563 cli->initialised = 1;
565 return cli;
567 /* Clean up after malloc() error */
569 error:
571 SAFE_FREE(cli->inbuf);
572 SAFE_FREE(cli->outbuf);
573 TALLOC_FREE(cli);
574 return NULL;
577 struct cli_state *cli_initialise(void)
579 return cli_initialise_ex(Undefined);
582 /****************************************************************************
583 Close all pipes open on this session.
584 ****************************************************************************/
586 void cli_nt_pipes_close(struct cli_state *cli)
588 while (cli->pipe_list != NULL) {
590 * No TALLOC_FREE here!
592 talloc_free(cli->pipe_list);
596 /****************************************************************************
597 Shutdown a client structure.
598 ****************************************************************************/
600 void cli_shutdown(struct cli_state *cli)
602 if (cli == NULL) {
603 return;
606 if (cli->prev == NULL) {
608 * Possible head of a DFS list,
609 * shutdown all subsidiary DFS
610 * connections.
612 struct cli_state *p, *next;
614 for (p = cli->next; p; p = next) {
615 next = p->next;
616 cli_shutdown(p);
618 } else {
620 * We're a subsidiary connection.
621 * Just remove ourselves from the
622 * DFS list.
624 DLIST_REMOVE(cli->prev, cli);
627 cli_nt_pipes_close(cli);
630 * tell our peer to free his resources. Wihtout this, when an
631 * application attempts to do a graceful shutdown and calls
632 * smbc_free_context() to clean up all connections, some connections
633 * can remain active on the peer end, until some (long) timeout period
634 * later. This tree disconnect forces the peer to clean up, since the
635 * connection will be going away.
637 * Also, do not do tree disconnect when cli->smb_rw_error is SMB_DO_NOT_DO_TDIS
638 * the only user for this so far is smbmount which passes opened connection
639 * down to kernel's smbfs module.
641 if ( (cli->cnum != (uint16)-1) && (cli->smb_rw_error != SMB_DO_NOT_DO_TDIS ) ) {
642 cli_tdis(cli);
645 SAFE_FREE(cli->outbuf);
646 SAFE_FREE(cli->inbuf);
648 cli_free_signing_context(cli);
649 data_blob_free(&cli->secblob);
650 data_blob_free(&cli->user_session_key);
652 if (cli->fd != -1) {
653 close(cli->fd);
655 cli->fd = -1;
656 cli->smb_rw_error = SMB_READ_OK;
658 TALLOC_FREE(cli);
661 /****************************************************************************
662 Set socket options on a open connection.
663 ****************************************************************************/
665 void cli_sockopt(struct cli_state *cli, const char *options)
667 set_socket_options(cli->fd, options);
670 /****************************************************************************
671 Set the PID to use for smb messages. Return the old pid.
672 ****************************************************************************/
674 uint16 cli_setpid(struct cli_state *cli, uint16 pid)
676 uint16 ret = cli->pid;
677 cli->pid = pid;
678 return ret;
681 /****************************************************************************
682 Set the case sensitivity flag on the packets. Returns old state.
683 ****************************************************************************/
685 bool cli_set_case_sensitive(struct cli_state *cli, bool case_sensitive)
687 bool ret = cli->case_sensitive;
688 cli->case_sensitive = case_sensitive;
689 return ret;
692 /****************************************************************************
693 Send a keepalive packet to the server
694 ****************************************************************************/
696 bool cli_send_keepalive(struct cli_state *cli)
698 if (cli->fd == -1) {
699 DEBUG(3, ("cli_send_keepalive: fd == -1\n"));
700 return false;
702 if (!send_keepalive(cli->fd)) {
703 close(cli->fd);
704 cli->fd = -1;
705 DEBUG(0,("Error sending keepalive packet to client.\n"));
706 return false;
708 return true;
712 * @brief: Collect a echo reply
713 * @param[in] req The corresponding async request
715 * There might be more than one echo reply. This helper pulls the reply out of
716 * the data stream. If all expected replies have arrived, declare the
717 * async_req done.
720 static void cli_echo_recv_helper(struct async_req *req)
722 struct cli_request *cli_req;
723 uint8_t wct;
724 uint16_t *vwv;
725 uint16_t num_bytes;
726 uint8_t *bytes;
727 NTSTATUS status;
729 status = cli_pull_reply(req, &wct, &vwv, &num_bytes, &bytes);
730 if (!NT_STATUS_IS_OK(status)) {
731 async_req_nterror(req, status);
732 return;
735 cli_req = talloc_get_type_abort(req->private_data, struct cli_request);
737 if ((num_bytes != cli_req->data.echo.data.length)
738 || (memcmp(cli_req->data.echo.data.data, bytes,
739 num_bytes) != 0)) {
740 async_req_nterror(req, NT_STATUS_INVALID_NETWORK_RESPONSE);
741 return;
744 cli_req->data.echo.num_echos -= 1;
746 if (cli_req->data.echo.num_echos == 0) {
747 client_set_trans_sign_state_off(cli_req->cli, cli_req->mid);
748 async_req_done(req);
749 return;
752 return;
756 * @brief Send SMBEcho requests
757 * @param[in] mem_ctx The memory context to put the async_req on
758 * @param[in] ev The event context that will call us back
759 * @param[in] cli The connection to send the echo to
760 * @param[in] num_echos How many times do we want to get the reply?
761 * @param[in] data The data we want to get back
762 * @retval The async request
765 struct async_req *cli_echo_send(TALLOC_CTX *mem_ctx, struct event_context *ev,
766 struct cli_state *cli, uint16_t num_echos,
767 DATA_BLOB data)
769 uint16_t vwv[1];
770 uint8_t *data_copy;
771 struct async_req *result;
772 struct cli_request *req;
774 SSVAL(vwv, 0, num_echos);
776 data_copy = (uint8_t *)talloc_memdup(mem_ctx, data.data, data.length);
777 if (data_copy == NULL) {
778 return NULL;
781 result = cli_request_send(mem_ctx, ev, cli, SMBecho, 0, 1, vwv, 0,
782 data.length, data.data);
783 if (result == NULL) {
784 TALLOC_FREE(data_copy);
785 return NULL;
787 req = talloc_get_type_abort(result->private_data, struct cli_request);
789 client_set_trans_sign_state_on(cli, req->mid);
791 req->data.echo.num_echos = num_echos;
792 req->data.echo.data.data = talloc_move(req, &data_copy);
793 req->data.echo.data.length = data.length;
795 req->recv_helper.fn = cli_echo_recv_helper;
797 return result;
801 * Get the result out from an echo request
802 * @param[in] req The async_req from cli_echo_send
803 * @retval Did the server reply correctly?
806 NTSTATUS cli_echo_recv(struct async_req *req)
808 return async_req_simple_recv_ntstatus(req);
812 * @brief Send/Receive SMBEcho requests
813 * @param[in] mem_ctx The memory context to put the async_req on
814 * @param[in] ev The event context that will call us back
815 * @param[in] cli The connection to send the echo to
816 * @param[in] num_echos How many times do we want to get the reply?
817 * @param[in] data The data we want to get back
818 * @retval Did the server reply correctly?
821 NTSTATUS cli_echo(struct cli_state *cli, uint16_t num_echos, DATA_BLOB data)
823 TALLOC_CTX *frame = talloc_stackframe();
824 struct event_context *ev;
825 struct async_req *req;
826 NTSTATUS status = NT_STATUS_NO_MEMORY;
828 if (cli->fd_event != NULL) {
830 * Can't use sync call while an async call is in flight
832 cli_set_error(cli, NT_STATUS_INVALID_PARAMETER);
833 goto fail;
836 ev = event_context_init(frame);
837 if (ev == NULL) {
838 goto fail;
841 req = cli_echo_send(frame, ev, cli, num_echos, data);
842 if (req == NULL) {
843 goto fail;
846 while (req->state < ASYNC_REQ_DONE) {
847 event_loop_once(ev);
850 status = cli_echo_recv(req);
852 fail:
853 TALLOC_FREE(frame);
854 return status;
858 * Is the SMB command able to hold an AND_X successor
859 * @param[in] cmd The SMB command in question
860 * @retval Can we add a chained request after "cmd"?
862 bool is_andx_req(uint8_t cmd)
864 switch (cmd) {
865 case SMBtconX:
866 case SMBlockingX:
867 case SMBopenX:
868 case SMBreadX:
869 case SMBwriteX:
870 case SMBsesssetupX:
871 case SMBulogoffX:
872 case SMBntcreateX:
873 return true;
874 break;
875 default:
876 break;
879 return false;