2 Unix SMB/CIFS implementation.
3 SMB client generic functions
4 Copyright (C) Andrew Tridgell 1994-1998
5 Copyright (C) Jeremy Allison 2007.
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.
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, see <http://www.gnu.org/licenses/>.
23 /*******************************************************************
24 Setup the word count and byte count for a client smb message.
25 ********************************************************************/
27 int cli_set_message(char *buf
,int num_words
,int num_bytes
,bool zero
)
29 if (zero
&& (num_words
|| num_bytes
)) {
30 memset(buf
+ smb_size
,'\0',num_words
*2 + num_bytes
);
32 SCVAL(buf
,smb_wct
,num_words
);
33 SSVAL(buf
,smb_vwv
+ num_words
*SIZEOFWORD
,num_bytes
);
34 smb_setlen(buf
,smb_size
+ num_words
*2 + num_bytes
- 4);
35 return (smb_size
+ num_words
*2 + num_bytes
);
38 /****************************************************************************
39 Change the timeout (in milliseconds).
40 ****************************************************************************/
42 unsigned int cli_set_timeout(struct cli_state
*cli
, unsigned int timeout
)
44 unsigned int old_timeout
= cli
->timeout
;
45 cli
->timeout
= timeout
;
49 /****************************************************************************
50 Change the port number used to call on.
51 ****************************************************************************/
53 void cli_set_port(struct cli_state
*cli
, int port
)
58 /****************************************************************************
59 convenience routine to find if we negotiated ucs2
60 ****************************************************************************/
62 bool cli_ucs2(struct cli_state
*cli
)
64 return ((cli
->capabilities
& CAP_UNICODE
) != 0);
68 /****************************************************************************
69 Read an smb from a fd ignoring all keepalive packets.
70 The timeout is in milliseconds
72 This is exactly the same as receive_smb except that it never returns
73 a session keepalive packet (just as receive_smb used to do).
74 receive_smb was changed to return keepalives as the oplock processing means this call
75 should never go into a blocking read.
76 ****************************************************************************/
78 static ssize_t
client_receive_smb(struct cli_state
*cli
, size_t maxlen
)
85 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_OK
);
87 status
= receive_smb_raw(cli
->fd
, cli
->inbuf
, cli
->bufsize
,
88 cli
->timeout
, maxlen
, &len
);
89 if (!NT_STATUS_IS_OK(status
)) {
90 DEBUG(10,("client_receive_smb failed\n"));
93 if (NT_STATUS_EQUAL(status
, NT_STATUS_END_OF_FILE
)) {
94 set_smb_read_error(&cli
->smb_rw_error
,
99 if (NT_STATUS_EQUAL(status
, NT_STATUS_IO_TIMEOUT
)) {
100 set_smb_read_error(&cli
->smb_rw_error
,
105 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_ERROR
);
110 * I don't believe len can be < 0 with NT_STATUS_OK
111 * returned above, but this check doesn't hurt. JRA.
114 if ((ssize_t
)len
< 0) {
118 /* Ignore session keepalive packets. */
119 if(CVAL(cli
->inbuf
,0) != SMBkeepalive
) {
124 if (cli_encryption_on(cli
)) {
125 NTSTATUS status
= cli_decrypt_message(cli
);
126 if (!NT_STATUS_IS_OK(status
)) {
127 DEBUG(0, ("SMB decryption failed on incoming packet! Error %s\n",
129 cli
->smb_rw_error
= SMB_READ_BAD_DECRYPT
;
134 show_msg(cli
->inbuf
);
138 /****************************************************************************
140 ****************************************************************************/
142 bool cli_receive_smb(struct cli_state
*cli
)
146 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
151 len
= client_receive_smb(cli
, 0);
154 /* it might be an oplock break request */
155 if (!(CVAL(cli
->inbuf
, smb_flg
) & FLAG_REPLY
) &&
156 CVAL(cli
->inbuf
,smb_com
) == SMBlockingX
&&
157 SVAL(cli
->inbuf
,smb_vwv6
) == 0 &&
158 SVAL(cli
->inbuf
,smb_vwv7
) == 0) {
159 if (cli
->oplock_handler
) {
160 int fnum
= SVAL(cli
->inbuf
,smb_vwv2
);
161 unsigned char level
= CVAL(cli
->inbuf
,smb_vwv3
+1);
162 if (!cli
->oplock_handler(cli
, fnum
, level
)) {
166 /* try to prevent loops */
167 SCVAL(cli
->inbuf
,smb_com
,0xFF);
172 /* If the server is not responding, note that now */
174 DEBUG(0, ("Receiving SMB: Server stopped responding\n"));
180 if (!cli_check_sign_mac(cli
, cli
->inbuf
)) {
182 * If we get a signature failure in sessionsetup, then
183 * the server sometimes just reflects the sent signature
184 * back to us. Detect this and allow the upper layer to
185 * retrieve the correct Windows error message.
187 if (CVAL(cli
->outbuf
,smb_com
) == SMBsesssetupX
&&
188 (smb_len(cli
->inbuf
) > (smb_ss_field
+ 8 - 4)) &&
189 (SVAL(cli
->inbuf
,smb_flg2
) & FLAGS2_SMB_SECURITY_SIGNATURES
) &&
190 memcmp(&cli
->outbuf
[smb_ss_field
],&cli
->inbuf
[smb_ss_field
],8) == 0 &&
194 * Reflected signature on login error.
195 * Set bad sig but don't close fd.
197 cli
->smb_rw_error
= SMB_READ_BAD_SIG
;
201 DEBUG(0, ("SMB Signature verification failed on incoming packet!\n"));
202 cli
->smb_rw_error
= SMB_READ_BAD_SIG
;
210 /****************************************************************************
211 Read the data portion of a readX smb.
212 The timeout is in milliseconds
213 ****************************************************************************/
215 ssize_t
cli_receive_smb_data(struct cli_state
*cli
, char *buffer
, size_t len
)
219 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_OK
);
221 status
= read_socket_with_timeout(
222 cli
->fd
, buffer
, len
, len
, cli
->timeout
, NULL
);
223 if (NT_STATUS_IS_OK(status
)) {
227 if (NT_STATUS_EQUAL(status
, NT_STATUS_END_OF_FILE
)) {
228 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_EOF
);
232 if (NT_STATUS_EQUAL(status
, NT_STATUS_IO_TIMEOUT
)) {
233 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_TIMEOUT
);
237 set_smb_read_error(&cli
->smb_rw_error
, SMB_READ_ERROR
);
241 static ssize_t
write_socket(int fd
, const char *buf
, size_t len
)
245 DEBUG(6,("write_socket(%d,%d)\n",fd
,(int)len
));
246 ret
= write_data(fd
,buf
,len
);
248 DEBUG(6,("write_socket(%d,%d) wrote %d\n",fd
,(int)len
,(int)ret
));
250 DEBUG(0,("write_socket: Error writing %d bytes to socket %d: ERRNO = %s\n",
251 (int)len
, fd
, strerror(errno
) ));
256 /****************************************************************************
258 ****************************************************************************/
260 bool cli_send_smb(struct cli_state
*cli
)
265 char *buf_out
= cli
->outbuf
;
266 bool enc_on
= cli_encryption_on(cli
);
268 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
272 cli_calculate_sign_mac(cli
, cli
->outbuf
);
275 NTSTATUS status
= cli_encrypt_message(cli
, cli
->outbuf
,
277 if (!NT_STATUS_IS_OK(status
)) {
280 cli
->smb_rw_error
= SMB_WRITE_ERROR
;
281 DEBUG(0,("Error in encrypting client message. Error %s\n",
282 nt_errstr(status
) ));
287 len
= smb_len(buf_out
) + 4;
289 while (nwritten
< len
) {
290 ret
= write_socket(cli
->fd
,buf_out
+nwritten
,len
- nwritten
);
293 cli_free_enc_buffer(cli
, buf_out
);
297 cli
->smb_rw_error
= SMB_WRITE_ERROR
;
298 DEBUG(0,("Error writing %d bytes to client. %d (%s)\n",
299 (int)len
,(int)ret
, strerror(errno
) ));
306 cli_free_enc_buffer(cli
, buf_out
);
309 /* Increment the mid so we can tell between responses. */
316 /****************************************************************************
317 Send a "direct" writeX smb to a fd.
318 ****************************************************************************/
320 bool cli_send_smb_direct_writeX(struct cli_state
*cli
,
324 /* First length to send is the offset to the data. */
325 size_t len
= SVAL(cli
->outbuf
,smb_vwv11
) + 4;
329 /* fd == -1 causes segfaults -- Tom (tom@ninja.nl) */
334 if (client_is_signing_on(cli
)) {
335 DEBUG(0,("cli_send_smb_large: cannot send signed packet.\n"));
339 iov
[0].iov_base
= cli
->outbuf
;
340 iov
[0].iov_len
= len
;
341 iov
[1].iov_base
= CONST_DISCARD(char *, p
);
342 iov
[1].iov_len
= extradata
;
344 nwritten
= write_data_iov(cli
->fd
, iov
, 2);
345 if (nwritten
< (len
+ extradata
)) {
348 cli
->smb_rw_error
= SMB_WRITE_ERROR
;
349 DEBUG(0,("Error writing %d bytes to client. (%s)\n",
350 (int)(len
+extradata
), strerror(errno
)));
354 /* Increment the mid so we can tell between responses. */
361 /****************************************************************************
362 Setup basics in a outgoing packet.
363 ****************************************************************************/
365 void cli_setup_packet_buf(struct cli_state
*cli
, char *buf
)
369 SIVAL(buf
,smb_rcls
,0);
370 SSVAL(buf
,smb_pid
,cli
->pid
);
371 memset(buf
+smb_pidhigh
, 0, 12);
372 SSVAL(buf
,smb_uid
,cli
->vuid
);
373 SSVAL(buf
,smb_mid
,cli
->mid
);
375 if (cli
->protocol
<= PROTOCOL_CORE
) {
379 if (cli
->case_sensitive
) {
380 SCVAL(buf
,smb_flg
,0x0);
382 /* Default setting, case insensitive. */
383 SCVAL(buf
,smb_flg
,0x8);
385 flags2
= FLAGS2_LONG_PATH_COMPONENTS
;
386 if (cli
->capabilities
& CAP_UNICODE
)
387 flags2
|= FLAGS2_UNICODE_STRINGS
;
388 if ((cli
->capabilities
& CAP_DFS
) && cli
->dfsroot
)
389 flags2
|= FLAGS2_DFS_PATHNAMES
;
390 if (cli
->capabilities
& CAP_STATUS32
)
391 flags2
|= FLAGS2_32_BIT_ERROR_CODES
;
393 flags2
|= FLAGS2_EXTENDED_SECURITY
;
394 SSVAL(buf
,smb_flg2
, flags2
);
397 void cli_setup_packet(struct cli_state
*cli
)
399 cli_setup_packet_buf(cli
, cli
->outbuf
);
402 /****************************************************************************
403 Setup the bcc length of the packet from a pointer to the end of the data.
404 ****************************************************************************/
406 void cli_setup_bcc(struct cli_state
*cli
, void *p
)
408 set_message_bcc(cli
->outbuf
, PTR_DIFF(p
, smb_buf(cli
->outbuf
)));
411 /****************************************************************************
412 Initialize Domain, user or password.
413 ****************************************************************************/
415 NTSTATUS
cli_set_domain(struct cli_state
*cli
, const char *domain
)
417 TALLOC_FREE(cli
->domain
);
418 cli
->domain
= talloc_strdup(cli
, domain
? domain
: "");
419 if (cli
->domain
== NULL
) {
420 return NT_STATUS_NO_MEMORY
;
425 NTSTATUS
cli_set_username(struct cli_state
*cli
, const char *username
)
427 TALLOC_FREE(cli
->user_name
);
428 cli
->user_name
= talloc_strdup(cli
, username
? username
: "");
429 if (cli
->user_name
== NULL
) {
430 return NT_STATUS_NO_MEMORY
;
435 NTSTATUS
cli_set_password(struct cli_state
*cli
, const char *password
)
437 TALLOC_FREE(cli
->password
);
439 /* Password can be NULL. */
441 cli
->password
= talloc_strdup(cli
, password
);
442 if (cli
->password
== NULL
) {
443 return NT_STATUS_NO_MEMORY
;
446 /* Use zero NTLMSSP hashes and session key. */
447 cli
->password
= NULL
;
453 /****************************************************************************
454 Initialise credentials of a client structure.
455 ****************************************************************************/
457 NTSTATUS
cli_init_creds(struct cli_state
*cli
, const char *username
, const char *domain
, const char *password
)
459 NTSTATUS status
= cli_set_username(cli
, username
);
460 if (!NT_STATUS_IS_OK(status
)) {
463 status
= cli_set_domain(cli
, domain
);
464 if (!NT_STATUS_IS_OK(status
)) {
467 DEBUG(10,("cli_init_creds: user %s domain %s\n", cli
->user_name
, cli
->domain
));
469 return cli_set_password(cli
, password
);
472 /****************************************************************************
473 Initialise a client structure. Always returns a talloc'ed struct.
474 Set the signing state (used from the command line).
475 ****************************************************************************/
477 struct cli_state
*cli_initialise_ex(int signing_state
)
479 struct cli_state
*cli
= NULL
;
480 bool allow_smb_signing
= false;
481 bool mandatory_signing
= false;
483 /* Check the effective uid - make sure we are not setuid */
484 if (is_setuid_root()) {
485 DEBUG(0,("libsmb based programs must *NOT* be setuid root.\n"));
489 cli
= TALLOC_ZERO_P(NULL
, struct cli_state
);
494 cli
->dfs_mountpoint
= talloc_strdup(cli
, "");
495 if (!cli
->dfs_mountpoint
) {
501 cli
->pid
= (uint16
)sys_getpid();
503 cli
->vuid
= UID_FIELD_INVALID
;
504 cli
->protocol
= PROTOCOL_NT1
;
505 cli
->timeout
= 20000; /* Timeout is in milliseconds. */
506 cli
->bufsize
= CLI_BUFFER_SIZE
+4;
507 cli
->max_xmit
= cli
->bufsize
;
508 cli
->outbuf
= (char *)SMB_MALLOC(cli
->bufsize
+SAFETY_MARGIN
);
509 cli
->inbuf
= (char *)SMB_MALLOC(cli
->bufsize
+SAFETY_MARGIN
);
510 cli
->oplock_handler
= cli_oplock_ack
;
511 cli
->case_sensitive
= false;
512 cli
->smb_rw_error
= SMB_READ_OK
;
514 cli
->use_spnego
= lp_client_use_spnego();
516 cli
->capabilities
= CAP_UNICODE
| CAP_STATUS32
| CAP_DFS
;
518 /* Set the CLI_FORCE_DOSERR environment variable to test
519 client routines using DOS errors instead of STATUS32
520 ones. This intended only as a temporary hack. */
521 if (getenv("CLI_FORCE_DOSERR"))
522 cli
->force_dos_errors
= true;
524 if (lp_client_signing()) {
525 allow_smb_signing
= true;
528 if (lp_client_signing() == Required
) {
529 mandatory_signing
= true;
532 if (signing_state
!= Undefined
) {
533 allow_smb_signing
= true;
536 if (signing_state
== false) {
537 allow_smb_signing
= false;
538 mandatory_signing
= false;
541 if (signing_state
== Required
) {
542 mandatory_signing
= true;
545 if (!cli
->outbuf
|| !cli
->inbuf
)
548 memset(cli
->outbuf
, 0, cli
->bufsize
);
549 memset(cli
->inbuf
, 0, cli
->bufsize
);
552 #if defined(DEVELOPER)
553 /* just because we over-allocate, doesn't mean it's right to use it */
554 clobber_region(FUNCTION_MACRO
, __LINE__
, cli
->outbuf
+cli
->bufsize
, SAFETY_MARGIN
);
555 clobber_region(FUNCTION_MACRO
, __LINE__
, cli
->inbuf
+cli
->bufsize
, SAFETY_MARGIN
);
558 /* initialise signing */
559 cli
->sign_info
.allow_smb_signing
= allow_smb_signing
;
560 cli
->sign_info
.mandatory_signing
= mandatory_signing
;
561 cli_null_set_signing(cli
);
563 cli
->initialised
= 1;
567 /* Clean up after malloc() error */
571 SAFE_FREE(cli
->inbuf
);
572 SAFE_FREE(cli
->outbuf
);
577 struct cli_state
*cli_initialise(void)
579 return cli_initialise_ex(Undefined
);
582 /****************************************************************************
583 Close all pipes open on this session.
584 ****************************************************************************/
586 void cli_nt_pipes_close(struct cli_state
*cli
)
588 while (cli
->pipe_list
!= NULL
) {
590 * No TALLOC_FREE here!
592 talloc_free(cli
->pipe_list
);
596 /****************************************************************************
597 Shutdown a client structure.
598 ****************************************************************************/
600 void cli_shutdown(struct cli_state
*cli
)
602 if (cli
->prev
== NULL
) {
604 * Possible head of a DFS list,
605 * shutdown all subsidiary DFS
608 struct cli_state
*p
, *next
;
610 for (p
= cli
->next
; p
; p
= next
) {
616 * We're a subsidiary connection.
617 * Just remove ourselves from the
620 DLIST_REMOVE(cli
->prev
, cli
);
623 cli_nt_pipes_close(cli
);
626 * tell our peer to free his resources. Wihtout this, when an
627 * application attempts to do a graceful shutdown and calls
628 * smbc_free_context() to clean up all connections, some connections
629 * can remain active on the peer end, until some (long) timeout period
630 * later. This tree disconnect forces the peer to clean up, since the
631 * connection will be going away.
633 * Also, do not do tree disconnect when cli->smb_rw_error is SMB_DO_NOT_DO_TDIS
634 * the only user for this so far is smbmount which passes opened connection
635 * down to kernel's smbfs module.
637 if ( (cli
->cnum
!= (uint16
)-1) && (cli
->smb_rw_error
!= SMB_DO_NOT_DO_TDIS
) ) {
641 SAFE_FREE(cli
->outbuf
);
642 SAFE_FREE(cli
->inbuf
);
644 cli_free_signing_context(cli
);
645 data_blob_free(&cli
->secblob
);
646 data_blob_free(&cli
->user_session_key
);
652 cli
->smb_rw_error
= SMB_READ_OK
;
657 /****************************************************************************
658 Set socket options on a open connection.
659 ****************************************************************************/
661 void cli_sockopt(struct cli_state
*cli
, const char *options
)
663 set_socket_options(cli
->fd
, options
);
666 /****************************************************************************
667 Set the PID to use for smb messages. Return the old pid.
668 ****************************************************************************/
670 uint16
cli_setpid(struct cli_state
*cli
, uint16 pid
)
672 uint16 ret
= cli
->pid
;
677 /****************************************************************************
678 Set the case sensitivity flag on the packets. Returns old state.
679 ****************************************************************************/
681 bool cli_set_case_sensitive(struct cli_state
*cli
, bool case_sensitive
)
683 bool ret
= cli
->case_sensitive
;
684 cli
->case_sensitive
= case_sensitive
;
688 /****************************************************************************
689 Send a keepalive packet to the server
690 ****************************************************************************/
692 bool cli_send_keepalive(struct cli_state
*cli
)
695 DEBUG(3, ("cli_send_keepalive: fd == -1\n"));
698 if (!send_keepalive(cli
->fd
)) {
701 DEBUG(0,("Error sending keepalive packet to client.\n"));
708 * @brief: Collect a echo reply
709 * @param[in] req The corresponding async request
711 * There might be more than one echo reply. This helper pulls the reply out of
712 * the data stream. If all expected replies have arrived, declare the
716 static void cli_echo_recv_helper(struct async_req
*req
)
718 struct cli_request
*cli_req
;
725 status
= cli_pull_reply(req
, &wct
, &vwv
, &num_bytes
, &bytes
);
726 if (!NT_STATUS_IS_OK(status
)) {
727 async_req_nterror(req
, status
);
731 cli_req
= talloc_get_type_abort(req
->private_data
, struct cli_request
);
733 if ((num_bytes
!= cli_req
->data
.echo
.data
.length
)
734 || (memcmp(cli_req
->data
.echo
.data
.data
, bytes
,
736 async_req_nterror(req
, NT_STATUS_INVALID_NETWORK_RESPONSE
);
740 cli_req
->data
.echo
.num_echos
-= 1;
742 if (cli_req
->data
.echo
.num_echos
== 0) {
743 client_set_trans_sign_state_off(cli_req
->cli
, cli_req
->mid
);
752 * @brief Send SMBEcho requests
753 * @param[in] mem_ctx The memory context to put the async_req on
754 * @param[in] ev The event context that will call us back
755 * @param[in] cli The connection to send the echo to
756 * @param[in] num_echos How many times do we want to get the reply?
757 * @param[in] data The data we want to get back
758 * @retval The async request
761 struct async_req
*cli_echo_send(TALLOC_CTX
*mem_ctx
, struct event_context
*ev
,
762 struct cli_state
*cli
, uint16_t num_echos
,
767 struct async_req
*result
;
768 struct cli_request
*req
;
770 SSVAL(vwv
, 0, num_echos
);
772 data_copy
= (uint8_t *)talloc_memdup(mem_ctx
, data
.data
, data
.length
);
773 if (data_copy
== NULL
) {
777 result
= cli_request_send(mem_ctx
, ev
, cli
, SMBecho
, 0, 1, vwv
, 0,
778 data
.length
, data
.data
);
779 if (result
== NULL
) {
780 TALLOC_FREE(data_copy
);
783 req
= talloc_get_type_abort(result
->private_data
, struct cli_request
);
785 client_set_trans_sign_state_on(cli
, req
->mid
);
787 req
->data
.echo
.num_echos
= num_echos
;
788 req
->data
.echo
.data
.data
= talloc_move(req
, &data_copy
);
789 req
->data
.echo
.data
.length
= data
.length
;
791 req
->recv_helper
.fn
= cli_echo_recv_helper
;
797 * Get the result out from an echo request
798 * @param[in] req The async_req from cli_echo_send
799 * @retval Did the server reply correctly?
802 NTSTATUS
cli_echo_recv(struct async_req
*req
)
804 return async_req_simple_recv_ntstatus(req
);
808 * @brief Send/Receive SMBEcho requests
809 * @param[in] mem_ctx The memory context to put the async_req on
810 * @param[in] ev The event context that will call us back
811 * @param[in] cli The connection to send the echo to
812 * @param[in] num_echos How many times do we want to get the reply?
813 * @param[in] data The data we want to get back
814 * @retval Did the server reply correctly?
817 NTSTATUS
cli_echo(struct cli_state
*cli
, uint16_t num_echos
, DATA_BLOB data
)
819 TALLOC_CTX
*frame
= talloc_stackframe();
820 struct event_context
*ev
;
821 struct async_req
*req
;
822 NTSTATUS status
= NT_STATUS_NO_MEMORY
;
824 if (cli
->fd_event
!= NULL
) {
826 * Can't use sync call while an async call is in flight
828 cli_set_error(cli
, NT_STATUS_INVALID_PARAMETER
);
832 ev
= event_context_init(frame
);
837 req
= cli_echo_send(frame
, ev
, cli
, num_echos
, data
);
842 while (req
->state
< ASYNC_REQ_DONE
) {
846 status
= cli_echo_recv(req
);
854 * Is the SMB command able to hold an AND_X successor
855 * @param[in] cmd The SMB command in question
856 * @retval Can we add a chained request after "cmd"?
858 bool is_andx_req(uint8_t cmd
)