2 Unix SMB/CIFS implementation.
4 client connect/disconnect routines
6 Copyright (C) Andrew Tridgell 2003-2005
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #include "libcli/raw/libcliraw.h"
25 #include "libcli/composite/composite.h"
28 wrapper around smbcli_sock_connect()
30 BOOL smbcli_socket_connect(struct smbcli_state *cli, const char *server)
32 struct smbcli_socket *sock;
34 sock = smbcli_sock_init(cli, NULL);
35 if (!sock) return False;
37 if (!smbcli_sock_connect_byname(sock, server, 0)) {
42 cli->transport = smbcli_transport_init(sock, cli, True);
43 if (!cli->transport) {
50 /* wrapper around smbcli_transport_connect() */
51 BOOL smbcli_transport_establish(struct smbcli_state *cli,
52 struct nbt_name *calling,
53 struct nbt_name *called)
55 return smbcli_transport_connect(cli->transport, calling, called);
58 /* wrapper around smb_raw_negotiate() */
59 NTSTATUS smbcli_negprot(struct smbcli_state *cli)
61 return smb_raw_negotiate(cli->transport, lp_maxprotocol());
64 /* wrapper around smb_raw_session_setup() */
65 NTSTATUS smbcli_session_setup(struct smbcli_state *cli,
66 struct cli_credentials *credentials)
68 struct smb_composite_sesssetup setup;
72 cli->session = smbcli_session_init(cli->transport, cli, True);
73 if (!cli->session) return NT_STATUS_UNSUCCESSFUL;
75 mem_ctx = talloc_init("smbcli_session_setup");
76 if (!mem_ctx) return NT_STATUS_NO_MEMORY;
78 setup.in.sesskey = cli->transport->negotiate.sesskey;
79 setup.in.capabilities = cli->transport->negotiate.capabilities;
80 if (cli_credentials_is_anonymous(credentials)) {
81 setup.in.password = NULL;
84 setup.in.capabilities &= ~CAP_EXTENDED_SECURITY;
86 if (cli->transport->negotiate.sec_mode & NEGOTIATE_SECURITY_USER_LEVEL) {
87 setup.in.password = cli_credentials_get_password(credentials);
89 setup.in.password = NULL;
91 setup.in.user = cli_credentials_get_username(credentials);
92 setup.in.domain = cli_credentials_get_domain(credentials);
95 status = smb_composite_sesssetup(cli->session, &setup);
97 cli->session->vuid = setup.out.vuid;
104 /* wrapper around smb_tree_connect() */
105 NTSTATUS smbcli_send_tconX(struct smbcli_state *cli, const char *sharename,
106 const char *devtype, const char *password)
112 cli->tree = smbcli_tree_init(cli->session, cli, True);
113 if (!cli->tree) return NT_STATUS_UNSUCCESSFUL;
115 mem_ctx = talloc_init("tcon");
117 return NT_STATUS_NO_MEMORY;
120 /* setup a tree connect */
121 tcon.generic.level = RAW_TCON_TCONX;
122 tcon.tconx.in.flags = 0;
123 if (cli->transport->negotiate.sec_mode & NEGOTIATE_SECURITY_USER_LEVEL) {
124 tcon.tconx.in.password = data_blob(NULL, 0);
125 } else if (cli->transport->negotiate.sec_mode & NEGOTIATE_SECURITY_CHALLENGE_RESPONSE) {
126 tcon.tconx.in.password = data_blob_talloc(mem_ctx, NULL, 24);
127 if (cli->transport->negotiate.secblob.length < 8) {
128 return NT_STATUS_INVALID_PARAMETER;
130 SMBencrypt(password, cli->transport->negotiate.secblob.data, tcon.tconx.in.password.data);
132 tcon.tconx.in.password = data_blob_talloc(mem_ctx, password, strlen(password)+1);
134 tcon.tconx.in.path = sharename;
135 tcon.tconx.in.device = devtype;
137 status = smb_tree_connect(cli->tree, mem_ctx, &tcon);
139 cli->tree->tid = tcon.tconx.out.tid;
141 talloc_free(mem_ctx);
148 easy way to get to a fully connected smbcli_state in one call
150 NTSTATUS smbcli_full_connection(TALLOC_CTX *parent_ctx,
151 struct smbcli_state **ret_cli,
154 const char *sharename,
156 struct cli_credentials *credentials)
158 struct smbcli_tree *tree;
162 mem_ctx = talloc_init("smbcli_full_connection");
166 status = smbcli_tree_full_connection(parent_ctx,
167 &tree, myname, host, 0, sharename, devtype,
169 if (!NT_STATUS_IS_OK(status)) {
173 (*ret_cli) = smbcli_state_init(parent_ctx);
175 (*ret_cli)->tree = tree;
176 (*ret_cli)->session = tree->session;
177 (*ret_cli)->transport = tree->session->transport;
180 talloc_free(mem_ctx);
189 NTSTATUS smbcli_tdis(struct smbcli_state *cli)
191 return smb_tree_disconnect(cli->tree);
194 /****************************************************************************
195 Initialise a client state structure.
196 ****************************************************************************/
197 struct smbcli_state *smbcli_state_init(TALLOC_CTX *mem_ctx)
199 struct smbcli_state *cli;
201 cli = talloc_zero(mem_ctx, struct smbcli_state);
209 /****************************************************************************
210 Shutdown a client structure.
211 ****************************************************************************/
212 void smbcli_shutdown(struct smbcli_state *cli)
218 parse a //server/share type UNC name
220 BOOL smbcli_parse_unc(const char *unc_name, TALLOC_CTX *mem_ctx,
221 const char **hostname, const char **sharename)
225 if (strncmp(unc_name, "\\\\", 2) &&
226 strncmp(unc_name, "//", 2)) {
230 *hostname = talloc_strdup(mem_ctx, &unc_name[2]);
231 p = strchr_m(&(*hostname)[2],'/');
233 p = strchr_m(&(*hostname)[2],'\\');
234 if (!p) return False;
237 *sharename = talloc_strdup(mem_ctx, p+1);