fs/cifs/Kconfig

   1 config CIFS
   2         tristate "CIFS support (advanced network filesystem, SMBFS successor)"
   3         depends on INET
   4         select NLS
   5         select CRYPTO
   6         select CRYPTO_MD5
   7         select CRYPTO_ARC4
   8         help
   9           This is the client VFS module for the Common Internet File System
  10           (CIFS) protocol which is the successor to the Server Message Block
  11           (SMB) protocol, the native file sharing mechanism for most early
  12           PC operating systems.  The CIFS protocol is fully supported by
  13           file servers such as Windows 2000 (including Windows 2003, NT 4
  14           and Windows XP) as well by Samba (which provides excellent CIFS
  15           server support for Linux and many other operating systems). Limited
  16           support for OS/2 and Windows ME and similar servers is provided as
  17           well.
  18
  19           The cifs module provides an advanced network file system
  20           client for mounting to CIFS compliant servers.  It includes
  21           support for DFS (hierarchical name space), secure per-user
  22           session establishment via Kerberos or NTLM or NTLMv2,
  23           safe distributed caching (oplock), optional packet
  24           signing, Unicode and other internationalization improvements.
  25           If you need to mount to Samba or Windows from this machine, say Y.
  26
  27 config CIFS_STATS
  28         bool "CIFS statistics"
  29         depends on CIFS
  30         help
  31           Enabling this option will cause statistics for each server share
  32           mounted by the cifs client to be displayed in /proc/fs/cifs/Stats
  33
  34 config CIFS_STATS2
  35         bool "Extended statistics"
  36         depends on CIFS_STATS
  37         help
  38           Enabling this option will allow more detailed statistics on SMB
  39           request timing to be displayed in /proc/fs/cifs/DebugData and also
  40           allow optional logging of slow responses to dmesg (depending on the
  41           value of /proc/fs/cifs/cifsFYI, see fs/cifs/README for more details).
  42           These additional statistics may have a minor effect on performance
  43           and memory utilization.
  44
  45           Unless you are a developer or are doing network performance analysis
  46           or tuning, say N.
  47
  48 config CIFS_WEAK_PW_HASH
  49         bool "Support legacy servers which use weaker LANMAN security"
  50         depends on CIFS
  51         help
  52           Modern CIFS servers including Samba and most Windows versions
  53           (since 1997) support stronger NTLM (and even NTLMv2 and Kerberos)
  54           security mechanisms. These hash the password more securely
  55           than the mechanisms used in the older LANMAN version of the
  56           SMB protocol but LANMAN based authentication is needed to
  57           establish sessions with some old SMB servers.
  58
  59           Enabling this option allows the cifs module to mount to older
  60           LANMAN based servers such as OS/2 and Windows 95, but such
  61           mounts may be less secure than mounts using NTLM or more recent
  62           security mechanisms if you are on a public network.  Unless you
  63           have a need to access old SMB servers (and are on a private
  64           network) you probably want to say N.  Even if this support
  65           is enabled in the kernel build, LANMAN authentication will not be
  66           used automatically. At runtime LANMAN mounts are disabled but
  67           can be set to required (or optional) either in
  68           /proc/fs/cifs (see fs/cifs/README for more detail) or via an
  69           option on the mount command. This support is disabled by
  70           default in order to reduce the possibility of a downgrade
  71           attack.
  72
  73           If unsure, say N.
  74
  75 config CIFS_UPCALL
  76         bool "Kerberos/SPNEGO advanced session setup"
  77         depends on CIFS && KEYS
  78         select DNS_RESOLVER
  79         help
  80           Enables an upcall mechanism for CIFS which accesses userspace helper
  81           utilities to provide SPNEGO packaged (RFC 4178) Kerberos tickets
  82           which are needed to mount to certain secure servers (for which more
  83           secure Kerberos authentication is required). If unsure, say N.
  84
  85 config CIFS_XATTR
  86         bool "CIFS extended attributes"
  87         depends on CIFS
  88         help
  89           Extended attributes are name:value pairs associated with inodes by
  90           the kernel or by users (see the attr(5) manual page, or visit
  91           <http://acl.bestbits.at/> for details).  CIFS maps the name of
  92           extended attributes beginning with the user namespace prefix
  93           to SMB/CIFS EAs. EAs are stored on Windows servers without the
  94           user namespace prefix, but their names are seen by Linux cifs clients
  95           prefaced by the user namespace prefix. The system namespace
  96           (used by some filesystems to store ACLs) is not supported at
  97           this time.
  98
  99           If unsure, say N.
 100
 101 config CIFS_POSIX
 102         bool "CIFS POSIX Extensions"
 103         depends on CIFS_XATTR
 104         help
 105           Enabling this option will cause the cifs client to attempt to
 106           negotiate a newer dialect with servers, such as Samba 3.0.5
 107           or later, that optionally can handle more POSIX like (rather
 108           than Windows like) file behavior.  It also enables
 109           support for POSIX ACLs (getfacl and setfacl) to servers
 110           (such as Samba 3.10 and later) which can negotiate
 111           CIFS POSIX ACL support.  If unsure, say N.
 112
 113 config CIFS_DEBUG2
 114         bool "Enable additional CIFS debugging routines"
 115         depends on CIFS
 116         help
 117            Enabling this option adds a few more debugging routines
 118            to the cifs code which slightly increases the size of
 119            the cifs module and can cause additional logging of debug
 120            messages in some error paths, slowing performance. This
 121            option can be turned off unless you are debugging
 122            cifs problems.  If unsure, say N.
 123
 124 config CIFS_DFS_UPCALL
 125           bool "DFS feature support"
 126           depends on CIFS && KEYS
 127           select DNS_RESOLVER
 128           help
 129             Distributed File System (DFS) support is used to access shares
 130             transparently in an enterprise name space, even if the share
 131             moves to a different server.  This feature also enables
 132             an upcall mechanism for CIFS which contacts userspace helper
 133             utilities to provide server name resolution (host names to
 134             IP addresses) which is needed for implicit mounts of DFS junction
 135             points. If unsure, say N.
 136
 137 config CIFS_FSCACHE
 138           bool "Provide CIFS client caching support (EXPERIMENTAL)"
 139           depends on EXPERIMENTAL
 140           depends on CIFS=m && FSCACHE || CIFS=y && FSCACHE=y
 141           help
 142             Makes CIFS FS-Cache capable. Say Y here if you want your CIFS data
 143             to be cached locally on disk through the general filesystem cache
 144             manager. If unsure, say N.
 145
 146 config CIFS_EXPERIMENTAL
 147           bool "CIFS Experimental Features (EXPERIMENTAL)"
 148           depends on CIFS && EXPERIMENTAL
 149           help
 150             Enables cifs features under testing. These features are
 151             experimental and currently include DFS support and directory
 152             change notification ie fcntl(F_DNOTIFY), as well as the upcall
 153             mechanism which will be used for Kerberos session negotiation
 154             and uid remapping.  Some of these features also may depend on
 155             setting a value of 1 to the pseudo-file /proc/fs/cifs/Experimental
 156             (which is disabled by default). See the file fs/cifs/README
 157             for more details.  If unsure, say N.
 158