introduction.rst 2.4 KB

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