]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
smb: add documentation references for smb2 change notify definitions
authorChenXiaoSong <chenxiaosong@kylinos.cn>
Mon, 1 Dec 2025 07:40:14 +0000 (15:40 +0800)
committerSteve French <stfrench@microsoft.com>
Wed, 10 Dec 2025 03:22:01 +0000 (21:22 -0600)
To make it easier to locate the documentation during development.

Signed-off-by: ChenXiaoSong <chenxiaosong@kylinos.cn>
Signed-off-by: Steve French <stfrench@microsoft.com>
fs/smb/client/cifspdu.h
fs/smb/common/smb2pdu.h

index 37b23664ddf3ba507848aef22572eddd69bad835..d8e3a7e950201dc21ca5c4a4c6ced6ca54f81ba8 100644 (file)
@@ -1381,7 +1381,10 @@ typedef struct smb_com_transaction_change_notify_rsp {
 #define FILE_ACTION_REMOVED_STREAM     0x00000007
 #define FILE_ACTION_MODIFIED_STREAM    0x00000008
 
-/* response contains array of the following structures */
+/*
+ * response contains array of the following structures
+ * See MS-FSCC 2.7.1
+ */
 struct file_notify_information {
        __le32 NextEntryOffset;
        __le32 Action;
index 945a8e0cf36c2641bdf18919bf6e9109a8a19bd7..d5413029b59a7ccf870d629259c7e619606a4280 100644 (file)
@@ -1002,7 +1002,10 @@ struct smb2_set_info_rsp {
 #define FILE_NOTIFY_CHANGE_STREAM_SIZE         0x00000400
 #define FILE_NOTIFY_CHANGE_STREAM_WRITE                0x00000800
 
-/* SMB2 Notify Action Flags */
+/*
+ * SMB2 Notify Action Flags
+ * See MS-FSCC 2.7.1
+ */
 #define FILE_ACTION_ADDED                       0x00000001
 #define FILE_ACTION_REMOVED                     0x00000002
 #define FILE_ACTION_MODIFIED                    0x00000003
@@ -1013,6 +1016,7 @@ struct smb2_set_info_rsp {
 #define FILE_ACTION_MODIFIED_STREAM             0x00000008
 #define FILE_ACTION_REMOVED_BY_DELETE           0x00000009
 
+/* See MS-SMB2 2.2.35 */
 struct smb2_change_notify_req {
        struct smb2_hdr hdr;
        __le16  StructureSize;
@@ -1024,6 +1028,7 @@ struct smb2_change_notify_req {
        __u32   Reserved;
 } __packed;
 
+/* See MS-SMB2 2.2.36 */
 struct smb2_change_notify_rsp {
        struct smb2_hdr hdr;
        __le16  StructureSize;  /* Must be 9 */