2 Unix SMB/CIFS implementation.
4 dcerpc connect functions
6 Copyright (C) Andrew Tridgell 2003
7 Copyright (C) Jelmer Vernooij 2004
8 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2005-2007
9 Copyright (C) Rafal Szczesniak 2005
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
27 #include "libcli/composite/composite.h"
28 #include "libcli/smb_composite/smb_composite.h"
29 #include "lib/events/events.h"
30 #include "libcli/smb2/smb2.h"
31 #include "libcli/smb2/smb2_calls.h"
32 #include "librpc/rpc/dcerpc.h"
33 #include "librpc/rpc/dcerpc_proto.h"
34 #include "auth/credentials/credentials.h"
35 #include "param/param.h"
36 #include "libcli/resolve/resolve.h"
39 struct pipe_np_smb_state {
40 struct smb_composite_connect conn;
41 struct smbcli_tree *tree;
42 struct dcerpc_pipe_connect io;
47 Stage 3 of ncacn_np_smb: Named pipe opened (or not)
49 static void continue_pipe_open_smb(struct composite_context *ctx)
51 struct composite_context *c = talloc_get_type(ctx->async.private_data,
52 struct composite_context);
54 /* receive result of named pipe open request on smb */
55 c->status = dcerpc_pipe_open_smb_recv(ctx);
56 if (!composite_is_ok(c)) return;
63 Stage 2 of ncacn_np_smb: Open a named pipe after successful smb connection
65 static void continue_smb_connect(struct composite_context *ctx)
67 struct composite_context *open_ctx;
68 struct composite_context *c = talloc_get_type(ctx->async.private_data,
69 struct composite_context);
70 struct pipe_np_smb_state *s = talloc_get_type(c->private_data,
71 struct pipe_np_smb_state);
73 /* receive result of smb connect request */
74 c->status = smb_composite_connect_recv(ctx, c);
75 if (!composite_is_ok(c)) return;
77 /* prepare named pipe open parameters */
78 s->tree = s->conn.out.tree;
79 s->io.pipe_name = s->io.binding->endpoint;
81 /* send named pipe open request */
82 open_ctx = dcerpc_pipe_open_smb_send(s->io.pipe, s->tree, s->io.pipe_name);
83 if (composite_nomem(open_ctx, c)) return;
85 composite_continue(c, open_ctx, continue_pipe_open_smb, c);
90 Initiate async open of a rpc connection to a rpc pipe on SMB using
91 the binding structure to determine the endpoint and options
93 static struct composite_context *dcerpc_pipe_connect_ncacn_np_smb_send(TALLOC_CTX *mem_ctx, struct dcerpc_pipe_connect *io, struct loadparm_context *lp_ctx)
95 struct composite_context *c;
96 struct pipe_np_smb_state *s;
97 struct composite_context *conn_req;
98 struct smb_composite_connect *conn;
100 /* composite context allocation and setup */
101 c = composite_create(mem_ctx, io->pipe->conn->event_ctx);
102 if (c == NULL) return NULL;
104 s = talloc_zero(c, struct pipe_np_smb_state);
105 if (composite_nomem(s, c)) return c;
111 /* prepare smb connection parameters: we're connecting to IPC$ share on
113 conn->in.dest_host = s->io.binding->host;
114 conn->in.dest_ports = lp_smb_ports(lp_ctx);
115 if (s->io.binding->target_hostname == NULL)
116 conn->in.called_name = "*SMBSERVER"; /* FIXME: This is invalid */
118 conn->in.called_name = s->io.binding->target_hostname;
119 conn->in.service = "IPC$";
120 conn->in.service_type = NULL;
121 conn->in.workgroup = lp_workgroup(lp_ctx);
123 conn->in.iconv_convenience = lp_iconv_convenience(lp_ctx);
125 lp_smbcli_options(lp_ctx, &conn->in.options);
126 lp_smbcli_session_options(lp_ctx, &conn->in.session_options);
129 * provide proper credentials - user supplied, but allow a
130 * fallback to anonymous if this is an schannel connection
131 * (might be NT4 not allowing machine logins at session
134 s->conn.in.credentials = s->io.creds;
135 if (s->io.binding->flags & DCERPC_SCHANNEL) {
136 conn->in.fallback_to_anonymous = true;
138 conn->in.fallback_to_anonymous = false;
141 /* send smb connect request */
142 conn_req = smb_composite_connect_send(conn, s->io.pipe->conn,
144 s->io.pipe->conn->event_ctx);
145 if (composite_nomem(conn_req, c)) return c;
147 composite_continue(c, conn_req, continue_smb_connect, c);
153 Receive result of a rpc connection to a rpc pipe on SMB
155 static NTSTATUS dcerpc_pipe_connect_ncacn_np_smb_recv(struct composite_context *c)
157 NTSTATUS status = composite_wait(c);
164 struct pipe_np_smb2_state {
165 struct smb2_tree *tree;
166 struct dcerpc_pipe_connect io;
171 Stage 3 of ncacn_np_smb: Named pipe opened (or not)
173 static void continue_pipe_open_smb2(struct composite_context *ctx)
175 struct composite_context *c = talloc_get_type(ctx->async.private_data,
176 struct composite_context);
178 /* receive result of named pipe open request on smb2 */
179 c->status = dcerpc_pipe_open_smb2_recv(ctx);
180 if (!composite_is_ok(c)) return;
187 Stage 2 of ncacn_np_smb2: Open a named pipe after successful smb2 connection
189 static void continue_smb2_connect(struct composite_context *ctx)
191 struct composite_context *open_req;
192 struct composite_context *c = talloc_get_type(ctx->async.private_data,
193 struct composite_context);
194 struct pipe_np_smb2_state *s = talloc_get_type(c->private_data,
195 struct pipe_np_smb2_state);
197 /* receive result of smb2 connect request */
198 c->status = smb2_connect_recv(ctx, c, &s->tree);
199 if (!composite_is_ok(c)) return;
201 /* prepare named pipe open parameters */
202 s->io.pipe_name = s->io.binding->endpoint;
204 /* send named pipe open request */
205 open_req = dcerpc_pipe_open_smb2_send(s->io.pipe, s->tree, s->io.pipe_name);
206 if (composite_nomem(open_req, c)) return;
208 composite_continue(c, open_req, continue_pipe_open_smb2, c);
213 Initiate async open of a rpc connection request on SMB2 using
214 the binding structure to determine the endpoint and options
216 static struct composite_context *dcerpc_pipe_connect_ncacn_np_smb2_send(
218 struct dcerpc_pipe_connect *io,
219 struct loadparm_context *lp_ctx)
221 struct composite_context *c;
222 struct pipe_np_smb2_state *s;
223 struct composite_context *conn_req;
224 struct smbcli_options options;
226 /* composite context allocation and setup */
227 c = composite_create(mem_ctx, io->pipe->conn->event_ctx);
228 if (c == NULL) return NULL;
230 s = talloc_zero(c, struct pipe_np_smb2_state);
231 if (composite_nomem(s, c)) return c;
237 * provide proper credentials - user supplied or anonymous in case this is
238 * schannel connection
240 if (s->io.binding->flags & DCERPC_SCHANNEL) {
241 s->io.creds = cli_credentials_init(mem_ctx);
242 if (composite_nomem(s->io.creds, c)) return c;
244 cli_credentials_guess(s->io.creds, lp_ctx);
247 lp_smbcli_options(lp_ctx, &options);
249 /* send smb2 connect request */
250 conn_req = smb2_connect_send(mem_ctx, s->io.binding->host,
251 lp_parm_string_list(mem_ctx, lp_ctx, NULL, "smb2", "ports", NULL),
257 composite_continue(c, conn_req, continue_smb2_connect, c);
263 Receive result of a rpc connection to a rpc pipe on SMB2
265 static NTSTATUS dcerpc_pipe_connect_ncacn_np_smb2_recv(struct composite_context *c)
267 NTSTATUS status = composite_wait(c);
274 struct pipe_ip_tcp_state {
275 struct dcerpc_pipe_connect io;
277 const char *target_hostname;
283 Stage 2 of ncacn_ip_tcp: rpc pipe opened (or not)
285 static void continue_pipe_open_ncacn_ip_tcp(struct composite_context *ctx)
287 struct composite_context *c = talloc_get_type(ctx->async.private_data,
288 struct composite_context);
290 /* receive result of named pipe open request on tcp/ip */
291 c->status = dcerpc_pipe_open_tcp_recv(ctx);
292 if (!composite_is_ok(c)) return;
299 Initiate async open of a rpc connection to a rpc pipe on TCP/IP using
300 the binding structure to determine the endpoint and options
302 static struct composite_context* dcerpc_pipe_connect_ncacn_ip_tcp_send(TALLOC_CTX *mem_ctx,
303 struct dcerpc_pipe_connect *io)
305 struct composite_context *c;
306 struct pipe_ip_tcp_state *s;
307 struct composite_context *pipe_req;
309 /* composite context allocation and setup */
310 c = composite_create(mem_ctx, io->pipe->conn->event_ctx);
311 if (c == NULL) return NULL;
313 s = talloc_zero(c, struct pipe_ip_tcp_state);
314 if (composite_nomem(s, c)) return c;
317 /* store input parameters in state structure */
319 s->host = talloc_reference(c, io->binding->host);
320 s->target_hostname = talloc_reference(c, io->binding->target_hostname);
321 /* port number is a binding endpoint here */
322 s->port = atoi(io->binding->endpoint);
324 /* send pipe open request on tcp/ip */
325 pipe_req = dcerpc_pipe_open_tcp_send(s->io.pipe->conn, s->host, s->target_hostname,
326 s->port, io->resolve_ctx);
327 composite_continue(c, pipe_req, continue_pipe_open_ncacn_ip_tcp, c);
333 Receive result of a rpc connection to a rpc pipe on TCP/IP
335 static NTSTATUS dcerpc_pipe_connect_ncacn_ip_tcp_recv(struct composite_context *c)
337 NTSTATUS status = composite_wait(c);
344 struct pipe_unix_state {
345 struct dcerpc_pipe_connect io;
351 Stage 2 of ncacn_unix: rpc pipe opened (or not)
353 static void continue_pipe_open_ncacn_unix_stream(struct composite_context *ctx)
355 struct composite_context *c = talloc_get_type(ctx->async.private_data,
356 struct composite_context);
358 /* receive result of pipe open request on unix socket */
359 c->status = dcerpc_pipe_open_unix_stream_recv(ctx);
360 if (!composite_is_ok(c)) return;
367 Initiate async open of a rpc connection to a rpc pipe on unix socket using
368 the binding structure to determine the endpoint and options
370 static struct composite_context* dcerpc_pipe_connect_ncacn_unix_stream_send(TALLOC_CTX *mem_ctx,
371 struct dcerpc_pipe_connect *io)
373 struct composite_context *c;
374 struct pipe_unix_state *s;
375 struct composite_context *pipe_req;
377 /* composite context allocation and setup */
378 c = composite_create(mem_ctx, io->pipe->conn->event_ctx);
379 if (c == NULL) return NULL;
381 s = talloc_zero(c, struct pipe_unix_state);
382 if (composite_nomem(s, c)) return c;
385 /* prepare pipe open parameters and store them in state structure
386 also, verify whether biding endpoint is not null */
389 if (!io->binding->endpoint) {
390 DEBUG(0, ("Path to unix socket not specified\n"));
391 composite_error(c, NT_STATUS_INVALID_PARAMETER);
395 s->path = talloc_strdup(c, io->binding->endpoint); /* path is a binding endpoint here */
396 if (composite_nomem(s->path, c)) return c;
398 /* send pipe open request on unix socket */
399 pipe_req = dcerpc_pipe_open_unix_stream_send(s->io.pipe->conn, s->path);
400 composite_continue(c, pipe_req, continue_pipe_open_ncacn_unix_stream, c);
406 Receive result of a rpc connection to a pipe on unix socket
408 static NTSTATUS dcerpc_pipe_connect_ncacn_unix_stream_recv(struct composite_context *c)
410 NTSTATUS status = composite_wait(c);
417 struct pipe_ncalrpc_state {
418 struct dcerpc_pipe_connect io;
421 static NTSTATUS dcerpc_pipe_connect_ncalrpc_recv(struct composite_context *c);
424 Stage 2 of ncalrpc: rpc pipe opened (or not)
426 static void continue_pipe_open_ncalrpc(struct composite_context *ctx)
428 struct composite_context *c = talloc_get_type(ctx->async.private_data,
429 struct composite_context);
431 /* receive result of pipe open request on ncalrpc */
432 c->status = dcerpc_pipe_connect_ncalrpc_recv(ctx);
433 if (!composite_is_ok(c)) return;
440 Initiate async open of a rpc connection request on NCALRPC using
441 the binding structure to determine the endpoint and options
443 static struct composite_context* dcerpc_pipe_connect_ncalrpc_send(TALLOC_CTX *mem_ctx,
444 struct dcerpc_pipe_connect *io, struct loadparm_context *lp_ctx)
446 struct composite_context *c;
447 struct pipe_ncalrpc_state *s;
448 struct composite_context *pipe_req;
450 /* composite context allocation and setup */
451 c = composite_create(mem_ctx, io->pipe->conn->event_ctx);
452 if (c == NULL) return NULL;
454 s = talloc_zero(c, struct pipe_ncalrpc_state);
455 if (composite_nomem(s, c)) return c;
458 /* store input parameters in state structure */
461 /* send pipe open request */
462 pipe_req = dcerpc_pipe_open_pipe_send(s->io.pipe->conn, lp_ncalrpc_dir(lp_ctx),
463 s->io.binding->endpoint);
464 composite_continue(c, pipe_req, continue_pipe_open_ncalrpc, c);
470 Receive result of a rpc connection to a rpc pipe on NCALRPC
472 static NTSTATUS dcerpc_pipe_connect_ncalrpc_recv(struct composite_context *c)
474 NTSTATUS status = composite_wait(c);
481 struct pipe_connect_state {
482 struct dcerpc_pipe *pipe;
483 struct dcerpc_binding *binding;
484 const struct ndr_interface_table *table;
485 struct cli_credentials *credentials;
486 struct loadparm_context *lp_ctx;
490 static void continue_map_binding(struct composite_context *ctx);
491 static void continue_connect(struct composite_context *c, struct pipe_connect_state *s);
492 static void continue_pipe_connect_ncacn_np_smb2(struct composite_context *ctx);
493 static void continue_pipe_connect_ncacn_np_smb(struct composite_context *ctx);
494 static void continue_pipe_connect_ncacn_ip_tcp(struct composite_context *ctx);
495 static void continue_pipe_connect_ncacn_unix(struct composite_context *ctx);
496 static void continue_pipe_connect_ncalrpc(struct composite_context *ctx);
497 static void continue_pipe_connect(struct composite_context *c, struct pipe_connect_state *s);
498 static void continue_pipe_auth(struct composite_context *ctx);
502 Stage 2 of pipe_connect_b: Receive result of endpoint mapping
504 static void continue_map_binding(struct composite_context *ctx)
506 struct composite_context *c = talloc_get_type(ctx->async.private_data,
507 struct composite_context);
508 struct pipe_connect_state *s = talloc_get_type(c->private_data,
509 struct pipe_connect_state);
511 c->status = dcerpc_epm_map_binding_recv(ctx);
512 if (!composite_is_ok(c)) return;
514 DEBUG(2,("Mapped to DCERPC endpoint %s\n", s->binding->endpoint));
516 continue_connect(c, s);
521 Stage 2 of pipe_connect_b: Continue connection after endpoint is known
523 static void continue_connect(struct composite_context *c, struct pipe_connect_state *s)
525 struct dcerpc_pipe_connect pc;
527 /* potential exits to another stage by sending an async request */
528 struct composite_context *ncacn_np_smb2_req;
529 struct composite_context *ncacn_np_smb_req;
530 struct composite_context *ncacn_ip_tcp_req;
531 struct composite_context *ncacn_unix_req;
532 struct composite_context *ncalrpc_req;
534 /* dcerpc pipe connect input parameters */
536 pc.binding = s->binding;
537 pc.interface = s->table;
538 pc.creds = s->credentials;
539 pc.resolve_ctx = lp_resolve_context(s->lp_ctx);
541 /* connect dcerpc pipe depending on required transport */
542 switch (s->binding->transport) {
544 if (pc.binding->flags & DCERPC_SMB2) {
545 /* new varient of SMB a.k.a. SMB2 */
546 ncacn_np_smb2_req = dcerpc_pipe_connect_ncacn_np_smb2_send(c, &pc, s->lp_ctx);
547 composite_continue(c, ncacn_np_smb2_req, continue_pipe_connect_ncacn_np_smb2, c);
551 /* good old ordinary SMB */
552 ncacn_np_smb_req = dcerpc_pipe_connect_ncacn_np_smb_send(c, &pc, s->lp_ctx);
553 composite_continue(c, ncacn_np_smb_req, continue_pipe_connect_ncacn_np_smb, c);
559 ncacn_ip_tcp_req = dcerpc_pipe_connect_ncacn_ip_tcp_send(c, &pc);
560 composite_continue(c, ncacn_ip_tcp_req, continue_pipe_connect_ncacn_ip_tcp, c);
563 case NCACN_UNIX_STREAM:
564 ncacn_unix_req = dcerpc_pipe_connect_ncacn_unix_stream_send(c, &pc);
565 composite_continue(c, ncacn_unix_req, continue_pipe_connect_ncacn_unix, c);
569 ncalrpc_req = dcerpc_pipe_connect_ncalrpc_send(c, &pc, s->lp_ctx);
570 composite_continue(c, ncalrpc_req, continue_pipe_connect_ncalrpc, c);
574 /* looks like a transport we don't support now */
575 composite_error(c, NT_STATUS_NOT_SUPPORTED);
581 Stage 3 of pipe_connect_b: Receive result of pipe connect request on
584 static void continue_pipe_connect_ncacn_np_smb2(struct composite_context *ctx)
586 struct composite_context *c = talloc_get_type(ctx->async.private_data,
587 struct composite_context);
588 struct pipe_connect_state *s = talloc_get_type(c->private_data,
589 struct pipe_connect_state);
591 c->status = dcerpc_pipe_connect_ncacn_np_smb2_recv(ctx);
592 if (!composite_is_ok(c)) return;
594 continue_pipe_connect(c, s);
599 Stage 3 of pipe_connect_b: Receive result of pipe connect request on
602 static void continue_pipe_connect_ncacn_np_smb(struct composite_context *ctx)
604 struct composite_context *c = talloc_get_type(ctx->async.private_data,
605 struct composite_context);
606 struct pipe_connect_state *s = talloc_get_type(c->private_data,
607 struct pipe_connect_state);
609 c->status = dcerpc_pipe_connect_ncacn_np_smb_recv(ctx);
610 if (!composite_is_ok(c)) return;
612 continue_pipe_connect(c, s);
617 Stage 3 of pipe_connect_b: Receive result of pipe connect request on tcp/ip
619 static void continue_pipe_connect_ncacn_ip_tcp(struct composite_context *ctx)
621 struct composite_context *c = talloc_get_type(ctx->async.private_data,
622 struct composite_context);
623 struct pipe_connect_state *s = talloc_get_type(c->private_data,
624 struct pipe_connect_state);
626 c->status = dcerpc_pipe_connect_ncacn_ip_tcp_recv(ctx);
627 if (!composite_is_ok(c)) return;
629 continue_pipe_connect(c, s);
634 Stage 3 of pipe_connect_b: Receive result of pipe connect request on unix socket
636 static void continue_pipe_connect_ncacn_unix(struct composite_context *ctx)
638 struct composite_context *c = talloc_get_type(ctx->async.private_data,
639 struct composite_context);
640 struct pipe_connect_state *s = talloc_get_type(c->private_data,
641 struct pipe_connect_state);
643 c->status = dcerpc_pipe_connect_ncacn_unix_stream_recv(ctx);
644 if (!composite_is_ok(c)) return;
646 continue_pipe_connect(c, s);
651 Stage 3 of pipe_connect_b: Receive result of pipe connect request on local rpc
653 static void continue_pipe_connect_ncalrpc(struct composite_context *ctx)
655 struct composite_context *c = talloc_get_type(ctx->async.private_data,
656 struct composite_context);
657 struct pipe_connect_state *s = talloc_get_type(c->private_data,
658 struct pipe_connect_state);
660 c->status = dcerpc_pipe_connect_ncalrpc_recv(ctx);
661 if (!composite_is_ok(c)) return;
663 continue_pipe_connect(c, s);
668 Stage 4 of pipe_connect_b: Start an authentication on connected dcerpc pipe
669 depending on credentials and binding flags passed.
671 static void continue_pipe_connect(struct composite_context *c, struct pipe_connect_state *s)
673 struct composite_context *auth_bind_req;
675 s->pipe->binding = s->binding;
676 if (!talloc_reference(s->pipe, s->binding)) {
677 composite_error(c, NT_STATUS_NO_MEMORY);
681 auth_bind_req = dcerpc_pipe_auth_send(s->pipe, s->binding, s->table,
682 s->credentials, s->lp_ctx);
683 composite_continue(c, auth_bind_req, continue_pipe_auth, c);
688 Stage 5 of pipe_connect_b: Receive result of pipe authentication request
689 and say if all went ok
691 static void continue_pipe_auth(struct composite_context *ctx)
693 struct composite_context *c = talloc_get_type(ctx->async.private_data,
694 struct composite_context);
695 struct pipe_connect_state *s = talloc_get_type(c->private_data, struct pipe_connect_state);
697 c->status = dcerpc_pipe_auth_recv(ctx, s, &s->pipe);
698 if (!composite_is_ok(c)) return;
705 handle timeouts of a dcerpc connect
707 static void dcerpc_connect_timeout_handler(struct event_context *ev, struct timed_event *te,
708 struct timeval t, void *private)
710 struct composite_context *c = talloc_get_type(private, struct composite_context);
711 composite_error(c, NT_STATUS_IO_TIMEOUT);
715 start a request to open a rpc connection to a rpc pipe, using
716 specified binding structure to determine the endpoint and options
718 _PUBLIC_ struct composite_context* dcerpc_pipe_connect_b_send(TALLOC_CTX *parent_ctx,
719 struct dcerpc_binding *binding,
720 const struct ndr_interface_table *table,
721 struct cli_credentials *credentials,
722 struct event_context *ev,
723 struct loadparm_context *lp_ctx)
725 struct composite_context *c;
726 struct pipe_connect_state *s;
727 struct event_context *new_ev = NULL;
729 /* composite context allocation and setup */
730 c = composite_create(parent_ctx, ev);
735 talloc_steal(c, new_ev);
737 s = talloc_zero(c, struct pipe_connect_state);
738 if (composite_nomem(s, c)) return c;
741 /* initialise dcerpc pipe structure */
742 s->pipe = dcerpc_pipe_init(c, ev, lp_iconv_convenience(lp_ctx));
743 if (composite_nomem(s->pipe, c)) return c;
745 /* store parameters in state structure */
746 s->binding = binding;
748 s->credentials = credentials;
751 event_add_timed(c->event_ctx, c,
752 timeval_current_ofs(DCERPC_REQUEST_TIMEOUT, 0),
753 dcerpc_connect_timeout_handler, c);
755 switch (s->binding->transport) {
757 struct composite_context *binding_req;
758 binding_req = dcerpc_epm_map_binding_send(c, s->binding, s->table,
759 s->pipe->conn->event_ctx,
761 composite_continue(c, binding_req, continue_map_binding, c);
768 if (!s->binding->endpoint) {
769 struct composite_context *binding_req;
770 binding_req = dcerpc_epm_map_binding_send(c, s->binding, s->table,
771 s->pipe->conn->event_ctx,
773 composite_continue(c, binding_req, continue_map_binding, c);
781 continue_connect(c, s);
787 receive result of a request to open a rpc connection to a rpc pipe
789 _PUBLIC_ NTSTATUS dcerpc_pipe_connect_b_recv(struct composite_context *c, TALLOC_CTX *mem_ctx,
790 struct dcerpc_pipe **p)
793 struct pipe_connect_state *s;
795 status = composite_wait(c);
797 if (NT_STATUS_IS_OK(status)) {
798 s = talloc_get_type(c->private_data, struct pipe_connect_state);
799 talloc_steal(mem_ctx, s->pipe);
808 open a rpc connection to a rpc pipe, using the specified
809 binding structure to determine the endpoint and options - sync version
811 _PUBLIC_ NTSTATUS dcerpc_pipe_connect_b(TALLOC_CTX *parent_ctx,
812 struct dcerpc_pipe **pp,
813 struct dcerpc_binding *binding,
814 const struct ndr_interface_table *table,
815 struct cli_credentials *credentials,
816 struct event_context *ev,
817 struct loadparm_context *lp_ctx)
819 struct composite_context *c;
821 c = dcerpc_pipe_connect_b_send(parent_ctx, binding, table,
822 credentials, ev, lp_ctx);
823 return dcerpc_pipe_connect_b_recv(c, parent_ctx, pp);
827 struct pipe_conn_state {
828 struct dcerpc_pipe *pipe;
832 static void continue_pipe_connect_b(struct composite_context *ctx);
836 Initiate rpc connection to a rpc pipe, using the specified string
837 binding to determine the endpoint and options.
838 The string is to be parsed to a binding structure first.
840 _PUBLIC_ struct composite_context* dcerpc_pipe_connect_send(TALLOC_CTX *parent_ctx,
842 const struct ndr_interface_table *table,
843 struct cli_credentials *credentials,
844 struct event_context *ev, struct loadparm_context *lp_ctx)
846 struct composite_context *c;
847 struct pipe_conn_state *s;
848 struct dcerpc_binding *b;
849 struct composite_context *pipe_conn_req;
851 /* composite context allocation and setup */
852 c = composite_create(parent_ctx, ev);
857 s = talloc_zero(c, struct pipe_conn_state);
858 if (composite_nomem(s, c)) return c;
861 /* parse binding string to the structure */
862 c->status = dcerpc_parse_binding(c, binding, &b);
863 if (!NT_STATUS_IS_OK(c->status)) {
864 DEBUG(0, ("Failed to parse dcerpc binding '%s'\n", binding));
865 composite_error(c, c->status);
869 DEBUG(3, ("Using binding %s\n", dcerpc_binding_string(c, b)));
872 start connecting to a rpc pipe after binding structure
875 pipe_conn_req = dcerpc_pipe_connect_b_send(c, b, table,
876 credentials, ev, lp_ctx);
877 composite_continue(c, pipe_conn_req, continue_pipe_connect_b, c);
883 Stage 2 of pipe_connect: Receive result of actual pipe connect request
884 and say if we're done ok
886 static void continue_pipe_connect_b(struct composite_context *ctx)
888 struct composite_context *c = talloc_get_type(ctx->async.private_data,
889 struct composite_context);
890 struct pipe_conn_state *s = talloc_get_type(c->private_data,
891 struct pipe_conn_state);
893 c->status = dcerpc_pipe_connect_b_recv(ctx, c, &s->pipe);
894 talloc_steal(s, s->pipe);
895 if (!composite_is_ok(c)) return;
902 Receive result of pipe connect (using binding string) request
903 and return connected pipe structure.
905 NTSTATUS dcerpc_pipe_connect_recv(struct composite_context *c,
907 struct dcerpc_pipe **pp)
910 struct pipe_conn_state *s;
912 status = composite_wait(c);
913 if (NT_STATUS_IS_OK(status)) {
914 s = talloc_get_type(c->private_data, struct pipe_conn_state);
915 *pp = talloc_steal(mem_ctx, s->pipe);
923 Open a rpc connection to a rpc pipe, using the specified string
924 binding to determine the endpoint and options - sync version
926 _PUBLIC_ NTSTATUS dcerpc_pipe_connect(TALLOC_CTX *parent_ctx,
927 struct dcerpc_pipe **pp,
929 const struct ndr_interface_table *table,
930 struct cli_credentials *credentials,
931 struct event_context *ev,
932 struct loadparm_context *lp_ctx)
934 struct composite_context *c;
935 c = dcerpc_pipe_connect_send(parent_ctx, binding,
936 table, credentials, ev, lp_ctx);
937 return dcerpc_pipe_connect_recv(c, parent_ctx, pp);