2 Unix SMB/CIFS implementation.
3 SMB transaction2 handling
4 Copyright (C) Jeremy Allison 1994-2002.
6 Extensively modified by Andrew Tridgell, 1995
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.
26 /* Define the structures needed for the trans2 calls. */
28 /*******************************************************
29 For DosFindFirst/DosFindNext - level 1
37 typedef struct _FILEFINDBUF {
38 Byte offset Type name description
39 -------------+-------+-------------------+--------------
40 0 FDATE fdateCreation;
41 2 FTIME ftimeCreation;
42 4 FDATE fdateLastAccess;
43 6 FTIME ftimeLastAccess;
44 8 FDATE fdateLastWrite;
45 10 FTIME ftimeLastWrite;
46 12 ULONG cbFile file length in bytes
47 16 ULONG cbFileAlloc size of file allocation unit
49 22 UCHAR cchName length of name to follow (not including zero)
50 23 UCHAR achName[MAXFILENAMELEN]; Null terminated name
52 *********************************************************/
54 #define l1_fdateCreation 0
55 #define l1_fdateLastAccess 4
56 #define l1_fdateLastWrite 8
58 #define l1_cbFileAlloc 16
59 #define l1_attrFile 20
63 /**********************************************************
64 For DosFindFirst/DosFindNext - level 2
66 typedef struct _FILEFINDBUF2 {
67 Byte offset Type name description
68 -------------+-------+-------------------+--------------
69 0 FDATE fdateCreation;
70 2 FTIME ftimeCreation;
71 4 FDATE fdateLastAccess;
72 6 FTIME ftimeLastAccess;
73 8 FDATE fdateLastWrite;
74 10 FTIME ftimeLastWrite;
75 12 ULONG cbFile file length in bytes
76 16 ULONG cbFileAlloc size of file allocation unit
78 22 ULONG cbList Extended attribute list (always 0)
79 26 UCHAR cchName length of name to follow (not including zero)
80 27 UCHAR achName[MAXFILENAMELEN]; Null terminated name
82 *************************************************************/
84 #define l2_fdateCreation 0
85 #define l2_fdateLastAccess 4
86 #define l2_fdateLastWrite 8
88 #define l2_cbFileAlloc 16
89 #define l2_attrFile 20
95 /**********************************************************
96 For DosFindFirst/DosFindNext - level 260
98 typedef struct _FILEFINDBUF260 {
99 Byte offset Type name description
100 -------------+-------+-------------------+--------------
101 0 ULONG NextEntryOffset;
103 8 LARGE_INTEGER CreationTime;
104 16 LARGE_INTEGER LastAccessTime;
105 24 LARGE_INTEGER LastWriteTime;
106 32 LARGE_INTEGER ChangeTime;
107 40 LARGE_INTEGER EndOfFile;
108 48 LARGE_INTEGER AllocationSize;
109 56 ULONG FileAttributes;
110 60 ULONG FileNameLength;
112 68 CHAR ShortNameLength;
113 70 UNICODE ShortName[12];
114 94 UNICODE FileName[];
115 *************************************************************/
117 #define l260_achName 94
120 /**********************************************************
121 For DosQueryPathInfo/DosQueryFileInfo/DosSetPathInfo/
122 DosSetFileInfo - level 1
124 typedef struct _FILESTATUS {
125 Byte offset Type name description
126 -------------+-------+-------------------+--------------
127 0 FDATE fdateCreation;
128 2 FTIME ftimeCreation;
129 4 FDATE fdateLastAccess;
130 6 FTIME ftimeLastAccess;
131 8 FDATE fdateLastWrite;
132 10 FTIME ftimeLastWrite;
133 12 ULONG cbFile file length in bytes
134 16 ULONG cbFileAlloc size of file allocation unit
137 *************************************************************/
139 /* Use the l1_ defines from DosFindFirst */
141 /**********************************************************
142 For DosQueryPathInfo/DosQueryFileInfo/DosSetPathInfo/
143 DosSetFileInfo - level 2
145 typedef struct _FILESTATUS2 {
146 Byte offset Type name description
147 -------------+-------+-------------------+--------------
148 0 FDATE fdateCreation;
149 2 FTIME ftimeCreation;
150 4 FDATE fdateLastAccess;
151 6 FTIME ftimeLastAccess;
152 8 FDATE fdateLastWrite;
153 10 FTIME ftimeLastWrite;
154 12 ULONG cbFile file length in bytes
155 16 ULONG cbFileAlloc size of file allocation unit
157 22 ULONG cbList Length of EA's (0)
159 *************************************************************/
161 /* Use the l2_ #defines from DosFindFirst */
163 /**********************************************************
164 For DosQFSInfo/DosSetFSInfo - level 1
166 typedef struct _FSALLOCATE {
167 Byte offset Type name description
168 -------------+-------+-------------------+--------------
169 0 ULONG idFileSystem id of file system
170 4 ULONG cSectorUnit number of sectors per allocation unit
171 8 ULONG cUnit number of allocation units
172 12 ULONG cUnitAvail Available allocation units
173 16 USHORT cbSector bytes per sector
175 *************************************************************/
177 #define l1_idFileSystem 0
178 #define l1_cSectorUnit 4
180 #define l1_cUnitAvail 12
181 #define l1_cbSector 16
183 /**********************************************************
184 For DosQFSInfo/DosSetFSInfo - level 2
186 typedef struct _FSINFO {
187 Byte offset Type name description
188 -------------+-------+-------------------+--------------
189 0 FDATE vol_fdateCreation
190 2 FTIME vol_ftimeCreation
191 4 UCHAR vol_cch length of volume name (excluding NULL)
192 5 UCHAR vol_szVolLabel[12] volume name
194 *************************************************************/
196 #define SMB_INFO_STANDARD 1
197 #define SMB_INFO_QUERY_EA_SIZE 2
198 #define SMB_INFO_QUERY_EAS_FROM_LIST 3
199 #define SMB_INFO_QUERY_ALL_EAS 4
200 #define SMB_INFO_IS_NAME_VALID 6
201 #define SMB_QUERY_FS_LABEL_INFO 0x101
202 #define SMB_QUERY_FS_VOLUME_INFO 0x102
203 #define SMB_QUERY_FS_SIZE_INFO 0x103
204 #define SMB_QUERY_FS_DEVICE_INFO 0x104
205 #define SMB_QUERY_FS_ATTRIBUTE_INFO 0x105
208 #define l2_vol_fdateCreation 0
210 #define l2_vol_szVolLabel 5
213 #define SMB_QUERY_FILE_BASIC_INFO 0x101
214 #define SMB_QUERY_FILE_STANDARD_INFO 0x102
215 #define SMB_QUERY_FILE_EA_INFO 0x103
216 #define SMB_QUERY_FILE_NAME_INFO 0x104
217 #define SMB_QUERY_FILE_ALLOCATION_INFO 0x105
218 #define SMB_QUERY_FILE_END_OF_FILEINFO 0x106
219 #define SMB_QUERY_FILE_ALL_INFO 0x107
220 #define SMB_QUERY_FILE_ALT_NAME_INFO 0x108
221 #define SMB_QUERY_FILE_STREAM_INFO 0x109
223 #define SMB_FIND_FILE_DIRECTORY_INFO 0x101
224 #define SMB_FIND_FILE_FULL_DIRECTORY_INFO 0x102
225 #define SMB_FIND_FILE_NAMES_INFO 0x103
226 #define SMB_FIND_FILE_BOTH_DIRECTORY_INFO 0x104
228 #define SMB_SET_FILE_BASIC_INFO 0x101
229 #define SMB_SET_FILE_DISPOSITION_INFO 0x102
230 #define SMB_SET_FILE_ALLOCATION_INFO 0x103
231 #define SMB_SET_FILE_END_OF_FILE_INFO 0x104
234 * Thursby MAC extensions....
238 * MAC CIFS Extensions have the range 0x300 - 0x2FF reserved.
239 * Supposedly Microsoft have agreed to this.
242 #define MIN_MAC_INFO_LEVEL 0x300
243 #define MAX_MAC_INFO_LEVEL 0x3FF
245 #define SMB_MAC_QUERY_FS_INFO 0x301
247 #define DIRLEN_GUESS (45+MAX(l1_achName,l2_achName))
250 * DeviceType and Characteristics returned in a
251 * SMB_QUERY_FS_DEVICE_INFO call.
254 #define DEVICETYPE_CD_ROM 0x2
255 #define DEVICETYPE_CD_ROM_FILE_SYSTEM 0x3
256 #define DEVICETYPE_DISK 0x7
257 #define DEVICETYPE_DISK_FILE_SYSTEM 0x8
258 #define DEVICETYPE_FILE_SYSTEM 0x9
260 /* Characteristics. */
261 #define TYPE_REMOVABLE_MEDIA 0x1
262 #define TYPE_READ_ONLY_DEVICE 0x2
263 #define TYPE_FLOPPY 0x4
264 #define TYPE_WORM 0x8
265 #define TYPE_REMOTE 0x10
266 #define TYPE_MOUNTED 0x20
267 #define TYPE_VIRTUAL 0x40
269 /* NT passthrough levels... */
271 #define SMB_FILE_DIRECTORY_INFORMATION 1001
272 #define SMB_FILE_FULL_DIRECTORY_INFORMATION 1002
273 #define SMB_FILE_BOTH_DIRECTORY_INFORMATION 1003
274 #define SMB_FILE_BASIC_INFORMATION 1004
275 #define SMB_FILE_STANDARD_INFORMATION 1005
276 #define SMB_FILE_INTERNAL_INFORMATION 1006
277 #define SMB_FILE_EA_INFORMATION 1007
278 #define SMB_FILE_ACCESS_INFORMATION 1008
279 #define SMB_FILE_NAME_INFORMATION 1009
280 #define SMB_FILE_RENAME_INFORMATION 1010
281 #define SMB_FILE_LINK_INFORMATION 1011
282 #define SMB_FILE_NAMES_INFORMATION 1012
283 #define SMB_FILE_DISPOSITION_INFORMATION 1013
284 #define SMB_FILE_POSITION_INFORMATION 1014
285 #define SMB_FILE_FULL_EA_INFORMATION 1015
286 #define SMB_FILE_MODE_INFORMATION 1016
287 #define SMB_FILE_ALIGNMENT_INFORMATION 1017
288 #define SMB_FILE_ALL_INFORMATION 1018
289 #define SMB_FILE_ALLOCATION_INFORMATION 1019
290 #define SMB_FILE_END_OF_FILE_INFORMATION 1020
291 #define SMB_FILE_ALTERNATE_NAME_INFORMATION 1021
292 #define SMB_FILE_STREAM_INFORMATION 1022
293 #define SMB_FILE_PIPE_INFORMATION 1023
294 #define SMB_FILE_PIPE_LOCAL_INFORMATION 1024
295 #define SMB_FILE_PIPE_REMOTE_INFORMATION 1025
296 #define SMB_FILE_MAILSLOT_QUERY_INFORMATION 1026
297 #define SMB_FILE_MAILSLOT_SET_INFORMATION 1027
298 #define SMB_FILE_COMPRESSION_INFORMATION 1028
299 #define SMB_FILE_OBJECTID_INFORMATION 1029
300 #define SMB_FILE_COMPLETION_INFORMATION 1030
301 #define SMB_FILE_MOVE_CLUSTER_INFORMATION 1031
302 #define SMB_FILE_QUOTA_INFORMATION 1032
303 #define SMB_FILE_REPARSEPOINT_INFORMATION 1033
304 #define SMB_FILE_NETWORK_OPEN_INFORMATION 1034
305 #define SMB_FILE_ATTRIBUTE_TAG_INFORMATION 1035
306 #define SMB_FILE_TRACKING_INFORMATION 1036
307 #define SMB_FILE_MAXIMUM_INFORMATION 1037
309 /* NT passthough levels for qfsinfo. */
311 #define SMB_FS_VOLUME_INFORMATION 1001
312 #define SMB_FS_LABEL_INFORMATION 1002
313 #define SMB_FS_SIZE_INFORMATION 1003
314 #define SMB_FS_DEVICE_INFORMATION 1004
315 #define SMB_FS_ATTRIBUTE_INFORMATION 1005
316 #define SMB_FS_CONTROL_INFORMATION 1006
317 #define SMB_FS_FULL_SIZE_INFORMATION 1007
318 #define SMB_FS_OBJECTID_INFORMATION 1008
320 /* UNIX CIFS Extensions - created by HP */
322 * UNIX CIFS Extensions have the range 0x200 - 0x2FF reserved.
323 * Supposedly Microsoft have agreed to this.
326 #define MIN_UNIX_INFO_LEVEL 0x200
327 #define MAX_UNIX_INFO_LEVEL 0x2FF
329 #define INFO_LEVEL_IS_UNIX(level) (((level) >= MIN_UNIX_INFO_LEVEL) && ((level) <= MAX_UNIX_INFO_LEVEL))
331 #define SMB_QUERY_FILE_UNIX_BASIC 0x200 /* UNIX File Info*/
332 #define SMB_SET_FILE_UNIX_BASIC 0x200
334 #define SMB_MODE_NO_CHANGE 0xFFFFFFFF /* file mode value which */
335 /* means "don't change it" */
336 #define SMB_UID_NO_CHANGE 0xFFFFFFFF
337 #define SMB_GID_NO_CHANGE 0xFFFFFFFF
341 0 LARGE_INTEGER EndOfFile File size
342 8 LARGE_INTEGER Blocks Number of bytes used on disk (st_blocks).
343 16 LARGE_INTEGER CreationTime Creation time
344 24 LARGE_INTEGER LastAccessTime Last access time
345 32 LARGE_INTEGER LastModificationTime Last modification time
346 40 LARGE_INTEGER Uid Numeric user id for the owner
347 48 LARGE_INTEGER Gid Numeric group id of owner
348 56 ULONG Type Enumeration specifying the pathname type:
352 3 -- Character device
354 5 -- FIFO (named pipe)
355 6 -- Unix domain socket
357 60 LARGE_INTEGER devmajor Major device number if type is device
358 68 LARGE_INTEGER devminor Minor device number if type is device
359 76 LARGE_INTEGER uniqueid This is a server-assigned unique id for the file. The client
360 will typically map this onto an inode number. The scope of
361 uniqueness is the share.
362 84 LARGE_INTEGER permissions Standard UNIX file permissions - see below.
363 92 LARGE_INTEGER nlinks The number of directory entries that map to this entry
364 (number of hard links)
369 /* UNIX filetype mappings. */
371 #define UNIX_TYPE_FILE 0
372 #define UNIX_TYPE_DIR 1
373 #define UNIX_TYPE_SYMLINK 2
374 #define UNIX_TYPE_CHARDEV 3
375 #define UNIX_TYPE_BLKDEV 4
376 #define UNIX_TYPE_FIFO 5
377 #define UNIX_TYPE_SOCKET 6
378 #define UNIX_TYPE_UNKNOWN 0xFFFFFFFF
381 * Oh this is fun. "Standard UNIX permissions" has no
382 * meaning in POSIX. We need to define the mapping onto
383 * and off the wire as this was not done in the original HP
387 #define UNIX_X_OTH 0000001
388 #define UNIX_W_OTH 0000002
389 #define UNIX_R_OTH 0000004
390 #define UNIX_X_GRP 0000010
391 #define UNIX_W_GRP 0000020
392 #define UNIX_R_GRP 0000040
393 #define UNIX_X_USR 0000100
394 #define UNIX_W_USR 0000200
395 #define UNIX_R_USR 0000400
396 #define UNIX_STICKY 0001000
397 #define UNIX_SET_GID 0002000
398 #define UNIX_SET_UID 0004000
400 /* Masks for the above */
401 #define UNIX_OTH_MASK 0000007
402 #define UNIX_GRP_MASK 0000070
403 #define UNIX_USR_MASK 0000700
404 #define UNIX_PERM_MASK 0000777
405 #define UNIX_EXTRA_MASK 0007000
406 #define UNIX_ALL_MASK 0007777
408 #define SMB_QUERY_FILE_UNIX_LINK 0x201
409 #define SMB_SET_FILE_UNIX_LINK 0x201
410 #define SMB_SET_FILE_UNIX_HLINK 0x203
412 #define SMB_FIND_FILE_UNIX 0x202
415 Info level for QVOLINFO - returns version of CIFS UNIX extensions, plus
416 64-bits worth of capability fun :-).
419 #define SMB_CIFS_UNIX_QUERY_INFO 0x200
421 /* Returns the following.
423 UINT16 major version number
424 UINT16 minor version number
425 LARGE_INTEGER capability bitfield
429 #define CIFS_UNIX_MAJOR_VERSION 1
430 #define CIFS_UNIX_MINOR_VERSION 0
432 #define CIFS_UNIX_FCNTL_LOCKS_CAP 0x1
433 #define CIFS_UNIX_POSIX_ACLS_CAP 0x2
435 /* ... more as we think of them :-). */