^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Introduction
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) This is the client VFS module for the SMB3 NAS protocol as well
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) as for older dialects such as the Common Internet File System (CIFS)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) protocol which was the successor to the Server Message Block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) (SMB) protocol, the native file sharing mechanism for most early
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) PC operating systems. New and improved versions of CIFS are now
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) called SMB2 and SMB3. Use of SMB3 (and later, including SMB3.1.1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) is strongly preferred over using older dialects like CIFS due to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) security reaasons. All modern dialects, including the most recent,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) SMB3.1.1 are supported by the CIFS VFS module. The SMB3 protocol
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) is implemented and supported by all major file servers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) such as all modern versions of Windows (including Windows 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Server), as well as by Samba (which provides excellent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) CIFS/SMB2/SMB3 server support and tools for Linux and many other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) operating systems). Apple systems also support SMB3 well, as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) do most Network Attached Storage vendors, so this network
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) filesystem client can mount to a wide variety of systems.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) It also supports mounting to the cloud (for example
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Microsoft Azure), including the necessary security features.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) The intent of this module is to provide the most advanced network
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) file system function for SMB3 compliant servers, including advanced
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) security features, excellent parallelized high performance i/o, better
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) POSIX compliance, secure per-user session establishment, encryption,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) high performance safe distributed caching (leases/oplocks), optional packet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) signing, large files, Unicode support and other internationalization
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) improvements. Since both Samba server and this filesystem client support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) the CIFS Unix extensions (and in the future SMB3 POSIX extensions),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) the combination can provide a reasonable alternative to other network and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) cluster file systems for fileserving in some Linux to Linux environments,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) not just in Linux to Windows (or Linux to Mac) environments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) This filesystem has a mount utility (mount.cifs) and various user space
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) tools (including smbinfo and setcifsacl) that can be obtained from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) https://git.samba.org/?p=cifs-utils.git
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) git://git.samba.org/cifs-utils.git
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) mount.cifs should be installed in the directory with the other mount helpers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) For more information on the module see the project wiki page at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) https://wiki.samba.org/index.php/LinuxCIFS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) https://wiki.samba.org/index.php/LinuxCIFS_utils