• Steve French's avatar
    smb3: improve SMB3 change notification support · e3e94634
    Steve French authored
    Change notification is a commonly supported feature by most servers,
    but the current ioctl to request notification when a directory is
    changed does not return the information about what changed
    (even though it is returned by the server in the SMB3 change
    notify response), it simply returns when there is a change.
    
    This ioctl improves upon CIFS_IOC_NOTIFY by returning the notify
    information structure which includes the name of the file(s) that
    changed and why. See MS-SMB2 2.2.35 for details on the individual
    filter flags and the file_notify_information structure returned.
    
    To use this simply pass in the following (with enough space
    to fit at least one file_notify_information structure)
    
    struct __attribute__((__packed__)) smb3_notify {
           uint32_t completion_filter;
           bool     watch_tree;
           uint32_t data_len;
           uint8_t  data[];
    } __packed;
    
    using CIFS_IOC_NOTIFY_INFO 0xc009cf0b
     or equivalently _IOWR(CIFS_IOCTL_MAGIC, 11, struct smb3_notify_info)
    
    The ioctl will block until the server detects a change to that
    directory or its subdirectories (if watch_tree is set).
    Acked-by: default avatarPaulo Alcantara (SUSE) <pc@cjr.nz>
    Acked-by: default avatarRonnie Sahlberg <lsahlber@redhat.com>
    Signed-off-by: default avatarSteve French <stfrench@microsoft.com>
    e3e94634
ioctl.c 13.3 KB