731ddc09c2
Various minor changes to the admin-guide for cifs Signed-off-by: Steve French <stfrench@microsoft.com>
54 lines
2.4 KiB
ReStructuredText
54 lines
2.4 KiB
ReStructuredText
============
|
|
Introduction
|
|
============
|
|
|
|
This is the client VFS module for the SMB3 NAS protocol as well
|
|
as for older dialects such as the Common Internet File System (CIFS)
|
|
protocol which was the successor to the Server Message Block
|
|
(SMB) protocol, the native file sharing mechanism for most early
|
|
PC operating systems. New and improved versions of CIFS are now
|
|
called SMB2 and SMB3. Use of SMB3 (and later, including SMB3.1.1
|
|
the most current dialect) is strongly preferred over using older
|
|
dialects like CIFS due to security reasons. All modern dialects,
|
|
including the most recent, SMB3.1.1, are supported by the CIFS VFS
|
|
module. The SMB3 protocol is implemented and supported by all major
|
|
file servers such as Windows (including Windows 2019 Server), as
|
|
well as by Samba (which provides excellent CIFS/SMB2/SMB3 server
|
|
support and tools for Linux and many other operating systems).
|
|
Apple systems also support SMB3 well, as do most Network Attached
|
|
Storage vendors, so this network filesystem client can mount to a
|
|
wide variety of systems. It also supports mounting to the cloud
|
|
(for example Microsoft Azure), including the necessary security
|
|
features.
|
|
|
|
The intent of this module is to provide the most advanced network
|
|
file system function for SMB3 compliant servers, including advanced
|
|
security features, excellent parallelized high performance i/o, better
|
|
POSIX compliance, secure per-user session establishment, encryption,
|
|
high performance safe distributed caching (leases/oplocks), optional packet
|
|
signing, large files, Unicode support and other internationalization
|
|
improvements. Since both Samba server and this filesystem client support the
|
|
CIFS Unix extensions, and the Linux client also suppors SMB3 POSIX extensions,
|
|
the combination can provide a reasonable alternative to other network and
|
|
cluster file systems for fileserving in some Linux to Linux environments,
|
|
not just in Linux to Windows (or Linux to Mac) environments.
|
|
|
|
This filesystem has a mount utility (mount.cifs) and various user space
|
|
tools (including smbinfo and setcifsacl) that can be obtained from
|
|
|
|
https://git.samba.org/?p=cifs-utils.git
|
|
|
|
or
|
|
|
|
git://git.samba.org/cifs-utils.git
|
|
|
|
mount.cifs should be installed in the directory with the other mount helpers.
|
|
|
|
For more information on the module see the project wiki page at
|
|
|
|
https://wiki.samba.org/index.php/LinuxCIFS
|
|
|
|
and
|
|
|
|
https://wiki.samba.org/index.php/LinuxCIFS_utils
|