admin-guide/cifs/usage.rst

18 MS-SMB2 (for detailed SMB2/SMB3/SMB3.1.1 protocol specification)
34 1) Download the kernel (e.g. from https://www.kernel.org)
36    (e.g. /usr/src/linux-2.5.73)
48 the modules directory e.g. /lib/modules/6.3.0-060300-generic/kernel/fs/smb/client/cifs.ko).
57 required, mount.cifs is recommended.  Most distros include a ``cifs-utils``
63 found at cifs-utils.git on git.samba.org
122 mounts, unless umount is invoked with -i (which will avoid invoking a umount
166 disabled on a per-mount basis by specifying ``nouser_xattr`` on mount.
184 (the few optional settings are passed in on mount via -o parameters instead).
191 	 ln -s /mnt/foo bar
196 that is ignored by local server applications and non-cifs clients and that will
210   mount -t cifs //9.53.216.11/e$ /mnt -o username=myname,password=mypassword
212 Before -o the option -v may be specified to make the mount.cifs
214 After -o the following commonly used cifs vfs specific options
234   mount -t cifs tcp_name_of_server:share_name /mnt -o user=myname,pass=mypasswd
237 mechanisms, instead of specifying it after -o using the normal ``pass=`` syntax
255 Servers must support either "pure-TCP" (port 445 TCP/IP CIFS connections) or RFC
256 1001/1002 support for "Netbios-Over-TCP/IP." This is not likely to be a
340 		Enable local disk caching using FS-Cache (off by default). This
346 		caching is not suitable for all workloads for e.g. read-once
349 		disk caching is functional for CIFS files opened as read-only.
382 		attribute cache timeout in seconds (default 1 second).
385 		attribute cache timeout to suit the workload needs. Shorter
386 		timeouts mean better the cache coherency, but increased number
388 		of calls to the server at the expense of less stricter cache
389 		coherency checks (i.e. incorrect attribute cache for a short
392 		mount the network share read-write (note that the
393 		server may still consider the share read-only)
395 		mount network share read-only
400 		if first mount option (after the -o), overrides
404 			-o user=myname,password=mypassword,domain=mydom
408 			-o sep=.user=myname.password=mypassword.domain=mydom
473 		(e.g. pre-Windows 2000) do not support returning UniqueIDs
492 		the mount, cache the new file's uid and gid locally which means
522 		Use for switching on strict cache mode. In this mode the
523 		client read from the cache all the time it has Oplock Level II,
524 		otherwise - read from the server. All written data are stored
525 		in the cache, but if the client doesn't have Exclusive Oplock,
630 		Services for Unix (SFU).  In addition retrieve bits 10-12
693 The mount.cifs mount helper also accepts a few mount options before -o
697 	-S      take password from stdin (equivalent to setting the environment
699 	-V      print mount.cifs version
700 	-?      display simple usage information
709 Informational pseudo-files:
721 Configuration pseudo-files:
761 cifsFYI			If set to non-zero value, additional debug information
771 			  +-----------------------------------------------+------+
773 			  +-----------------------------------------------+------+
775 			  +-----------------------------------------------+------+
780 			  +-----------------------------------------------+------+
798 dfscache		List the content of the DFS cache.
799 			If set to 0, the client will clear the cache.
810 logging of various informational messages.  2 enables logging of non-zero
822 represent the number of attempted and failed (ie non-zero return code from the
835 /etc/request-key.conf file.  The cifs.upcall helper program is from the Samba
841 DFS support allows transparent redirection to shares in an MS-DFS name space.
846 be configured in the file /etc/request-key.conf.  Samba, Windows servers and
852 /etc/request-key.conf file::