xref: /illumos-gate/usr/src/uts/common/fs/smbsrv/smb_tree_connect.c (revision 45a4b79d042e642c2ed7090ec290469ccf8fc563)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2017 Nexenta Systems, Inc. All rights reserved.
24  */
25 
26 #include <smbsrv/smb_kproto.h>
27 #include <smbsrv/smb_share.h>
28 
29 static void
30 smb_tcon_puterror(smb_request_t *sr, uint32_t status)
31 {
32 
33 	switch (status) {
34 
35 	case NT_STATUS_BAD_NETWORK_NAME:
36 		/* Intentional status=0 */
37 		smbsr_error(sr, 0, ERRSRV, ERRinvnetname);
38 		break;
39 
40 	case NT_STATUS_ACCESS_DENIED:
41 		smbsr_error(sr, status, ERRSRV, ERRaccess);
42 		break;
43 
44 	case NT_STATUS_BAD_DEVICE_TYPE:
45 		smbsr_error(sr, status, ERRDOS, ERROR_BAD_DEV_TYPE);
46 		break;
47 
48 	default:
49 	case NT_STATUS_INTERNAL_ERROR:
50 		/* Intentional status=0 */
51 		smbsr_error(sr, 0, ERRSRV, ERRsrverror);
52 		break;
53 	}
54 }
55 
56 /*
57  * SmbTreeConnect: Map a share to a tree and obtain a tree-id (TID).
58  *
59  * Client Request                     Description
60  * ================================== =================================
61  *
62  * UCHAR WordCount;                   Count of parameter words = 0
63  * USHORT ByteCount;                  Count of data bytes;    min = 4
64  * UCHAR BufferFormat1;               0x04
65  * STRING Path[];                     Server name and share name
66  * UCHAR BufferFormat2;               0x04
67  * STRING Password[];                 Password
68  * UCHAR BufferFormat3;               0x04
69  * STRING Service[];                  Service name
70  *
71  * The CIFS server responds with:
72  *
73  * Server Response                  Description
74  * ================================ =================================
75  *
76  * UCHAR WordCount;                 Count of parameter words = 2
77  * USHORT MaxBufferSize;            Max size message the server handles
78  * USHORT Tid;                      Tree ID
79  * USHORT ByteCount;                Count of data bytes = 0
80  *
81  * If the negotiated dialect is MICROSOFT NETWORKS 1.03 or earlier,
82  * MaxBufferSize in the response message indicates the maximum size
83  * message that the server can handle.  The client should not generate
84  * messages, nor expect to receive responses, larger than this.  This
85  * must be constant for a given server. For newer dialects, this field
86  * is ignored.
87  */
88 smb_sdrc_t
89 smb_pre_tree_connect(smb_request_t *sr)
90 {
91 	smb_arg_tcon_t	*tcon = &sr->sr_tcon;
92 	int		rc;
93 
94 	/*
95 	 * Perhaps this should be "%A.sA" now that unicode is enabled.
96 	 */
97 	rc = smbsr_decode_data(sr, "%AAA", sr, &tcon->path,
98 	    &tcon->password, &tcon->service);
99 
100 	tcon->flags = 0;
101 	tcon->optional_support = 0;
102 
103 	DTRACE_SMB_START(op__TreeConnect, smb_request_t *, sr);
104 
105 	return ((rc == 0) ? SDRC_SUCCESS : SDRC_ERROR);
106 }
107 
108 void
109 smb_post_tree_connect(smb_request_t *sr)
110 {
111 	DTRACE_SMB_DONE(op__TreeConnect, smb_request_t *, sr);
112 }
113 
114 smb_sdrc_t
115 smb_com_tree_connect(smb_request_t *sr)
116 {
117 	uint32_t status;
118 	int rc;
119 
120 	status = smb_tree_connect(sr);
121 	if (status) {
122 		smb_tcon_puterror(sr, status);
123 		return (SDRC_ERROR);
124 	}
125 
126 	rc = smbsr_encode_result(sr, 2, 0, "bwww",
127 	    2,				/* wct */
128 	    (WORD)smb_maxbufsize,	/* MaxBufferSize */
129 	    sr->smb_tid,		/* TID */
130 	    0);				/* bcc */
131 
132 	return ((rc == 0) ? SDRC_SUCCESS : SDRC_ERROR);
133 }
134 
135 /*
136  * SmbTreeConnectX: Map a share to a tree and obtain a tree-id (TID).
137  *
138  * Client Request                     Description
139  * =================================  =================================
140  *
141  * UCHAR WordCount;                   Count of parameter words = 4
142  * UCHAR AndXCommand;                 Secondary (X) command; 0xFF = none
143  * UCHAR AndXReserved;                Reserved (must be 0)
144  * USHORT AndXOffset;                 Offset to next command WordCount
145  * USHORT Flags;                      Additional information
146  *                                    bit 0 set = disconnect Tid
147  * USHORT PasswordLength;             Length of Password[]
148  * USHORT ByteCount;                  Count of data bytes;    min = 3
149  * UCHAR Password[];                  Password
150  * STRING Path[];                     Server name and share name
151  * STRING Service[];                  Service name
152  *
153  * If the negotiated dialect is LANMAN1.0 or later, then it is a protocol
154  * violation for the client to send this message prior to a successful
155  * SMB_COM_SESSION_SETUP_ANDX, and the server ignores Password.
156  *
157  * If the negotiated dialect is prior to LANMAN1.0 and the client has not
158  * sent a successful SMB_COM_SESSION_SETUP_ANDX request when the tree
159  * connect arrives, a user level security mode server must nevertheless
160  * validate the client's credentials.
161  *
162  * Flags (prefix with TREE_CONNECT_ANDX_):
163  * ==========================  ========================================
164  * 0x0001 DISCONECT_TID        The tree specified by TID in the SMB header
165  *                             should be disconnected - disconnect errors
166  *                             should be ignored.
167  *
168  * 0x0004 EXTENDED_SIGNATURES  Client request for signing key protection.
169  *
170  * 0x0008 EXTENDED_RESPONSE    Client request for extended information.
171  *
172  * Path follows UNC style syntax (\\server\share) and indicates the name
173  * of the resource to which the client wishes to connect.
174  *
175  * Because Password may be an authentication response, it is a variable
176  * length field with the length specified by PasswordLength.   If
177  * authentication is not being used, Password should be a null terminated
178  * ASCII string with PasswordLength set to the string size including the
179  * terminating null.
180  *
181  * The server can enforce whatever policy it desires to govern share
182  * access.  Administrative privilege is required for administrative
183  * shares (C$, etc.).
184  *
185  * The Service component indicates the type of resource the client
186  * intends to access.  Valid values are:
187  *
188  * Service   Description               Earliest Dialect Allowed
189  * ========  ========================  ================================
190  *
191  * A:        disk share                PC NETWORK PROGRAM 1.0
192  * LPT1:     printer                   PC NETWORK PROGRAM 1.0
193  * IPC       named pipe                MICROSOFT NETWORKS 3.0
194  * COMM      communications device     MICROSOFT NETWORKS 3.0
195  * ?????     any type of device        MICROSOFT NETWORKS 3.0
196  *
197  * If the negotiated dialect is earlier than DOS LANMAN2.1, the response to
198  * this SMB is:
199  *
200  * Server Response                  Description
201  * ================================ ===================================
202  *
203  * UCHAR WordCount;                 Count of parameter words = 2
204  * UCHAR AndXCommand;               Secondary (X) command;  0xFF = none
205  * UCHAR AndXReserved;              Reserved (must be 0)
206  * USHORT AndXOffset;               Offset to next command WordCount
207  * USHORT ByteCount;                Count of data bytes;    min = 3
208  *
209  * If the negotiated is DOS LANMAN2.1 or later, the response to this SMB
210  * is:
211  *
212  * Server Response                  Description
213  * ================================ ===================================
214  *
215  * UCHAR WordCount;                 Count of parameter words = 3
216  * UCHAR AndXCommand;               Secondary (X) command;  0xFF = none
217  * UCHAR AndXReserved;              Reserved (must be 0)
218  * USHORT AndXOffset;               Offset to next command WordCount
219  * USHORT OptionalSupport;          Optional support bits
220  * USHORT ByteCount;                Count of data bytes;    min = 3
221  * UCHAR Service[];                 Service type connected to.  Always
222  *                                   ANSII.
223  * STRING NativeFileSystem[];       Native file system for this tree
224  *
225  * NativeFileSystem is the name of the filesystem; values to be expected
226  * include FAT, NTFS, etc.
227  *
228  * OptionalSupport:
229  * ==============================  ==========================
230  * 0x0001 SMB_SUPPORT_SEARCH_BITS  The server supports the use of Search
231  *                                 Attributes in client requests.
232  * 0x0002 SMB_SHARE_IS_IN_DFS      The share is managed by DFS.
233  * 0x000C SMB_CSC_MASK             Offline-caching mask - see CSC flags.
234  * 0x0010 SMB_UNIQUE_FILE_NAME     The server uses long names and does not
235  *                                 support short names.  Indicator for
236  *                                 clients directory/name-space caching.
237  * 0x0020 SMB_EXTENDED_SIGNATURES  The server will use signing key protection.
238  *
239  * Client-side caching (offline files):
240  * ==============================  ==========================
241  * 0x0000 SMB_CSC_CACHE_MANUAL_REINT Clients may cache files for offline use
242  *                                 but automatic file-by-file reintegration
243  *                                 is not allowed.
244  * 0x0004 SMB_CSC_CACHE_AUTO_REINT Automatic file-by-file reintegration is
245  *                                 allowed.
246  * 0x0008 SMB_CSC_CACHE_VDO        File opens do not need to be flowed.
247  * 0x000C SMB_CSC_CACHE_NONE       CSC is disabled for this share.
248  *
249  * Some servers negotiate "DOS LANMAN2.1" dialect or later and still send
250  * the "downlevel" (i.e. wordcount==2) response.  Valid AndX following
251  * commands are
252  *
253  * SMB_COM_OPEN              SMB_COM_OPEN_ANDX          SMB_COM_CREATE
254  * SMB_COM_CREATE_NEW        SMB_COM_CREATE_DIRECTORY   SMB_COM_DELETE
255  * SMB_COM_DELETE_DIRECTORY  SMB_COM_FIND               SMB_COM_COPY
256  * SMB_COM_FIND_UNIQUE       SMB_COM_RENAME
257  * SMB_COM_CHECK_DIRECTORY   SMB_COM_QUERY_INFORMATION
258  * SMB_COM_GET_PRINT_QUEUE   SMB_COM_OPEN_PRINT_FILE
259  * SMB_COM_TRANSACTION       SMB_COM_NO_ANDX_CMD
260  * SMB_COM_SET_INFORMATION   SMB_COM_NT_RENAME
261  *
262  * Errors:
263  * ERRDOS/ERRnomem
264  * ERRDOS/ERRbadpath
265  * ERRDOS/ERRinvdevice
266  * ERRSRV/ERRaccess
267  * ERRSRV/ERRbadpw
268  * ERRSRV/ERRinvnetname
269  */
270 smb_sdrc_t
271 smb_pre_tree_connect_andx(smb_request_t *sr)
272 {
273 	smb_arg_tcon_t	*tcon = &sr->sr_tcon;
274 	uint8_t		*pwbuf = NULL;
275 	uint16_t	pwlen = 0;
276 	int		rc;
277 
278 	rc = smbsr_decode_vwv(sr, "b.www", &sr->andx_com, &sr->andx_off,
279 	    &tcon->flags, &pwlen);
280 	if (rc == 0) {
281 		if (pwlen != 0)
282 			pwbuf = smb_srm_zalloc(sr, pwlen);
283 
284 		rc = smbsr_decode_data(sr, "%#cus", sr, pwlen, pwbuf,
285 		    &tcon->path, &tcon->service);
286 
287 		tcon->pwdlen = pwlen;
288 		tcon->password = (char *)pwbuf;
289 	}
290 
291 	tcon->optional_support = 0;
292 
293 	DTRACE_SMB_START(op__TreeConnectX, smb_request_t *, sr);
294 
295 	return ((rc == 0) ? SDRC_SUCCESS : SDRC_ERROR);
296 }
297 
298 void
299 smb_post_tree_connect_andx(smb_request_t *sr)
300 {
301 	DTRACE_SMB_DONE(op__TreeConnectX, smb_request_t *, sr);
302 }
303 
304 smb_sdrc_t
305 smb_com_tree_connect_andx(smb_request_t *sr)
306 {
307 	smb_arg_tcon_t	*tcon = &sr->sr_tcon;
308 	smb_tree_t	*tree;
309 	char		*service;
310 	uint32_t	status;
311 	int		rc;
312 
313 	if (tcon->flags & SMB_TCONX_DISCONECT_TID) {
314 		tree = smb_session_lookup_tree(sr->session, sr->smb_tid);
315 		if (tree != NULL) {
316 			smb_tree_disconnect(tree, B_TRUE);
317 			smb_session_cancel_requests(sr->session, tree, sr);
318 		}
319 	}
320 
321 	status = smb_tree_connect(sr);
322 	if (status) {
323 		smb_tcon_puterror(sr, status);
324 		return (SDRC_ERROR);
325 	}
326 	tree = sr->tid_tree;
327 
328 	switch (tree->t_res_type & STYPE_MASK) {
329 	case STYPE_IPC:
330 		service = "IPC";
331 		break;
332 	case STYPE_PRINTQ:
333 		service = "LPT1:";
334 		break;
335 	case STYPE_DISKTREE:
336 	default:
337 		service = "A:";
338 	}
339 
340 	if (sr->session->dialect < NT_LM_0_12) {
341 		rc = smbsr_encode_result(sr, 2, VAR_BCC, "bb.ww%ss",
342 		    (char)2,		/* wct */
343 		    sr->andx_com,
344 		    VAR_BCC,
345 		    VAR_BCC,
346 		    sr,
347 		    service,
348 		    tree->t_typename);
349 	} else if ((tcon->flags & SMB_TCONX_EXTENDED_RESPONSE) == 0) {
350 		rc = smbsr_encode_result(sr, 3, VAR_BCC, "bb.www%su",
351 		    (char)3,		/* wct */
352 		    sr->andx_com,
353 		    (short)64,
354 		    tcon->optional_support,
355 		    VAR_BCC,
356 		    sr,
357 		    service,
358 		    tree->t_typename);
359 
360 	} else {
361 		rc = smbsr_encode_result(sr, 7, VAR_BCC, "bb.wwllw%su",
362 		    (char)7,		/* wct (b) */
363 		    sr->andx_com,	/* AndXcmd (b) */
364 		    (short)72,		/* AndXoff (w) */
365 		    tcon->optional_support,	/* (w) */
366 		    tree->t_access,		/* (l) */
367 		    0,		/*    guest_access (l) */
368 		    VAR_BCC,		/* (w) */
369 		    sr,			/* (%) */
370 		    service,		/* (s) */
371 		    tree->t_typename);	/* (u) */
372 	}
373 
374 	return ((rc == 0) ? SDRC_SUCCESS : SDRC_ERROR);
375 }
376 
377 /*
378  * SmbTreeDisconnect: Disconnect a tree.
379  *
380  * Note: SDDF_SUPPRESS_UID is set for this operation, which means the sr
381  * uid_user field will not be valid on entry to these functions.  Do not
382  * use it until it is set up in smb_com_tree_disconnect() or the system
383  * will panic.
384  *
385  * Note: there are scenarios in which the client does not send a tree
386  * disconnect request, for example, when ERRbaduid is returned from
387  * SmbReadX after a user has logged off.  Any open files will remain
388  * around until the session is destroyed.
389  *
390  * Client Request                     Description
391  * ================================== =================================
392  *
393  * UCHAR WordCount;                   Count of parameter words = 0
394  * USHORT ByteCount;                  Count of data bytes = 0
395  *
396  * The resource sharing connection identified by Tid in the SMB header is
397  * logically disconnected from the server. Tid is invalidated; it will not
398  * be recognized if used by the client for subsequent requests. All locks,
399  * open files, etc. created on behalf of Tid are released.
400  *
401  * Server Response                    Description
402  * ================================== =================================
403  *
404  * UCHAR WordCount;                   Count of parameter words = 0
405  * USHORT ByteCount;                  Count of data bytes = 0
406  *
407  * Errors:
408  * ERRSRV/ERRinvnid
409  * ERRSRV/ERRbaduid
410  */
411 smb_sdrc_t
412 smb_pre_tree_disconnect(smb_request_t *sr)
413 {
414 	sr->uid_user = smb_session_lookup_uid(sr->session, sr->smb_uid);
415 	sr->tid_tree = smb_session_lookup_tree(sr->session, sr->smb_tid);
416 
417 	DTRACE_SMB_START(op__TreeDisconnect, smb_request_t *, sr);
418 	return (SDRC_SUCCESS);
419 }
420 
421 void
422 smb_post_tree_disconnect(smb_request_t *sr)
423 {
424 	DTRACE_SMB_DONE(op__TreeDisconnect, smb_request_t *, sr);
425 }
426 
427 /*
428  * SmbTreeDisconnect requires a valid UID as well as a valid TID.  Some
429  * clients logoff a user and then try to disconnect the trees connected
430  * by the user who has just been logged off, which would normally fail
431  * in the dispatch code with ERRbaduid but, unfortunately, ERRbaduid
432  * causes a problem for some of those clients.  Windows returns ERRinvnid.
433  *
434  * To prevent ERRbaduid being returned, the UID and TID are looked up here
435  * rather than prior to dispatching SmbTreeDisconnect requests.  If either
436  * the UID or the TID is invalid, ERRinvnid is returned.
437  */
438 smb_sdrc_t
439 smb_com_tree_disconnect(smb_request_t *sr)
440 {
441 	if (sr->uid_user == NULL || sr->tid_tree == NULL) {
442 		smbsr_error(sr, NT_STATUS_INVALID_HANDLE, ERRDOS, ERRinvnid);
443 		return (SDRC_ERROR);
444 	}
445 
446 	sr->user_cr = smb_user_getcred(sr->uid_user);
447 
448 	smb_tree_disconnect(sr->tid_tree, B_TRUE);
449 	smb_session_cancel_requests(sr->session, sr->tid_tree, sr);
450 
451 	if (smbsr_encode_empty_result(sr))
452 		return (SDRC_ERROR);
453 
454 	return (SDRC_SUCCESS);
455 }
456