Clarify Kconfig help text for CIFS and SMB2/SMB3

Clarify descriptions of SMB2 and SMB3 support in Kconfig

Signed-off-by: Steve French <smfrench@gmail.com>
Reviewed-by: Pavel Shilovsky <pshilovsky@samba.org>
This commit is contained in:
Steve French 2014-08-22 04:40:46 -05:00
parent 1bbe4997b1
commit ca5d13fc33
1 changed files with 23 additions and 12 deletions

View File

@ -22,6 +22,11 @@ config CIFS
support for OS/2 and Windows ME and similar servers is provided as support for OS/2 and Windows ME and similar servers is provided as
well. well.
The module also provides optional support for the followon
protocols for CIFS including SMB3, which enables
useful performance and security features (see the description
of CONFIG_CIFS_SMB2).
The cifs module provides an advanced network file system The cifs module provides an advanced network file system
client for mounting to CIFS compliant servers. It includes client for mounting to CIFS compliant servers. It includes
support for DFS (hierarchical name space), secure per-user support for DFS (hierarchical name space), secure per-user
@ -121,7 +126,8 @@ config CIFS_ACL
depends on CIFS_XATTR && KEYS depends on CIFS_XATTR && KEYS
help help
Allows fetching CIFS/NTFS ACL from the server. The DACL blob Allows fetching CIFS/NTFS ACL from the server. The DACL blob
is handed over to the application/caller. is handed over to the application/caller. See the man
page for getcifsacl for more information.
config CIFS_DEBUG config CIFS_DEBUG
bool "Enable CIFS debugging routines" bool "Enable CIFS debugging routines"
@ -162,7 +168,7 @@ config CIFS_NFSD_EXPORT
Allows NFS server to export a CIFS mounted share (nfsd over cifs) Allows NFS server to export a CIFS mounted share (nfsd over cifs)
config CIFS_SMB2 config CIFS_SMB2
bool "SMB2 network file system support" bool "SMB2 and SMB3 network file system support"
depends on CIFS && INET depends on CIFS && INET
select NLS select NLS
select KEYS select KEYS
@ -170,16 +176,21 @@ config CIFS_SMB2
select DNS_RESOLVER select DNS_RESOLVER
help help
This enables experimental support for the SMB2 (Server Message Block This enables support for the Server Message Block version 2
version 2) protocol. The SMB2 protocol is the successor to the family of protocols, including SMB3. SMB3 support is
popular CIFS and SMB network file sharing protocols. SMB2 is the enabled on mount by specifying "vers=3.0" in the mount
native file sharing mechanism for recent versions of Windows options. These protocols are the successors to the popular
operating systems (since Vista). SMB2 enablement will eventually CIFS and SMB network file sharing protocols. SMB3 is the
allow users better performance, security and features, than would be native file sharing mechanism for the more recent
possible with cifs. Note that smb2 mount options also are simpler versions of Windows (Windows 8 and Windows 2012 and
(compared to cifs) due to protocol improvements. later) and Samba server and many others support SMB3 well.
In general SMB3 enables better performance, security
Unless you are a developer or tester, say N. 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 do though). Note that SMB2/SMB3 mount
options are also slightly simpler (compared to CIFS) due
to protocol improvements.
config CIFS_FSCACHE config CIFS_FSCACHE
bool "Provide CIFS client caching support" bool "Provide CIFS client caching support"