2 Unix SMB/CIFS implementation.
4 Copyright (C) Andrew Tridgell 2005
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 a composite API for making a full SMB connection
25 #include "libcli/raw/libcliraw.h"
26 #include "libcli/composite/composite.h"
28 /* the stages of this call */
29 enum connect_stage {CONNECT_RESOLVE,
31 CONNECT_SESSION_REQUEST,
33 CONNECT_SESSION_SETUP,
36 struct connect_state {
37 enum connect_stage stage;
38 struct smbcli_socket *sock;
39 struct smbcli_transport *transport;
40 struct smbcli_session *session;
41 struct smb_composite_connect *io;
42 union smb_tcon *io_tcon;
43 struct smb_composite_sesssetup *io_setup;
44 struct smbcli_request *req;
45 struct composite_context *creq;
49 static void request_handler(struct smbcli_request *);
50 static void composite_handler(struct composite_context *);
55 static NTSTATUS connect_send_negprot(struct composite_context *c,
56 struct smb_composite_connect *io)
58 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
60 state->req = smb_raw_negotiate_send(state->transport, lp_maxprotocol());
61 NT_STATUS_HAVE_NO_MEMORY(state->req);
63 state->req->async.fn = request_handler;
64 state->req->async.private = c;
65 state->stage = CONNECT_NEGPROT;
72 a tree connect request has competed
74 static NTSTATUS connect_tcon(struct composite_context *c,
75 struct smb_composite_connect *io)
77 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
80 status = smb_tree_connect_recv(state->req, c, state->io_tcon);
81 NT_STATUS_NOT_OK_RETURN(status);
83 io->out.tree->tid = state->io_tcon->tconx.out.tid;
84 if (state->io_tcon->tconx.out.dev_type) {
85 io->out.tree->device = talloc_strdup(io->out.tree,
86 state->io_tcon->tconx.out.dev_type);
88 if (state->io_tcon->tconx.out.fs_type) {
89 io->out.tree->fs_type = talloc_strdup(io->out.tree,
90 state->io_tcon->tconx.out.fs_type);
94 c->state = SMBCLI_REQUEST_DONE;
101 a session setup request has competed
103 static NTSTATUS connect_session_setup(struct composite_context *c,
104 struct smb_composite_connect *io)
106 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
109 status = smb_composite_sesssetup_recv(state->creq);
110 NT_STATUS_NOT_OK_RETURN(status);
112 state->session->vuid = state->io_setup->out.vuid;
114 /* setup for a tconx */
115 io->out.tree = smbcli_tree_init(state->session, state, True);
116 NT_STATUS_HAVE_NO_MEMORY(io->out.tree);
118 state->io_tcon = talloc(c, union smb_tcon);
119 NT_STATUS_HAVE_NO_MEMORY(state->io_tcon);
121 /* connect to a share using a tree connect */
122 state->io_tcon->generic.level = RAW_TCON_TCONX;
123 state->io_tcon->tconx.in.flags = 0;
124 state->io_tcon->tconx.in.password = data_blob(NULL, 0);
126 state->io_tcon->tconx.in.path = talloc_asprintf(state->io_tcon,
130 NT_STATUS_HAVE_NO_MEMORY(state->io_tcon->tconx.in.path);
131 if (!io->in.service_type) {
132 state->io_tcon->tconx.in.device = "?????";
134 state->io_tcon->tconx.in.device = io->in.service_type;
137 state->req = smb_tree_connect_send(io->out.tree, state->io_tcon);
138 NT_STATUS_HAVE_NO_MEMORY(state->req);
140 state->req->async.fn = request_handler;
141 state->req->async.private = c;
142 state->stage = CONNECT_TCON;
148 a negprot request has competed
150 static NTSTATUS connect_negprot(struct composite_context *c,
151 struct smb_composite_connect *io)
153 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
156 status = smb_raw_negotiate_recv(state->req);
157 NT_STATUS_NOT_OK_RETURN(status);
159 /* next step is a session setup */
160 state->session = smbcli_session_init(state->transport, state, True);
161 NT_STATUS_HAVE_NO_MEMORY(state->session);
163 state->io_setup = talloc(c, struct smb_composite_sesssetup);
164 NT_STATUS_HAVE_NO_MEMORY(state->io_setup);
166 /* prepare a session setup to establish a security context */
167 state->io_setup->in.sesskey = state->transport->negotiate.sesskey;
168 state->io_setup->in.capabilities = state->transport->negotiate.capabilities;
169 state->io_setup->in.credentials = io->in.credentials;
170 state->io_setup->in.workgroup = io->in.workgroup;
172 state->creq = smb_composite_sesssetup_send(state->session, state->io_setup);
173 NT_STATUS_HAVE_NO_MEMORY(state->creq);
175 state->creq->async.fn = composite_handler;
176 state->creq->async.private = c;
177 state->stage = CONNECT_SESSION_SETUP;
184 a session request operation has competed
186 static NTSTATUS connect_session_request(struct composite_context *c,
187 struct smb_composite_connect *io)
189 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
192 status = smbcli_transport_connect_recv(state->req);
193 NT_STATUS_NOT_OK_RETURN(status);
195 /* next step is a negprot */
196 return connect_send_negprot(c, io);
200 a socket connection operation has competed
202 static NTSTATUS connect_socket(struct composite_context *c,
203 struct smb_composite_connect *io)
205 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
207 struct nbt_name calling, called;
209 status = smbcli_sock_connect_recv(state->creq);
210 NT_STATUS_NOT_OK_RETURN(status);
212 /* the socket is up - we can initialise the smbcli transport layer */
213 state->transport = smbcli_transport_init(state->sock, state, True);
214 NT_STATUS_HAVE_NO_MEMORY(state->transport);
216 make_nbt_name_client(&calling, cli_credentials_get_workstation(io->in.credentials));
218 nbt_choose_called_name(state, &called, io->in.called_name, NBT_NAME_SERVER);
220 /* we have a connected socket - next step is a session
221 request, if needed. Port 445 doesn't need it, so it goes
222 straight to the negprot */
223 if (state->sock->port == 445) {
224 status = nbt_name_dup(state->transport, &called,
225 &state->transport->called);
226 NT_STATUS_NOT_OK_RETURN(status);
227 return connect_send_negprot(c, io);
230 state->req = smbcli_transport_connect_send(state->transport, &calling, &called);
231 NT_STATUS_HAVE_NO_MEMORY(state->req);
233 state->req->async.fn = request_handler;
234 state->req->async.private = c;
235 state->stage = CONNECT_SESSION_REQUEST;
242 called when name resolution is finished
244 static NTSTATUS connect_resolve(struct composite_context *c,
245 struct smb_composite_connect *io)
247 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
251 status = resolve_name_recv(state->creq, state, &address);
252 NT_STATUS_NOT_OK_RETURN(status);
254 state->creq = smbcli_sock_connect_send(state->sock, address, state->io->in.port, io->in.dest_host);
255 NT_STATUS_HAVE_NO_MEMORY(state->creq);
257 state->stage = CONNECT_SOCKET;
258 state->creq->async.private = c;
259 state->creq->async.fn = composite_handler;
266 handle and dispatch state transitions
268 static void state_handler(struct composite_context *c)
270 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
272 switch (state->stage) {
273 case CONNECT_RESOLVE:
274 c->status = connect_resolve(c, state->io);
277 c->status = connect_socket(c, state->io);
279 case CONNECT_SESSION_REQUEST:
280 c->status = connect_session_request(c, state->io);
282 case CONNECT_NEGPROT:
283 c->status = connect_negprot(c, state->io);
285 case CONNECT_SESSION_SETUP:
286 c->status = connect_session_setup(c, state->io);
289 c->status = connect_tcon(c, state->io);
293 if (!NT_STATUS_IS_OK(c->status)) {
294 c->state = SMBCLI_REQUEST_ERROR;
297 if (c->state >= SMBCLI_REQUEST_DONE &&
305 handler for completion of a smbcli_request sub-request
307 static void request_handler(struct smbcli_request *req)
309 struct composite_context *c = talloc_get_type(req->async.private,
310 struct composite_context);
315 handler for completion of a smbcli_composite sub-request
317 static void composite_handler(struct composite_context *req)
319 struct composite_context *c = talloc_get_type(req->async.private,
320 struct composite_context);
325 a function to establish a smbcli_tree from scratch
327 struct composite_context *smb_composite_connect_send(struct smb_composite_connect *io,
328 struct event_context *event_ctx)
330 struct composite_context *c;
331 struct connect_state *state;
332 struct nbt_name name;
334 c = talloc_zero(NULL, struct composite_context);
335 if (c == NULL) goto failed;
337 state = talloc(c, struct connect_state);
338 if (state == NULL) goto failed;
340 state->sock = smbcli_sock_init(state, event_ctx);
341 if (state->sock == NULL) goto failed;
345 c->state = SMBCLI_REQUEST_SEND;
346 c->event_ctx = talloc_reference(c, state->sock->event.ctx);
349 /* if the destination is an IP address, then skip the name resolution part */
350 if (is_ipaddress(io->in.dest_host)) {
351 state->stage = CONNECT_SOCKET;
352 state->creq = smbcli_sock_connect_send(state->sock, io->in.dest_host,
356 state->stage = CONNECT_RESOLVE;
357 make_nbt_name_server(&name, io->in.dest_host);
358 state->creq = resolve_name_send(&name, c->event_ctx, lp_name_resolve_order());
361 if (state->creq == NULL) goto failed;
362 state->creq->async.private = c;
363 state->creq->async.fn = composite_handler;
372 recv half of async composite connect code
374 NTSTATUS smb_composite_connect_recv(struct composite_context *c, TALLOC_CTX *mem_ctx)
378 status = composite_wait(c);
380 if (NT_STATUS_IS_OK(status)) {
381 struct connect_state *state = talloc_get_type(c->private, struct connect_state);
382 talloc_steal(mem_ctx, state->io->out.tree);
390 sync version of smb_composite_connect
392 NTSTATUS smb_composite_connect(struct smb_composite_connect *io, TALLOC_CTX *mem_ctx,
393 struct event_context *ev)
395 struct composite_context *c = smb_composite_connect_send(io, ev);
396 return smb_composite_connect_recv(c, mem_ctx);