4 * Copyright (c) International Business Machines Corp., 2002,2009
5 * Author(s): Steve French (sfrench@us.ibm.com)
7 * This library is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU Lesser General Public License as published
9 * by the Free Software Foundation; either version 2.1 of the License, or
10 * (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
15 * the GNU Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public License
18 * along with this library; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 #include <asm/unaligned.h>
29 #ifdef CONFIG_CIFS_WEAK_PW_HASH
31 #define LANMAN2_PROT 1
36 #define POSIX_PROT (CIFS_PROT+1)
37 #define BAD_PROT 0xFFFF
40 * Note some commands have minimal (wct=0,bcc=0), or uninteresting, responses
41 * (ie which include no useful data other than the SMB error code itself).
42 * This can allow us to avoid response buffer allocations and copy in some cases
44 #define SMB_COM_CREATE_DIRECTORY 0x00 /* trivial response */
45 #define SMB_COM_DELETE_DIRECTORY 0x01 /* trivial response */
46 #define SMB_COM_CLOSE 0x04 /* triv req/rsp, timestamp ignored */
47 #define SMB_COM_FLUSH 0x05 /* triv req/rsp */
48 #define SMB_COM_DELETE 0x06 /* trivial response */
49 #define SMB_COM_RENAME 0x07 /* trivial response */
50 #define SMB_COM_QUERY_INFORMATION 0x08 /* aka getattr */
51 #define SMB_COM_SETATTR 0x09 /* trivial response */
52 #define SMB_COM_LOCKING_ANDX 0x24 /* trivial response */
53 #define SMB_COM_COPY 0x29 /* trivial rsp, fail filename ignrd*/
54 #define SMB_COM_ECHO 0x2B /* echo request */
55 #define SMB_COM_OPEN_ANDX 0x2D /* Legacy open for old servers */
56 #define SMB_COM_READ_ANDX 0x2E
57 #define SMB_COM_WRITE_ANDX 0x2F
58 #define SMB_COM_TRANSACTION2 0x32
59 #define SMB_COM_TRANSACTION2_SECONDARY 0x33
60 #define SMB_COM_FIND_CLOSE2 0x34 /* trivial response */
61 #define SMB_COM_TREE_DISCONNECT 0x71 /* trivial response */
62 #define SMB_COM_NEGOTIATE 0x72
63 #define SMB_COM_SESSION_SETUP_ANDX 0x73
64 #define SMB_COM_LOGOFF_ANDX 0x74 /* trivial response */
65 #define SMB_COM_TREE_CONNECT_ANDX 0x75
66 #define SMB_COM_NT_TRANSACT 0xA0
67 #define SMB_COM_NT_TRANSACT_SECONDARY 0xA1
68 #define SMB_COM_NT_CREATE_ANDX 0xA2
69 #define SMB_COM_NT_CANCEL 0xA4 /* no response */
70 #define SMB_COM_NT_RENAME 0xA5 /* trivial response */
72 /* Transact2 subcommand codes */
73 #define TRANS2_OPEN 0x00
74 #define TRANS2_FIND_FIRST 0x01
75 #define TRANS2_FIND_NEXT 0x02
76 #define TRANS2_QUERY_FS_INFORMATION 0x03
77 #define TRANS2_SET_FS_INFORMATION 0x04
78 #define TRANS2_QUERY_PATH_INFORMATION 0x05
79 #define TRANS2_SET_PATH_INFORMATION 0x06
80 #define TRANS2_QUERY_FILE_INFORMATION 0x07
81 #define TRANS2_SET_FILE_INFORMATION 0x08
82 #define TRANS2_GET_DFS_REFERRAL 0x10
83 #define TRANS2_REPORT_DFS_INCOSISTENCY 0x11
85 /* SMB Transact (Named Pipe) subcommand codes */
86 #define TRANS_SET_NMPIPE_STATE 0x0001
87 #define TRANS_RAW_READ_NMPIPE 0x0011
88 #define TRANS_QUERY_NMPIPE_STATE 0x0021
89 #define TRANS_QUERY_NMPIPE_INFO 0x0022
90 #define TRANS_PEEK_NMPIPE 0x0023
91 #define TRANS_TRANSACT_NMPIPE 0x0026
92 #define TRANS_RAW_WRITE_NMPIPE 0x0031
93 #define TRANS_READ_NMPIPE 0x0036
94 #define TRANS_WRITE_NMPIPE 0x0037
95 #define TRANS_WAIT_NMPIPE 0x0053
96 #define TRANS_CALL_NMPIPE 0x0054
98 /* NT Transact subcommand codes */
99 #define NT_TRANSACT_CREATE 0x01
100 #define NT_TRANSACT_IOCTL 0x02
101 #define NT_TRANSACT_SET_SECURITY_DESC 0x03
102 #define NT_TRANSACT_NOTIFY_CHANGE 0x04
103 #define NT_TRANSACT_RENAME 0x05
104 #define NT_TRANSACT_QUERY_SECURITY_DESC 0x06
105 #define NT_TRANSACT_GET_USER_QUOTA 0x07
106 #define NT_TRANSACT_SET_USER_QUOTA 0x08
108 #define MAX_CIFS_SMALL_BUFFER_SIZE 448 /* big enough for most */
109 /* future chained NTCreateXReadX bigger, but for time being NTCreateX biggest */
110 /* among the requests (NTCreateX response is bigger with wct of 34) */
111 #define MAX_CIFS_HDR_SIZE 0x58 /* 4 len + 32 hdr + (2*24 wct) + 2 bct + 2 pad */
112 #define CIFS_SMALL_PATH 120 /* allows for (448-88)/3 */
114 /* internal cifs vfs structures */
115 /*****************************************************************
116 * All constants go here
117 *****************************************************************
121 * Starting value for maximum SMB size negotiation
123 #define CIFS_MAX_MSGSIZE (4*4096)
126 * Size of encrypted user password in bytes
128 #define CIFS_ENCPWD_SIZE (16)
131 * Size of the crypto key returned on the negotiate SMB in bytes
133 #define CIFS_CRYPTO_KEY_SIZE (8)
136 * Size of the ntlm client response
138 #define CIFS_AUTH_RESP_SIZE (24)
141 * Size of the session key (crypto key encrypted with the password
143 #define CIFS_SESS_KEY_SIZE (16)
146 * Size of the smb3 signing key
148 #define SMB3_SIGN_KEY_SIZE (16)
150 #define CIFS_CLIENT_CHALLENGE_SIZE (8)
151 #define CIFS_SERVER_CHALLENGE_SIZE (8)
152 #define CIFS_HMAC_MD5_HASH_SIZE (16)
153 #define CIFS_CPHTXT_SIZE (16)
154 #define CIFS_NTHASH_SIZE (16)
157 * Maximum user name length
159 #define CIFS_UNLEN (20)
164 #define SMBOPEN_WRITE_THROUGH 0x4000
165 #define SMBOPEN_DENY_ALL 0x0010
166 #define SMBOPEN_DENY_WRITE 0x0020
167 #define SMBOPEN_DENY_READ 0x0030
168 #define SMBOPEN_DENY_NONE 0x0040
169 #define SMBOPEN_READ 0x0000
170 #define SMBOPEN_WRITE 0x0001
171 #define SMBOPEN_READWRITE 0x0002
172 #define SMBOPEN_EXECUTE 0x0003
174 #define SMBOPEN_OCREATE 0x0010
175 #define SMBOPEN_OTRUNC 0x0002
176 #define SMBOPEN_OAPPEND 0x0001
179 * SMB flag definitions
181 #define SMBFLG_EXTD_LOCK 0x01 /* server supports lock-read write-unlock smb */
182 #define SMBFLG_RCV_POSTED 0x02 /* obsolete */
183 #define SMBFLG_RSVD 0x04
184 #define SMBFLG_CASELESS 0x08 /* all pathnames treated as caseless (off
185 implies case sensitive file handling request) */
186 #define SMBFLG_CANONICAL_PATH_FORMAT 0x10 /* obsolete */
187 #define SMBFLG_OLD_OPLOCK 0x20 /* obsolete */
188 #define SMBFLG_OLD_OPLOCK_NOTIFY 0x40 /* obsolete */
189 #define SMBFLG_RESPONSE 0x80 /* this PDU is a response from server */
192 * SMB flag2 definitions
194 #define SMBFLG2_KNOWS_LONG_NAMES cpu_to_le16(1) /* can send long (non-8.3)
195 path names in response */
196 #define SMBFLG2_KNOWS_EAS cpu_to_le16(2)
197 #define SMBFLG2_SECURITY_SIGNATURE cpu_to_le16(4)
198 #define SMBFLG2_COMPRESSED (8)
199 #define SMBFLG2_SECURITY_SIGNATURE_REQUIRED (0x10)
200 #define SMBFLG2_IS_LONG_NAME cpu_to_le16(0x40)
201 #define SMBFLG2_REPARSE_PATH (0x400)
202 #define SMBFLG2_EXT_SEC cpu_to_le16(0x800)
203 #define SMBFLG2_DFS cpu_to_le16(0x1000)
204 #define SMBFLG2_PAGING_IO cpu_to_le16(0x2000)
205 #define SMBFLG2_ERR_STATUS cpu_to_le16(0x4000)
206 #define SMBFLG2_UNICODE cpu_to_le16(0x8000)
209 * These are the file access permission bits defined in CIFS for the
210 * NTCreateAndX as well as the level 0x107
211 * TRANS2_QUERY_PATH_INFORMATION API. The level 0x107, SMB_QUERY_FILE_ALL_INFO
212 * responds with the AccessFlags.
213 * The AccessFlags specifies the access permissions a caller has to the
214 * file and can have any suitable combination of the following values:
217 #define FILE_READ_DATA 0x00000001 /* Data can be read from the file */
218 #define FILE_WRITE_DATA 0x00000002 /* Data can be written to the file */
219 #define FILE_APPEND_DATA 0x00000004 /* Data can be appended to the file */
220 #define FILE_READ_EA 0x00000008 /* Extended attributes associated */
221 /* with the file can be read */
222 #define FILE_WRITE_EA 0x00000010 /* Extended attributes associated */
223 /* with the file can be written */
224 #define FILE_EXECUTE 0x00000020 /*Data can be read into memory from */
225 /* the file using system paging I/O */
226 #define FILE_DELETE_CHILD 0x00000040
227 #define FILE_READ_ATTRIBUTES 0x00000080 /* Attributes associated with the */
228 /* file can be read */
229 #define FILE_WRITE_ATTRIBUTES 0x00000100 /* Attributes associated with the */
230 /* file can be written */
231 #define DELETE 0x00010000 /* The file can be deleted */
232 #define READ_CONTROL 0x00020000 /* The access control list and */
233 /* ownership associated with the */
234 /* file can be read */
235 #define WRITE_DAC 0x00040000 /* The access control list and */
236 /* ownership associated with the */
237 /* file can be written. */
238 #define WRITE_OWNER 0x00080000 /* Ownership information associated */
239 /* with the file can be written */
240 #define SYNCHRONIZE 0x00100000 /* The file handle can waited on to */
241 /* synchronize with the completion */
242 /* of an input/output request */
243 #define GENERIC_ALL 0x10000000
244 #define GENERIC_EXECUTE 0x20000000
245 #define GENERIC_WRITE 0x40000000
246 #define GENERIC_READ 0x80000000
247 /* In summary - Relevant file */
248 /* access flags from CIFS are */
249 /* file_read_data, file_write_data */
250 /* file_execute, file_read_attributes*/
251 /* write_dac, and delete. */
253 #define FILE_READ_RIGHTS (FILE_READ_DATA | FILE_READ_EA | FILE_READ_ATTRIBUTES)
254 #define FILE_WRITE_RIGHTS (FILE_WRITE_DATA | FILE_APPEND_DATA \
255 | FILE_WRITE_EA | FILE_WRITE_ATTRIBUTES)
256 #define FILE_EXEC_RIGHTS (FILE_EXECUTE)
258 #define SET_FILE_READ_RIGHTS (FILE_READ_DATA | FILE_READ_EA | FILE_WRITE_EA \
259 | FILE_READ_ATTRIBUTES \
260 | FILE_WRITE_ATTRIBUTES \
261 | DELETE | READ_CONTROL | WRITE_DAC \
262 | WRITE_OWNER | SYNCHRONIZE)
263 #define SET_FILE_WRITE_RIGHTS (FILE_WRITE_DATA | FILE_APPEND_DATA \
264 | FILE_READ_EA | FILE_WRITE_EA \
265 | FILE_DELETE_CHILD | FILE_READ_ATTRIBUTES \
266 | FILE_WRITE_ATTRIBUTES \
267 | DELETE | READ_CONTROL | WRITE_DAC \
268 | WRITE_OWNER | SYNCHRONIZE)
269 #define SET_FILE_EXEC_RIGHTS (FILE_READ_EA | FILE_WRITE_EA | FILE_EXECUTE \
270 | FILE_READ_ATTRIBUTES \
271 | FILE_WRITE_ATTRIBUTES \
272 | DELETE | READ_CONTROL | WRITE_DAC \
273 | WRITE_OWNER | SYNCHRONIZE)
275 #define SET_MINIMUM_RIGHTS (FILE_READ_EA | FILE_READ_ATTRIBUTES \
276 | READ_CONTROL | SYNCHRONIZE)
280 * Invalid readdir handle
282 #define CIFS_NO_HANDLE 0xFFFF
284 #define NO_CHANGE_64 0xFFFFFFFFFFFFFFFFULL
287 #define CIFS_IPC_RESOURCE "\x49\x50\x43\x24"
289 /* IPC$ in Unicode */
290 #define CIFS_IPC_UNICODE_RESOURCE "\x00\x49\x00\x50\x00\x43\x00\x24\x00\x00"
292 /* Unicode Null terminate 2 bytes of 0 */
293 #define UNICODE_NULL "\x00\x00"
294 #define ASCII_NULL 0x00
297 * Server type values (returned on EnumServer API
299 #define CIFS_SV_TYPE_DC 0x00000008
300 #define CIFS_SV_TYPE_BACKDC 0x00000010
303 * Alias type flags (From EnumAlias API call
305 #define CIFS_ALIAS_TYPE_FILE 0x0001
306 #define CIFS_SHARE_TYPE_FILE 0x0000
309 * File Attribute flags
311 #define ATTR_READONLY 0x0001
312 #define ATTR_HIDDEN 0x0002
313 #define ATTR_SYSTEM 0x0004
314 #define ATTR_VOLUME 0x0008
315 #define ATTR_DIRECTORY 0x0010
316 #define ATTR_ARCHIVE 0x0020
317 #define ATTR_DEVICE 0x0040
318 #define ATTR_NORMAL 0x0080
319 #define ATTR_TEMPORARY 0x0100
320 #define ATTR_SPARSE 0x0200
321 #define ATTR_REPARSE 0x0400
322 #define ATTR_COMPRESSED 0x0800
323 #define ATTR_OFFLINE 0x1000 /* ie file not immediately available -
324 on offline storage */
325 #define ATTR_NOT_CONTENT_INDEXED 0x2000
326 #define ATTR_ENCRYPTED 0x4000
327 #define ATTR_POSIX_SEMANTICS 0x01000000
328 #define ATTR_BACKUP_SEMANTICS 0x02000000
329 #define ATTR_DELETE_ON_CLOSE 0x04000000
330 #define ATTR_SEQUENTIAL_SCAN 0x08000000
331 #define ATTR_RANDOM_ACCESS 0x10000000
332 #define ATTR_NO_BUFFERING 0x20000000
333 #define ATTR_WRITE_THROUGH 0x80000000
335 /* ShareAccess flags */
336 #define FILE_NO_SHARE 0x00000000
337 #define FILE_SHARE_READ 0x00000001
338 #define FILE_SHARE_WRITE 0x00000002
339 #define FILE_SHARE_DELETE 0x00000004
340 #define FILE_SHARE_ALL 0x00000007
342 /* CreateDisposition flags, similar to CreateAction as well */
343 #define FILE_SUPERSEDE 0x00000000
344 #define FILE_OPEN 0x00000001
345 #define FILE_CREATE 0x00000002
346 #define FILE_OPEN_IF 0x00000003
347 #define FILE_OVERWRITE 0x00000004
348 #define FILE_OVERWRITE_IF 0x00000005
351 #define CREATE_NOT_FILE 0x00000001 /* if set must not be file */
352 #define CREATE_WRITE_THROUGH 0x00000002
353 #define CREATE_SEQUENTIAL 0x00000004
354 #define CREATE_NO_BUFFER 0x00000008 /* should not buffer on srv */
355 #define CREATE_SYNC_ALERT 0x00000010 /* MBZ */
356 #define CREATE_ASYNC_ALERT 0x00000020 /* MBZ */
357 #define CREATE_NOT_DIR 0x00000040 /* if set must not be directory */
358 #define CREATE_TREE_CONNECTION 0x00000080 /* should be zero */
359 #define CREATE_COMPLETE_IF_OPLK 0x00000100 /* should be zero */
360 #define CREATE_NO_EA_KNOWLEDGE 0x00000200
361 #define CREATE_EIGHT_DOT_THREE 0x00000400 /* doc says this is obsolete
362 "open for recovery" flag should
363 be zero in any case */
364 #define CREATE_OPEN_FOR_RECOVERY 0x00000400
365 #define CREATE_RANDOM_ACCESS 0x00000800
366 #define CREATE_DELETE_ON_CLOSE 0x00001000
367 #define CREATE_OPEN_BY_ID 0x00002000
368 #define CREATE_OPEN_BACKUP_INTENT 0x00004000
369 #define CREATE_NO_COMPRESSION 0x00008000
370 #define CREATE_RESERVE_OPFILTER 0x00100000 /* should be zero */
371 #define OPEN_REPARSE_POINT 0x00200000
372 #define OPEN_NO_RECALL 0x00400000
373 #define OPEN_FREE_SPACE_QUERY 0x00800000 /* should be zero */
374 #define CREATE_OPTIONS_MASK 0x007FFFFF
375 #define CREATE_OPTION_READONLY 0x10000000
376 #define CREATE_OPTION_SPECIAL 0x20000000 /* system. NB not sent over wire */
378 /* ImpersonationLevel flags */
379 #define SECURITY_ANONYMOUS 0
380 #define SECURITY_IDENTIFICATION 1
381 #define SECURITY_IMPERSONATION 2
382 #define SECURITY_DELEGATION 3
385 #define SECURITY_CONTEXT_TRACKING 0x01
386 #define SECURITY_EFFECTIVE_ONLY 0x02
389 * Default PID value, used in all SMBs where the PID is not important
391 #define CIFS_DFT_PID 0x1234
394 * We use the same routine for Copy and Move SMBs. This flag is used to
397 #define CIFS_COPY_OP 1
398 #define CIFS_RENAME_OP 2
400 #define GETU16(var) (*((__u16 *)var)) /* BB check for endian issues */
401 #define GETU32(var) (*((__u32 *)var)) /* BB check for endian issues */
404 __be32 smb_buf_length
; /* BB length is only two (rarely three) bytes,
405 with one or two byte "type" preceding it that will be
406 zero - we could mask the type byte off */
414 } __attribute__((packed
)) DosError
;
416 } __attribute__((packed
)) Status
;
418 __le16 Flags2
; /* note: le */
422 __le32 SequenceNumber
; /* le */
423 __u32 Reserved
; /* zero */
424 } __attribute__((packed
)) Sequence
;
425 __u8 SecuritySignature
[8]; /* le */
426 } __attribute__((packed
)) Signature
;
433 } __attribute__((packed
));
435 /* given a pointer to an smb_hdr, retrieve a void pointer to the ByteCount */
437 BCC(struct smb_hdr
*smb
)
439 return (void *)smb
+ sizeof(*smb
) + 2 * smb
->WordCount
;
442 /* given a pointer to an smb_hdr retrieve the pointer to the byte area */
443 #define pByteArea(smb_var) (BCC(smb_var) + 2)
445 /* get the unconverted ByteCount for a SMB packet and return it */
447 get_bcc(struct smb_hdr
*hdr
)
449 __le16
*bc_ptr
= (__le16
*)BCC(hdr
);
451 return get_unaligned_le16(bc_ptr
);
454 /* set the ByteCount for a SMB packet in little-endian */
456 put_bcc(__u16 count
, struct smb_hdr
*hdr
)
458 __le16
*bc_ptr
= (__le16
*)BCC(hdr
);
460 put_unaligned_le16(count
, bc_ptr
);
464 * Computer Name Length (since Netbios name was length 16 with last byte 0x20)
465 * No longer as important, now that TCP names are more commonly used to
471 * Share Name Length (SNLEN)
472 * Note: This length was limited by the SMB used to get
473 * the Share info. NetShareEnum only returned 13
474 * chars, including the null termination.
475 * This was removed because it no longer is limiting.
481 #define MAXCOMMENTLEN 40
484 * The OS/2 maximum path name
486 #define MAX_PATHCONF 256
489 * SMB frame definitions (following must be packed structs)
490 * See the SNIA CIFS Specification for details.
492 * The Naming convention is the lower case version of the
493 * smb command code name for the struct and this is typedef to the
494 * uppercase version of the same name with the prefix SMB_ removed
495 * for brevity. Although typedefs are not commonly used for
496 * structure definitions in the Linux kernel, their use in the
497 * CIFS standards document, which this code is based on, may
498 * make this one of the cases where typedefs for structures make
499 * sense to improve readability for readers of the standards doc.
500 * Typedefs can always be removed later if they are too distracting
501 * and they are only used for the CIFSs PDUs themselves, not
502 * internal cifs vfs structures
506 typedef struct negotiate_req
{
507 struct smb_hdr hdr
; /* wct = 0 */
509 unsigned char DialectsArray
[1];
510 } __attribute__((packed
)) NEGOTIATE_REQ
;
512 /* Dialect index is 13 for LANMAN */
514 #define MIN_TZ_ADJ (15 * 60) /* minimum grid for timezones in seconds */
516 typedef struct lanman_neg_rsp
{
517 struct smb_hdr hdr
; /* wct = 13 */
528 } __attribute__((packed
)) SrvTime
;
529 __le16 ServerTimeZone
;
530 __le16 EncryptionKeyLength
;
533 unsigned char EncryptionKey
[1];
534 } __attribute__((packed
)) LANMAN_NEG_RSP
;
536 #define READ_RAW_ENABLE 1
537 #define WRITE_RAW_ENABLE 2
538 #define RAW_ENABLE (READ_RAW_ENABLE | WRITE_RAW_ENABLE)
539 #define SMB1_CLIENT_GUID_SIZE (16)
540 typedef struct negotiate_rsp
{
541 struct smb_hdr hdr
; /* wct = 17 */
542 __le16 DialectIndex
; /* 0xFFFF = no dialect acceptable */
546 __le32 MaxBufferSize
;
549 __le32 Capabilities
; /* see below */
550 __le32 SystemTimeLow
;
551 __le32 SystemTimeHigh
;
552 __le16 ServerTimeZone
;
553 __u8 EncryptionKeyLength
;
556 unsigned char EncryptionKey
[1]; /* cap extended security off */
557 /* followed by Domain name - if extended security is off */
558 /* followed by 16 bytes of server GUID */
559 /* then security blob if cap_extended_security negotiated */
561 unsigned char GUID
[SMB1_CLIENT_GUID_SIZE
];
562 unsigned char SecurityBlob
[1];
563 } __attribute__((packed
)) extended_response
;
564 } __attribute__((packed
)) u
;
565 } __attribute__((packed
)) NEGOTIATE_RSP
;
567 /* SecurityMode bits */
568 #define SECMODE_USER 0x01 /* off indicates share level security */
569 #define SECMODE_PW_ENCRYPT 0x02
570 #define SECMODE_SIGN_ENABLED 0x04 /* SMB security signatures enabled */
571 #define SECMODE_SIGN_REQUIRED 0x08 /* SMB security signatures required */
573 /* Negotiate response Capabilities */
574 #define CAP_RAW_MODE 0x00000001
575 #define CAP_MPX_MODE 0x00000002
576 #define CAP_UNICODE 0x00000004
577 #define CAP_LARGE_FILES 0x00000008
578 #define CAP_NT_SMBS 0x00000010 /* implies CAP_NT_FIND */
579 #define CAP_RPC_REMOTE_APIS 0x00000020
580 #define CAP_STATUS32 0x00000040
581 #define CAP_LEVEL_II_OPLOCKS 0x00000080
582 #define CAP_LOCK_AND_READ 0x00000100
583 #define CAP_NT_FIND 0x00000200
584 #define CAP_DFS 0x00001000
585 #define CAP_INFOLEVEL_PASSTHRU 0x00002000
586 #define CAP_LARGE_READ_X 0x00004000
587 #define CAP_LARGE_WRITE_X 0x00008000
588 #define CAP_LWIO 0x00010000 /* support fctl_srv_req_resume_key */
589 #define CAP_UNIX 0x00800000
590 #define CAP_COMPRESSED_DATA 0x02000000
591 #define CAP_DYNAMIC_REAUTH 0x20000000
592 #define CAP_PERSISTENT_HANDLES 0x40000000
593 #define CAP_EXTENDED_SECURITY 0x80000000
595 typedef union smb_com_session_setup_andx
{
596 struct { /* request format */
597 struct smb_hdr hdr
; /* wct = 12 */
601 __le16 MaxBufferSize
;
605 __le16 SecurityBlobLength
;
607 __le32 Capabilities
; /* see below */
609 unsigned char SecurityBlob
[1]; /* followed by */
610 /* STRING NativeOS */
611 /* STRING NativeLanMan */
612 } __attribute__((packed
)) req
; /* NTLM request format (with
615 struct { /* request format */
616 struct smb_hdr hdr
; /* wct = 13 */
620 __le16 MaxBufferSize
;
624 __le16 CaseInsensitivePasswordLength
; /* ASCII password len */
625 __le16 CaseSensitivePasswordLength
; /* Unicode password length*/
626 __u32 Reserved
; /* see below */
629 unsigned char CaseInsensitivePassword
[1]; /* followed by: */
630 /* unsigned char * CaseSensitivePassword; */
631 /* STRING AccountName */
632 /* STRING PrimaryDomain */
633 /* STRING NativeOS */
634 /* STRING NativeLanMan */
635 } __attribute__((packed
)) req_no_secext
; /* NTLM request format (without
638 struct { /* default (NTLM) response format */
639 struct smb_hdr hdr
; /* wct = 4 */
643 __le16 Action
; /* see below */
644 __le16 SecurityBlobLength
;
646 unsigned char SecurityBlob
[1]; /* followed by */
647 /* unsigned char * NativeOS; */
648 /* unsigned char * NativeLanMan; */
649 /* unsigned char * PrimaryDomain; */
650 } __attribute__((packed
)) resp
; /* NTLM response
651 (with or without extended sec) */
653 struct { /* request format */
654 struct smb_hdr hdr
; /* wct = 10 */
658 __le16 MaxBufferSize
;
662 __le16 PasswordLength
;
663 __u32 Reserved
; /* encrypt key len and offset */
665 unsigned char AccountPassword
[1]; /* followed by */
666 /* STRING AccountName */
667 /* STRING PrimaryDomain */
668 /* STRING NativeOS */
669 /* STRING NativeLanMan */
670 } __attribute__((packed
)) old_req
; /* pre-NTLM (LANMAN2.1) req format */
672 struct { /* default (NTLM) response format */
673 struct smb_hdr hdr
; /* wct = 3 */
677 __le16 Action
; /* see below */
679 unsigned char NativeOS
[1]; /* followed by */
680 /* unsigned char * NativeLanMan; */
681 /* unsigned char * PrimaryDomain; */
682 } __attribute__((packed
)) old_resp
; /* pre-NTLM (LANMAN2.1) response */
683 } __attribute__((packed
)) SESSION_SETUP_ANDX
;
685 /* format of NLTMv2 Response ie "case sensitive password" hash when NTLMv2 */
687 #define NTLMSSP_SERVER_TYPE 1
688 #define NTLMSSP_DOMAIN_TYPE 2
689 #define NTLMSSP_FQ_DOMAIN_TYPE 3
690 #define NTLMSSP_DNS_DOMAIN_TYPE 4
691 #define NTLMSSP_DNS_PARENT_TYPE 5
693 struct ntlmssp2_name
{
696 /* char name[length]; */
697 } __attribute__((packed
));
700 char ntlmv2_hash
[CIFS_ENCPWD_SIZE
];
701 __le32 blob_signature
;
704 __u64 client_chal
; /* random */
706 /* array of name entries could follow ending in minimum 4 byte struct */
707 } __attribute__((packed
));
710 #define CIFS_NETWORK_OPSYS "CIFS VFS Client for Linux"
712 /* Capabilities bits (for NTLM SessSetup request) */
713 #define CAP_UNICODE 0x00000004
714 #define CAP_LARGE_FILES 0x00000008
715 #define CAP_NT_SMBS 0x00000010
716 #define CAP_STATUS32 0x00000040
717 #define CAP_LEVEL_II_OPLOCKS 0x00000080
718 #define CAP_NT_FIND 0x00000200 /* reserved should be zero
719 (because NT_SMBs implies the same thing?) */
720 #define CAP_BULK_TRANSFER 0x20000000
721 #define CAP_EXTENDED_SECURITY 0x80000000
724 #define GUEST_LOGIN 1
726 typedef struct smb_com_tconx_req
{
727 struct smb_hdr hdr
; /* wct = 4 */
731 __le16 Flags
; /* see below */
732 __le16 PasswordLength
;
734 unsigned char Password
[1]; /* followed by */
735 /* STRING Path *//* \\server\share name */
737 } __attribute__((packed
)) TCONX_REQ
;
739 typedef struct smb_com_tconx_rsp
{
740 struct smb_hdr hdr
; /* wct = 3 , not extended response */
744 __le16 OptionalSupport
; /* see below */
746 unsigned char Service
[1]; /* always ASCII, not Unicode */
747 /* STRING NativeFileSystem */
748 } __attribute__((packed
)) TCONX_RSP
;
750 typedef struct smb_com_tconx_rsp_ext
{
751 struct smb_hdr hdr
; /* wct = 7, extended response */
755 __le16 OptionalSupport
; /* see below */
756 __le32 MaximalShareAccessRights
;
757 __le32 GuestMaximalShareAccessRights
;
759 unsigned char Service
[1]; /* always ASCII, not Unicode */
760 /* STRING NativeFileSystem */
761 } __attribute__((packed
)) TCONX_RSP_EXT
;
764 /* tree connect Flags */
765 #define DISCONNECT_TID 0x0001
766 #define TCON_EXTENDED_SIGNATURES 0x0004
767 #define TCON_EXTENDED_SECINFO 0x0008
769 /* OptionalSupport bits */
770 #define SMB_SUPPORT_SEARCH_BITS 0x0001 /* "must have" directory search bits
771 (exclusive searches supported) */
772 #define SMB_SHARE_IS_IN_DFS 0x0002
773 #define SMB_CSC_MASK 0x000C
774 /* CSC flags defined as follows */
775 #define SMB_CSC_CACHE_MANUAL_REINT 0x0000
776 #define SMB_CSC_CACHE_AUTO_REINT 0x0004
777 #define SMB_CSC_CACHE_VDO 0x0008
778 #define SMB_CSC_NO_CACHING 0x000C
779 #define SMB_UNIQUE_FILE_NAME 0x0010
780 #define SMB_EXTENDED_SIGNATURES 0x0020
792 typedef struct smb_com_echo_req
{
797 } __attribute__((packed
)) ECHO_REQ
;
799 typedef struct smb_com_echo_rsp
{
801 __le16 SequenceNumber
;
804 } __attribute__((packed
)) ECHO_RSP
;
806 typedef struct smb_com_logoff_andx_req
{
807 struct smb_hdr hdr
; /* wct = 2 */
812 } __attribute__((packed
)) LOGOFF_ANDX_REQ
;
814 typedef struct smb_com_logoff_andx_rsp
{
815 struct smb_hdr hdr
; /* wct = 2 */
820 } __attribute__((packed
)) LOGOFF_ANDX_RSP
;
822 typedef union smb_com_tree_disconnect
{ /* as an altetnative can use flag on
823 tree_connect PDU to effect disconnect */
824 /* tdis is probably simplest SMB PDU */
826 struct smb_hdr hdr
; /* wct = 0 */
827 __u16 ByteCount
; /* bcc = 0 */
828 } __attribute__((packed
)) req
;
830 struct smb_hdr hdr
; /* wct = 0 */
831 __u16 ByteCount
; /* bcc = 0 */
832 } __attribute__((packed
)) resp
;
833 } __attribute__((packed
)) TREE_DISCONNECT
;
835 typedef struct smb_com_close_req
{
836 struct smb_hdr hdr
; /* wct = 3 */
838 __u32 LastWriteTime
; /* should be zero or -1 */
839 __u16 ByteCount
; /* 0 */
840 } __attribute__((packed
)) CLOSE_REQ
;
842 typedef struct smb_com_close_rsp
{
843 struct smb_hdr hdr
; /* wct = 0 */
844 __u16 ByteCount
; /* bct = 0 */
845 } __attribute__((packed
)) CLOSE_RSP
;
847 typedef struct smb_com_flush_req
{
848 struct smb_hdr hdr
; /* wct = 1 */
850 __u16 ByteCount
; /* 0 */
851 } __attribute__((packed
)) FLUSH_REQ
;
853 typedef struct smb_com_findclose_req
{
854 struct smb_hdr hdr
; /* wct = 1 */
856 __u16 ByteCount
; /* 0 */
857 } __attribute__((packed
)) FINDCLOSE_REQ
;
860 #define REQ_MORE_INFO 0x00000001 /* legacy (OPEN_AND_X) only */
861 #define REQ_OPLOCK 0x00000002
862 #define REQ_BATCHOPLOCK 0x00000004
863 #define REQ_OPENDIRONLY 0x00000008
864 #define REQ_EXTENDED_INFO 0x00000010
867 #define DISK_TYPE 0x0000
868 #define BYTE_PIPE_TYPE 0x0001
869 #define MESSAGE_PIPE_TYPE 0x0002
870 #define PRINTER_TYPE 0x0003
871 #define COMM_DEV_TYPE 0x0004
872 #define UNKNOWN_TYPE 0xFFFF
874 /* Device Type or File Status Flags */
875 #define NO_EAS 0x0001
876 #define NO_SUBSTREAMS 0x0002
877 #define NO_REPARSETAG 0x0004
878 /* following flags can apply if pipe */
879 #define ICOUNT_MASK 0x00FF
880 #define PIPE_READ_MODE 0x0100
881 #define NAMED_PIPE_TYPE 0x0400
882 #define PIPE_END_POINT 0x4000
883 #define BLOCKING_NAMED_PIPE 0x8000
885 typedef struct smb_com_open_req
{ /* also handles create */
886 struct smb_hdr hdr
; /* wct = 24 */
890 __u8 Reserved
; /* Must Be Zero */
893 __u32 RootDirectoryFid
;
894 __le32 DesiredAccess
;
895 __le64 AllocationSize
;
896 __le32 FileAttributes
;
898 __le32 CreateDisposition
;
899 __le32 CreateOptions
;
900 __le32 ImpersonationLevel
;
904 } __attribute__((packed
)) OPEN_REQ
;
906 /* open response: oplock levels */
907 #define OPLOCK_NONE 0
908 #define OPLOCK_EXCLUSIVE 1
909 #define OPLOCK_BATCH 2
910 #define OPLOCK_READ 3 /* level 2 oplock */
912 /* open response for CreateAction shifted left */
913 #define CIFS_CREATE_ACTION 0x20000 /* file created */
915 typedef struct smb_com_open_rsp
{
916 struct smb_hdr hdr
; /* wct = 34 BB */
924 __le64 LastAccessTime
;
925 __le64 LastWriteTime
;
927 __le32 FileAttributes
;
928 __le64 AllocationSize
;
933 __u16 ByteCount
; /* bct = 0 */
934 } __attribute__((packed
)) OPEN_RSP
;
936 typedef struct smb_com_open_rsp_ext
{
937 struct smb_hdr hdr
; /* wct = 42 but meaningless due to MS bug? */
945 __le64 LastAccessTime
;
946 __le64 LastWriteTime
;
948 __le32 FileAttributes
;
949 __le64 AllocationSize
;
955 __u64 FileId
; /* note no endian conversion - is opaque UniqueID */
956 __le32 MaximalAccessRights
;
957 __le32 GuestMaximalAccessRights
;
958 __u16 ByteCount
; /* bct = 0 */
959 } __attribute__((packed
)) OPEN_RSP_EXT
;
962 /* format of legacy open request */
963 typedef struct smb_com_openx_req
{
964 struct smb_hdr hdr
; /* wct = 15 */
970 __le16 Sattr
; /* search attributes */
971 __le16 FileAttributes
; /* dos attrs */
972 __le32 CreateTime
; /* os2 format */
977 __le16 ByteCount
; /* file name follows */
979 } __attribute__((packed
)) OPENX_REQ
;
981 typedef struct smb_com_openx_rsp
{
982 struct smb_hdr hdr
; /* wct = 15 */
987 __le16 FileAttributes
;
988 __le32 LastWriteTime
; /* os2 format */
997 } __attribute__((packed
)) OPENX_RSP
;
999 /* For encoding of POSIX Open Request - see trans2 function 0x209 data struct */
1001 /* Legacy write request for older servers */
1002 typedef struct smb_com_writex_req
{
1003 struct smb_hdr hdr
; /* wct = 12 */
1009 __u32 Reserved
; /* Timeout */
1010 __le16 WriteMode
; /* 1 = write through */
1013 __le16 DataLengthLow
;
1016 __u8 Pad
; /* BB check for whether padded to DWORD
1017 boundary and optimum performance here */
1019 } __attribute__((packed
)) WRITEX_REQ
;
1021 typedef struct smb_com_write_req
{
1022 struct smb_hdr hdr
; /* wct = 14 */
1031 __le16 DataLengthHigh
;
1032 __le16 DataLengthLow
;
1036 __u8 Pad
; /* BB check for whether padded to DWORD
1037 boundary and optimum performance here */
1039 } __attribute__((packed
)) WRITE_REQ
;
1041 typedef struct smb_com_write_rsp
{
1042 struct smb_hdr hdr
; /* wct = 6 */
1051 } __attribute__((packed
)) WRITE_RSP
;
1053 /* legacy read request for older servers */
1054 typedef struct smb_com_readx_req
{
1055 struct smb_hdr hdr
; /* wct = 10 */
1062 __le16 MinCount
; /* obsolete */
1066 } __attribute__((packed
)) READX_REQ
;
1068 typedef struct smb_com_read_req
{
1069 struct smb_hdr hdr
; /* wct = 12 */
1076 __le16 MinCount
; /* obsolete */
1077 __le32 MaxCountHigh
;
1081 } __attribute__((packed
)) READ_REQ
;
1083 typedef struct smb_com_read_rsp
{
1084 struct smb_hdr hdr
; /* wct = 12 */
1089 __le16 DataCompactionMode
;
1093 __le16 DataLengthHigh
;
1096 /* read response data immediately follows */
1097 } __attribute__((packed
)) READ_RSP
;
1099 typedef struct locking_andx_range
{
1106 } __attribute__((packed
)) LOCKING_ANDX_RANGE
;
1108 #define LOCKING_ANDX_SHARED_LOCK 0x01
1109 #define LOCKING_ANDX_OPLOCK_RELEASE 0x02
1110 #define LOCKING_ANDX_CHANGE_LOCKTYPE 0x04
1111 #define LOCKING_ANDX_CANCEL_LOCK 0x08
1112 #define LOCKING_ANDX_LARGE_FILES 0x10 /* always on for us */
1114 typedef struct smb_com_lock_req
{
1115 struct smb_hdr hdr
; /* wct = 8 */
1123 __le16 NumberOfUnlocks
;
1124 __le16 NumberOfLocks
;
1126 LOCKING_ANDX_RANGE Locks
[1];
1127 } __attribute__((packed
)) LOCK_REQ
;
1130 #define CIFS_RDLCK 0
1131 #define CIFS_WRLCK 1
1132 #define CIFS_UNLCK 2
1133 typedef struct cifs_posix_lock
{
1134 __le16 lock_type
; /* 0 = Read, 1 = Write, 2 = Unlock */
1135 __le16 lock_flags
; /* 1 = Wait (only valid for setlock) */
1139 /* BB what about additional owner info to identify network client */
1140 } __attribute__((packed
)) CIFS_POSIX_LOCK
;
1142 typedef struct smb_com_lock_rsp
{
1143 struct smb_hdr hdr
; /* wct = 2 */
1148 } __attribute__((packed
)) LOCK_RSP
;
1150 typedef struct smb_com_rename_req
{
1151 struct smb_hdr hdr
; /* wct = 1 */
1152 __le16 SearchAttributes
; /* target file attributes */
1154 __u8 BufferFormat
; /* 4 = ASCII or Unicode */
1155 unsigned char OldFileName
[1];
1156 /* followed by __u8 BufferFormat2 */
1157 /* followed by NewFileName */
1158 } __attribute__((packed
)) RENAME_REQ
;
1160 /* copy request flags */
1161 #define COPY_MUST_BE_FILE 0x0001
1162 #define COPY_MUST_BE_DIR 0x0002
1163 #define COPY_TARGET_MODE_ASCII 0x0004 /* if not set, binary */
1164 #define COPY_SOURCE_MODE_ASCII 0x0008 /* if not set, binary */
1165 #define COPY_VERIFY_WRITES 0x0010
1166 #define COPY_TREE 0x0020
1168 typedef struct smb_com_copy_req
{
1169 struct smb_hdr hdr
; /* wct = 3 */
1171 __le16 OpenFunction
;
1174 __u8 BufferFormat
; /* 4 = ASCII or Unicode */
1175 unsigned char OldFileName
[1];
1176 /* followed by __u8 BufferFormat2 */
1177 /* followed by NewFileName string */
1178 } __attribute__((packed
)) COPY_REQ
;
1180 typedef struct smb_com_copy_rsp
{
1181 struct smb_hdr hdr
; /* wct = 1 */
1182 __le16 CopyCount
; /* number of files copied */
1183 __u16 ByteCount
; /* may be zero */
1184 __u8 BufferFormat
; /* 0x04 - only present if errored file follows */
1185 unsigned char ErrorFileName
[1]; /* only present if error in copy */
1186 } __attribute__((packed
)) COPY_RSP
;
1188 #define CREATE_HARD_LINK 0x103
1189 #define MOVEFILE_COPY_ALLOWED 0x0002
1190 #define MOVEFILE_REPLACE_EXISTING 0x0001
1192 typedef struct smb_com_nt_rename_req
{ /* A5 - also used for create hardlink */
1193 struct smb_hdr hdr
; /* wct = 4 */
1194 __le16 SearchAttributes
; /* target file attributes */
1195 __le16 Flags
; /* spec says Information Level */
1196 __le32 ClusterCount
;
1198 __u8 BufferFormat
; /* 4 = ASCII or Unicode */
1199 unsigned char OldFileName
[1];
1200 /* followed by __u8 BufferFormat2 */
1201 /* followed by NewFileName */
1202 } __attribute__((packed
)) NT_RENAME_REQ
;
1204 typedef struct smb_com_rename_rsp
{
1205 struct smb_hdr hdr
; /* wct = 0 */
1206 __u16 ByteCount
; /* bct = 0 */
1207 } __attribute__((packed
)) RENAME_RSP
;
1209 typedef struct smb_com_delete_file_req
{
1210 struct smb_hdr hdr
; /* wct = 1 */
1211 __le16 SearchAttributes
;
1213 __u8 BufferFormat
; /* 4 = ASCII */
1214 unsigned char fileName
[1];
1215 } __attribute__((packed
)) DELETE_FILE_REQ
;
1217 typedef struct smb_com_delete_file_rsp
{
1218 struct smb_hdr hdr
; /* wct = 0 */
1219 __u16 ByteCount
; /* bct = 0 */
1220 } __attribute__((packed
)) DELETE_FILE_RSP
;
1222 typedef struct smb_com_delete_directory_req
{
1223 struct smb_hdr hdr
; /* wct = 0 */
1225 __u8 BufferFormat
; /* 4 = ASCII */
1226 unsigned char DirName
[1];
1227 } __attribute__((packed
)) DELETE_DIRECTORY_REQ
;
1229 typedef struct smb_com_delete_directory_rsp
{
1230 struct smb_hdr hdr
; /* wct = 0 */
1231 __u16 ByteCount
; /* bct = 0 */
1232 } __attribute__((packed
)) DELETE_DIRECTORY_RSP
;
1234 typedef struct smb_com_create_directory_req
{
1235 struct smb_hdr hdr
; /* wct = 0 */
1237 __u8 BufferFormat
; /* 4 = ASCII */
1238 unsigned char DirName
[1];
1239 } __attribute__((packed
)) CREATE_DIRECTORY_REQ
;
1241 typedef struct smb_com_create_directory_rsp
{
1242 struct smb_hdr hdr
; /* wct = 0 */
1243 __u16 ByteCount
; /* bct = 0 */
1244 } __attribute__((packed
)) CREATE_DIRECTORY_RSP
;
1246 typedef struct smb_com_query_information_req
{
1247 struct smb_hdr hdr
; /* wct = 0 */
1248 __le16 ByteCount
; /* 1 + namelen + 1 */
1249 __u8 BufferFormat
; /* 4 = ASCII */
1250 unsigned char FileName
[1];
1251 } __attribute__((packed
)) QUERY_INFORMATION_REQ
;
1253 typedef struct smb_com_query_information_rsp
{
1254 struct smb_hdr hdr
; /* wct = 10 */
1256 __le32 last_write_time
;
1259 __le16 ByteCount
; /* bcc = 0 */
1260 } __attribute__((packed
)) QUERY_INFORMATION_RSP
;
1262 typedef struct smb_com_setattr_req
{
1263 struct smb_hdr hdr
; /* wct = 8 */
1267 __le16 reserved
[5]; /* must be zero */
1269 __u8 BufferFormat
; /* 4 = ASCII */
1270 unsigned char fileName
[1];
1271 } __attribute__((packed
)) SETATTR_REQ
;
1273 typedef struct smb_com_setattr_rsp
{
1274 struct smb_hdr hdr
; /* wct = 0 */
1275 __u16 ByteCount
; /* bct = 0 */
1276 } __attribute__((packed
)) SETATTR_RSP
;
1278 /* empty wct response to setattr */
1280 /*******************************************************/
1281 /* NT Transact structure definitions follow */
1282 /* Currently only ioctl, acl (get security descriptor) */
1283 /* and notify are implemented */
1284 /*******************************************************/
1285 typedef struct smb_com_ntransact_req
{
1286 struct smb_hdr hdr
; /* wct >= 19 */
1289 __le32 TotalParameterCount
;
1290 __le32 TotalDataCount
;
1291 __le32 MaxParameterCount
;
1292 __le32 MaxDataCount
;
1293 __le32 ParameterCount
;
1294 __le32 ParameterOffset
;
1297 __u8 SetupCount
; /* four setup words follow subcommand */
1298 /* SNIA spec incorrectly included spurious pad here */
1299 __le16 SubCommand
; /* 2 = IOCTL/FSCTL */
1300 /* SetupCount words follow then */
1304 } __attribute__((packed
)) NTRANSACT_REQ
;
1306 typedef struct smb_com_ntransact_rsp
{
1307 struct smb_hdr hdr
; /* wct = 18 */
1309 __le32 TotalParameterCount
;
1310 __le32 TotalDataCount
;
1311 __le32 ParameterCount
;
1312 __le32 ParameterOffset
;
1313 __le32 ParameterDisplacement
;
1316 __le32 DataDisplacement
;
1317 __u8 SetupCount
; /* 0 */
1320 /* parms and data follow */
1321 } __attribute__((packed
)) NTRANSACT_RSP
;
1323 /* See MS-SMB 2.2.7.2.1.1 */
1324 struct srv_copychunk
{
1325 __le64 SourceOffset
;
1326 __le64 DestinationOffset
;
1331 typedef struct smb_com_transaction_ioctl_req
{
1332 struct smb_hdr hdr
; /* wct = 23 */
1335 __le32 TotalParameterCount
;
1336 __le32 TotalDataCount
;
1337 __le32 MaxParameterCount
;
1338 __le32 MaxDataCount
;
1339 __le32 ParameterCount
;
1340 __le32 ParameterOffset
;
1343 __u8 SetupCount
; /* four setup words follow subcommand */
1344 /* SNIA spec incorrectly included spurious pad here */
1345 __le16 SubCommand
; /* 2 = IOCTL/FSCTL */
1346 __le32 FunctionCode
;
1348 __u8 IsFsctl
; /* 1 = File System Control 0 = device control (IOCTL) */
1349 __u8 IsRootFlag
; /* 1 = apply command to root of share (must be DFS) */
1353 } __attribute__((packed
)) TRANSACT_IOCTL_REQ
;
1355 typedef struct smb_com_transaction_ioctl_rsp
{
1356 struct smb_hdr hdr
; /* wct = 19 */
1358 __le32 TotalParameterCount
;
1359 __le32 TotalDataCount
;
1360 __le32 ParameterCount
;
1361 __le32 ParameterOffset
;
1362 __le32 ParameterDisplacement
;
1365 __le32 DataDisplacement
;
1366 __u8 SetupCount
; /* 1 */
1367 __le16 ReturnedDataLen
;
1369 } __attribute__((packed
)) TRANSACT_IOCTL_RSP
;
1371 #define CIFS_ACL_OWNER 1
1372 #define CIFS_ACL_GROUP 2
1373 #define CIFS_ACL_DACL 4
1374 #define CIFS_ACL_SACL 8
1376 typedef struct smb_com_transaction_qsec_req
{
1377 struct smb_hdr hdr
; /* wct = 19 */
1380 __le32 TotalParameterCount
;
1381 __le32 TotalDataCount
;
1382 __le32 MaxParameterCount
;
1383 __le32 MaxDataCount
;
1384 __le32 ParameterCount
;
1385 __le32 ParameterOffset
;
1388 __u8 SetupCount
; /* no setup words follow subcommand */
1389 /* SNIA spec incorrectly included spurious pad here */
1390 __le16 SubCommand
; /* 6 = QUERY_SECURITY_DESC */
1391 __le16 ByteCount
; /* bcc = 3 + 8 */
1396 } __attribute__((packed
)) QUERY_SEC_DESC_REQ
;
1399 typedef struct smb_com_transaction_ssec_req
{
1400 struct smb_hdr hdr
; /* wct = 19 */
1403 __le32 TotalParameterCount
;
1404 __le32 TotalDataCount
;
1405 __le32 MaxParameterCount
;
1406 __le32 MaxDataCount
;
1407 __le32 ParameterCount
;
1408 __le32 ParameterOffset
;
1411 __u8 SetupCount
; /* no setup words follow subcommand */
1412 /* SNIA spec incorrectly included spurious pad here */
1413 __le16 SubCommand
; /* 3 = SET_SECURITY_DESC */
1414 __le16 ByteCount
; /* bcc = 3 + 8 */
1419 } __attribute__((packed
)) SET_SEC_DESC_REQ
;
1421 typedef struct smb_com_transaction_change_notify_req
{
1422 struct smb_hdr hdr
; /* wct = 23 */
1425 __le32 TotalParameterCount
;
1426 __le32 TotalDataCount
;
1427 __le32 MaxParameterCount
;
1428 __le32 MaxDataCount
;
1429 __le32 ParameterCount
;
1430 __le32 ParameterOffset
;
1433 __u8 SetupCount
; /* four setup words follow subcommand */
1434 /* SNIA spec incorrectly included spurious pad here */
1435 __le16 SubCommand
;/* 4 = Change Notify */
1436 __le32 CompletionFilter
; /* operation to monitor */
1438 __u8 WatchTree
; /* 1 = Monitor subdirectories */
1443 } __attribute__((packed
)) TRANSACT_CHANGE_NOTIFY_REQ
;
1445 /* BB eventually change to use generic ntransact rsp struct
1446 and validation routine */
1447 typedef struct smb_com_transaction_change_notify_rsp
{
1448 struct smb_hdr hdr
; /* wct = 18 */
1450 __le32 TotalParameterCount
;
1451 __le32 TotalDataCount
;
1452 __le32 ParameterCount
;
1453 __le32 ParameterOffset
;
1454 __le32 ParameterDisplacement
;
1457 __le32 DataDisplacement
;
1458 __u8 SetupCount
; /* 0 */
1461 } __attribute__((packed
)) TRANSACT_CHANGE_NOTIFY_RSP
;
1462 /* Completion Filter flags for Notify */
1463 #define FILE_NOTIFY_CHANGE_FILE_NAME 0x00000001
1464 #define FILE_NOTIFY_CHANGE_DIR_NAME 0x00000002
1465 #define FILE_NOTIFY_CHANGE_NAME 0x00000003
1466 #define FILE_NOTIFY_CHANGE_ATTRIBUTES 0x00000004
1467 #define FILE_NOTIFY_CHANGE_SIZE 0x00000008
1468 #define FILE_NOTIFY_CHANGE_LAST_WRITE 0x00000010
1469 #define FILE_NOTIFY_CHANGE_LAST_ACCESS 0x00000020
1470 #define FILE_NOTIFY_CHANGE_CREATION 0x00000040
1471 #define FILE_NOTIFY_CHANGE_EA 0x00000080
1472 #define FILE_NOTIFY_CHANGE_SECURITY 0x00000100
1473 #define FILE_NOTIFY_CHANGE_STREAM_NAME 0x00000200
1474 #define FILE_NOTIFY_CHANGE_STREAM_SIZE 0x00000400
1475 #define FILE_NOTIFY_CHANGE_STREAM_WRITE 0x00000800
1477 #define FILE_ACTION_ADDED 0x00000001
1478 #define FILE_ACTION_REMOVED 0x00000002
1479 #define FILE_ACTION_MODIFIED 0x00000003
1480 #define FILE_ACTION_RENAMED_OLD_NAME 0x00000004
1481 #define FILE_ACTION_RENAMED_NEW_NAME 0x00000005
1482 #define FILE_ACTION_ADDED_STREAM 0x00000006
1483 #define FILE_ACTION_REMOVED_STREAM 0x00000007
1484 #define FILE_ACTION_MODIFIED_STREAM 0x00000008
1486 /* response contains array of the following structures */
1487 struct file_notify_information
{
1488 __le32 NextEntryOffset
;
1490 __le32 FileNameLength
;
1492 } __attribute__((packed
));
1494 struct reparse_data
{
1496 __u16 ReparseDataLength
;
1498 __u16 SubstituteNameOffset
;
1499 __u16 SubstituteNameLength
;
1500 __u16 PrintNameOffset
;
1501 __u16 PrintNameLength
;
1504 } __attribute__((packed
));
1506 struct cifs_quota_data
{
1507 __u32 rsrvd1
; /* 0 */
1509 __u64 rsrvd2
; /* 0 */
1513 char sid
[1]; /* variable size? */
1514 } __attribute__((packed
));
1516 /* quota sub commands */
1517 #define QUOTA_LIST_CONTINUE 0
1518 #define QUOTA_LIST_START 0x100
1519 #define QUOTA_FOR_SID 0x101
1522 /* struct smb_hdr hdr precedes. Set wct = 14+ */
1523 __le16 TotalParameterCount
;
1524 __le16 TotalDataCount
;
1525 __le16 MaxParameterCount
;
1526 __le16 MaxDataCount
;
1532 __le16 ParameterCount
;
1533 __le16 ParameterOffset
;
1538 __le16 SubCommand
; /* 1st setup word - SetupCount words follow */
1540 } __attribute__((packed
));
1544 struct trans2_req t2_req
;
1545 } __attribute__((packed
));
1547 struct trans2_resp
{
1548 /* struct smb_hdr hdr precedes. Note wct = 10 + setup count */
1549 __le16 TotalParameterCount
;
1550 __le16 TotalDataCount
;
1552 __le16 ParameterCount
;
1553 __le16 ParameterOffset
;
1554 __le16 ParameterDisplacement
;
1557 __le16 DataDisplacement
;
1560 /* SetupWords[SetupCount];
1563 /* data area follows */
1564 } __attribute__((packed
));
1568 struct trans2_resp t2_rsp
;
1569 } __attribute__((packed
));
1571 /* PathInfo/FileInfo infolevels */
1572 #define SMB_INFO_STANDARD 1
1573 #define SMB_SET_FILE_EA 2
1574 #define SMB_QUERY_FILE_EA_SIZE 2
1575 #define SMB_INFO_QUERY_EAS_FROM_LIST 3
1576 #define SMB_INFO_QUERY_ALL_EAS 4
1577 #define SMB_INFO_IS_NAME_VALID 6
1578 #define SMB_QUERY_FILE_BASIC_INFO 0x101
1579 #define SMB_QUERY_FILE_STANDARD_INFO 0x102
1580 #define SMB_QUERY_FILE_EA_INFO 0x103
1581 #define SMB_QUERY_FILE_NAME_INFO 0x104
1582 #define SMB_QUERY_FILE_ALLOCATION_INFO 0x105
1583 #define SMB_QUERY_FILE_END_OF_FILEINFO 0x106
1584 #define SMB_QUERY_FILE_ALL_INFO 0x107
1585 #define SMB_QUERY_ALT_NAME_INFO 0x108
1586 #define SMB_QUERY_FILE_STREAM_INFO 0x109
1587 #define SMB_QUERY_FILE_COMPRESSION_INFO 0x10B
1588 #define SMB_QUERY_FILE_UNIX_BASIC 0x200
1589 #define SMB_QUERY_FILE_UNIX_LINK 0x201
1590 #define SMB_QUERY_POSIX_ACL 0x204
1591 #define SMB_QUERY_XATTR 0x205 /* e.g. system EA name space */
1592 #define SMB_QUERY_ATTR_FLAGS 0x206 /* append,immutable etc. */
1593 #define SMB_QUERY_POSIX_PERMISSION 0x207
1594 #define SMB_QUERY_POSIX_LOCK 0x208
1595 /* #define SMB_POSIX_OPEN 0x209 */
1596 /* #define SMB_POSIX_UNLINK 0x20a */
1597 #define SMB_QUERY_FILE__UNIX_INFO2 0x20b
1598 #define SMB_QUERY_FILE_INTERNAL_INFO 0x3ee
1599 #define SMB_QUERY_FILE_ACCESS_INFO 0x3f0
1600 #define SMB_QUERY_FILE_NAME_INFO2 0x3f1 /* 0x30 bytes */
1601 #define SMB_QUERY_FILE_POSITION_INFO 0x3f6
1602 #define SMB_QUERY_FILE_MODE_INFO 0x3f8
1603 #define SMB_QUERY_FILE_ALGN_INFO 0x3f9
1606 #define SMB_SET_FILE_BASIC_INFO 0x101
1607 #define SMB_SET_FILE_DISPOSITION_INFO 0x102
1608 #define SMB_SET_FILE_ALLOCATION_INFO 0x103
1609 #define SMB_SET_FILE_END_OF_FILE_INFO 0x104
1610 #define SMB_SET_FILE_UNIX_BASIC 0x200
1611 #define SMB_SET_FILE_UNIX_LINK 0x201
1612 #define SMB_SET_FILE_UNIX_HLINK 0x203
1613 #define SMB_SET_POSIX_ACL 0x204
1614 #define SMB_SET_XATTR 0x205
1615 #define SMB_SET_ATTR_FLAGS 0x206 /* append, immutable etc. */
1616 #define SMB_SET_POSIX_LOCK 0x208
1617 #define SMB_POSIX_OPEN 0x209
1618 #define SMB_POSIX_UNLINK 0x20a
1619 #define SMB_SET_FILE_UNIX_INFO2 0x20b
1620 #define SMB_SET_FILE_BASIC_INFO2 0x3ec
1621 #define SMB_SET_FILE_RENAME_INFORMATION 0x3f2 /* BB check if qpathinfo too */
1622 #define SMB_FILE_ALL_INFO2 0x3fa
1623 #define SMB_SET_FILE_ALLOCATION_INFO2 0x3fb
1624 #define SMB_SET_FILE_END_OF_FILE_INFO2 0x3fc
1625 #define SMB_FILE_MOVE_CLUSTER_INFO 0x407
1626 #define SMB_FILE_QUOTA_INFO 0x408
1627 #define SMB_FILE_REPARSEPOINT_INFO 0x409
1628 #define SMB_FILE_MAXIMUM_INFO 0x40d
1630 /* Find File infolevels */
1631 #define SMB_FIND_FILE_INFO_STANDARD 0x001
1632 #define SMB_FIND_FILE_QUERY_EA_SIZE 0x002
1633 #define SMB_FIND_FILE_QUERY_EAS_FROM_LIST 0x003
1634 #define SMB_FIND_FILE_DIRECTORY_INFO 0x101
1635 #define SMB_FIND_FILE_FULL_DIRECTORY_INFO 0x102
1636 #define SMB_FIND_FILE_NAMES_INFO 0x103
1637 #define SMB_FIND_FILE_BOTH_DIRECTORY_INFO 0x104
1638 #define SMB_FIND_FILE_ID_FULL_DIR_INFO 0x105
1639 #define SMB_FIND_FILE_ID_BOTH_DIR_INFO 0x106
1640 #define SMB_FIND_FILE_UNIX 0x202
1642 typedef struct smb_com_transaction2_qpi_req
{
1643 struct smb_hdr hdr
; /* wct = 14+ */
1644 __le16 TotalParameterCount
;
1645 __le16 TotalDataCount
;
1646 __le16 MaxParameterCount
;
1647 __le16 MaxDataCount
;
1653 __le16 ParameterCount
;
1654 __le16 ParameterOffset
;
1659 __le16 SubCommand
; /* one setup word */
1662 __le16 InformationLevel
;
1665 } __attribute__((packed
)) TRANSACTION2_QPI_REQ
;
1667 typedef struct smb_com_transaction2_qpi_rsp
{
1668 struct smb_hdr hdr
; /* wct = 10 + SetupCount */
1669 struct trans2_resp t2
;
1671 __u16 Reserved2
; /* parameter word is present for infolevels > 100 */
1672 } __attribute__((packed
)) TRANSACTION2_QPI_RSP
;
1674 typedef struct smb_com_transaction2_spi_req
{
1675 struct smb_hdr hdr
; /* wct = 15 */
1676 __le16 TotalParameterCount
;
1677 __le16 TotalDataCount
;
1678 __le16 MaxParameterCount
;
1679 __le16 MaxDataCount
;
1685 __le16 ParameterCount
;
1686 __le16 ParameterOffset
;
1691 __le16 SubCommand
; /* one setup word */
1695 __le16 InformationLevel
;
1698 } __attribute__((packed
)) TRANSACTION2_SPI_REQ
;
1700 typedef struct smb_com_transaction2_spi_rsp
{
1701 struct smb_hdr hdr
; /* wct = 10 + SetupCount */
1702 struct trans2_resp t2
;
1704 __u16 Reserved2
; /* parameter word is present for infolevels > 100 */
1705 } __attribute__((packed
)) TRANSACTION2_SPI_RSP
;
1707 struct set_file_rename
{
1708 __le32 overwrite
; /* 1 = overwrite dest */
1709 __u32 root_fid
; /* zero */
1710 __le32 target_name_len
;
1711 char target_name
[0]; /* Must be unicode */
1712 } __attribute__((packed
));
1714 struct smb_com_transaction2_sfi_req
{
1715 struct smb_hdr hdr
; /* wct = 15 */
1716 __le16 TotalParameterCount
;
1717 __le16 TotalDataCount
;
1718 __le16 MaxParameterCount
;
1719 __le16 MaxDataCount
;
1725 __le16 ParameterCount
;
1726 __le16 ParameterOffset
;
1731 __le16 SubCommand
; /* one setup word */
1736 __le16 InformationLevel
;
1738 } __attribute__((packed
));
1740 struct smb_com_transaction2_sfi_rsp
{
1741 struct smb_hdr hdr
; /* wct = 10 + SetupCount */
1742 struct trans2_resp t2
;
1744 __u16 Reserved2
; /* parameter word reserved -
1745 present for infolevels > 100 */
1746 } __attribute__((packed
));
1748 struct smb_t2_qfi_req
{
1750 struct trans2_req t2
;
1753 __le16 InformationLevel
;
1754 } __attribute__((packed
));
1756 struct smb_t2_qfi_rsp
{
1757 struct smb_hdr hdr
; /* wct = 10 + SetupCount */
1758 struct trans2_resp t2
;
1760 __u16 Reserved2
; /* parameter word reserved -
1761 present for infolevels > 100 */
1762 } __attribute__((packed
));
1765 * Flags on T2 FINDFIRST and FINDNEXT
1767 #define CIFS_SEARCH_CLOSE_ALWAYS 0x0001
1768 #define CIFS_SEARCH_CLOSE_AT_END 0x0002
1769 #define CIFS_SEARCH_RETURN_RESUME 0x0004
1770 #define CIFS_SEARCH_CONTINUE_FROM_LAST 0x0008
1771 #define CIFS_SEARCH_BACKUP_SEARCH 0x0010
1774 * Size of the resume key on FINDFIRST and FINDNEXT calls
1776 #define CIFS_SMB_RESUME_KEY_SIZE 4
1778 typedef struct smb_com_transaction2_ffirst_req
{
1779 struct smb_hdr hdr
; /* wct = 15 */
1780 __le16 TotalParameterCount
;
1781 __le16 TotalDataCount
;
1782 __le16 MaxParameterCount
;
1783 __le16 MaxDataCount
;
1789 __le16 ParameterCount
;
1790 __le16 ParameterOffset
;
1793 __u8 SetupCount
; /* one */
1795 __le16 SubCommand
; /* TRANS2_FIND_FIRST */
1798 __le16 SearchAttributes
;
1801 __le16 InformationLevel
;
1802 __le32 SearchStorageType
;
1804 } __attribute__((packed
)) TRANSACTION2_FFIRST_REQ
;
1806 typedef struct smb_com_transaction2_ffirst_rsp
{
1807 struct smb_hdr hdr
; /* wct = 10 */
1808 struct trans2_resp t2
;
1810 } __attribute__((packed
)) TRANSACTION2_FFIRST_RSP
;
1812 typedef struct smb_com_transaction2_ffirst_rsp_parms
{
1816 __le16 EAErrorOffset
;
1817 __le16 LastNameOffset
;
1818 } __attribute__((packed
)) T2_FFIRST_RSP_PARMS
;
1820 typedef struct smb_com_transaction2_fnext_req
{
1821 struct smb_hdr hdr
; /* wct = 15 */
1822 __le16 TotalParameterCount
;
1823 __le16 TotalDataCount
;
1824 __le16 MaxParameterCount
;
1825 __le16 MaxDataCount
;
1831 __le16 ParameterCount
;
1832 __le16 ParameterOffset
;
1835 __u8 SetupCount
; /* one */
1837 __le16 SubCommand
; /* TRANS2_FIND_NEXT */
1842 __le16 InformationLevel
;
1845 char ResumeFileName
[1];
1846 } __attribute__((packed
)) TRANSACTION2_FNEXT_REQ
;
1848 typedef struct smb_com_transaction2_fnext_rsp
{
1849 struct smb_hdr hdr
; /* wct = 10 */
1850 struct trans2_resp t2
;
1852 } __attribute__((packed
)) TRANSACTION2_FNEXT_RSP
;
1854 typedef struct smb_com_transaction2_fnext_rsp_parms
{
1857 __le16 EAErrorOffset
;
1858 __le16 LastNameOffset
;
1859 } __attribute__((packed
)) T2_FNEXT_RSP_PARMS
;
1861 /* QFSInfo Levels */
1862 #define SMB_INFO_ALLOCATION 1
1863 #define SMB_INFO_VOLUME 2
1864 #define SMB_QUERY_FS_VOLUME_INFO 0x102
1865 #define SMB_QUERY_FS_SIZE_INFO 0x103
1866 #define SMB_QUERY_FS_DEVICE_INFO 0x104
1867 #define SMB_QUERY_FS_ATTRIBUTE_INFO 0x105
1868 #define SMB_QUERY_CIFS_UNIX_INFO 0x200
1869 #define SMB_QUERY_POSIX_FS_INFO 0x201
1870 #define SMB_QUERY_POSIX_WHO_AM_I 0x202
1871 #define SMB_REQUEST_TRANSPORT_ENCRYPTION 0x203
1872 #define SMB_QUERY_FS_PROXY 0x204 /* WAFS enabled. Returns structure
1873 FILE_SYSTEM__UNIX_INFO to tell
1874 whether new NTIOCTL available
1875 (0xACE) for WAN friendly SMB
1876 operations to be carried */
1877 #define SMB_QUERY_LABEL_INFO 0x3ea
1878 #define SMB_QUERY_FS_QUOTA_INFO 0x3ee
1879 #define SMB_QUERY_FS_FULL_SIZE_INFO 0x3ef
1880 #define SMB_QUERY_OBJECTID_INFO 0x3f0
1882 typedef struct smb_com_transaction2_qfsi_req
{
1883 struct smb_hdr hdr
; /* wct = 14+ */
1884 __le16 TotalParameterCount
;
1885 __le16 TotalDataCount
;
1886 __le16 MaxParameterCount
;
1887 __le16 MaxDataCount
;
1893 __le16 ParameterCount
;
1894 __le16 ParameterOffset
;
1899 __le16 SubCommand
; /* one setup word */
1902 __le16 InformationLevel
;
1903 } __attribute__((packed
)) TRANSACTION2_QFSI_REQ
;
1905 typedef struct smb_com_transaction_qfsi_rsp
{
1906 struct smb_hdr hdr
; /* wct = 10 + SetupCount */
1907 struct trans2_resp t2
;
1909 __u8 Pad
; /* may be three bytes? *//* followed by data area */
1910 } __attribute__((packed
)) TRANSACTION2_QFSI_RSP
;
1912 typedef struct whoami_rsp_data
{ /* Query level 0x202 */
1913 __u32 flags
; /* 0 = Authenticated user 1 = GUEST */
1914 __u32 mask
; /* which flags bits server understands ie 0x0001 */
1916 __u64 unix_user_gid
;
1917 __u32 number_of_supplementary_gids
; /* may be zero */
1918 __u32 number_of_sids
; /* may be zero */
1919 __u32 length_of_sid_array
; /* in bytes - may be zero */
1920 __u32 pad
; /* reserved - MBZ */
1921 /* __u64 gid_array[0]; */ /* may be empty */
1922 /* __u8 * psid_list */ /* may be empty */
1923 } __attribute__((packed
)) WHOAMI_RSP_DATA
;
1925 /* SETFSInfo Levels */
1926 #define SMB_SET_CIFS_UNIX_INFO 0x200
1927 /* level 0x203 is defined above in list of QFS info levels */
1928 /* #define SMB_REQUEST_TRANSPORT_ENCRYPTION 0x203 */
1930 /* Level 0x200 request structure follows */
1931 typedef struct smb_com_transaction2_setfsi_req
{
1932 struct smb_hdr hdr
; /* wct = 15 */
1933 __le16 TotalParameterCount
;
1934 __le16 TotalDataCount
;
1935 __le16 MaxParameterCount
;
1936 __le16 MaxDataCount
;
1942 __le16 ParameterCount
; /* 4 */
1943 __le16 ParameterOffset
;
1944 __le16 DataCount
; /* 12 */
1946 __u8 SetupCount
; /* one */
1948 __le16 SubCommand
; /* TRANS2_SET_FS_INFORMATION */
1951 __u16 FileNum
; /* Parameters start. */
1952 __le16 InformationLevel
;/* Parameters end. */
1953 __le16 ClientUnixMajor
; /* Data start. */
1954 __le16 ClientUnixMinor
;
1955 __le64 ClientUnixCap
; /* Data end */
1956 } __attribute__((packed
)) TRANSACTION2_SETFSI_REQ
;
1958 /* level 0x203 request structure follows */
1959 typedef struct smb_com_transaction2_setfs_enc_req
{
1960 struct smb_hdr hdr
; /* wct = 15 */
1961 __le16 TotalParameterCount
;
1962 __le16 TotalDataCount
;
1963 __le16 MaxParameterCount
;
1964 __le16 MaxDataCount
;
1970 __le16 ParameterCount
; /* 4 */
1971 __le16 ParameterOffset
;
1972 __le16 DataCount
; /* 12 */
1974 __u8 SetupCount
; /* one */
1976 __le16 SubCommand
; /* TRANS2_SET_FS_INFORMATION */
1979 __u16 Reserved4
; /* Parameters start. */
1980 __le16 InformationLevel
;/* Parameters end. */
1981 /* NTLMSSP Blob, Data start. */
1982 } __attribute__((packed
)) TRANSACTION2_SETFSI_ENC_REQ
;
1984 /* response for setfsinfo levels 0x200 and 0x203 */
1985 typedef struct smb_com_transaction2_setfsi_rsp
{
1986 struct smb_hdr hdr
; /* wct = 10 */
1987 struct trans2_resp t2
;
1989 } __attribute__((packed
)) TRANSACTION2_SETFSI_RSP
;
1991 typedef struct smb_com_transaction2_get_dfs_refer_req
{
1992 struct smb_hdr hdr
; /* wct = 15 */
1993 __le16 TotalParameterCount
;
1994 __le16 TotalDataCount
;
1995 __le16 MaxParameterCount
;
1996 __le16 MaxDataCount
;
2002 __le16 ParameterCount
;
2003 __le16 ParameterOffset
;
2008 __le16 SubCommand
; /* one setup word */
2010 __u8 Pad
[3]; /* Win2K has sent 0x0F01 (max response length
2011 perhaps?) followed by one byte pad - doesn't
2012 seem to matter though */
2013 __le16 MaxReferralLevel
;
2014 char RequestFileName
[1];
2015 } __attribute__((packed
)) TRANSACTION2_GET_DFS_REFER_REQ
;
2017 #define DFS_VERSION cpu_to_le16(0x0003)
2019 /* DFS server target type */
2020 #define DFS_TYPE_LINK 0x0000 /* also for sysvol targets */
2021 #define DFS_TYPE_ROOT 0x0001
2023 /* Referral Entry Flags */
2024 #define DFS_NAME_LIST_REF 0x0200 /* set for domain or DC referral responses */
2025 #define DFS_TARGET_SET_BOUNDARY 0x0400 /* only valid with version 4 dfs req */
2027 typedef struct dfs_referral_level_3
{ /* version 4 is same, + one flag bit */
2028 __le16 VersionNumber
; /* must be 3 or 4 */
2030 __le16 ServerType
; /* 0x0001 = root targets; 0x0000 = link targets */
2031 __le16 ReferralEntryFlags
;
2033 __le16 DfsPathOffset
;
2034 __le16 DfsAlternatePathOffset
;
2035 __le16 NetworkAddressOffset
; /* offset of the link target */
2036 __u8 ServiceSiteGuid
[16]; /* MBZ, ignored */
2037 } __attribute__((packed
)) REFERRAL3
;
2039 typedef struct smb_com_transaction_get_dfs_refer_rsp
{
2040 struct smb_hdr hdr
; /* wct = 10 */
2041 struct trans2_resp t2
;
2044 __le16 PathConsumed
;
2045 __le16 NumberOfReferrals
;
2047 REFERRAL3 referrals
[1]; /* array of level 3 dfs_referral structures */
2048 /* followed by the strings pointed to by the referral structures */
2049 } __attribute__((packed
)) TRANSACTION2_GET_DFS_REFER_RSP
;
2052 #define DFSREF_REFERRAL_SERVER 0x00000001 /* all targets are DFS roots */
2053 #define DFSREF_STORAGE_SERVER 0x00000002 /* no further ref requests needed */
2054 #define DFSREF_TARGET_FAILBACK 0x00000004 /* only for DFS referral version 4 */
2057 ************************************************************************
2058 * All structs for everything above the SMB PDUs themselves
2059 * (such as the T2 level specific data) go here
2060 ************************************************************************
2064 * Information on a server
2069 unsigned char versionMajor
;
2070 unsigned char versionMinor
;
2072 unsigned int commentOffset
;
2073 } __attribute__((packed
));
2076 * The following structure is the format of the data returned on a NetShareEnum
2077 * with level "90" (x5A)
2083 unsigned short type
;
2084 unsigned int commentOffset
;
2085 } __attribute__((packed
));
2090 unsigned int commentOffset
;
2091 unsigned char type
[2];
2092 } __attribute__((packed
));
2094 struct aliasInfo92
{
2095 int aliasNameOffset
;
2096 int serverNameOffset
;
2097 int shareNameOffset
;
2098 } __attribute__((packed
));
2101 __le64 TotalAllocationUnits
;
2102 __le64 FreeAllocationUnits
;
2103 __le32 SectorsPerAllocationUnit
;
2104 __le32 BytesPerSector
;
2105 } __attribute__((packed
)) FILE_SYSTEM_INFO
; /* size info, level 0x103 */
2109 __le32 SectorsPerAllocationUnit
;
2110 __le32 TotalAllocationUnits
;
2111 __le32 FreeAllocationUnits
;
2112 __le16 BytesPerSector
;
2113 } __attribute__((packed
)) FILE_SYSTEM_ALLOC_INFO
;
2116 __le16 MajorVersionNumber
;
2117 __le16 MinorVersionNumber
;
2119 } __attribute__((packed
)) FILE_SYSTEM_UNIX_INFO
; /* Unix extension level 0x200*/
2121 /* Version numbers for CIFS UNIX major and minor. */
2122 #define CIFS_UNIX_MAJOR_VERSION 1
2123 #define CIFS_UNIX_MINOR_VERSION 0
2125 /* Linux/Unix extensions capability flags */
2126 #define CIFS_UNIX_FCNTL_CAP 0x00000001 /* support for fcntl locks */
2127 #define CIFS_UNIX_POSIX_ACL_CAP 0x00000002 /* support getfacl/setfacl */
2128 #define CIFS_UNIX_XATTR_CAP 0x00000004 /* support new namespace */
2129 #define CIFS_UNIX_EXTATTR_CAP 0x00000008 /* support chattr/chflag */
2130 #define CIFS_UNIX_POSIX_PATHNAMES_CAP 0x00000010 /* Allow POSIX path chars */
2131 #define CIFS_UNIX_POSIX_PATH_OPS_CAP 0x00000020 /* Allow new POSIX path based
2132 calls including posix open
2134 #define CIFS_UNIX_LARGE_READ_CAP 0x00000040 /* support reads >128K (up
2136 #define CIFS_UNIX_LARGE_WRITE_CAP 0x00000080
2137 #define CIFS_UNIX_TRANSPORT_ENCRYPTION_CAP 0x00000100 /* can do SPNEGO crypt */
2138 #define CIFS_UNIX_TRANSPORT_ENCRYPTION_MANDATORY_CAP 0x00000200 /* must do */
2139 #define CIFS_UNIX_PROXY_CAP 0x00000400 /* Proxy cap: 0xACE ioctl and
2141 #ifdef CONFIG_CIFS_POSIX
2142 /* presumably don't need the 0x20 POSIX_PATH_OPS_CAP since we never send
2143 LockingX instead of posix locking call on unix sess (and we do not expect
2144 LockingX to use different (ie Windows) semantics than posix locking on
2145 the same session (if WINE needs to do this later, we can add this cap
2147 /* #define CIFS_UNIX_CAP_MASK 0x000000fb */
2148 #define CIFS_UNIX_CAP_MASK 0x000003db
2150 #define CIFS_UNIX_CAP_MASK 0x00000013
2151 #endif /* CONFIG_CIFS_POSIX */
2154 #define CIFS_POSIX_EXTENSIONS 0x00000010 /* support for new QFSInfo */
2157 /* For undefined recommended transfer size return -1 in that field */
2158 __le32 OptimalTransferSize
; /* bsize on some os, iosize on other os */
2160 /* The next three fields are in terms of the block size.
2161 (above). If block size is unknown, 4096 would be a
2162 reasonable block size for a server to report.
2163 Note that returning the blocks/blocksavail removes need
2164 to make a second call (to QFSInfo level 0x103 to get this info.
2165 UserBlockAvail is typically less than or equal to BlocksAvail,
2166 if no distinction is made return the same value in each */
2168 __le64 BlocksAvail
; /* bfree */
2169 __le64 UserBlocksAvail
; /* bavail */
2170 /* For undefined Node fields or FSID return -1 */
2171 __le64 TotalFileNodes
;
2172 __le64 FreeFileNodes
;
2173 __le64 FileSysIdentifier
; /* fsid */
2174 /* NB Namelen comes from FILE_SYSTEM_ATTRIBUTE_INFO call */
2175 /* NB flags can come from FILE_SYSTEM_DEVICE_INFO call */
2176 } __attribute__((packed
)) FILE_SYSTEM_POSIX_INFO
;
2178 /* DeviceType Flags */
2179 #define FILE_DEVICE_CD_ROM 0x00000002
2180 #define FILE_DEVICE_CD_ROM_FILE_SYSTEM 0x00000003
2181 #define FILE_DEVICE_DFS 0x00000006
2182 #define FILE_DEVICE_DISK 0x00000007
2183 #define FILE_DEVICE_DISK_FILE_SYSTEM 0x00000008
2184 #define FILE_DEVICE_FILE_SYSTEM 0x00000009
2185 #define FILE_DEVICE_NAMED_PIPE 0x00000011
2186 #define FILE_DEVICE_NETWORK 0x00000012
2187 #define FILE_DEVICE_NETWORK_FILE_SYSTEM 0x00000014
2188 #define FILE_DEVICE_NULL 0x00000015
2189 #define FILE_DEVICE_PARALLEL_PORT 0x00000016
2190 #define FILE_DEVICE_PRINTER 0x00000018
2191 #define FILE_DEVICE_SERIAL_PORT 0x0000001b
2192 #define FILE_DEVICE_STREAMS 0x0000001e
2193 #define FILE_DEVICE_TAPE 0x0000001f
2194 #define FILE_DEVICE_TAPE_FILE_SYSTEM 0x00000020
2195 #define FILE_DEVICE_VIRTUAL_DISK 0x00000024
2196 #define FILE_DEVICE_NETWORK_REDIRECTOR 0x00000028
2200 __le32 DeviceCharacteristics
;
2201 } __attribute__((packed
)) FILE_SYSTEM_DEVICE_INFO
; /* device info level 0x104 */
2205 __le32 MaxPathNameComponentLength
;
2206 __le32 FileSystemNameLen
;
2207 char FileSystemName
[52]; /* do not have to save this - get subset? */
2208 } __attribute__((packed
)) FILE_SYSTEM_ATTRIBUTE_INFO
;
2210 /******************************************************************************/
2211 /* QueryFileInfo/QueryPathinfo (also for SetPath/SetFile) data buffer formats */
2212 /******************************************************************************/
2213 typedef struct { /* data block encoding of response to level 263 QPathInfo */
2214 __le64 CreationTime
;
2215 __le64 LastAccessTime
;
2216 __le64 LastWriteTime
;
2220 __le64 AllocationSize
;
2221 __le64 EndOfFile
; /* size ie offset to first free byte in file */
2222 __le32 NumberOfLinks
; /* hard links */
2230 __le64 CurrentByteOffset
;
2232 __le32 AlignmentRequirement
;
2233 __le32 FileNameLength
;
2235 } __attribute__((packed
)) FILE_ALL_INFO
; /* level 0x107 QPathInfo */
2237 /* defines for enumerating possible values of the Unix type field below */
2240 #define UNIX_SYMLINK 2
2241 #define UNIX_CHARDEV 3
2242 #define UNIX_BLOCKDEV 4
2244 #define UNIX_SOCKET 6
2248 __le64 LastStatusChange
; /*SNIA specs DCE time for the 3 time fields */
2249 __le64 LastAccessTime
;
2250 __le64 LastModificationTime
;
2259 } __attribute__((packed
)) FILE_UNIX_BASIC_INFO
; /* level 0x200 QPathInfo */
2263 } __attribute__((packed
)) FILE_UNIX_LINK_INFO
; /* level 0x201 QPathInfo */
2265 /* The following three structures are needed only for
2266 setting time to NT4 and some older servers via
2267 the primitive DOS time format */
2272 } __attribute__((packed
)) SMB_DATE
;
2278 } __attribute__((packed
)) SMB_TIME
;
2281 __le16 CreationDate
; /* SMB Date see above */
2282 __le16 CreationTime
; /* SMB Time */
2283 __le16 LastAccessDate
;
2284 __le16 LastAccessTime
;
2285 __le16 LastWriteDate
;
2286 __le16 LastWriteTime
;
2287 __le32 DataSize
; /* File Size (EOF) */
2288 __le32 AllocationSize
;
2289 __le16 Attributes
; /* verify not u32 */
2291 } __attribute__((packed
)) FILE_INFO_STANDARD
; /* level 1 SetPath/FileInfo */
2294 __le64 CreationTime
;
2295 __le64 LastAccessTime
;
2296 __le64 LastWriteTime
;
2300 } __attribute__((packed
)) FILE_BASIC_INFO
; /* size info, level 0x101 */
2302 struct file_allocation_info
{
2303 __le64 AllocationSize
; /* Note old Samba srvr rounds this up too much */
2304 } __attribute__((packed
)); /* size used on disk, for level 0x103 for set,
2307 struct file_end_of_file_info
{
2308 __le64 FileSize
; /* offset to end of file */
2309 } __attribute__((packed
)); /* size info, level 0x104 for set, 0x106 for query */
2311 struct file_alt_name_info
{
2313 } __attribute__((packed
)); /* level 0x0108 */
2315 struct file_stream_info
{
2316 __le32 number_of_streams
; /* BB check sizes and verify location */
2317 /* followed by info on streams themselves
2321 }; /* level 0x109 */
2323 struct file_compression_info
{
2324 __le64 compressed_size
;
2330 } __attribute__((packed
)); /* level 0x10b */
2332 /* POSIX ACL set/query path info structures */
2333 #define CIFS_ACL_VERSION 1
2334 struct cifs_posix_ace
{ /* access control entry (ACE) */
2337 __le64 cifs_uid
; /* or gid */
2338 } __attribute__((packed
));
2340 struct cifs_posix_acl
{ /* access conrol list (ACL) */
2342 __le16 access_entry_count
; /* access ACL - count of entries */
2343 __le16 default_entry_count
; /* default ACL - count of entries */
2344 struct cifs_posix_ace ace_array
[0];
2346 struct cifs_posix_ace default_ace_arraay[] */
2347 } __attribute__((packed
)); /* level 0x204 */
2349 /* types of access control entries already defined in posix_acl.h */
2350 /* #define CIFS_POSIX_ACL_USER_OBJ 0x01
2351 #define CIFS_POSIX_ACL_USER 0x02
2352 #define CIFS_POSIX_ACL_GROUP_OBJ 0x04
2353 #define CIFS_POSIX_ACL_GROUP 0x08
2354 #define CIFS_POSIX_ACL_MASK 0x10
2355 #define CIFS_POSIX_ACL_OTHER 0x20 */
2357 /* types of perms */
2358 /* #define CIFS_POSIX_ACL_EXECUTE 0x01
2359 #define CIFS_POSIX_ACL_WRITE 0x02
2360 #define CIFS_POSIX_ACL_READ 0x04 */
2362 /* end of POSIX ACL definitions */
2364 /* POSIX Open Flags */
2365 #define SMB_O_RDONLY 0x1
2366 #define SMB_O_WRONLY 0x2
2367 #define SMB_O_RDWR 0x4
2368 #define SMB_O_CREAT 0x10
2369 #define SMB_O_EXCL 0x20
2370 #define SMB_O_TRUNC 0x40
2371 #define SMB_O_APPEND 0x80
2372 #define SMB_O_SYNC 0x100
2373 #define SMB_O_DIRECTORY 0x200
2374 #define SMB_O_NOFOLLOW 0x400
2375 #define SMB_O_DIRECT 0x800
2378 __le32 OpenFlags
; /* same as NT CreateX */
2379 __le32 PosixOpenFlags
;
2381 __le16 Level
; /* reply level requested (see QPathInfo levels) */
2382 } __attribute__((packed
)) OPEN_PSX_REQ
; /* level 0x209 SetPathInfo data */
2387 __le32 CreateAction
;
2388 __le16 ReturnedLevel
;
2390 /* struct following varies based on requested level */
2391 } __attribute__((packed
)) OPEN_PSX_RSP
; /* level 0x209 SetPathInfo data */
2393 #define SMB_POSIX_UNLINK_FILE_TARGET 0
2394 #define SMB_POSIX_UNLINK_DIRECTORY_TARGET 1
2396 struct unlink_psx_rq
{ /* level 0x20a SetPathInfo */
2398 } __attribute__((packed
));
2400 struct file_internal_info
{
2401 __le64 UniqueId
; /* inode number */
2402 } __attribute__((packed
)); /* level 0x3ee */
2404 struct file_mode_info
{
2406 } __attribute__((packed
)); /* level 0x3f8 */
2408 struct file_attrib_tag
{
2411 } __attribute__((packed
)); /* level 0x40b */
2414 /********************************************************/
2415 /* FindFirst/FindNext transact2 data buffer formats */
2416 /********************************************************/
2419 __le32 NextEntryOffset
;
2420 __u32 ResumeKey
; /* as with FileIndex - no need to convert */
2421 FILE_UNIX_BASIC_INFO basic
;
2423 } __attribute__((packed
)) FILE_UNIX_INFO
; /* level 0x202 */
2426 __le32 NextEntryOffset
;
2428 __le64 CreationTime
;
2429 __le64 LastAccessTime
;
2430 __le64 LastWriteTime
;
2433 __le64 AllocationSize
;
2434 __le32 ExtFileAttributes
;
2435 __le32 FileNameLength
;
2437 } __attribute__((packed
)) FILE_DIRECTORY_INFO
; /* level 0x101 FF resp data */
2440 __le32 NextEntryOffset
;
2442 __le64 CreationTime
;
2443 __le64 LastAccessTime
;
2444 __le64 LastWriteTime
;
2447 __le64 AllocationSize
;
2448 __le32 ExtFileAttributes
;
2449 __le32 FileNameLength
;
2450 __le32 EaSize
; /* length of the xattrs */
2452 } __attribute__((packed
)) FILE_FULL_DIRECTORY_INFO
; /* level 0x102 rsp data */
2455 __le32 NextEntryOffset
;
2457 __le64 CreationTime
;
2458 __le64 LastAccessTime
;
2459 __le64 LastWriteTime
;
2462 __le64 AllocationSize
;
2463 __le32 ExtFileAttributes
;
2464 __le32 FileNameLength
;
2465 __le32 EaSize
; /* EA size */
2467 __le64 UniqueId
; /* inode num - le since Samba puts ino in low 32 bit*/
2469 } __attribute__((packed
)) SEARCH_ID_FULL_DIR_INFO
; /* level 0x105 FF rsp data */
2472 __le32 NextEntryOffset
;
2474 __le64 CreationTime
;
2475 __le64 LastAccessTime
;
2476 __le64 LastWriteTime
;
2479 __le64 AllocationSize
;
2480 __le32 ExtFileAttributes
;
2481 __le32 FileNameLength
;
2482 __le32 EaSize
; /* length of the xattrs */
2483 __u8 ShortNameLength
;
2487 } __attribute__((packed
)) FILE_BOTH_DIRECTORY_INFO
; /* level 0x104 FFrsp data */
2491 __le16 CreationDate
; /* SMB Date */
2492 __le16 CreationTime
; /* SMB Time */
2493 __le16 LastAccessDate
;
2494 __le16 LastAccessTime
;
2495 __le16 LastWriteDate
;
2496 __le16 LastWriteTime
;
2497 __le32 DataSize
; /* File Size (EOF) */
2498 __le32 AllocationSize
;
2499 __le16 Attributes
; /* verify not u32 */
2500 __u8 FileNameLength
;
2502 } __attribute__((packed
)) FIND_FILE_STANDARD_INFO
; /* level 0x1 FF resp data */
2506 unsigned char type
[8]; /* IntxCHR or IntxBLK */
2509 } __attribute__((packed
));
2512 unsigned char name_len
;
2514 } __attribute__((packed
));
2517 unsigned long list_len
;
2519 } __attribute__((packed
));
2522 unsigned char EA_flags
;
2526 /* optionally followed by value */
2527 } __attribute__((packed
));
2528 /* flags for _FEA.fEA */
2529 #define FEA_NEEDEA 0x80 /* need EA bit */
2534 } __attribute__((packed
));
2536 /* used to hold an arbitrary blob of data */
2540 void (*free
) (struct data_blob
*data_blob
);
2541 } __attribute__((packed
));
2544 #ifdef CONFIG_CIFS_POSIX
2546 For better POSIX semantics from Linux client, (even better
2547 than the existing CIFS Unix Extensions) we need updated PDUs for:
2549 1) PosixCreateX - to set and return the mode, inode#, device info and
2550 perhaps add a CreateDevice - to create Pipes and other special .inodes
2551 Also note POSIX open flags
2552 2) Close - to return the last write time to do cache across close
2554 3) FindFirst return unique inode number - what about resume key, two
2555 forms short (matches readdir) and full (enough info to cache inodes)
2558 And under consideration:
2559 5) FindClose2 (return nanosecond timestamp ??)
2560 6) Use nanosecond timestamps throughout all time fields if
2561 corresponding attribute flag is set
2562 7) sendfile - handle based copy
2564 what about fixing 64 bit alignment
2566 There are also various legacy SMB/CIFS requests used as is
2568 From existing Lanman and NTLM dialects:
2569 --------------------------------------
2571 SESSION_SETUP_ANDX (BB which?)
2572 TREE_CONNECT_ANDX (BB which wct?)
2573 TREE_DISCONNECT (BB add volume timestamp on response)
2575 DELETE (note delete open file behavior)
2579 LOCKING_AND_X (note posix lock semantics)
2580 RENAME (note rename across dirs and open file rename posix behaviors)
2581 NT_RENAME (for hardlinks) Is this good enough for all features?
2583 TRANSACTION2 (18 cases)
2584 SMB_SET_FILE_END_OF_FILE_INFO2 SMB_SET_PATH_END_OF_FILE_INFO2
2585 (BB verify that never need to set allocation size)
2586 SMB_SET_FILE_BASIC_INFO2 (setting times - BB can it be done via
2589 COPY (note support for copy across directories) - FUTURE, OPTIONAL
2590 setting/getting OS/2 EAs - FUTURE (BB can this handle
2591 setting Linux xattrs perfectly) - OPTIONAL
2592 dnotify - FUTURE, OPTIONAL
2593 quota - FUTURE, OPTIONAL
2595 Note that various requests implemented for NT interop such as
2596 NT_TRANSACT (IOCTL) QueryReparseInfo
2597 are unneeded to servers compliant with the CIFS POSIX extensions
2599 From CIFS Unix Extensions:
2600 -------------------------
2601 T2 SET_PATH_INFO (SMB_SET_FILE_UNIX_LINK) for symlinks
2602 T2 SET_PATH_INFO (SMB_SET_FILE_BASIC_INFO2)
2603 T2 QUERY_PATH_INFO (SMB_QUERY_FILE_UNIX_LINK)
2604 T2 QUERY_PATH_INFO (SMB_QUERY_FILE_UNIX_BASIC) BB check for missing
2606 Actually a need QUERY_FILE_UNIX_INFO
2608 BB what about a) blksize/blkbits/blocks
2614 T2 FIND_FIRST/FIND_NEXT FIND_FILE_UNIX
2615 TRANS2_GET_DFS_REFERRAL - OPTIONAL but recommended
2616 T2_QFS_INFO QueryDevice/AttributeInfo - OPTIONAL
2619 /* xsymlink is a symlink format (used by MacOS) that can be used
2620 to save symlink info in a regular file when
2621 mounted to operating systems that do not
2622 support the cifs Unix extensions or EAs (for xattr
2623 based symlinks). For such a file to be recognized
2624 as containing symlink data:
2626 1) file size must be 1067,
2627 2) signature must begin file data,
2628 3) length field must be set to ASCII representation
2629 of a number which is less than or equal to 1024,
2630 4) md5 must match that of the path data */
2634 char signature
[4]; /* XSym */ /* not null terminated */
2636 /* ASCII representation of length (4 bytes decimal) terminated by \n not null */
2639 /* md5 of valid subset of path ie path[0] through path[length-1] */
2642 /* if room left, then end with \n then 0x20s by convention but not required */
2644 } __attribute__((packed
));
2646 typedef struct file_xattr_info
{
2647 /* BB do we need another field for flags? BB */
2648 __u32 xattr_name_len
;
2649 __u32 xattr_value_len
;
2651 /* followed by xattr_value[xattr_value_len], no pad */
2652 } __attribute__((packed
)) FILE_XATTR_INFO
; /* extended attribute info
2656 /* flags for chattr command */
2657 #define EXT_SECURE_DELETE 0x00000001 /* EXT3_SECRM_FL */
2658 #define EXT_ENABLE_UNDELETE 0x00000002 /* EXT3_UNRM_FL */
2659 /* Reserved for compress file 0x4 */
2660 #define EXT_SYNCHRONOUS 0x00000008 /* EXT3_SYNC_FL */
2661 #define EXT_IMMUTABLE_FL 0x00000010 /* EXT3_IMMUTABLE_FL */
2662 #define EXT_OPEN_APPEND_ONLY 0x00000020 /* EXT3_APPEND_FL */
2663 #define EXT_DO_NOT_BACKUP 0x00000040 /* EXT3_NODUMP_FL */
2664 #define EXT_NO_UPDATE_ATIME 0x00000080 /* EXT3_NOATIME_FL */
2665 /* 0x100 through 0x800 reserved for compression flags and are GET-ONLY */
2666 #define EXT_HASH_TREE_INDEXED_DIR 0x00001000 /* GET-ONLY EXT3_INDEX_FL */
2667 /* 0x2000 reserved for IMAGIC_FL */
2668 #define EXT_JOURNAL_THIS_FILE 0x00004000 /* GET-ONLY EXT3_JOURNAL_DATA_FL */
2669 /* 0x8000 reserved for EXT3_NOTAIL_FL */
2670 #define EXT_SYNCHRONOUS_DIR 0x00010000 /* EXT3_DIRSYNC_FL */
2671 #define EXT_TOPDIR 0x00020000 /* EXT3_TOPDIR_FL */
2673 #define EXT_SET_MASK 0x000300FF
2674 #define EXT_GET_MASK 0x0003DFFF
2676 typedef struct file_chattr_info
{
2677 __le64 mask
; /* list of all possible attribute bits */
2678 __le64 mode
; /* list of actual attribute bits on this inode */
2679 } __attribute__((packed
)) FILE_CHATTR_INFO
; /* ext attributes
2680 (chattr, chflags) level 0x206 */
2682 #endif /* _CIFSPDU_H */