ldb: Build and install python modules when possible.
[samba-svnmirror.git] / source / libcli / cliconnect.c
1 /*
2    Unix SMB/CIFS implementation.
3
4    client connect/disconnect routines
5
6    Copyright (C) Andrew Tridgell 2003-2005
7    Copyright (C) James Peach 2005
8
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 3 of the License, or
12    (at your option) any later version.
13
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with this program.  If not, see <http://www.gnu.org/licenses/>.
21 */
22
23 #include "includes.h"
24 #include "libcli/libcli.h"
25 #include "libcli/raw/libcliraw.h"
26 #include "libcli/auth/libcli_auth.h"
27 #include "libcli/smb_composite/smb_composite.h"
28 #include "param/param.h"
29
30 /*
31   wrapper around smbcli_sock_connect()
32 */
33 bool smbcli_socket_connect(struct smbcli_state *cli, const char *server, 
34                            const char **ports, 
35                            struct resolve_context *resolve_ctx,
36                            struct smbcli_options *options)
37 {
38         struct smbcli_socket *sock;
39
40         sock = smbcli_sock_connect_byname(server, ports, NULL, resolve_ctx, 
41                                           NULL);
42
43         if (sock == NULL) return false;
44         
45         cli->transport = smbcli_transport_init(sock, cli, true, options);
46         if (!cli->transport) {
47                 return false;
48         }
49
50         return true;
51 }
52
53 /* wrapper around smbcli_transport_connect() */
54 bool smbcli_transport_establish(struct smbcli_state *cli, 
55                                 struct nbt_name *calling,
56                                 struct nbt_name *called)
57 {
58         return smbcli_transport_connect(cli->transport, calling, called);
59 }
60
61 /* wrapper around smb_raw_negotiate() */
62 NTSTATUS smbcli_negprot(struct smbcli_state *cli, bool unicode, int maxprotocol)
63 {
64         return smb_raw_negotiate(cli->transport, unicode, maxprotocol);
65 }
66
67 /* wrapper around smb_raw_sesssetup() */
68 NTSTATUS smbcli_session_setup(struct smbcli_state *cli, 
69                               struct cli_credentials *credentials,
70                               const char *workgroup)
71 {
72         struct smb_composite_sesssetup setup;
73         NTSTATUS status;
74
75         cli->session = smbcli_session_init(cli->transport, cli, true);
76         if (!cli->session) return NT_STATUS_UNSUCCESSFUL;
77
78         setup.in.sesskey = cli->transport->negotiate.sesskey;
79         setup.in.capabilities = cli->transport->negotiate.capabilities;
80         setup.in.credentials = credentials;
81         setup.in.workgroup = workgroup;
82
83         status = smb_composite_sesssetup(cli->session, &setup);
84
85         cli->session->vuid = setup.out.vuid;
86
87         return status;
88 }
89
90 /* wrapper around smb_raw_tcon() */
91 NTSTATUS smbcli_tconX(struct smbcli_state *cli, const char *sharename, 
92                       const char *devtype, const char *password)
93 {
94         union smb_tcon tcon;
95         TALLOC_CTX *mem_ctx;
96         NTSTATUS status;
97
98         cli->tree = smbcli_tree_init(cli->session, cli, true);
99         if (!cli->tree) return NT_STATUS_UNSUCCESSFUL;
100
101         mem_ctx = talloc_init("tcon");
102         if (!mem_ctx) {
103                 return NT_STATUS_NO_MEMORY;
104         }
105
106         /* setup a tree connect */
107         tcon.generic.level = RAW_TCON_TCONX;
108         tcon.tconx.in.flags = 0;
109         if (cli->transport->negotiate.sec_mode & NEGOTIATE_SECURITY_USER_LEVEL) {
110                 tcon.tconx.in.password = data_blob(NULL, 0);
111         } else if (cli->transport->negotiate.sec_mode & NEGOTIATE_SECURITY_CHALLENGE_RESPONSE) {
112                 tcon.tconx.in.password = data_blob_talloc(mem_ctx, NULL, 24);
113                 if (cli->transport->negotiate.secblob.length < 8) {
114                         return NT_STATUS_INVALID_PARAMETER;
115                 }
116                 SMBencrypt(password, cli->transport->negotiate.secblob.data, tcon.tconx.in.password.data);
117         } else {
118                 tcon.tconx.in.password = data_blob_talloc(mem_ctx, password, strlen(password)+1);
119         }
120         tcon.tconx.in.path = sharename;
121         tcon.tconx.in.device = devtype;
122         
123         status = smb_raw_tcon(cli->tree, mem_ctx, &tcon);
124
125         cli->tree->tid = tcon.tconx.out.tid;
126
127         talloc_free(mem_ctx);
128
129         return status;
130 }
131
132
133 /*
134   easy way to get to a fully connected smbcli_state in one call
135 */
136 NTSTATUS smbcli_full_connection(TALLOC_CTX *parent_ctx,
137                                 struct smbcli_state **ret_cli, 
138                                 const char *host,
139                                 const char **ports,
140                                 const char *sharename,
141                                 const char *devtype,
142                                 struct cli_credentials *credentials,
143                                 struct resolve_context *resolve_ctx,
144                                 struct event_context *ev,
145                                 struct smbcli_options *options)
146 {
147         struct smbcli_tree *tree;
148         NTSTATUS status;
149
150         *ret_cli = NULL;
151
152         status = smbcli_tree_full_connection(parent_ctx,
153                                              &tree, host, ports, 
154                                              sharename, devtype,
155                                              credentials, resolve_ctx, ev,
156                                              options);
157         if (!NT_STATUS_IS_OK(status)) {
158                 goto done;
159         }
160
161         (*ret_cli) = smbcli_state_init(parent_ctx);
162
163         (*ret_cli)->tree = tree;
164         (*ret_cli)->session = tree->session;
165         (*ret_cli)->transport = tree->session->transport;
166
167         talloc_steal(*ret_cli, tree);
168         
169 done:
170         return status;
171 }
172
173
174 /*
175   disconnect the tree
176 */
177 NTSTATUS smbcli_tdis(struct smbcli_state *cli)
178 {
179         return smb_tree_disconnect(cli->tree);
180 }
181
182 /****************************************************************************
183  Initialise a client state structure.
184 ****************************************************************************/
185 struct smbcli_state *smbcli_state_init(TALLOC_CTX *mem_ctx)
186 {
187         return talloc_zero(mem_ctx, struct smbcli_state);
188 }
189
190 /* Insert a NULL at the first separator of the given path and return a pointer
191  * to the remainder of the string.
192  */
193 static char *
194 terminate_path_at_separator(char * path)
195 {
196         char * p;
197
198         if (!path) {
199                 return NULL;
200         }
201
202         if ((p = strchr_m(path, '/'))) {
203                 *p = '\0';
204                 return p + 1;
205         }
206
207         if ((p = strchr_m(path, '\\'))) {
208                 *p = '\0';
209                 return p + 1;
210         }
211         
212         /* No separator. */
213         return NULL;
214 }
215
216 /*
217   parse a //server/share type UNC name
218 */
219 bool smbcli_parse_unc(const char *unc_name, TALLOC_CTX *mem_ctx,
220                       char **hostname, char **sharename)
221 {
222         char *p;
223
224         *hostname = *sharename = NULL;
225
226         if (strncmp(unc_name, "\\\\", 2) &&
227             strncmp(unc_name, "//", 2)) {
228                 return false;
229         }
230
231         *hostname = talloc_strdup(mem_ctx, &unc_name[2]);
232         p = terminate_path_at_separator(*hostname);
233
234         if (p != NULL && *p) {
235                 *sharename = talloc_strdup(mem_ctx, p);
236                 terminate_path_at_separator(*sharename);
237         }
238
239         if (*hostname && *sharename) {
240                 return true;
241         }
242
243         talloc_free(*hostname);
244         talloc_free(*sharename);
245         *hostname = *sharename = NULL;
246         return false;
247 }
248
249
250