2 Unix SMB/CIFS implementation.
3 SMB client transport context management functions
4 Copyright (C) Andrew Tridgell 1994-2003
5 Copyright (C) James Myers 2003 <myersjj@samba.org>
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 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 static void smbcli_transport_process_recv(struct smbcli_transport *transport);
26 static void smbcli_transport_process_send(struct smbcli_transport *transport);
29 an event has happened on the socket
31 static void smbcli_transport_event_handler(struct event_context *ev, struct fd_event *fde,
32 time_t t, uint16_t flags)
34 struct smbcli_transport *transport = fde->private;
36 if (flags & EVENT_FD_READ) {
37 smbcli_transport_process_recv(transport);
39 if (flags & EVENT_FD_WRITE) {
40 smbcli_transport_process_send(transport);
47 static int transport_destructor(void *ptr)
49 struct smbcli_transport *transport = ptr;
51 smbcli_transport_dead(transport);
52 event_remove_fd(transport->event.ctx, transport->event.fde);
53 event_remove_timed(transport->event.ctx, transport->event.te);
54 event_context_destroy(transport->event.ctx);
59 create a transport structure based on an established socket
61 struct smbcli_transport *smbcli_transport_init(struct smbcli_socket *sock)
63 struct smbcli_transport *transport;
66 transport = talloc_p(sock, struct smbcli_transport);
67 if (!transport) return NULL;
69 ZERO_STRUCTP(transport);
71 transport->event.ctx = event_context_init(transport);
72 if (transport->event.ctx == NULL) {
73 talloc_free(transport);
77 transport->socket = talloc_reference(transport, sock);
78 transport->negotiate.protocol = PROTOCOL_NT1;
79 transport->options.use_spnego = lp_use_spnego();
80 transport->negotiate.max_xmit = ~0;
82 smbcli_init_signing(transport);
84 ZERO_STRUCT(transport->called);
87 fde.flags = EVENT_FD_READ;
88 fde.handler = smbcli_transport_event_handler;
89 fde.private = transport;
92 transport->event.fde = event_add_fd(transport->event.ctx, &fde);
94 talloc_set_destructor(transport, transport_destructor);
100 mark the transport as dead
102 void smbcli_transport_dead(struct smbcli_transport *transport)
104 smbcli_sock_dead(transport->socket);
106 /* all pending sends become errors */
107 while (transport->pending_send) {
108 struct smbcli_request *req = transport->pending_send;
109 req->state = SMBCLI_REQUEST_ERROR;
110 req->status = NT_STATUS_NET_WRITE_FAULT;
111 DLIST_REMOVE(transport->pending_send, req);
117 /* as do all pending receives */
118 while (transport->pending_recv) {
119 struct smbcli_request *req = transport->pending_recv;
120 req->state = SMBCLI_REQUEST_ERROR;
121 req->status = NT_STATUS_NET_WRITE_FAULT;
122 DLIST_REMOVE(transport->pending_recv, req);
131 enable select for write on a transport
133 static void smbcli_transport_write_enable(struct smbcli_transport *transport)
135 transport->event.fde->flags |= EVENT_FD_WRITE;
139 disable select for write on a transport
141 static void smbcli_transport_write_disable(struct smbcli_transport *transport)
143 transport->event.fde->flags &= ~EVENT_FD_WRITE;
146 /****************************************************************************
147 send a session request (if appropriate)
148 ****************************************************************************/
149 BOOL smbcli_transport_connect(struct smbcli_transport *transport,
150 struct nmb_name *calling,
151 struct nmb_name *called)
154 int len = NBT_HDR_SIZE;
155 struct smbcli_request *req;
158 transport->called = *called;
161 /* 445 doesn't have session request */
162 if (transport->socket->port == 445) {
166 /* allocate output buffer */
167 req = smbcli_request_setup_nonsmb(transport, NBT_HDR_SIZE + 2*nbt_mangled_name_len());
169 /* put in the destination name */
170 p = req->out.buffer + NBT_HDR_SIZE;
171 name_mangle(called->name, p, called->name_type);
175 p = req->out.buffer+len;
176 name_mangle(calling->name, p, calling->name_type);
179 _smb_setlen(req->out.buffer,len-4);
180 SCVAL(req->out.buffer,0,0x81);
182 if (!smbcli_request_send(req) ||
183 !smbcli_request_receive(req)) {
184 smbcli_request_destroy(req);
188 if (CVAL(req->in.buffer,0) != 0x82) {
189 transport->error.etype = ETYPE_NBT;
190 transport->error.e.nbt_error = CVAL(req->in.buffer,4);
191 smbcli_request_destroy(req);
195 smbcli_request_destroy(req);
200 /****************************************************************************
201 get next mid in sequence
202 ****************************************************************************/
203 uint16_t smbcli_transport_next_mid(struct smbcli_transport *transport)
206 struct smbcli_request *req;
208 mid = transport->next_mid;
211 /* now check to see if this mid is being used by one of the
212 pending requests. This is quite efficient because the list is
213 usually very short */
215 /* the zero mid is reserved for requests that don't have a mid */
216 if (mid == 0) mid = 1;
218 for (req=transport->pending_recv; req; req=req->next) {
219 if (req->mid == mid) {
225 transport->next_mid = mid+1;
229 static void idle_handler(struct event_context *ev,
230 struct timed_event *te, time_t t)
232 struct smbcli_transport *transport = te->private;
233 te->next_event = t + transport->idle.period;
234 transport->idle.func(transport, transport->idle.private);
238 setup the idle handler for a transport
239 the period is in seconds
241 void smbcli_transport_idle_handler(struct smbcli_transport *transport,
242 void (*idle_func)(struct smbcli_transport *, void *),
246 struct timed_event te;
247 transport->idle.func = idle_func;
248 transport->idle.private = private;
249 transport->idle.period = period;
251 if (transport->event.te != NULL) {
252 event_remove_timed(transport->event.ctx, transport->event.te);
255 te.next_event = time(NULL) + period;
256 te.handler = idle_handler;
257 te.private = transport;
258 transport->event.te = event_add_timed(transport->event.ctx, &te);
262 process some pending sends
264 static void smbcli_transport_process_send(struct smbcli_transport *transport)
266 while (transport->pending_send) {
267 struct smbcli_request *req = transport->pending_send;
269 ret = smbcli_sock_write(transport->socket, req->out.buffer, req->out.size);
271 if (errno == EAGAIN || errno == EINTR) {
274 smbcli_transport_dead(transport);
277 req->out.buffer += ret;
278 req->out.size -= ret;
279 if (req->out.size == 0) {
280 DLIST_REMOVE(transport->pending_send, req);
281 if (req->one_way_request) {
282 req->state = SMBCLI_REQUEST_DONE;
283 smbcli_request_destroy(req);
285 req->state = SMBCLI_REQUEST_RECV;
286 DLIST_ADD(transport->pending_recv, req);
291 /* we're out of requests to send, so don't wait for write
293 smbcli_transport_write_disable(transport);
297 we have a full request in our receive buffer - match it to a pending request
300 static void smbcli_transport_finish_recv(struct smbcli_transport *transport)
302 uint8_t *buffer, *hdr, *vwv;
304 uint16_t wct=0, mid = 0;
305 struct smbcli_request *req;
307 buffer = transport->recv_buffer.buffer;
308 len = transport->recv_buffer.req_size;
310 ZERO_STRUCT(transport->recv_buffer);
312 hdr = buffer+NBT_HDR_SIZE;
315 /* see if it could be an oplock break request */
316 if (handle_oplock_break(transport, len, hdr, vwv)) {
321 /* at this point we need to check for a readbraw reply, as
322 these can be any length */
323 if (transport->readbraw_pending) {
324 transport->readbraw_pending = 0;
326 /* it must match the first entry in the pending queue
327 as the client is not allowed to have outstanding
329 req = transport->pending_recv;
330 if (!req) goto error;
332 req->in.buffer = buffer;
333 talloc_steal(req, buffer);
335 req->in.allocated = req->in.size;
339 if (len >= MIN_SMB_SIZE) {
340 /* extract the mid for matching to pending requests */
341 mid = SVAL(hdr, HDR_MID);
342 wct = CVAL(hdr, HDR_WCT);
345 /* match the incoming request against the list of pending requests */
346 for (req=transport->pending_recv; req; req=req->next) {
347 if (req->mid == mid) break;
351 DEBUG(1,("Discarding unmatched reply with mid %d\n", mid));
355 /* fill in the 'in' portion of the matching request */
356 req->in.buffer = buffer;
357 talloc_steal(req, buffer);
359 req->in.allocated = req->in.size;
361 /* handle NBT session replies */
362 if (req->in.size >= 4 && req->in.buffer[0] != 0) {
363 req->status = NT_STATUS_OK;
367 /* handle non-SMB replies */
368 if (req->in.size < NBT_HDR_SIZE + MIN_SMB_SIZE) {
369 req->state = SMBCLI_REQUEST_ERROR;
373 if (req->in.size < NBT_HDR_SIZE + MIN_SMB_SIZE + VWV(wct)) {
374 DEBUG(2,("bad reply size for mid %d\n", mid));
375 req->status = NT_STATUS_UNSUCCESSFUL;
376 req->state = SMBCLI_REQUEST_ERROR;
383 if (req->in.size >= NBT_HDR_SIZE + MIN_SMB_SIZE + VWV(wct)) {
384 req->in.data = req->in.vwv + VWV(wct) + 2;
385 req->in.data_size = SVAL(req->in.vwv, VWV(wct));
386 if (req->in.size < NBT_HDR_SIZE + MIN_SMB_SIZE + VWV(wct) + req->in.data_size) {
387 DEBUG(3,("bad data size for mid %d\n", mid));
388 /* blergh - w2k3 gives a bogus data size values in some
390 req->in.data_size = req->in.size - (NBT_HDR_SIZE + MIN_SMB_SIZE + VWV(wct));
393 req->in.ptr = req->in.data;
394 req->flags2 = SVAL(req->in.hdr, HDR_FLG2);
396 if (!(req->flags2 & FLAGS2_32_BIT_ERROR_CODES)) {
397 transport->error.etype = ETYPE_DOS;
398 transport->error.e.dos.eclass = CVAL(req->in.hdr,HDR_RCLS);
399 transport->error.e.dos.ecode = SVAL(req->in.hdr,HDR_ERR);
400 req->status = dos_to_ntstatus(transport->error.e.dos.eclass,
401 transport->error.e.dos.ecode);
403 transport->error.etype = ETYPE_NT;
404 transport->error.e.nt_status = NT_STATUS(IVAL(req->in.hdr, HDR_RCLS));
405 req->status = transport->error.e.nt_status;
408 if (!smbcli_request_check_sign_mac(req)) {
409 transport->error.etype = ETYPE_SOCKET;
410 transport->error.e.socket_error = SOCKET_READ_BAD_SIG;
411 req->state = SMBCLI_REQUEST_ERROR;
416 /* if this request has an async handler then call that to
417 notify that the reply has been received. This might destroy
418 the request so it must happen last */
419 DLIST_REMOVE(transport->pending_recv, req);
420 req->state = SMBCLI_REQUEST_DONE;
428 DLIST_REMOVE(transport->pending_recv, req);
429 req->state = SMBCLI_REQUEST_ERROR;
434 process some pending receives
436 static void smbcli_transport_process_recv(struct smbcli_transport *transport)
438 /* a incoming packet goes through 2 stages - first we read the
439 4 byte header, which tells us how much more is coming. Then
441 if (transport->recv_buffer.received < NBT_HDR_SIZE) {
443 ret = smbcli_sock_read(transport->socket,
444 transport->recv_buffer.header +
445 transport->recv_buffer.received,
446 NBT_HDR_SIZE - transport->recv_buffer.received);
448 smbcli_transport_dead(transport);
452 if (errno == EINTR || errno == EAGAIN) {
455 smbcli_transport_dead(transport);
459 transport->recv_buffer.received += ret;
461 if (transport->recv_buffer.received == NBT_HDR_SIZE) {
462 /* we've got a full header */
463 transport->recv_buffer.req_size = smb_len(transport->recv_buffer.header) + NBT_HDR_SIZE;
464 transport->recv_buffer.buffer = talloc(transport,
465 NBT_HDR_SIZE+transport->recv_buffer.req_size);
466 if (transport->recv_buffer.buffer == NULL) {
467 smbcli_transport_dead(transport);
470 memcpy(transport->recv_buffer.buffer, transport->recv_buffer.header, NBT_HDR_SIZE);
474 if (transport->recv_buffer.received < transport->recv_buffer.req_size) {
476 ret = smbcli_sock_read(transport->socket,
477 transport->recv_buffer.buffer +
478 transport->recv_buffer.received,
479 transport->recv_buffer.req_size -
480 transport->recv_buffer.received);
482 if (errno == EINTR || errno == EAGAIN) {
485 smbcli_transport_dead(transport);
488 transport->recv_buffer.received += ret;
491 if (transport->recv_buffer.received != 0 &&
492 transport->recv_buffer.received == transport->recv_buffer.req_size) {
493 smbcli_transport_finish_recv(transport);
498 process some read/write requests that are pending
499 return False if the socket is dead
501 BOOL smbcli_transport_process(struct smbcli_transport *transport)
503 smbcli_transport_process_send(transport);
504 smbcli_transport_process_recv(transport);
505 if (transport->socket->fd == -1) {
514 put a request into the send queue
516 void smbcli_transport_send(struct smbcli_request *req)
518 /* check if the transport is dead */
519 if (req->transport->socket->fd == -1) {
520 req->state = SMBCLI_REQUEST_ERROR;
521 req->status = NT_STATUS_NET_WRITE_FAULT;
525 /* put it on the outgoing socket queue */
526 req->state = SMBCLI_REQUEST_SEND;
527 DLIST_ADD_END(req->transport->pending_send, req, struct smbcli_request *);
529 /* make sure we look for write events */
530 smbcli_transport_write_enable(req->transport);