2 Unix SMB/CIFS implementation.
4 SMB client tree context management functions
6 Copyright (C) Andrew Tridgell 1994-2005
7 Copyright (C) James Myers 2003 <myersjj@samba.org>
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 2 of the License, or
12 (at your option) any later version.
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.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 #include "libcli/raw/libcliraw.h"
26 #include "libcli/composite/composite.h"
28 #define SETUP_REQUEST_TREE(cmd, wct, buflen) do { \
29 req = smbcli_request_setup(tree, cmd, wct, buflen); \
30 if (!req) return NULL; \
33 /****************************************************************************
34 Initialize the tree context
35 ****************************************************************************/
36 struct smbcli_tree *smbcli_tree_init(struct smbcli_session *session,
37 TALLOC_CTX *parent_ctx, BOOL primary)
39 struct smbcli_tree *tree;
41 tree = talloc_zero(parent_ctx, struct smbcli_tree);
47 tree->session = talloc_steal(tree, session);
49 tree->session = talloc_reference(tree, session);
56 /****************************************************************************
57 Send a tconX (async send)
58 ****************************************************************************/
59 struct smbcli_request *smb_raw_tcon_send(struct smbcli_tree *tree,
60 union smb_tcon *parms)
62 struct smbcli_request *req = NULL;
64 switch (parms->tcon.level) {
66 SETUP_REQUEST_TREE(SMBtcon, 0, 0);
67 smbcli_req_append_ascii4(req, parms->tcon.in.service, STR_ASCII);
68 smbcli_req_append_ascii4(req, parms->tcon.in.password,STR_ASCII);
69 smbcli_req_append_ascii4(req, parms->tcon.in.dev, STR_ASCII);
73 SETUP_REQUEST_TREE(SMBtconX, 4, 0);
74 SSVAL(req->out.vwv, VWV(0), 0xFF);
75 SSVAL(req->out.vwv, VWV(1), 0);
76 SSVAL(req->out.vwv, VWV(2), parms->tconx.in.flags);
77 SSVAL(req->out.vwv, VWV(3), parms->tconx.in.password.length);
78 smbcli_req_append_blob(req, &parms->tconx.in.password);
79 smbcli_req_append_string(req, parms->tconx.in.path, STR_TERMINATE | STR_UPPER);
80 smbcli_req_append_string(req, parms->tconx.in.device, STR_TERMINATE | STR_ASCII);
84 if (!smbcli_request_send(req)) {
85 smbcli_request_destroy(req);
92 /****************************************************************************
93 Send a tconX (async recv)
94 ****************************************************************************/
95 NTSTATUS smb_raw_tcon_recv(struct smbcli_request *req, TALLOC_CTX *mem_ctx,
96 union smb_tcon *parms)
100 if (!smbcli_request_receive(req) ||
101 smbcli_request_is_error(req)) {
105 switch (parms->tcon.level) {
107 SMBCLI_CHECK_WCT(req, 2);
108 parms->tcon.out.max_xmit = SVAL(req->in.vwv, VWV(0));
109 parms->tcon.out.tid = SVAL(req->in.vwv, VWV(1));
113 ZERO_STRUCT(parms->tconx.out);
114 parms->tconx.out.tid = SVAL(req->in.hdr, HDR_TID);
115 if (req->in.wct >= 4) {
116 parms->tconx.out.options = SVAL(req->in.vwv, VWV(3));
119 /* output is actual service name */
123 p += smbcli_req_pull_string(req, mem_ctx, &parms->tconx.out.dev_type,
124 p, -1, STR_ASCII | STR_TERMINATE);
125 p += smbcli_req_pull_string(req, mem_ctx, &parms->tconx.out.fs_type,
126 p, -1, STR_TERMINATE);
131 return smbcli_request_destroy(req);
134 /****************************************************************************
135 Send a tconX (sync interface)
136 ****************************************************************************/
137 NTSTATUS smb_raw_tcon(struct smbcli_tree *tree, TALLOC_CTX *mem_ctx,
138 union smb_tcon *parms)
140 struct smbcli_request *req = smb_raw_tcon_send(tree, parms);
141 return smb_raw_tcon_recv(req, mem_ctx, parms);
145 /****************************************************************************
146 Send a tree disconnect.
147 ****************************************************************************/
148 NTSTATUS smb_tree_disconnect(struct smbcli_tree *tree)
150 struct smbcli_request *req;
152 if (!tree) return NT_STATUS_OK;
153 req = smbcli_request_setup(tree, SMBtdis, 0, 0);
155 if (smbcli_request_send(req)) {
156 smbcli_request_receive(req);
158 return smbcli_request_destroy(req);
163 a convenient function to establish a smbcli_tree from scratch
165 NTSTATUS smbcli_tree_full_connection(TALLOC_CTX *parent_ctx,
166 struct smbcli_tree **ret_tree,
167 const char *dest_host, int port,
168 const char *service, const char *service_type,
169 struct cli_credentials *credentials,
170 struct event_context *ev)
172 struct smb_composite_connect io;
175 io.in.dest_host = dest_host;
177 io.in.called_name = strupper_talloc(parent_ctx, dest_host);
178 io.in.service = service;
179 io.in.service_type = service_type;
180 io.in.credentials = credentials;
181 io.in.workgroup = lp_workgroup();
183 status = smb_composite_connect(&io, parent_ctx, ev);
184 if (NT_STATUS_IS_OK(status)) {
185 *ret_tree = io.out.tree;