Linux Audio

Check our new training course

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