s3: Remove cli_write
[obnox/samba-ctdb.git] / source3 / libsmb / clientgen.c
1 /* 
2    Unix SMB/CIFS implementation.
3    SMB client generic functions
4    Copyright (C) Andrew Tridgell 1994-1998
5    Copyright (C) Jeremy Allison 2007.
6    
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.
11    
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.
16    
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/>.
19 */
20
21 #include "includes.h"
22 #include "smb_signing.h"
23 #include "async_smb.h"
24
25 /*******************************************************************
26  Setup the word count and byte count for a client smb message.
27 ********************************************************************/
28
29 int cli_set_message(char *buf,int num_words,int num_bytes,bool zero)
30 {
31         if (zero && (num_words || num_bytes)) {
32                 memset(buf + smb_size,'\0',num_words*2 + num_bytes);
33         }
34         SCVAL(buf,smb_wct,num_words);
35         SSVAL(buf,smb_vwv + num_words*SIZEOFWORD,num_bytes);
36         smb_setlen(buf,smb_size + num_words*2 + num_bytes - 4);
37         return (smb_size + num_words*2 + num_bytes);
38 }
39
40 /****************************************************************************
41  Change the timeout (in milliseconds).
42 ****************************************************************************/
43
44 unsigned int cli_set_timeout(struct cli_state *cli, unsigned int timeout)
45 {
46         unsigned int old_timeout = cli->timeout;
47         cli->timeout = timeout;
48         return old_timeout;
49 }
50
51 /****************************************************************************
52  Change the port number used to call on.
53 ****************************************************************************/
54
55 void cli_set_port(struct cli_state *cli, int port)
56 {
57         cli->port = port;
58 }
59
60 /****************************************************************************
61  convenience routine to find if we negotiated ucs2
62 ****************************************************************************/
63
64 bool cli_ucs2(struct cli_state *cli)
65 {
66         return ((cli->capabilities & CAP_UNICODE) != 0);
67 }
68
69
70 /****************************************************************************
71  Read an smb from a fd ignoring all keepalive packets.
72  The timeout is in milliseconds
73
74  This is exactly the same as receive_smb except that it never returns
75  a session keepalive packet (just as receive_smb used to do).
76  receive_smb was changed to return keepalives as the oplock processing means this call
77  should never go into a blocking read.
78 ****************************************************************************/
79
80 static ssize_t client_receive_smb(struct cli_state *cli, size_t maxlen)
81 {
82         size_t len;
83
84         for(;;) {
85                 NTSTATUS status;
86
87                 set_smb_read_error(&cli->smb_rw_error, SMB_READ_OK);
88
89                 status = receive_smb_raw(cli->fd, cli->inbuf, cli->bufsize,
90                                         cli->timeout, maxlen, &len);
91                 if (!NT_STATUS_IS_OK(status)) {
92                         DEBUG(10,("client_receive_smb failed\n"));
93                         show_msg(cli->inbuf);
94
95                         if (NT_STATUS_EQUAL(status, NT_STATUS_END_OF_FILE)) {
96                                 set_smb_read_error(&cli->smb_rw_error,
97                                                    SMB_READ_EOF);
98                                 return -1;
99                         }
100
101                         if (NT_STATUS_EQUAL(status, NT_STATUS_IO_TIMEOUT)) {
102                                 set_smb_read_error(&cli->smb_rw_error,
103                                                    SMB_READ_TIMEOUT);
104                                 return -1;
105                         }
106
107                         set_smb_read_error(&cli->smb_rw_error, SMB_READ_ERROR);
108                         return -1;
109                 }
110
111                 /*
112                  * I don't believe len can be < 0 with NT_STATUS_OK
113                  * returned above, but this check doesn't hurt. JRA.
114                  */
115
116                 if ((ssize_t)len < 0) {
117                         return len;
118                 }
119
120                 /* Ignore session keepalive packets. */
121                 if(CVAL(cli->inbuf,0) != SMBkeepalive) {
122                         break;
123                 }
124         }
125
126         if (cli_encryption_on(cli)) {
127                 NTSTATUS status = cli_decrypt_message(cli);
128                 if (!NT_STATUS_IS_OK(status)) {
129                         DEBUG(0, ("SMB decryption failed on incoming packet! Error %s\n",
130                                 nt_errstr(status)));
131                         cli->smb_rw_error = SMB_READ_BAD_DECRYPT;
132                         return -1;
133                 }
134         }
135
136         show_msg(cli->inbuf);
137         return len;
138 }
139
140 static bool cli_state_set_seqnum(struct cli_state *cli, uint16_t mid, uint32_t seqnum)
141 {
142         struct cli_state_seqnum *c;
143
144         for (c = cli->seqnum; c; c = c->next) {
145                 if (c->mid == mid) {
146                         c->seqnum = seqnum;
147                         return true;
148                 }
149         }
150
151         c = talloc_zero(cli, struct cli_state_seqnum);
152         if (!c) {
153                 return false;
154         }
155
156         c->mid = mid;
157         c->seqnum = seqnum;
158         c->persistent = false;
159         DLIST_ADD_END(cli->seqnum, c, struct cli_state_seqnum *);
160
161         return true;
162 }
163
164 bool cli_state_seqnum_persistent(struct cli_state *cli,
165                                  uint16_t mid)
166 {
167         struct cli_state_seqnum *c;
168
169         for (c = cli->seqnum; c; c = c->next) {
170                 if (c->mid == mid) {
171                         c->persistent = true;
172                         return true;
173                 }
174         }
175
176         return false;
177 }
178
179 bool cli_state_seqnum_remove(struct cli_state *cli,
180                              uint16_t mid)
181 {
182         struct cli_state_seqnum *c;
183
184         for (c = cli->seqnum; c; c = c->next) {
185                 if (c->mid == mid) {
186                         DLIST_REMOVE(cli->seqnum, c);
187                         TALLOC_FREE(c);
188                         return true;
189                 }
190         }
191
192         return false;
193 }
194
195 static uint32_t cli_state_get_seqnum(struct cli_state *cli, uint16_t mid)
196 {
197         struct cli_state_seqnum *c;
198
199         for (c = cli->seqnum; c; c = c->next) {
200                 if (c->mid == mid) {
201                         uint32_t seqnum = c->seqnum;
202                         if (!c->persistent) {
203                                 DLIST_REMOVE(cli->seqnum, c);
204                                 TALLOC_FREE(c);
205                         }
206                         return seqnum;
207                 }
208         }
209
210         return 0;
211 }
212
213 /****************************************************************************
214  Recv an smb.
215 ****************************************************************************/
216
217 bool cli_receive_smb(struct cli_state *cli)
218 {
219         ssize_t len;
220         uint16_t mid;
221         uint32_t seqnum;
222
223         /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
224         if (cli->fd == -1)
225                 return false; 
226
227  again:
228         len = client_receive_smb(cli, 0);
229         
230         if (len > 0) {
231                 /* it might be an oplock break request */
232                 if (!(CVAL(cli->inbuf, smb_flg) & FLAG_REPLY) &&
233                     CVAL(cli->inbuf,smb_com) == SMBlockingX &&
234                     SVAL(cli->inbuf,smb_vwv6) == 0 &&
235                     SVAL(cli->inbuf,smb_vwv7) == 0) {
236                         if (cli->oplock_handler) {
237                                 int fnum = SVAL(cli->inbuf,smb_vwv2);
238                                 unsigned char level = CVAL(cli->inbuf,smb_vwv3+1);
239                                 if (!NT_STATUS_IS_OK(cli->oplock_handler(cli, fnum, level))) {
240                                         return false;
241                                 }
242                         }
243                         /* try to prevent loops */
244                         SCVAL(cli->inbuf,smb_com,0xFF);
245                         goto again;
246                 }
247         }
248
249         /* If the server is not responding, note that now */
250         if (len < 0) {
251                 /*
252                  * only log if the connection should still be open and not when
253                  * the connection was closed due to a dropped ip message
254                  */
255                 if (cli->fd != -1) {
256                         char addr[INET6_ADDRSTRLEN];
257                         print_sockaddr(addr, sizeof(addr), &cli->dest_ss);
258                         DEBUG(0, ("Receiving SMB: Server %s stopped responding\n",
259                                 addr));
260                         close(cli->fd);
261                         cli->fd = -1;
262                 }
263                 return false;
264         }
265
266         mid = SVAL(cli->inbuf,smb_mid);
267         seqnum = cli_state_get_seqnum(cli, mid);
268
269         if (!cli_check_sign_mac(cli, cli->inbuf, seqnum+1)) {
270                 /*
271                  * If we get a signature failure in sessionsetup, then
272                  * the server sometimes just reflects the sent signature
273                  * back to us. Detect this and allow the upper layer to
274                  * retrieve the correct Windows error message.
275                  */
276                 if (CVAL(cli->outbuf,smb_com) == SMBsesssetupX &&
277                         (smb_len(cli->inbuf) > (smb_ss_field + 8 - 4)) &&
278                         (SVAL(cli->inbuf,smb_flg2) & FLAGS2_SMB_SECURITY_SIGNATURES) &&
279                         memcmp(&cli->outbuf[smb_ss_field],&cli->inbuf[smb_ss_field],8) == 0 &&
280                         cli_is_error(cli)) {
281
282                         /*
283                          * Reflected signature on login error. 
284                          * Set bad sig but don't close fd.
285                          */
286                         cli->smb_rw_error = SMB_READ_BAD_SIG;
287                         return true;
288                 }
289
290                 DEBUG(0, ("SMB Signature verification failed on incoming packet!\n"));
291                 cli->smb_rw_error = SMB_READ_BAD_SIG;
292                 close(cli->fd);
293                 cli->fd = -1;
294                 return false;
295         };
296         return true;
297 }
298
299 static ssize_t write_socket(int fd, const char *buf, size_t len)
300 {
301         ssize_t ret=0;
302
303         DEBUG(6,("write_socket(%d,%d)\n",fd,(int)len));
304         ret = write_data(fd,buf,len);
305
306         DEBUG(6,("write_socket(%d,%d) wrote %d\n",fd,(int)len,(int)ret));
307         if(ret <= 0)
308                 DEBUG(0,("write_socket: Error writing %d bytes to socket %d: ERRNO = %s\n",
309                         (int)len, fd, strerror(errno) ));
310
311         return(ret);
312 }
313
314 /****************************************************************************
315  Send an smb to a fd.
316 ****************************************************************************/
317
318 bool cli_send_smb(struct cli_state *cli)
319 {
320         size_t len;
321         size_t nwritten=0;
322         ssize_t ret;
323         char *buf_out = cli->outbuf;
324         bool enc_on = cli_encryption_on(cli);
325         uint32_t seqnum;
326
327         /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
328         if (cli->fd == -1)
329                 return false;
330
331         cli_calculate_sign_mac(cli, cli->outbuf, &seqnum);
332
333         if (!cli_state_set_seqnum(cli, cli->mid, seqnum)) {
334                 DEBUG(0,("Failed to store mid[%u]/seqnum[%u]\n",
335                         (unsigned int)cli->mid,
336                         (unsigned int)seqnum));
337                 return false;
338         }
339
340         if (enc_on) {
341                 NTSTATUS status = cli_encrypt_message(cli, cli->outbuf,
342                                                       &buf_out);
343                 if (!NT_STATUS_IS_OK(status)) {
344                         close(cli->fd);
345                         cli->fd = -1;
346                         cli->smb_rw_error = SMB_WRITE_ERROR;
347                         DEBUG(0,("Error in encrypting client message. Error %s\n",
348                                 nt_errstr(status) ));
349                         return false;
350                 }
351         }
352
353         len = smb_len(buf_out) + 4;
354
355         while (nwritten < len) {
356                 ret = write_socket(cli->fd,buf_out+nwritten,len - nwritten);
357                 if (ret <= 0) {
358                         if (enc_on) {
359                                 cli_free_enc_buffer(cli, buf_out);
360                         }
361                         close(cli->fd);
362                         cli->fd = -1;
363                         cli->smb_rw_error = SMB_WRITE_ERROR;
364                         DEBUG(0,("Error writing %d bytes to client. %d (%s)\n",
365                                 (int)len,(int)ret, strerror(errno) ));
366                         return false;
367                 }
368                 nwritten += ret;
369         }
370
371         if (enc_on) {
372                 cli_free_enc_buffer(cli, buf_out);
373         }
374
375         /* Increment the mid so we can tell between responses. */
376         cli->mid++;
377         if (!cli->mid)
378                 cli->mid++;
379         return true;
380 }
381
382 /****************************************************************************
383  Setup basics in a outgoing packet.
384 ****************************************************************************/
385
386 void cli_setup_packet_buf(struct cli_state *cli, char *buf)
387 {
388         uint16 flags2;
389         cli->rap_error = 0;
390         SIVAL(buf,smb_rcls,0);
391         SSVAL(buf,smb_pid,cli->pid);
392         memset(buf+smb_pidhigh, 0, 12);
393         SSVAL(buf,smb_uid,cli->vuid);
394         SSVAL(buf,smb_mid,cli->mid);
395
396         if (cli->protocol <= PROTOCOL_CORE) {
397                 return;
398         }
399
400         if (cli->case_sensitive) {
401                 SCVAL(buf,smb_flg,0x0);
402         } else {
403                 /* Default setting, case insensitive. */
404                 SCVAL(buf,smb_flg,0x8);
405         }
406         flags2 = FLAGS2_LONG_PATH_COMPONENTS;
407         if (cli->capabilities & CAP_UNICODE)
408                 flags2 |= FLAGS2_UNICODE_STRINGS;
409         if ((cli->capabilities & CAP_DFS) && cli->dfsroot)
410                 flags2 |= FLAGS2_DFS_PATHNAMES;
411         if (cli->capabilities & CAP_STATUS32)
412                 flags2 |= FLAGS2_32_BIT_ERROR_CODES;
413         if (cli->use_spnego)
414                 flags2 |= FLAGS2_EXTENDED_SECURITY;
415         SSVAL(buf,smb_flg2, flags2);
416 }
417
418 void cli_setup_packet(struct cli_state *cli)
419 {
420         cli_setup_packet_buf(cli, cli->outbuf);
421 }
422
423 /****************************************************************************
424  Setup the bcc length of the packet from a pointer to the end of the data.
425 ****************************************************************************/
426
427 void cli_setup_bcc(struct cli_state *cli, void *p)
428 {
429         set_message_bcc(cli->outbuf, PTR_DIFF(p, smb_buf(cli->outbuf)));
430 }
431
432 /****************************************************************************
433  Initialize Domain, user or password.
434 ****************************************************************************/
435
436 NTSTATUS cli_set_domain(struct cli_state *cli, const char *domain)
437 {
438         TALLOC_FREE(cli->domain);
439         cli->domain = talloc_strdup(cli, domain ? domain : "");
440         if (cli->domain == NULL) {
441                 return NT_STATUS_NO_MEMORY;
442         }
443         return NT_STATUS_OK;
444 }
445
446 NTSTATUS cli_set_username(struct cli_state *cli, const char *username)
447 {
448         TALLOC_FREE(cli->user_name);
449         cli->user_name = talloc_strdup(cli, username ? username : "");
450         if (cli->user_name == NULL) {
451                 return NT_STATUS_NO_MEMORY;
452         }
453         return NT_STATUS_OK;
454 }
455
456 NTSTATUS cli_set_password(struct cli_state *cli, const char *password)
457 {
458         TALLOC_FREE(cli->password);
459
460         /* Password can be NULL. */
461         if (password) {
462                 cli->password = talloc_strdup(cli, password);
463                 if (cli->password == NULL) {
464                         return NT_STATUS_NO_MEMORY;
465                 }
466         } else {
467                 /* Use zero NTLMSSP hashes and session key. */
468                 cli->password = NULL;
469         }
470
471         return NT_STATUS_OK;
472 }
473
474 /****************************************************************************
475  Initialise credentials of a client structure.
476 ****************************************************************************/
477
478 NTSTATUS cli_init_creds(struct cli_state *cli, const char *username, const char *domain, const char *password)
479 {
480         NTSTATUS status = cli_set_username(cli, username);
481         if (!NT_STATUS_IS_OK(status)) {
482                 return status;
483         }
484         status = cli_set_domain(cli, domain);
485         if (!NT_STATUS_IS_OK(status)) {
486                 return status;
487         }
488         DEBUG(10,("cli_init_creds: user %s domain %s\n", cli->user_name, cli->domain));
489
490         return cli_set_password(cli, password);
491 }
492
493 /****************************************************************************
494  Initialise a client structure. Always returns a talloc'ed struct.
495  Set the signing state (used from the command line).
496 ****************************************************************************/
497
498 struct cli_state *cli_initialise_ex(int signing_state)
499 {
500         struct cli_state *cli = NULL;
501         bool allow_smb_signing = false;
502         bool mandatory_signing = false;
503
504         /* Check the effective uid - make sure we are not setuid */
505         if (is_setuid_root()) {
506                 DEBUG(0,("libsmb based programs must *NOT* be setuid root.\n"));
507                 return NULL;
508         }
509
510         cli = TALLOC_ZERO_P(NULL, struct cli_state);
511         if (!cli) {
512                 return NULL;
513         }
514
515         cli->dfs_mountpoint = talloc_strdup(cli, "");
516         if (!cli->dfs_mountpoint) {
517                 goto error;
518         }
519         cli->port = 0;
520         cli->fd = -1;
521         cli->cnum = -1;
522         cli->pid = (uint16)sys_getpid();
523         cli->mid = 1;
524         cli->vuid = UID_FIELD_INVALID;
525         cli->protocol = PROTOCOL_NT1;
526         cli->timeout = 20000; /* Timeout is in milliseconds. */
527         cli->bufsize = CLI_BUFFER_SIZE+4;
528         cli->max_xmit = cli->bufsize;
529         cli->outbuf = (char *)SMB_MALLOC(cli->bufsize+SAFETY_MARGIN);
530         cli->seqnum = 0;
531         cli->inbuf = (char *)SMB_MALLOC(cli->bufsize+SAFETY_MARGIN);
532         cli->oplock_handler = cli_oplock_ack;
533         cli->case_sensitive = false;
534         cli->smb_rw_error = SMB_READ_OK;
535
536         cli->use_spnego = lp_client_use_spnego();
537
538         cli->capabilities = CAP_UNICODE | CAP_STATUS32 | CAP_DFS;
539
540         /* Set the CLI_FORCE_DOSERR environment variable to test
541            client routines using DOS errors instead of STATUS32
542            ones.  This intended only as a temporary hack. */    
543         if (getenv("CLI_FORCE_DOSERR"))
544                 cli->force_dos_errors = true;
545
546         if (lp_client_signing()) {
547                 allow_smb_signing = true;
548         }
549
550         if (lp_client_signing() == Required) {
551                 mandatory_signing = true;
552         }
553
554         if (signing_state != Undefined) {
555                 allow_smb_signing = true;
556         }
557
558         if (signing_state == false) {
559                 allow_smb_signing = false;
560                 mandatory_signing = false;
561         }
562
563         if (signing_state == Required) {
564                 mandatory_signing = true;
565         }
566
567         if (!cli->outbuf || !cli->inbuf)
568                 goto error;
569
570         memset(cli->outbuf, 0, cli->bufsize);
571         memset(cli->inbuf, 0, cli->bufsize);
572
573
574 #if defined(DEVELOPER)
575         /* just because we over-allocate, doesn't mean it's right to use it */
576         clobber_region(__FUNCTION__, __LINE__, cli->outbuf+cli->bufsize, SAFETY_MARGIN);
577         clobber_region(__FUNCTION__, __LINE__, cli->inbuf+cli->bufsize, SAFETY_MARGIN);
578 #endif
579
580         /* initialise signing */
581         cli->signing_state = smb_signing_init(cli,
582                                               allow_smb_signing,
583                                               mandatory_signing);
584         if (!cli->signing_state) {
585                 goto error;
586         }
587
588         cli->outgoing = tevent_queue_create(cli, "cli_outgoing");
589         if (cli->outgoing == NULL) {
590                 goto error;
591         }
592         cli->pending = NULL;
593
594         cli->initialised = 1;
595
596         return cli;
597
598         /* Clean up after malloc() error */
599
600  error:
601
602         SAFE_FREE(cli->inbuf);
603         SAFE_FREE(cli->outbuf);
604         TALLOC_FREE(cli);
605         return NULL;
606 }
607
608 struct cli_state *cli_initialise(void)
609 {
610         return cli_initialise_ex(Undefined);
611 }
612
613 /****************************************************************************
614  Close all pipes open on this session.
615 ****************************************************************************/
616
617 void cli_nt_pipes_close(struct cli_state *cli)
618 {
619         while (cli->pipe_list != NULL) {
620                 /*
621                  * No TALLOC_FREE here!
622                  */
623                 talloc_free(cli->pipe_list);
624         }
625 }
626
627 /****************************************************************************
628  Shutdown a client structure.
629 ****************************************************************************/
630
631 static void _cli_shutdown(struct cli_state *cli)
632 {
633         cli_nt_pipes_close(cli);
634
635         /*
636          * tell our peer to free his resources.  Wihtout this, when an
637          * application attempts to do a graceful shutdown and calls
638          * smbc_free_context() to clean up all connections, some connections
639          * can remain active on the peer end, until some (long) timeout period
640          * later.  This tree disconnect forces the peer to clean up, since the
641          * connection will be going away.
642          *
643          * Also, do not do tree disconnect when cli->smb_rw_error is SMB_DO_NOT_DO_TDIS
644          * the only user for this so far is smbmount which passes opened connection
645          * down to kernel's smbfs module.
646          */
647         if ( (cli->cnum != (uint16)-1) && (cli->smb_rw_error != SMB_DO_NOT_DO_TDIS ) ) {
648                 cli_tdis(cli);
649         }
650         
651         SAFE_FREE(cli->outbuf);
652         SAFE_FREE(cli->inbuf);
653
654         data_blob_free(&cli->secblob);
655         data_blob_free(&cli->user_session_key);
656
657         if (cli->fd != -1) {
658                 close(cli->fd);
659         }
660         cli->fd = -1;
661         cli->smb_rw_error = SMB_READ_OK;
662
663         /*
664          * Need to free pending first, they remove themselves
665          */
666         while (cli->pending) {
667                 talloc_free(cli->pending[0]);
668         }
669         TALLOC_FREE(cli);
670 }
671
672 void cli_shutdown(struct cli_state *cli)
673 {
674         struct cli_state *cli_head;
675         if (cli == NULL) {
676                 return;
677         }
678         DLIST_HEAD(cli, cli_head);
679         if (cli_head == cli) {
680                 /*
681                  * head of a DFS list, shutdown all subsidiary DFS
682                  * connections.
683                  */
684                 struct cli_state *p, *next;
685
686                 for (p = cli_head->next; p; p = next) {
687                         next = p->next;
688                         DLIST_REMOVE(cli_head, p);
689                         _cli_shutdown(p);
690                 }
691         } else {
692                 DLIST_REMOVE(cli_head, cli);
693         }
694
695         _cli_shutdown(cli);
696 }
697
698 /****************************************************************************
699  Set socket options on a open connection.
700 ****************************************************************************/
701
702 void cli_sockopt(struct cli_state *cli, const char *options)
703 {
704         set_socket_options(cli->fd, options);
705 }
706
707 /****************************************************************************
708  Set the PID to use for smb messages. Return the old pid.
709 ****************************************************************************/
710
711 uint16 cli_setpid(struct cli_state *cli, uint16 pid)
712 {
713         uint16 ret = cli->pid;
714         cli->pid = pid;
715         return ret;
716 }
717
718 /****************************************************************************
719  Set the case sensitivity flag on the packets. Returns old state.
720 ****************************************************************************/
721
722 bool cli_set_case_sensitive(struct cli_state *cli, bool case_sensitive)
723 {
724         bool ret = cli->case_sensitive;
725         cli->case_sensitive = case_sensitive;
726         return ret;
727 }
728
729 struct cli_echo_state {
730         uint16_t vwv[1];
731         DATA_BLOB data;
732         int num_echos;
733 };
734
735 static void cli_echo_done(struct tevent_req *subreq);
736
737 struct tevent_req *cli_echo_send(TALLOC_CTX *mem_ctx, struct event_context *ev,
738                                  struct cli_state *cli, uint16_t num_echos,
739                                  DATA_BLOB data)
740 {
741         struct tevent_req *req, *subreq;
742         struct cli_echo_state *state;
743
744         req = tevent_req_create(mem_ctx, &state, struct cli_echo_state);
745         if (req == NULL) {
746                 return NULL;
747         }
748         SSVAL(state->vwv, 0, num_echos);
749         state->data = data;
750         state->num_echos = num_echos;
751
752         subreq = cli_smb_send(state, ev, cli, SMBecho, 0, 1, state->vwv,
753                               data.length, data.data);
754         if (subreq == NULL) {
755                 goto fail;
756         }
757         tevent_req_set_callback(subreq, cli_echo_done, req);
758         return req;
759  fail:
760         TALLOC_FREE(req);
761         return NULL;
762 }
763
764 static void cli_echo_done(struct tevent_req *subreq)
765 {
766         struct tevent_req *req = tevent_req_callback_data(
767                 subreq, struct tevent_req);
768         struct cli_echo_state *state = tevent_req_data(
769                 req, struct cli_echo_state);
770         NTSTATUS status;
771         uint32_t num_bytes;
772         uint8_t *bytes;
773         uint8_t *inbuf;
774
775         status = cli_smb_recv(subreq, state, &inbuf, 0, NULL, NULL,
776                               &num_bytes, &bytes);
777         if (!NT_STATUS_IS_OK(status)) {
778                 tevent_req_nterror(req, status);
779                 return;
780         }
781         if ((num_bytes != state->data.length)
782             || (memcmp(bytes, state->data.data, num_bytes) != 0)) {
783                 tevent_req_nterror(req, NT_STATUS_INVALID_NETWORK_RESPONSE);
784                 return;
785         }
786
787         state->num_echos -=1;
788         if (state->num_echos == 0) {
789                 tevent_req_done(req);
790                 return;
791         }
792
793         if (!cli_smb_req_set_pending(subreq)) {
794                 tevent_req_nterror(req, NT_STATUS_NO_MEMORY);
795                 return;
796         }
797 }
798
799 /**
800  * Get the result out from an echo request
801  * @param[in] req       The async_req from cli_echo_send
802  * @retval Did the server reply correctly?
803  */
804
805 NTSTATUS cli_echo_recv(struct tevent_req *req)
806 {
807         return tevent_req_simple_recv_ntstatus(req);
808 }
809
810 /**
811  * @brief Send/Receive SMBEcho requests
812  * @param[in] mem_ctx   The memory context to put the async_req on
813  * @param[in] ev        The event context that will call us back
814  * @param[in] cli       The connection to send the echo to
815  * @param[in] num_echos How many times do we want to get the reply?
816  * @param[in] data      The data we want to get back
817  * @retval Did the server reply correctly?
818  */
819
820 NTSTATUS cli_echo(struct cli_state *cli, uint16_t num_echos, DATA_BLOB data)
821 {
822         TALLOC_CTX *frame = talloc_stackframe();
823         struct event_context *ev;
824         struct tevent_req *req;
825         NTSTATUS status = NT_STATUS_OK;
826
827         if (cli_has_async_calls(cli)) {
828                 /*
829                  * Can't use sync call while an async call is in flight
830                  */
831                 status = NT_STATUS_INVALID_PARAMETER;
832                 goto fail;
833         }
834
835         ev = event_context_init(frame);
836         if (ev == NULL) {
837                 status = NT_STATUS_NO_MEMORY;
838                 goto fail;
839         }
840
841         req = cli_echo_send(frame, ev, cli, num_echos, data);
842         if (req == NULL) {
843                 status = NT_STATUS_NO_MEMORY;
844                 goto fail;
845         }
846
847         if (!tevent_req_poll(req, ev)) {
848                 status = map_nt_error_from_unix(errno);
849                 goto fail;
850         }
851
852         status = cli_echo_recv(req);
853  fail:
854         TALLOC_FREE(frame);
855         if (!NT_STATUS_IS_OK(status)) {
856                 cli_set_error(cli, status);
857         }
858         return status;
859 }
860
861 /**
862  * Is the SMB command able to hold an AND_X successor
863  * @param[in] cmd       The SMB command in question
864  * @retval Can we add a chained request after "cmd"?
865  */
866 bool is_andx_req(uint8_t cmd)
867 {
868         switch (cmd) {
869         case SMBtconX:
870         case SMBlockingX:
871         case SMBopenX:
872         case SMBreadX:
873         case SMBwriteX:
874         case SMBsesssetupX:
875         case SMBulogoffX:
876         case SMBntcreateX:
877                 return true;
878                 break;
879         default:
880                 break;
881         }
882
883         return false;
884 }
885
886 NTSTATUS cli_smb(TALLOC_CTX *mem_ctx, struct cli_state *cli,
887                  uint8_t smb_command, uint8_t additional_flags,
888                  uint8_t wct, uint16_t *vwv,
889                  uint32_t num_bytes, const uint8_t *bytes,
890                  struct tevent_req **result_parent,
891                  uint8_t min_wct, uint8_t *pwct, uint16_t **pvwv,
892                  uint32_t *pnum_bytes, uint8_t **pbytes)
893 {
894         struct tevent_context *ev;
895         struct tevent_req *req = NULL;
896         NTSTATUS status = NT_STATUS_NO_MEMORY;
897
898         if (cli_has_async_calls(cli)) {
899                 return NT_STATUS_INVALID_PARAMETER;
900         }
901         ev = tevent_context_init(mem_ctx);
902         if (ev == NULL) {
903                 goto fail;
904         }
905         req = cli_smb_send(mem_ctx, ev, cli, smb_command, additional_flags,
906                            wct, vwv, num_bytes, bytes);
907         if (req == NULL) {
908                 goto fail;
909         }
910         if (!tevent_req_poll_ntstatus(req, ev, &status)) {
911                 goto fail;
912         }
913         status = cli_smb_recv(req, NULL, NULL, min_wct, pwct, pvwv,
914                               pnum_bytes, pbytes);
915 fail:
916         TALLOC_FREE(ev);
917         if (NT_STATUS_IS_OK(status) && (result_parent != NULL)) {
918                 *result_parent = req;
919         }
920         return status;
921 }