Commit ed2f1d9c authored by Steve French's avatar Steve French

cifs: update Kconfig description

There were various outdated or missing things in fs/cifs/Kconfig
e.g. mention of support for insecure NTLM which has been removed,
and lack of mention of some important features. This also shortens
it slightly, and fixes some confusing text (e.g. the SMB1 POSIX
extensions option).
Reviewed-by: default avatarNamjae Jeon <linkinjeon@kernel.org>
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>
parent d4fba63f
...@@ -19,39 +19,36 @@ config CIFS ...@@ -19,39 +19,36 @@ config CIFS
select ASN1 select ASN1
select OID_REGISTRY select OID_REGISTRY
help help
This is the client VFS module for the SMB3 family of NAS protocols, This is the client VFS module for the SMB3 family of network file
(including support for the most recent, most secure dialect SMB3.1.1) protocols (including the most recent, most secure dialect SMB3.1.1).
as well as for earlier dialects such as SMB2.1, SMB2 and the older This module also includes support for earlier dialects such as
Common Internet File System (CIFS) protocol. CIFS was the successor SMB2.1, SMB2 and even the old Common Internet File System (CIFS)
to the original dialect, the Server Message Block (SMB) protocol, the protocol. CIFS was the successor to the original network filesystem
native file sharing mechanism for most early PC operating systems. protocol, Server Message Block (SMB ie SMB1), the native file sharing
mechanism for most early PC operating systems.
The SMB3 protocol is supported by most modern operating systems
and NAS appliances (e.g. Samba, Windows 10, Windows Server 2016, The SMB3.1.1 protocol is supported by most modern operating systems
MacOS) and even in the cloud (e.g. Microsoft Azure). and NAS appliances (e.g. Samba, Windows 11, Windows Server 2022,
The older CIFS protocol was included in Windows NT4, 2000 and XP (and MacOS) and even in the cloud (e.g. Microsoft Azure) and also by the
later) as well by Samba (which provides excellent CIFS and SMB3 Linux kernel server, ksmbd. Support for the older CIFS protocol was
server support for Linux and many other operating systems). Use of included in Windows NT4, 2000 and XP (and later). Use of dialects
dialects older than SMB2.1 is often discouraged on public networks. older than SMB2.1 is often discouraged on public networks.
This module also provides limited support for OS/2 and Windows ME This module also provides limited support for OS/2 and Windows ME
and similar very old servers. and similar very old servers.
This module provides an advanced network file system client This module provides an advanced network file system client for
for mounting to SMB3 (and CIFS) compliant servers. It includes mounting to SMB3 (and CIFS) compliant servers. It includes support
support for DFS (hierarchical name space), secure per-user for DFS (hierarchical name space), secure per-user session
session establishment via Kerberos or NTLM or NTLMv2, RDMA establishment via Kerberos or NTLMv2, RDMA (smbdirect), advanced
(smbdirect), advanced security features, per-share encryption, security features, per-share encryption, packet-signing, snapshots,
directory leases, safe distributed caching (oplock), optional packet directory leases, safe distributed caching (leases), multichannel,
signing, Unicode and other internationalization improvements. Unicode and other internationalization improvements.
In general, the default dialects, SMB3 and later, enable better In general, the default dialects, SMB3 and later, enable better
performance, security and features, than would be possible with CIFS. performance, security and features, than would be possible with CIFS.
Note that when mounting to Samba, due to the CIFS POSIX extensions,
CIFS mounts can provide slightly better POSIX compatibility
than SMB3 mounts. SMB2/SMB3 mount options are also
slightly simpler (compared to CIFS) due to protocol improvements.
If you need to mount to Samba, Azure, Macs or Windows from this machine, say Y. If you need to mount to Samba, Azure, ksmbd, Macs or Windows from this
machine, say Y.
config CIFS_STATS2 config CIFS_STATS2
bool "Extended statistics" bool "Extended statistics"
...@@ -111,12 +108,12 @@ config CIFS_POSIX ...@@ -111,12 +108,12 @@ config CIFS_POSIX
depends on CIFS && CIFS_ALLOW_INSECURE_LEGACY && CIFS_XATTR depends on CIFS && CIFS_ALLOW_INSECURE_LEGACY && CIFS_XATTR
help help
Enabling this option will cause the cifs client to attempt to Enabling this option will cause the cifs client to attempt to
negotiate a newer dialect with servers, such as Samba 3.0.5 negotiate a feature of the older cifs dialect with servers, such as
or later, that optionally can handle more POSIX like (rather Samba 3.0.5 or later, that optionally can handle more POSIX like
than Windows like) file behavior. It also enables (rather than Windows like) file behavior. It also enables support
support for POSIX ACLs (getfacl and setfacl) to servers for POSIX ACLs (getfacl and setfacl) to servers (such as Samba 3.10
(such as Samba 3.10 and later) which can negotiate and later) which can negotiate CIFS POSIX ACL support. This config
CIFS POSIX ACL support. If unsure, say N. option is not needed when mounting with SMB3.1.1. If unsure, say N.
config CIFS_DEBUG config CIFS_DEBUG
bool "Enable CIFS debugging routines" bool "Enable CIFS debugging routines"
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment