Kconfig 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203
  1. # SPDX-License-Identifier: GPL-2.0-only
  2. config CIFS
  3. tristate "SMB3 and CIFS support (advanced network filesystem)"
  4. depends on INET
  5. select NLS
  6. select CRYPTO
  7. select CRYPTO_MD5
  8. select CRYPTO_SHA256
  9. select CRYPTO_SHA512
  10. select CRYPTO_CMAC
  11. select CRYPTO_HMAC
  12. select CRYPTO_AEAD2
  13. select CRYPTO_CCM
  14. select CRYPTO_GCM
  15. select CRYPTO_ECB
  16. select CRYPTO_AES
  17. select KEYS
  18. select DNS_RESOLVER
  19. select ASN1
  20. select OID_REGISTRY
  21. help
  22. This is the client VFS module for the SMB3 family of NAS protocols,
  23. (including support for the most recent, most secure dialect SMB3.1.1)
  24. as well as for earlier dialects such as SMB2.1, SMB2 and the older
  25. Common Internet File System (CIFS) protocol. CIFS was the successor
  26. to the original dialect, the Server Message Block (SMB) protocol, the
  27. native file sharing mechanism for most early PC operating systems.
  28. The SMB3 protocol is supported by most modern operating systems
  29. and NAS appliances (e.g. Samba, Windows 10, Windows Server 2016,
  30. MacOS) and even in the cloud (e.g. Microsoft Azure).
  31. The older CIFS protocol was included in Windows NT4, 2000 and XP (and
  32. later) as well by Samba (which provides excellent CIFS and SMB3
  33. server support for Linux and many other operating systems). Use of
  34. dialects older than SMB2.1 is often discouraged on public networks.
  35. This module also provides limited support for OS/2 and Windows ME
  36. and similar very old servers.
  37. This module provides an advanced network file system client
  38. for mounting to SMB3 (and CIFS) compliant servers. It includes
  39. support for DFS (hierarchical name space), secure per-user
  40. session establishment via Kerberos or NTLM or NTLMv2, RDMA
  41. (smbdirect), advanced security features, per-share encryption,
  42. directory leases, safe distributed caching (oplock), optional packet
  43. signing, Unicode and other internationalization improvements.
  44. In general, the default dialects, SMB3 and later, enable better
  45. performance, security and features, than would be possible with CIFS.
  46. Note that when mounting to Samba, due to the CIFS POSIX extensions,
  47. CIFS mounts can provide slightly better POSIX compatibility
  48. than SMB3 mounts. SMB2/SMB3 mount options are also
  49. slightly simpler (compared to CIFS) due to protocol improvements.
  50. If you need to mount to Samba, Azure, Macs or Windows from this machine, say Y.
  51. config CIFS_STATS2
  52. bool "Extended statistics"
  53. depends on CIFS
  54. default y
  55. help
  56. Enabling this option will allow more detailed statistics on SMB
  57. request timing to be displayed in /proc/fs/cifs/DebugData and also
  58. allow optional logging of slow responses to dmesg (depending on the
  59. value of /proc/fs/cifs/cifsFYI). See Documentation/admin-guide/cifs/usage.rst
  60. for more details. These additional statistics may have a minor effect
  61. on performance and memory utilization.
  62. If unsure, say Y.
  63. config CIFS_ALLOW_INSECURE_LEGACY
  64. bool "Support legacy servers which use less secure dialects"
  65. depends on CIFS
  66. default y
  67. help
  68. Modern dialects, SMB2.1 and later (including SMB3 and 3.1.1), have
  69. additional security features, including protection against
  70. man-in-the-middle attacks and stronger crypto hashes, so the use
  71. of legacy dialects (SMB1/CIFS and SMB2.0) is discouraged.
  72. Disabling this option prevents users from using vers=1.0 or vers=2.0
  73. on mounts with cifs.ko
  74. If unsure, say Y.
  75. config CIFS_UPCALL
  76. bool "Kerberos/SPNEGO advanced session setup"
  77. depends on CIFS
  78. help
  79. Enables an upcall mechanism for CIFS which accesses userspace helper
  80. utilities to provide SPNEGO packaged (RFC 4178) Kerberos tickets
  81. which are needed to mount to certain secure servers (for which more
  82. secure Kerberos authentication is required). If unsure, say Y.
  83. config CIFS_XATTR
  84. bool "CIFS extended attributes"
  85. depends on CIFS
  86. help
  87. Extended attributes are name:value pairs associated with inodes by
  88. the kernel or by users (see the attr(5) manual page for details).
  89. CIFS maps the name of extended attributes beginning with the user
  90. namespace prefix to SMB/CIFS EAs. EAs are stored on Windows
  91. servers without the user namespace prefix, but their names are
  92. seen by Linux cifs clients prefaced by the user namespace prefix.
  93. The system namespace (used by some filesystems to store ACLs) is
  94. not supported at this time.
  95. If unsure, say Y.
  96. config CIFS_POSIX
  97. bool "CIFS POSIX Extensions"
  98. depends on CIFS && CIFS_ALLOW_INSECURE_LEGACY && CIFS_XATTR
  99. help
  100. Enabling this option will cause the cifs client to attempt to
  101. negotiate a newer dialect with servers, such as Samba 3.0.5
  102. or later, that optionally can handle more POSIX like (rather
  103. than Windows like) file behavior. It also enables
  104. support for POSIX ACLs (getfacl and setfacl) to servers
  105. (such as Samba 3.10 and later) which can negotiate
  106. CIFS POSIX ACL support. If unsure, say N.
  107. config CIFS_DEBUG
  108. bool "Enable CIFS debugging routines"
  109. default y
  110. depends on CIFS
  111. help
  112. Enabling this option adds helpful debugging messages to
  113. the cifs code which increases the size of the cifs module.
  114. If unsure, say Y.
  115. config CIFS_DEBUG2
  116. bool "Enable additional CIFS debugging routines"
  117. depends on CIFS_DEBUG
  118. help
  119. Enabling this option adds a few more debugging routines
  120. to the cifs code which slightly increases the size of
  121. the cifs module and can cause additional logging of debug
  122. messages in some error paths, slowing performance. This
  123. option can be turned off unless you are debugging
  124. cifs problems. If unsure, say N.
  125. config CIFS_DEBUG_DUMP_KEYS
  126. bool "Dump encryption keys for offline decryption (Unsafe)"
  127. depends on CIFS_DEBUG
  128. help
  129. Enabling this will dump the encryption and decryption keys
  130. used to communicate on an encrypted share connection on the
  131. console. This allows Wireshark to decrypt and dissect
  132. encrypted network captures. Enable this carefully.
  133. If unsure, say N.
  134. config CIFS_DFS_UPCALL
  135. bool "DFS feature support"
  136. depends on CIFS
  137. help
  138. Distributed File System (DFS) support is used to access shares
  139. transparently in an enterprise name space, even if the share
  140. moves to a different server. This feature also enables
  141. an upcall mechanism for CIFS which contacts userspace helper
  142. utilities to provide server name resolution (host names to
  143. IP addresses) which is needed in order to reconnect to
  144. servers if their addresses change or for implicit mounts of
  145. DFS junction points. If unsure, say Y.
  146. config CIFS_SWN_UPCALL
  147. bool "SWN feature support"
  148. depends on CIFS
  149. help
  150. The Service Witness Protocol (SWN) is used to get notifications
  151. from a highly available server of resource state changes. This
  152. feature enables an upcall mechanism for CIFS which contacts a
  153. userspace daemon to establish the DCE/RPC connection to retrieve
  154. the cluster available interfaces and resource change notifications.
  155. If unsure, say Y.
  156. config CIFS_NFSD_EXPORT
  157. bool "Allow nfsd to export CIFS file system"
  158. depends on CIFS && BROKEN
  159. help
  160. Allows NFS server to export a CIFS mounted share (nfsd over cifs)
  161. config CIFS_SMB_DIRECT
  162. bool "SMB Direct support"
  163. depends on CIFS=m && INFINIBAND && INFINIBAND_ADDR_TRANS || CIFS=y && INFINIBAND=y && INFINIBAND_ADDR_TRANS=y
  164. help
  165. Enables SMB Direct support for SMB 3.0, 3.02 and 3.1.1.
  166. SMB Direct allows transferring SMB packets over RDMA. If unsure,
  167. say Y.
  168. config CIFS_FSCACHE
  169. bool "Provide CIFS client caching support"
  170. depends on CIFS=m && FSCACHE || CIFS=y && FSCACHE=y
  171. help
  172. Makes CIFS FS-Cache capable. Say Y here if you want your CIFS data
  173. to be cached locally on disk through the general filesystem cache
  174. manager. If unsure, say N.
  175. config CIFS_ROOT
  176. bool "SMB root file system (Experimental)"
  177. depends on CIFS=y && IP_PNP
  178. help
  179. Enables root file system support over SMB protocol.
  180. Most people say N here.