r21204: Add define for new QFS Info for "who am i"
[sfrench/samba-autobuild/.git] / source3 / include / trans2.h
1 /* 
2    Unix SMB/CIFS implementation.
3    SMB transaction2 handling
4    Copyright (C) Jeremy Allison 1994-2002.
5
6    Extensively modified by Andrew Tridgell, 1995
7
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.
12    
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.
17    
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.
21 */
22
23 #ifndef _TRANS2_H_
24 #define _TRANS2_H_
25
26 /* Define the structures needed for the trans2 calls. */
27
28 /*******************************************************
29  For DosFindFirst/DosFindNext - level 1
30
31 MAXFILENAMELEN = 255;
32 FDATE == uint16
33 FTIME == uint16
34 ULONG == uint32
35 USHORT == uint16
36
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
48 20            USHORT   attrFile
49 22            UCHAR    cchName              length of name to follow (not including zero)
50 23            UCHAR    achName[MAXFILENAMELEN]; Null terminated name
51 } FILEFINDBUF;
52 *********************************************************/
53
54 #define l1_fdateCreation 0
55 #define l1_fdateLastAccess 4
56 #define l1_fdateLastWrite 8
57 #define l1_cbFile 12
58 #define l1_cbFileAlloc 16
59 #define l1_attrFile 20
60 #define l1_cchName 22
61 #define l1_achName 23
62
63 /**********************************************************
64 For DosFindFirst/DosFindNext - level 2
65
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
77 20            USHORT   attrFile
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
81 } FILEFINDBUF2;
82 *************************************************************/
83
84 #define l2_fdateCreation 0
85 #define l2_fdateLastAccess 4
86 #define l2_fdateLastWrite 8
87 #define l2_cbFile 12
88 #define l2_cbFileAlloc 16
89 #define l2_attrFile 20
90 #define l2_cbList 22
91 #define l2_cchName 26
92 #define l2_achName 27
93
94
95 /**********************************************************
96 For DosFindFirst/DosFindNext - level 260
97
98 typedef struct _FILEFINDBUF260 {
99 Byte offset   Type     name                description
100 -------------+-------+-------------------+--------------
101 0              ULONG  NextEntryOffset;
102 4              ULONG  FileIndex;
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;
111 64             ULONG EaSize;
112 68             CHAR ShortNameLength;
113 70             UNICODE ShortName[12];
114 94             UNICODE FileName[];
115 *************************************************************/
116
117 #define l260_achName 94
118
119
120 /**********************************************************
121 For DosQueryPathInfo/DosQueryFileInfo/DosSetPathInfo/
122 DosSetFileInfo - level 1
123
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
135 20            USHORT   attrFile
136 } FILESTATUS;
137 *************************************************************/
138
139 /* Use the l1_ defines from DosFindFirst */
140
141 /**********************************************************
142 For DosQueryPathInfo/DosQueryFileInfo/DosSetPathInfo/
143 DosSetFileInfo - level 2
144
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
156 20            USHORT   attrFile
157 22            ULONG    cbList               Length of EA's (0)
158 } FILESTATUS2;
159 *************************************************************/
160
161 /* Use the l2_ #defines from DosFindFirst */
162
163 /**********************************************************
164 For DosQFSInfo/DosSetFSInfo - level 1
165
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
174 } FSALLOCATE;
175 *************************************************************/
176
177 #define l1_idFileSystem 0
178 #define l1_cSectorUnit 4
179 #define l1_cUnit 8
180 #define l1_cUnitAvail 12
181 #define l1_cbSector 16
182
183 /**********************************************************
184 For DosQFSInfo/DosSetFSInfo - level 2
185
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
193 } FSINFO;
194 *************************************************************/
195
196 #define SMB_INFO_STANDARD               1  /* FILESTATUS3 struct */
197 #define SMB_INFO_SET_EA                 2  /* EAOP2 struct, only valid on set not query */
198 #define SMB_INFO_QUERY_EA_SIZE          2  /* FILESTATUS4 struct, only valid on query not set */
199 #define SMB_INFO_QUERY_EAS_FROM_LIST    3  /* only valid on query not set */
200 #define SMB_INFO_QUERY_ALL_EAS          4  /* only valid on query not set */
201 #define SMB_INFO_IS_NAME_VALID          6
202 #define SMB_INFO_STANDARD_LONG          11  /* similar to level 1, ie struct FileStatus3 */
203 #define SMB_QUERY_EA_SIZE_LONG          12  /* similar to level 2, ie struct FileStatus4 */
204 #define SMB_QUERY_FS_LABEL_INFO         0x101
205 #define SMB_QUERY_FS_VOLUME_INFO        0x102
206 #define SMB_QUERY_FS_SIZE_INFO          0x103
207 #define SMB_QUERY_FS_DEVICE_INFO        0x104
208 #define SMB_QUERY_FS_ATTRIBUTE_INFO     0x105
209 #if 0
210 #define SMB_QUERY_FS_QUOTA_INFO         
211 #endif
212
213 #define l2_vol_fdateCreation 0
214 #define l2_vol_cch 4
215 #define l2_vol_szVolLabel 5
216
217
218 #define SMB_QUERY_FILE_BASIC_INFO       0x101
219 #define SMB_QUERY_FILE_STANDARD_INFO    0x102
220 #define SMB_QUERY_FILE_EA_INFO          0x103
221 #define SMB_QUERY_FILE_NAME_INFO        0x104
222 #define SMB_QUERY_FILE_ALLOCATION_INFO  0x105
223 #define SMB_QUERY_FILE_END_OF_FILEINFO  0x106
224 #define SMB_QUERY_FILE_ALL_INFO         0x107
225 #define SMB_QUERY_FILE_ALT_NAME_INFO    0x108
226 #define SMB_QUERY_FILE_STREAM_INFO      0x109
227 #define SMB_QUERY_COMPRESSION_INFO      0x10b
228
229 #define SMB_FIND_INFO_STANDARD                  1
230 #define SMB_FIND_EA_SIZE                        2
231 #define SMB_FIND_EA_LIST                        3
232 #define SMB_FIND_FILE_DIRECTORY_INFO            0x101
233 #define SMB_FIND_FILE_FULL_DIRECTORY_INFO       0x102
234 #define SMB_FIND_FILE_NAMES_INFO                0x103
235 #define SMB_FIND_FILE_BOTH_DIRECTORY_INFO       0x104
236 #define SMB_FIND_ID_FULL_DIRECTORY_INFO         0x105
237 #define SMB_FIND_ID_BOTH_DIRECTORY_INFO         0x106
238
239 #define SMB_SET_FILE_BASIC_INFO         0x101
240 #define SMB_SET_FILE_DISPOSITION_INFO   0x102
241 #define SMB_SET_FILE_ALLOCATION_INFO    0x103
242 #define SMB_SET_FILE_END_OF_FILE_INFO   0x104
243
244 /* Query FS info. */
245 #define SMB_INFO_ALLOCATION             1
246 #define SMB_INFO_VOLUME                 2
247
248 /*
249  * Thursby MAC extensions....
250  */
251
252 /*
253  * MAC CIFS Extensions have the range 0x300 - 0x2FF reserved.
254  * Supposedly Microsoft have agreed to this.
255  */
256
257 #define MIN_MAC_INFO_LEVEL 0x300
258 #define MAX_MAC_INFO_LEVEL 0x3FF
259
260 #define SMB_MAC_QUERY_FS_INFO           0x301
261
262 #define DIRLEN_GUESS (45+MAX(l1_achName,l2_achName))
263
264 /*
265  * DeviceType and Characteristics returned in a
266  * SMB_QUERY_FS_DEVICE_INFO call.
267  */
268
269 #define DEVICETYPE_CD_ROM               0x2
270 #define DEVICETYPE_CD_ROM_FILE_SYSTEM   0x3
271 #define DEVICETYPE_DISK                 0x7
272 #define DEVICETYPE_DISK_FILE_SYSTEM     0x8
273 #define DEVICETYPE_FILE_SYSTEM          0x9
274
275 /* Characteristics. */
276 #define TYPE_REMOVABLE_MEDIA            0x1
277 #define TYPE_READ_ONLY_DEVICE           0x2
278 #define TYPE_FLOPPY                     0x4
279 #define TYPE_WORM                       0x8
280 #define TYPE_REMOTE                     0x10
281 #define TYPE_MOUNTED                    0x20
282 #define TYPE_VIRTUAL                    0x40
283
284 /* NT passthrough levels... */
285
286 #define SMB_FILE_DIRECTORY_INFORMATION                  1001
287 #define SMB_FILE_FULL_DIRECTORY_INFORMATION             1002
288 #define SMB_FILE_BOTH_DIRECTORY_INFORMATION             1003
289 #define SMB_FILE_BASIC_INFORMATION                      1004
290 #define SMB_FILE_STANDARD_INFORMATION                   1005
291 #define SMB_FILE_INTERNAL_INFORMATION                   1006
292 #define SMB_FILE_EA_INFORMATION                         1007
293 #define SMB_FILE_ACCESS_INFORMATION                     1008
294 #define SMB_FILE_NAME_INFORMATION                       1009
295 #define SMB_FILE_RENAME_INFORMATION                     1010
296 #define SMB_FILE_LINK_INFORMATION                       1011
297 #define SMB_FILE_NAMES_INFORMATION                      1012
298 #define SMB_FILE_DISPOSITION_INFORMATION                1013
299 #define SMB_FILE_POSITION_INFORMATION                   1014
300 #define SMB_FILE_FULL_EA_INFORMATION                    1015
301 #define SMB_FILE_MODE_INFORMATION                       1016
302 #define SMB_FILE_ALIGNMENT_INFORMATION                  1017
303 #define SMB_FILE_ALL_INFORMATION                        1018
304 #define SMB_FILE_ALLOCATION_INFORMATION                 1019
305 #define SMB_FILE_END_OF_FILE_INFORMATION                1020
306 #define SMB_FILE_ALTERNATE_NAME_INFORMATION             1021
307 #define SMB_FILE_STREAM_INFORMATION                     1022
308 #define SMB_FILE_PIPE_INFORMATION                       1023
309 #define SMB_FILE_PIPE_LOCAL_INFORMATION                 1024
310 #define SMB_FILE_PIPE_REMOTE_INFORMATION                1025
311 #define SMB_FILE_MAILSLOT_QUERY_INFORMATION             1026
312 #define SMB_FILE_MAILSLOT_SET_INFORMATION               1027
313 #define SMB_FILE_COMPRESSION_INFORMATION                1028
314 #define SMB_FILE_OBJECTID_INFORMATION                   1029
315 #define SMB_FILE_COMPLETION_INFORMATION                 1030
316 #define SMB_FILE_MOVE_CLUSTER_INFORMATION               1031
317 #define SMB_FILE_QUOTA_INFORMATION                      1032
318 #define SMB_FILE_REPARSEPOINT_INFORMATION               1033
319 #define SMB_FILE_NETWORK_OPEN_INFORMATION               1034
320 #define SMB_FILE_ATTRIBUTE_TAG_INFORMATION              1035
321 #define SMB_FILE_TRACKING_INFORMATION                   1036
322 #define SMB_FILE_MAXIMUM_INFORMATION                    1037
323
324 /* NT passthough levels for qfsinfo. */
325
326 #define SMB_FS_VOLUME_INFORMATION                       1001
327 #define SMB_FS_LABEL_INFORMATION                        1002
328 #define SMB_FS_SIZE_INFORMATION                         1003
329 #define SMB_FS_DEVICE_INFORMATION                       1004
330 #define SMB_FS_ATTRIBUTE_INFORMATION                    1005
331 #define SMB_FS_QUOTA_INFORMATION                        1006
332 #define SMB_FS_FULL_SIZE_INFORMATION                    1007
333 #define SMB_FS_OBJECTID_INFORMATION                     1008
334
335 /* flags on trans2 findfirst/findnext that control search */
336 #define FLAG_TRANS2_FIND_CLOSE          0x1
337 #define FLAG_TRANS2_FIND_CLOSE_IF_END   0x2
338 #define FLAG_TRANS2_FIND_REQUIRE_RESUME 0x4
339 #define FLAG_TRANS2_FIND_CONTINUE       0x8
340 #define FLAG_TRANS2_FIND_BACKUP_INTENT  0x10
341
342 /* UNIX CIFS Extensions - created by HP */
343 /*
344  * UNIX CIFS Extensions have the range 0x200 - 0x2FF reserved.
345  * Supposedly Microsoft have agreed to this.
346  */
347
348 #define MIN_UNIX_INFO_LEVEL 0x200
349 #define MAX_UNIX_INFO_LEVEL 0x2FF
350
351 #define INFO_LEVEL_IS_UNIX(level) (((level) >= MIN_UNIX_INFO_LEVEL) && ((level) <= MAX_UNIX_INFO_LEVEL))
352
353 #define SMB_QUERY_FILE_UNIX_BASIC      0x200   /* UNIX File Info*/
354 #define SMB_SET_FILE_UNIX_BASIC        0x200
355
356 #define SMB_MODE_NO_CHANGE                 0xFFFFFFFF     /* file mode value which */
357                                               /* means "don't change it" */
358 #define SMB_UID_NO_CHANGE                  0xFFFFFFFF
359 #define SMB_GID_NO_CHANGE                  0xFFFFFFFF
360
361 #define SMB_SIZE_NO_CHANGE_LO              0xFFFFFFFF
362 #define SMB_SIZE_NO_CHANGE_HI              0xFFFFFFFF
363  
364 #define SMB_TIME_NO_CHANGE_LO              0xFFFFFFFF
365 #define SMB_TIME_NO_CHANGE_HI              0xFFFFFFFF
366
367 /*
368 Offset Size         Name
369 0      LARGE_INTEGER EndOfFile                File size
370 8      LARGE_INTEGER Blocks                   Number of bytes used on disk (st_blocks).
371 16     LARGE_INTEGER CreationTime             Creation time
372 24     LARGE_INTEGER LastAccessTime           Last access time
373 32     LARGE_INTEGER LastModificationTime     Last modification time
374 40     LARGE_INTEGER Uid                      Numeric user id for the owner
375 48     LARGE_INTEGER Gid                      Numeric group id of owner
376 56     ULONG Type                             Enumeration specifying the pathname type:
377                                               0 -- File
378                                               1 -- Directory
379                                               2 -- Symbolic link
380                                               3 -- Character device
381                                               4 -- Block device
382                                               5 -- FIFO (named pipe)
383                                               6 -- Unix domain socket
384
385 60     LARGE_INTEGER devmajor                 Major device number if type is device
386 68     LARGE_INTEGER devminor                 Minor device number if type is device
387 76     LARGE_INTEGER uniqueid                 This is a server-assigned unique id for the file. The client
388                                               will typically map this onto an inode number. The scope of
389                                               uniqueness is the share.
390 84     LARGE_INTEGER permissions              Standard UNIX file permissions  - see below.
391 92     LARGE_INTEGER nlinks                   The number of directory entries that map to this entry
392                                               (number of hard links)
393
394 100 - end.
395 */
396
397 /* UNIX filetype mappings. */
398
399 #define UNIX_TYPE_FILE 0
400 #define UNIX_TYPE_DIR 1
401 #define UNIX_TYPE_SYMLINK 2
402 #define UNIX_TYPE_CHARDEV 3
403 #define UNIX_TYPE_BLKDEV 4
404 #define UNIX_TYPE_FIFO 5
405 #define UNIX_TYPE_SOCKET 6
406 #define UNIX_TYPE_UNKNOWN 0xFFFFFFFF
407
408 /*
409  * Oh this is fun. "Standard UNIX permissions" has no
410  * meaning in POSIX. We need to define the mapping onto
411  * and off the wire as this was not done in the original HP
412  * spec. JRA.
413  */
414
415 #define UNIX_X_OTH                      0000001
416 #define UNIX_W_OTH                      0000002
417 #define UNIX_R_OTH                      0000004
418 #define UNIX_X_GRP                      0000010
419 #define UNIX_W_GRP                      0000020
420 #define UNIX_R_GRP                      0000040
421 #define UNIX_X_USR                      0000100
422 #define UNIX_W_USR                      0000200
423 #define UNIX_R_USR                      0000400
424 #define UNIX_STICKY                     0001000
425 #define UNIX_SET_GID                    0002000
426 #define UNIX_SET_UID                    0004000
427
428 /* Masks for the above */
429 #define UNIX_OTH_MASK                   0000007
430 #define UNIX_GRP_MASK                   0000070
431 #define UNIX_USR_MASK                   0000700
432 #define UNIX_PERM_MASK                  0000777
433 #define UNIX_EXTRA_MASK                 0007000
434 #define UNIX_ALL_MASK                   0007777
435
436 #define SMB_QUERY_FILE_UNIX_LINK       0x201
437 #define SMB_SET_FILE_UNIX_LINK         0x201
438 #define SMB_SET_FILE_UNIX_HLINK        0x203
439 /* SMB_QUERY_POSIX_ACL 0x204 see below */
440 #define SMB_QUERY_XATTR                0x205 /* need for non-user XATTRs */
441 #define SMB_QUERY_ATTR_FLAGS           0x206 /* chflags, chattr */
442 #define SMB_SET_ATTR_FLAGS             0x206 
443 #define SMB_QUERY_POSIX_PERMISSION     0x207
444 /* Only valid for qfileinfo */
445 #define SMB_QUERY_POSIX_LOCK           0x208
446 /* Only valid for setfileinfo */
447 #define SMB_SET_POSIX_LOCK             0x208
448
449 /* The set info levels for POSIX path operations. */
450 #define SMB_POSIX_PATH_OPEN            0x209
451 #define SMB_POSIX_PATH_UNLINK          0x20A
452
453 #define SMB_QUERY_FILE_UNIX_INFO2      0x20B   /* UNIX File Info2 */
454 #define SMB_SET_FILE_UNIX_INFO2        0x20B
455
456 /* Transact 2 Find First levels */
457 #define SMB_FIND_FILE_UNIX             0x202
458
459 /*
460  Info level for TRANS2_QFSINFO - returns version of CIFS UNIX extensions, plus
461  64-bits worth of capability fun :-).
462  Use the same info level for TRANS2_SETFSINFO
463 */
464
465 #define SMB_QUERY_CIFS_UNIX_INFO      0x200
466 #define SMB_SET_CIFS_UNIX_INFO        0x200
467
468 /* Returns or sets the following.
469
470   UINT16             major version number
471   UINT16             minor version number
472   LARGE_INTEGER      capability bitfield
473
474 */
475
476 #define CIFS_UNIX_MAJOR_VERSION 1
477 #define CIFS_UNIX_MINOR_VERSION 0
478
479 #define CIFS_UNIX_FCNTL_LOCKS_CAP           0x1
480 #define CIFS_UNIX_POSIX_ACLS_CAP            0x2
481 #define CIFS_UNIX_XATTTR_CAP                0x4 /* for support of other xattr
482                                                 namespaces such as system,
483                                                 security and trusted */
484 #define CIFS_UNIX_EXTATTR_CAP               0x8 /* for support of chattr
485                                                 (chflags) and lsattr */
486 #define CIFS_UNIX_POSIX_PATHNAMES_CAP      0x10 /* Use POSIX pathnames on the wire. */
487 #define CIFS_UNIX_POSIX_PATH_OPERATIONS_CAP        0x20 /* We can cope with POSIX open/mkdir/unlink etc. */
488
489
490 #define SMB_QUERY_POSIX_FS_INFO     0x201
491
492 /* Returns FILE_SYSTEM_POSIX_INFO struct as follows
493       (NB   For undefined values return -1 in that field) 
494    le32 OptimalTransferSize;    bsize on some os, iosize on other os, This 
495                                 is a hint to the client about best size. Server
496                                 can return -1 if no preference, ie if SMB 
497                                 negotiated size is adequate for optimal
498                                 read/write performance
499    le32 BlockSize; (often 512 bytes) NB: BlockSize * TotalBlocks = disk space
500    le64 TotalBlocks;  redundant with other infolevels but easy to ret here
501    le64 BlocksAvail;  although redundant, easy to return
502    le64 UserBlocksAvail;      bavail 
503    le64 TotalFileNodes;
504    le64 FreeFileNodes;
505    le64 FileSysIdentifier;    fsid 
506    (NB statfs field Namelen comes from FILE_SYSTEM_ATTRIBUTE_INFO call) 
507    (NB statfs field flags can come from FILE_SYSTEM_DEVICE_INFO call)  
508 */
509
510 #define SMB_QUERY_POSIX_WHO_AM_I  0x202 /* QFS Info */
511 /* returns:
512         __u32 flags;  0 = Authenticated user 1 = GUEST 
513         __u32 mask;  which flags bits server understands ie 0x0001 
514         __u64 unix_user_id;
515         __u64 unix_user_gid;
516         __u32 number_of_supplementary_gids;  may be zero 
517         __u32 number_of_sids;  may be zero
518         __u32 length_of_sid_array;  in bytes - may be zero 
519         __u32 pad;  reserved - MBZ 
520         __u64 gid_array[0];  may be empty 
521         __u8 * psid_list  may be empty
522 */
523
524
525 /* ... more as we think of them :-). */
526
527 /* SMB POSIX ACL definitions. */
528 /* Wire format is (all little endian) :
529
530 [2 bytes]              -     Version number.
531 [2 bytes]              -     Number of ACE entries to follow.
532 [2 bytes]              -     Number of default ACE entries to follow.
533 -------------------------------------
534 ^
535 |
536 ACE entries
537 |
538 v
539 -------------------------------------
540 ^
541 |
542 Default ACE entries
543 |
544 v
545 -------------------------------------
546
547 Where an ACE entry looks like :
548
549 [1 byte]           - Entry type.
550
551 Entry types are :
552
553 ACL_USER_OBJ            0x01
554 ACL_USER                0x02
555 ACL_GROUP_OBJ           0x04
556 ACL_GROUP               0x08
557 ACL_MASK                0x10
558 ACL_OTHER               0x20
559
560 [1 byte]          - permissions (perm_t)
561
562 perm_t types are :
563
564 ACL_READ                0x04
565 ACL_WRITE               0x02
566 ACL_EXECUTE             0x01
567
568 [8 bytes]         - uid/gid to apply this permission to.
569
570 In the same format as the uid/gid fields in the other
571 UNIX extensions definitions. Use 0xFFFFFFFFFFFFFFFF for
572 the MASK and OTHER entry types.
573
574 If the Number of ACE entries for either file or default ACE's
575 is set to 0xFFFF this means ignore this kind of ACE (and the
576 number of entries sent will be zero.
577
578 */
579
580 /* The query/set info levels for POSIX ACLs. */
581 #define SMB_QUERY_POSIX_ACL  0x204
582 #define SMB_SET_POSIX_ACL  0x204
583
584 /* Current on the wire ACL version. */
585 #define SMB_POSIX_ACL_VERSION 1
586
587 /* ACE entry type. */
588 #define SMB_POSIX_ACL_USER_OBJ            0x01
589 #define SMB_POSIX_ACL_USER                0x02
590 #define SMB_POSIX_ACL_GROUP_OBJ           0x04
591 #define SMB_POSIX_ACL_GROUP               0x08
592 #define SMB_POSIX_ACL_MASK                0x10
593 #define SMB_POSIX_ACL_OTHER               0x20
594
595 /* perm_t types. */
596 #define SMB_POSIX_ACL_READ                0x04
597 #define SMB_POSIX_ACL_WRITE               0x02
598 #define SMB_POSIX_ACL_EXECUTE             0x01
599
600 #define SMB_POSIX_ACL_HEADER_SIZE         6
601 #define SMB_POSIX_ACL_ENTRY_SIZE         10
602
603 #define SMB_POSIX_IGNORE_ACE_ENTRIES    0xFFFF
604
605 /* Definition of parameter block of SMB_SET_POSIX_LOCK */
606 /*
607   [2 bytes] lock_type - 0 = Read, 1 = Write, 2 = Unlock
608   [2 bytes] lock_flags - 1 = Wait (only valid for setlock)
609   [4 bytes] pid = locking context.
610   [8 bytes] start = unsigned 64 bits.
611   [8 bytes] length = unsigned 64 bits.
612 */
613
614 #define POSIX_LOCK_TYPE_OFFSET 0
615 #define POSIX_LOCK_FLAGS_OFFSET 2
616 #define POSIX_LOCK_PID_OFFSET 4
617 #define POSIX_LOCK_START_OFFSET 8
618 #define POSIX_LOCK_LEN_OFFSET 16
619 #define POSIX_LOCK_DATA_SIZE 24
620
621 #define POSIX_LOCK_FLAG_NOWAIT 0
622 #define POSIX_LOCK_FLAG_WAIT 1
623
624 #define POSIX_LOCK_TYPE_READ 0
625 #define POSIX_LOCK_TYPE_WRITE 1
626 #define POSIX_LOCK_TYPE_UNLOCK 2
627
628 /* SMB_POSIX_PATH_OPEN "open_mode" definitions. */
629 #define SMB_O_RDONLY                      0x1
630 #define SMB_O_WRONLY                      0x2
631 #define SMB_O_RDWR                        0x4
632
633 #define SMB_ACCMODE                       0x7
634
635 #define SMB_O_CREAT                      0x10
636 #define SMB_O_EXCL                       0x20
637 #define SMB_O_TRUNC                      0x40
638 #define SMB_O_APPEND                     0x80
639 #define SMB_O_SYNC                      0x100
640 #define SMB_O_DIRECTORY                 0x200
641 #define SMB_O_NOFOLLOW                  0x400
642 #define SMB_O_DIRECT                    0x800
643
644 /* Definition of request parameter block for SMB_POSIX_PATH_OPEN */
645 /*
646   [4 bytes] flags (as smb_ntcreate_Flags).
647   [4 bytes] open_mode
648   [4 bytes] mode_t              - same encoding as "Standard UNIX permissions" above.
649   [2 bytes] ret_info_level      - optimization. Info level to be returned.
650 */
651
652 /* Definition of reply data block for SMB_POSIX_PATH_OPEN */
653
654 #define SMB_NO_INFO_LEVEL_RETURNED 0xFFFF
655
656 /*
657   [2 bytes] reply info level    - as requested or 0xFFFF if not available.
658   [n bytes] - info level reply  - if available.
659 */
660
661 #endif