blob: d5b2e12b5d02212046f0a7b816550737cc3b45af [file] [log] [blame]
Alexey Dobriyanbb26b962008-10-18 20:28:49 -07001config CIFS
Steve French2a38e122017-07-08 18:48:15 -05002 tristate "SMB3 and CIFS support (advanced network filesystem)"
Alexey Dobriyanbb26b962008-10-18 20:28:49 -07003 depends on INET
4 select NLS
Shirish Pargaonkard2b91522010-10-21 14:25:08 -05005 select CRYPTO
Jeff Laytonf855f6c2011-01-31 08:41:36 -05006 select CRYPTO_MD4
Shirish Pargaonkard2b91522010-10-21 14:25:08 -05007 select CRYPTO_MD5
Benjamin Gilbert5b454a62017-10-19 13:09:29 -07008 select CRYPTO_SHA256
9 select CRYPTO_CMAC
Steve French362d3122010-11-14 03:34:30 +000010 select CRYPTO_HMAC
Shirish Pargaonkard2b91522010-10-21 14:25:08 -050011 select CRYPTO_ARC4
Benjamin Gilbert5b454a62017-10-19 13:09:29 -070012 select CRYPTO_AEAD2
13 select CRYPTO_CCM
Suresh Jayaraman5f0b23e2011-06-03 14:19:01 +053014 select CRYPTO_ECB
Benjamin Gilbert5b454a62017-10-19 13:09:29 -070015 select CRYPTO_AES
Steve French43988d72011-04-19 18:23:31 +000016 select CRYPTO_DES
Alexey Dobriyanbb26b962008-10-18 20:28:49 -070017 help
Steve French2a38e122017-07-08 18:48:15 -050018 This is the client VFS module for the SMB3 family of NAS protocols,
19 as well as for earlier dialects such as SMB2.1, SMB2 and the
20 Common Internet File System (CIFS) protocol. CIFS was the successor
21 to the original dialect, the Server Message Block (SMB) protocol, the
22 native file sharing mechanism for most early PC operating systems.
23
24 The SMB3 protocol is supported by most modern operating systems and
25 NAS appliances (e.g. Samba, Windows 8, Windows 2012, MacOS).
26 The older CIFS protocol was included in Windows NT4, 2000 and XP (and
27 later) as well by Samba (which provides excellent CIFS and SMB3
Alexey Dobriyanbb26b962008-10-18 20:28:49 -070028 server support for Linux and many other operating systems). Limited
Steve French2a38e122017-07-08 18:48:15 -050029 support for OS/2 and Windows ME and similar very old servers is
30 provided as well.
Alexey Dobriyanbb26b962008-10-18 20:28:49 -070031
Steve French2a38e122017-07-08 18:48:15 -050032 The cifs module provides an advanced network file system client
33 for mounting to SMB3 (and CIFS) compliant servers. It includes
Alexey Dobriyanbb26b962008-10-18 20:28:49 -070034 support for DFS (hierarchical name space), secure per-user
35 session establishment via Kerberos or NTLM or NTLMv2,
36 safe distributed caching (oplock), optional packet
37 signing, Unicode and other internationalization improvements.
Steve French2a38e122017-07-08 18:48:15 -050038
39 In general, the default dialects, SMB3 and later, enable better
40 performance, security and features, than would be possible with CIFS.
41 Note that when mounting to Samba, due to the CIFS POSIX extensions,
42 CIFS mounts can provide slightly better POSIX compatibility
43 than SMB3 mounts. SMB2/SMB3 mount options are also
44 slightly simpler (compared to CIFS) due to protocol improvements.
45
46 If you need to mount to Samba, Macs or Windows from this machine, say Y.
Alexey Dobriyanbb26b962008-10-18 20:28:49 -070047
48config CIFS_STATS
49 bool "CIFS statistics"
50 depends on CIFS
51 help
52 Enabling this option will cause statistics for each server share
53 mounted by the cifs client to be displayed in /proc/fs/cifs/Stats
54
55config CIFS_STATS2
56 bool "Extended statistics"
57 depends on CIFS_STATS
58 help
59 Enabling this option will allow more detailed statistics on SMB
60 request timing to be displayed in /proc/fs/cifs/DebugData and also
61 allow optional logging of slow responses to dmesg (depending on the
62 value of /proc/fs/cifs/cifsFYI, see fs/cifs/README for more details).
63 These additional statistics may have a minor effect on performance
64 and memory utilization.
65
66 Unless you are a developer or are doing network performance analysis
67 or tuning, say N.
68
69config CIFS_WEAK_PW_HASH
70 bool "Support legacy servers which use weaker LANMAN security"
71 depends on CIFS
72 help
73 Modern CIFS servers including Samba and most Windows versions
74 (since 1997) support stronger NTLM (and even NTLMv2 and Kerberos)
75 security mechanisms. These hash the password more securely
76 than the mechanisms used in the older LANMAN version of the
77 SMB protocol but LANMAN based authentication is needed to
78 establish sessions with some old SMB servers.
79
80 Enabling this option allows the cifs module to mount to older
81 LANMAN based servers such as OS/2 and Windows 95, but such
82 mounts may be less secure than mounts using NTLM or more recent
83 security mechanisms if you are on a public network. Unless you
84 have a need to access old SMB servers (and are on a private
85 network) you probably want to say N. Even if this support
86 is enabled in the kernel build, LANMAN authentication will not be
87 used automatically. At runtime LANMAN mounts are disabled but
88 can be set to required (or optional) either in
89 /proc/fs/cifs (see fs/cifs/README for more detail) or via an
90 option on the mount command. This support is disabled by
91 default in order to reduce the possibility of a downgrade
92 attack.
93
94 If unsure, say N.
95
96config CIFS_UPCALL
Wang Lei1a4240f2010-08-04 15:16:33 +010097 bool "Kerberos/SPNEGO advanced session setup"
98 depends on CIFS && KEYS
99 select DNS_RESOLVER
100 help
101 Enables an upcall mechanism for CIFS which accesses userspace helper
102 utilities to provide SPNEGO packaged (RFC 4178) Kerberos tickets
103 which are needed to mount to certain secure servers (for which more
Steve French2a38e122017-07-08 18:48:15 -0500104 secure Kerberos authentication is required). If unsure, say Y.
Alexey Dobriyanbb26b962008-10-18 20:28:49 -0700105
106config CIFS_XATTR
107 bool "CIFS extended attributes"
108 depends on CIFS
109 help
110 Extended attributes are name:value pairs associated with inodes by
111 the kernel or by users (see the attr(5) manual page, or visit
112 <http://acl.bestbits.at/> for details). CIFS maps the name of
113 extended attributes beginning with the user namespace prefix
114 to SMB/CIFS EAs. EAs are stored on Windows servers without the
115 user namespace prefix, but their names are seen by Linux cifs clients
116 prefaced by the user namespace prefix. The system namespace
117 (used by some filesystems to store ACLs) is not supported at
118 this time.
119
Steve French2a38e122017-07-08 18:48:15 -0500120 If unsure, say Y.
Alexey Dobriyanbb26b962008-10-18 20:28:49 -0700121
122config CIFS_POSIX
123 bool "CIFS POSIX Extensions"
124 depends on CIFS_XATTR
125 help
126 Enabling this option will cause the cifs client to attempt to
127 negotiate a newer dialect with servers, such as Samba 3.0.5
128 or later, that optionally can handle more POSIX like (rather
129 than Windows like) file behavior. It also enables
130 support for POSIX ACLs (getfacl and setfacl) to servers
131 (such as Samba 3.10 and later) which can negotiate
132 CIFS POSIX ACL support. If unsure, say N.
133
Steve French1d4ab902012-10-01 12:48:03 -0500134config CIFS_ACL
135 bool "Provide CIFS ACL support"
136 depends on CIFS_XATTR && KEYS
137 help
138 Allows fetching CIFS/NTFS ACL from the server. The DACL blob
Steve Frenchca5d13f2014-08-22 04:40:46 -0500139 is handed over to the application/caller. See the man
Steve French2a38e122017-07-08 18:48:15 -0500140 page for getcifsacl for more information. If unsure, say Y.
Steve French1d4ab902012-10-01 12:48:03 -0500141
Joe Perches471b1f92012-12-05 12:42:58 -0800142config CIFS_DEBUG
143 bool "Enable CIFS debugging routines"
144 default y
145 depends on CIFS
146 help
147 Enabling this option adds helpful debugging messages to
148 the cifs code which increases the size of the cifs module.
149 If unsure, say Y.
Alexey Dobriyanbb26b962008-10-18 20:28:49 -0700150config CIFS_DEBUG2
151 bool "Enable additional CIFS debugging routines"
Joe Perches471b1f92012-12-05 12:42:58 -0800152 depends on CIFS_DEBUG
Alexey Dobriyanbb26b962008-10-18 20:28:49 -0700153 help
154 Enabling this option adds a few more debugging routines
155 to the cifs code which slightly increases the size of
156 the cifs module and can cause additional logging of debug
157 messages in some error paths, slowing performance. This
158 option can be turned off unless you are debugging
159 cifs problems. If unsure, say N.
160
Aurélien Apteld38de3c62017-05-24 16:13:25 +0200161config CIFS_DEBUG_DUMP_KEYS
162 bool "Dump encryption keys for offline decryption (Unsafe)"
Steve French2a38e122017-07-08 18:48:15 -0500163 depends on CIFS_DEBUG
Aurélien Apteld38de3c62017-05-24 16:13:25 +0200164 help
165 Enabling this will dump the encryption and decryption keys
166 used to communicate on an encrypted share connection on the
167 console. This allows Wireshark to decrypt and dissect
168 encrypted network captures. Enable this carefully.
Steve French2a38e122017-07-08 18:48:15 -0500169 If unsure, say N.
Aurélien Apteld38de3c62017-05-24 16:13:25 +0200170
Steve French10e70af2009-02-22 01:33:07 +0000171config CIFS_DFS_UPCALL
172 bool "DFS feature support"
173 depends on CIFS && KEYS
Wang Lei1a4240f2010-08-04 15:16:33 +0100174 select DNS_RESOLVER
Steve French10e70af2009-02-22 01:33:07 +0000175 help
176 Distributed File System (DFS) support is used to access shares
177 transparently in an enterprise name space, even if the share
178 moves to a different server. This feature also enables
179 an upcall mechanism for CIFS which contacts userspace helper
180 utilities to provide server name resolution (host names to
181 IP addresses) which is needed for implicit mounts of DFS junction
Steve French2a38e122017-07-08 18:48:15 -0500182 points. If unsure, say Y.
Steve French10e70af2009-02-22 01:33:07 +0000183
Shirish Pargaonkar25720872011-02-25 10:48:55 -0600184config CIFS_NFSD_EXPORT
Kees Cook00f36162013-01-16 18:54:09 -0800185 bool "Allow nfsd to export CIFS file system"
186 depends on CIFS && BROKEN
Alexey Dobriyanbb26b962008-10-18 20:28:49 -0700187 help
Shirish Pargaonkar25720872011-02-25 10:48:55 -0600188 Allows NFS server to export a CIFS mounted share (nfsd over cifs)
Steve French675f36f2011-02-24 17:58:00 +0000189
Steve French5f7fbf72014-12-17 22:52:58 -0600190config CIFS_SMB311
191 bool "SMB3.1.1 network file system support (Experimental)"
Steve French2a38e122017-07-08 18:48:15 -0500192 depends on CIFS
Steve French5f7fbf72014-12-17 22:52:58 -0600193
194 help
195 This enables experimental support for the newest, SMB3.1.1, dialect.
196 This dialect includes improved security negotiation features.
197 If unsure, say N
198
Steve French1d4ab902012-10-01 12:48:03 -0500199config CIFS_FSCACHE
200 bool "Provide CIFS client caching support"
201 depends on CIFS=m && FSCACHE || CIFS=y && FSCACHE=y
202 help
203 Makes CIFS FS-Cache capable. Say Y here if you want your CIFS data
204 to be cached locally on disk through the general filesystem cache
205 manager. If unsure, say N.
206