s3-libsmb: introduce option to disable dos error mapping
[obnox/samba/samba-obnox.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 "libsmb/libsmb.h"
23 #include "../lib/util/tevent_ntstatus.h"
24 #include "../libcli/smb/smb_signing.h"
25 #include "../libcli/smb/smb_seal.h"
26 #include "async_smb.h"
27
28 /*******************************************************************
29  Setup the word count and byte count for a client smb message.
30 ********************************************************************/
31
32 int cli_set_message(char *buf,int num_words,int num_bytes,bool zero)
33 {
34         if (zero && (num_words || num_bytes)) {
35                 memset(buf + smb_size,'\0',num_words*2 + num_bytes);
36         }
37         SCVAL(buf,smb_wct,num_words);
38         SSVAL(buf,smb_vwv + num_words*SIZEOFWORD,num_bytes);
39         smb_setlen(buf,smb_size + num_words*2 + num_bytes - 4);
40         return (smb_size + num_words*2 + num_bytes);
41 }
42
43 /****************************************************************************
44  Change the timeout (in milliseconds).
45 ****************************************************************************/
46
47 unsigned int cli_set_timeout(struct cli_state *cli, unsigned int timeout)
48 {
49         unsigned int old_timeout = cli->timeout;
50         cli->timeout = timeout;
51         return old_timeout;
52 }
53
54 /****************************************************************************
55  convenience routine to find if we negotiated ucs2
56 ****************************************************************************/
57
58 bool cli_ucs2(struct cli_state *cli)
59 {
60         return ((cli_state_capabilities(cli) & CAP_UNICODE) != 0);
61 }
62
63 /****************************************************************************
64  Setup basics in a outgoing packet.
65 ****************************************************************************/
66
67 void cli_setup_packet_buf(struct cli_state *cli, char *buf)
68 {
69         uint16 flags2;
70         cli->rap_error = 0;
71         SIVAL(buf,smb_rcls,0);
72         SSVAL(buf,smb_pid,cli->smb1.pid);
73         memset(buf+smb_pidhigh, 0, 12);
74         SSVAL(buf,smb_uid, cli_state_get_uid(cli));
75         SSVAL(buf,smb_mid, 0);
76
77         if (cli_state_protocol(cli) <= PROTOCOL_CORE) {
78                 return;
79         }
80
81         if (cli->case_sensitive) {
82                 SCVAL(buf,smb_flg,0x0);
83         } else {
84                 /* Default setting, case insensitive. */
85                 SCVAL(buf,smb_flg,0x8);
86         }
87         flags2 = FLAGS2_LONG_PATH_COMPONENTS;
88         if (cli_state_capabilities(cli) & CAP_UNICODE)
89                 flags2 |= FLAGS2_UNICODE_STRINGS;
90         if ((cli_state_capabilities(cli) & CAP_DFS) && cli->dfsroot)
91                 flags2 |= FLAGS2_DFS_PATHNAMES;
92         if (cli_state_capabilities(cli) & CAP_STATUS32)
93                 flags2 |= FLAGS2_32_BIT_ERROR_CODES;
94         if (cli_state_capabilities(cli) & CAP_EXTENDED_SECURITY)
95                 flags2 |= FLAGS2_EXTENDED_SECURITY;
96         SSVAL(buf,smb_flg2, flags2);
97 }
98
99 /****************************************************************************
100  Initialize Domain, user or password.
101 ****************************************************************************/
102
103 NTSTATUS cli_set_domain(struct cli_state *cli, const char *domain)
104 {
105         TALLOC_FREE(cli->domain);
106         cli->domain = talloc_strdup(cli, domain ? domain : "");
107         if (cli->domain == NULL) {
108                 return NT_STATUS_NO_MEMORY;
109         }
110         return NT_STATUS_OK;
111 }
112
113 NTSTATUS cli_set_username(struct cli_state *cli, const char *username)
114 {
115         TALLOC_FREE(cli->user_name);
116         cli->user_name = talloc_strdup(cli, username ? username : "");
117         if (cli->user_name == NULL) {
118                 return NT_STATUS_NO_MEMORY;
119         }
120         return NT_STATUS_OK;
121 }
122
123 NTSTATUS cli_set_password(struct cli_state *cli, const char *password)
124 {
125         TALLOC_FREE(cli->password);
126
127         /* Password can be NULL. */
128         if (password) {
129                 cli->password = talloc_strdup(cli, password);
130                 if (cli->password == NULL) {
131                         return NT_STATUS_NO_MEMORY;
132                 }
133         } else {
134                 /* Use zero NTLMSSP hashes and session key. */
135                 cli->password = NULL;
136         }
137
138         return NT_STATUS_OK;
139 }
140
141 /****************************************************************************
142  Initialise credentials of a client structure.
143 ****************************************************************************/
144
145 NTSTATUS cli_init_creds(struct cli_state *cli, const char *username, const char *domain, const char *password)
146 {
147         NTSTATUS status = cli_set_username(cli, username);
148         if (!NT_STATUS_IS_OK(status)) {
149                 return status;
150         }
151         status = cli_set_domain(cli, domain);
152         if (!NT_STATUS_IS_OK(status)) {
153                 return status;
154         }
155         DEBUG(10,("cli_init_creds: user %s domain %s\n", cli->user_name, cli->domain));
156
157         return cli_set_password(cli, password);
158 }
159
160 /****************************************************************************
161  Initialise a client structure. Always returns a talloc'ed struct.
162  Set the signing state (used from the command line).
163 ****************************************************************************/
164
165 struct cli_state *cli_state_create(TALLOC_CTX *mem_ctx,
166                                    int fd,
167                                    const char *remote_name,
168                                    const char *remote_realm,
169                                    int signing_state, int flags)
170 {
171         struct cli_state *cli = NULL;
172         bool allow_smb_signing;
173         bool desire_smb_signing;
174         bool mandatory_signing;
175         socklen_t ss_length;
176         int ret;
177         bool use_spnego = lp_client_use_spnego();
178         bool force_dos_errors = false;
179         bool force_ascii = false;
180         bool use_level_II_oplocks = false;
181
182         /* Check the effective uid - make sure we are not setuid */
183         if (is_setuid_root()) {
184                 DEBUG(0,("libsmb based programs must *NOT* be setuid root.\n"));
185                 return NULL;
186         }
187
188         cli = talloc_zero(mem_ctx, struct cli_state);
189         if (!cli) {
190                 return NULL;
191         }
192
193         cli->server_domain = talloc_strdup(cli, "");
194         if (!cli->server_domain) {
195                 goto error;
196         }
197         cli->server_os = talloc_strdup(cli, "");
198         if (!cli->server_os) {
199                 goto error;
200         }
201         cli->server_type = talloc_strdup(cli, "");
202         if (!cli->server_type) {
203                 goto error;
204         }
205
206         cli->dfs_mountpoint = talloc_strdup(cli, "");
207         if (!cli->dfs_mountpoint) {
208                 goto error;
209         }
210         cli->raw_status = NT_STATUS_INTERNAL_ERROR;
211         cli->map_dos_errors = true; /* remove this */
212         cli->timeout = 20000; /* Timeout is in milliseconds. */
213         cli->case_sensitive = false;
214
215         /* Set the CLI_FORCE_DOSERR environment variable to test
216            client routines using DOS errors instead of STATUS32
217            ones.  This intended only as a temporary hack. */    
218         if (getenv("CLI_FORCE_DOSERR")) {
219                 force_dos_errors = true;
220         }
221         if (flags & CLI_FULL_CONNECTION_FORCE_DOS_ERRORS) {
222                 force_dos_errors = true;
223         }
224
225         if (getenv("CLI_FORCE_ASCII")) {
226                 force_ascii = true;
227         }
228         if (flags & CLI_FULL_CONNECTION_FORCE_ASCII) {
229                 force_ascii = true;
230         }
231
232         if (flags & CLI_FULL_CONNECTION_DONT_SPNEGO) {
233                 use_spnego = false;
234         } else if (flags & CLI_FULL_CONNECTION_USE_KERBEROS) {
235                 cli->use_kerberos = true;
236         }
237         if ((flags & CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS) &&
238              cli->use_kerberos) {
239                 cli->fallback_after_kerberos = true;
240         }
241
242         if (flags & CLI_FULL_CONNECTION_USE_CCACHE) {
243                 cli->use_ccache = true;
244         }
245
246         if (flags & CLI_FULL_CONNECTION_OPLOCKS) {
247                 cli->use_oplocks = true;
248         }
249         if (flags & CLI_FULL_CONNECTION_LEVEL_II_OPLOCKS) {
250                 use_level_II_oplocks = true;
251         }
252
253         if (signing_state == SMB_SIGNING_DEFAULT) {
254                 signing_state = lp_client_signing();
255         }
256
257         switch (signing_state) {
258         case SMB_SIGNING_OFF:
259                 /* never */
260                 allow_smb_signing = false;
261                 desire_smb_signing = false;
262                 mandatory_signing = false;
263                 break;
264         default:
265         case SMB_SIGNING_DEFAULT:
266         case SMB_SIGNING_IF_REQUIRED:
267                 allow_smb_signing = true;
268                 desire_smb_signing = false;
269                 mandatory_signing = false;
270                 break;
271         case SMB_SIGNING_REQUIRED:
272                 /* always */
273                 allow_smb_signing = true;
274                 desire_smb_signing = true;
275                 mandatory_signing = true;
276                 break;
277         }
278
279         /* initialise signing */
280         cli->signing_state = smb_signing_init(cli,
281                                               allow_smb_signing,
282                                               desire_smb_signing,
283                                               mandatory_signing);
284         if (!cli->signing_state) {
285                 goto error;
286         }
287
288         cli->conn.smb1.client.capabilities = 0;
289         cli->conn.smb1.client.capabilities |= CAP_LARGE_FILES;
290         cli->conn.smb1.client.capabilities |= CAP_NT_SMBS | CAP_RPC_REMOTE_APIS;
291         cli->conn.smb1.client.capabilities |= CAP_LOCK_AND_READ | CAP_NT_FIND;
292         cli->conn.smb1.client.capabilities |= CAP_DFS | CAP_W2K_SMBS;
293         cli->conn.smb1.client.capabilities |= CAP_LARGE_READX|CAP_LARGE_WRITEX;
294         cli->conn.smb1.client.capabilities |= CAP_LWIO;
295
296         if (!force_dos_errors) {
297                 cli->conn.smb1.client.capabilities |= CAP_STATUS32;
298         }
299
300         if (!force_ascii) {
301                 cli->conn.smb1.client.capabilities |= CAP_UNICODE;
302         }
303
304         if (use_spnego) {
305                 cli->conn.smb1.client.capabilities |= CAP_EXTENDED_SECURITY;
306         }
307
308         if (use_level_II_oplocks) {
309                 cli->conn.smb1.client.capabilities |= CAP_LEVEL_II_OPLOCKS;
310         }
311
312         cli->conn.smb1.client.max_xmit = CLI_BUFFER_SIZE;
313
314         cli->conn.smb1.capabilities = cli->conn.smb1.client.capabilities;
315         cli->conn.smb1.max_xmit = 1024;
316
317         cli->conn.smb1.mid = 1;
318
319         cli->conn.outgoing = tevent_queue_create(cli, "cli_outgoing");
320         if (cli->conn.outgoing == NULL) {
321                 goto error;
322         }
323         cli->conn.pending = NULL;
324
325         cli->conn.remote_name = talloc_strdup(cli, remote_name);
326         if (cli->conn.remote_name == NULL) {
327                 goto error;
328         }
329
330         if (remote_realm) {
331                 cli->conn.remote_realm = talloc_strdup(cli, remote_realm);
332                 if (cli->conn.remote_realm == NULL) {
333                         goto error;
334                 }
335         }
336
337         cli->conn.fd = fd;
338
339         ss_length = sizeof(cli->conn.local_ss);
340         ret = getsockname(fd,
341                           (struct sockaddr *)(void *)&cli->conn.local_ss,
342                           &ss_length);
343         if (ret == -1) {
344                 goto error;
345         }
346         ss_length = sizeof(cli->conn.remote_ss);
347         ret = getpeername(fd,
348                           (struct sockaddr *)(void *)&cli->conn.remote_ss,
349                           &ss_length);
350         if (ret == -1) {
351                 goto error;
352         }
353
354         cli->smb1.pid = (uint16_t)sys_getpid();
355         cli->smb1.vc_num = cli->smb1.pid;
356         cli->smb1.tid = UINT16_MAX;
357         cli->smb1.uid = UID_FIELD_INVALID;
358
359         cli->initialised = 1;
360         return cli;
361
362         /* Clean up after malloc() error */
363
364  error:
365
366         TALLOC_FREE(cli);
367         return NULL;
368 }
369
370 bool cli_state_encryption_on(struct cli_state *cli)
371 {
372         return common_encryption_on(cli->trans_enc_state);
373 }
374
375
376 /****************************************************************************
377  Close all pipes open on this session.
378 ****************************************************************************/
379
380 void cli_nt_pipes_close(struct cli_state *cli)
381 {
382         while (cli->pipe_list != NULL) {
383                 /*
384                  * No TALLOC_FREE here!
385                  */
386                 talloc_free(cli->pipe_list);
387         }
388 }
389
390 /****************************************************************************
391  Shutdown a client structure.
392 ****************************************************************************/
393
394 static void _cli_shutdown(struct cli_state *cli)
395 {
396         cli_nt_pipes_close(cli);
397
398         /*
399          * tell our peer to free his resources.  Wihtout this, when an
400          * application attempts to do a graceful shutdown and calls
401          * smbc_free_context() to clean up all connections, some connections
402          * can remain active on the peer end, until some (long) timeout period
403          * later.  This tree disconnect forces the peer to clean up, since the
404          * connection will be going away.
405          */
406         if (cli_state_has_tcon(cli)) {
407                 cli_tdis(cli);
408         }
409         
410         data_blob_free(&cli->user_session_key);
411
412         cli_state_disconnect(cli);
413
414         /*
415          * Need to free pending first, they remove themselves
416          */
417         while (cli->conn.pending) {
418                 talloc_free(cli->conn.pending[0]);
419         }
420         TALLOC_FREE(cli);
421 }
422
423 void cli_shutdown(struct cli_state *cli)
424 {
425         struct cli_state *cli_head;
426         if (cli == NULL) {
427                 return;
428         }
429         DLIST_HEAD(cli, cli_head);
430         if (cli_head == cli) {
431                 /*
432                  * head of a DFS list, shutdown all subsidiary DFS
433                  * connections.
434                  */
435                 struct cli_state *p, *next;
436
437                 for (p = cli_head->next; p; p = next) {
438                         next = p->next;
439                         DLIST_REMOVE(cli_head, p);
440                         _cli_shutdown(p);
441                 }
442         } else {
443                 DLIST_REMOVE(cli_head, cli);
444         }
445
446         _cli_shutdown(cli);
447 }
448
449 /****************************************************************************
450  Set socket options on a open connection.
451 ****************************************************************************/
452
453 void cli_sockopt(struct cli_state *cli, const char *options)
454 {
455         set_socket_options(cli->conn.fd, options);
456 }
457
458 const struct sockaddr_storage *cli_state_local_sockaddr(struct cli_state *cli)
459 {
460         return &cli->conn.local_ss;
461 }
462
463 const struct sockaddr_storage *cli_state_remote_sockaddr(struct cli_state *cli)
464 {
465         return &cli->conn.remote_ss;
466 }
467
468 const char *cli_state_remote_name(struct cli_state *cli)
469 {
470         return cli->conn.remote_name;
471 }
472
473 const char *cli_state_remote_realm(struct cli_state *cli)
474 {
475         return cli->conn.remote_realm;
476 }
477
478 uint16_t cli_state_get_vc_num(struct cli_state *cli)
479 {
480         return cli->smb1.vc_num;
481 }
482
483 uint32_t cli_state_server_session_key(struct cli_state *cli)
484 {
485         return cli->conn.smb1.server.session_key;
486 }
487
488 /****************************************************************************
489  Set the PID to use for smb messages. Return the old pid.
490 ****************************************************************************/
491
492 uint16 cli_setpid(struct cli_state *cli, uint16 pid)
493 {
494         uint16_t ret = cli->smb1.pid;
495         cli->smb1.pid = pid;
496         return ret;
497 }
498
499 uint16_t cli_getpid(struct cli_state *cli)
500 {
501         return cli->smb1.pid;
502 }
503
504 bool cli_state_has_tcon(struct cli_state *cli)
505 {
506         if (cli->smb1.tid == UINT16_MAX) {
507                 return false;
508         }
509
510         return true;
511 }
512
513 uint16_t cli_state_get_tid(struct cli_state *cli)
514 {
515         return cli->smb1.tid;
516 }
517
518 uint16_t cli_state_set_tid(struct cli_state *cli, uint16_t tid)
519 {
520         uint16_t ret = cli->smb1.tid;
521         cli->smb1.tid = tid;
522         return ret;
523 }
524
525 uint16_t cli_state_get_uid(struct cli_state *cli)
526 {
527         return cli->smb1.uid;
528 }
529
530 uint16_t cli_state_set_uid(struct cli_state *cli, uint16_t uid)
531 {
532         uint16_t ret = cli->smb1.uid;
533         cli->smb1.uid = uid;
534         return ret;
535 }
536
537 /****************************************************************************
538  Set the case sensitivity flag on the packets. Returns old state.
539 ****************************************************************************/
540
541 bool cli_set_case_sensitive(struct cli_state *cli, bool case_sensitive)
542 {
543         bool ret = cli->case_sensitive;
544         cli->case_sensitive = case_sensitive;
545         return ret;
546 }
547
548 enum protocol_types cli_state_protocol(struct cli_state *cli)
549 {
550         return cli->conn.protocol;
551 }
552
553 uint32_t cli_state_capabilities(struct cli_state *cli)
554 {
555         return cli->conn.smb1.capabilities;
556 }
557
558 uint32_t cli_state_available_size(struct cli_state *cli, uint32_t ofs)
559 {
560         uint32_t ret = cli->conn.smb1.max_xmit;
561
562         if (ofs >= ret) {
563                 return 0;
564         }
565
566         ret -= ofs;
567
568         return ret;
569 }
570
571 uint16_t cli_state_max_requests(struct cli_state *cli)
572 {
573         return cli->conn.smb1.server.max_mux;
574 }
575
576 const uint8_t *cli_state_server_challenge(struct cli_state *cli)
577 {
578         return cli->conn.smb1.server.challenge;
579 }
580
581 const DATA_BLOB *cli_state_server_gss_blob(struct cli_state *cli)
582 {
583         return &cli->conn.smb1.server.gss_blob;
584 }
585
586 uint16_t cli_state_security_mode(struct cli_state *cli)
587 {
588         return cli->conn.smb1.server.security_mode;
589 }
590
591 int cli_state_server_time_zone(struct cli_state *cli)
592 {
593         return cli->conn.smb1.server.time_zone;
594 }
595
596 time_t cli_state_server_time(struct cli_state *cli)
597 {
598         return cli->conn.smb1.server.system_time;
599 }
600
601 struct cli_echo_state {
602         uint16_t vwv[1];
603         DATA_BLOB data;
604         int num_echos;
605 };
606
607 static void cli_echo_done(struct tevent_req *subreq);
608
609 struct tevent_req *cli_echo_send(TALLOC_CTX *mem_ctx, struct event_context *ev,
610                                  struct cli_state *cli, uint16_t num_echos,
611                                  DATA_BLOB data)
612 {
613         struct tevent_req *req, *subreq;
614         struct cli_echo_state *state;
615
616         req = tevent_req_create(mem_ctx, &state, struct cli_echo_state);
617         if (req == NULL) {
618                 return NULL;
619         }
620         SSVAL(state->vwv, 0, num_echos);
621         state->data = data;
622         state->num_echos = num_echos;
623
624         subreq = cli_smb_send(state, ev, cli, SMBecho, 0, 1, state->vwv,
625                               data.length, data.data);
626         if (subreq == NULL) {
627                 goto fail;
628         }
629         tevent_req_set_callback(subreq, cli_echo_done, req);
630         return req;
631  fail:
632         TALLOC_FREE(req);
633         return NULL;
634 }
635
636 static void cli_echo_done(struct tevent_req *subreq)
637 {
638         struct tevent_req *req = tevent_req_callback_data(
639                 subreq, struct tevent_req);
640         struct cli_echo_state *state = tevent_req_data(
641                 req, struct cli_echo_state);
642         NTSTATUS status;
643         uint32_t num_bytes;
644         uint8_t *bytes;
645         uint8_t *inbuf;
646
647         status = cli_smb_recv(subreq, state, &inbuf, 0, NULL, NULL,
648                               &num_bytes, &bytes);
649         if (!NT_STATUS_IS_OK(status)) {
650                 tevent_req_nterror(req, status);
651                 return;
652         }
653         if ((num_bytes != state->data.length)
654             || (memcmp(bytes, state->data.data, num_bytes) != 0)) {
655                 tevent_req_nterror(req, NT_STATUS_INVALID_NETWORK_RESPONSE);
656                 return;
657         }
658
659         state->num_echos -=1;
660         if (state->num_echos == 0) {
661                 tevent_req_done(req);
662                 return;
663         }
664
665         if (!cli_smb_req_set_pending(subreq)) {
666                 tevent_req_nterror(req, NT_STATUS_NO_MEMORY);
667                 return;
668         }
669 }
670
671 /**
672  * Get the result out from an echo request
673  * @param[in] req       The async_req from cli_echo_send
674  * @retval Did the server reply correctly?
675  */
676
677 NTSTATUS cli_echo_recv(struct tevent_req *req)
678 {
679         return tevent_req_simple_recv_ntstatus(req);
680 }
681
682 /**
683  * @brief Send/Receive SMBEcho requests
684  * @param[in] mem_ctx   The memory context to put the async_req on
685  * @param[in] ev        The event context that will call us back
686  * @param[in] cli       The connection to send the echo to
687  * @param[in] num_echos How many times do we want to get the reply?
688  * @param[in] data      The data we want to get back
689  * @retval Did the server reply correctly?
690  */
691
692 NTSTATUS cli_echo(struct cli_state *cli, uint16_t num_echos, DATA_BLOB data)
693 {
694         TALLOC_CTX *frame = talloc_stackframe();
695         struct event_context *ev;
696         struct tevent_req *req;
697         NTSTATUS status = NT_STATUS_OK;
698
699         if (cli_has_async_calls(cli)) {
700                 /*
701                  * Can't use sync call while an async call is in flight
702                  */
703                 status = NT_STATUS_INVALID_PARAMETER;
704                 goto fail;
705         }
706
707         ev = event_context_init(frame);
708         if (ev == NULL) {
709                 status = NT_STATUS_NO_MEMORY;
710                 goto fail;
711         }
712
713         req = cli_echo_send(frame, ev, cli, num_echos, data);
714         if (req == NULL) {
715                 status = NT_STATUS_NO_MEMORY;
716                 goto fail;
717         }
718
719         if (!tevent_req_poll(req, ev)) {
720                 status = map_nt_error_from_unix(errno);
721                 goto fail;
722         }
723
724         status = cli_echo_recv(req);
725  fail:
726         TALLOC_FREE(frame);
727         return status;
728 }
729
730 /**
731  * Is the SMB command able to hold an AND_X successor
732  * @param[in] cmd       The SMB command in question
733  * @retval Can we add a chained request after "cmd"?
734  */
735 bool is_andx_req(uint8_t cmd)
736 {
737         switch (cmd) {
738         case SMBtconX:
739         case SMBlockingX:
740         case SMBopenX:
741         case SMBreadX:
742         case SMBwriteX:
743         case SMBsesssetupX:
744         case SMBulogoffX:
745         case SMBntcreateX:
746                 return true;
747                 break;
748         default:
749                 break;
750         }
751
752         return false;
753 }
754
755 NTSTATUS cli_smb(TALLOC_CTX *mem_ctx, struct cli_state *cli,
756                  uint8_t smb_command, uint8_t additional_flags,
757                  uint8_t wct, uint16_t *vwv,
758                  uint32_t num_bytes, const uint8_t *bytes,
759                  struct tevent_req **result_parent,
760                  uint8_t min_wct, uint8_t *pwct, uint16_t **pvwv,
761                  uint32_t *pnum_bytes, uint8_t **pbytes)
762 {
763         struct tevent_context *ev;
764         struct tevent_req *req = NULL;
765         NTSTATUS status = NT_STATUS_NO_MEMORY;
766
767         if (cli_has_async_calls(cli)) {
768                 return NT_STATUS_INVALID_PARAMETER;
769         }
770         ev = tevent_context_init(mem_ctx);
771         if (ev == NULL) {
772                 goto fail;
773         }
774         req = cli_smb_send(mem_ctx, ev, cli, smb_command, additional_flags,
775                            wct, vwv, num_bytes, bytes);
776         if (req == NULL) {
777                 goto fail;
778         }
779         if (!tevent_req_poll_ntstatus(req, ev, &status)) {
780                 goto fail;
781         }
782         status = cli_smb_recv(req, NULL, NULL, min_wct, pwct, pvwv,
783                               pnum_bytes, pbytes);
784 fail:
785         TALLOC_FREE(ev);
786         if (NT_STATUS_IS_OK(status) && (result_parent != NULL)) {
787                 *result_parent = req;
788         }
789         return status;
790 }