Blame SOURCES/0005-mount.cifs.rst-document-missing-options-correct-wron.patch

75f41f
From e1e36b41e779d241cc1ff0e2f6f90b630b1e3d14 Mon Sep 17 00:00:00 2001
75f41f
From: =?UTF-8?q?Aur=C3=A9lien=20Aptel?= <aaptel@suse.com>
75f41f
Date: Tue, 10 Jul 2018 17:50:43 +0200
75f41f
Subject: [PATCH 05/36] mount.cifs.rst: document missing options, correct wrong
75f41f
 ones
75f41f
75f41f
Signed-off-by: Aurelien Aptel <aaptel@suse.com>
75f41f
(cherry picked from commit 7325a01abc529d68756bae90cf23233392626939)
75f41f
Signed-off-by: Sachin Prabhu <sprabhu@redhat.com>
75f41f
---
75f41f
 mount.cifs.rst | 111 ++++++++++++++++++++++++++++++++++++++++-----------------
75f41f
 1 file changed, 79 insertions(+), 32 deletions(-)
75f41f
75f41f
diff --git a/mount.cifs.rst b/mount.cifs.rst
75f41f
index 56c1bf9..13b3a1e 100644
75f41f
--- a/mount.cifs.rst
75f41f
+++ b/mount.cifs.rst
75f41f
@@ -123,6 +123,11 @@ forcegid
75f41f
   of the gid= option. See the section on `FILE AND DIRECTORY OWNERSHIP
75f41f
   AND PERMISSIONS`_ below for more information.
75f41f
 
75f41f
+idsfromsid
75f41f
+  Extract uid/gid from special SID instead of mapping it. See the
75f41f
+  section on `FILE AND DIRECTORY OWNERSHIP AND PERMISSIONS`_ below for
75f41f
+  more information.
75f41f
+
75f41f
 port=arg
75f41f
   sets the port number on which the client will attempt to contact the
75f41f
   CIFS server. If this value is specified, look for an existing
75f41f
@@ -133,8 +138,9 @@ port=arg
75f41f
   try to connect on port 445 first and then port 139 if that
75f41f
   fails. Return an error if both fail.
75f41f
 
75f41f
-servernetbiosname=arg
75f41f
-  Specify the server netbios name (RFC1001 name) to use when attempting
75f41f
+
75f41f
+netbiosname=arg
75f41f
+  Specify the client netbios name (RFC1001 name) to use when attempting
75f41f
   to setup a session to the server. Although rarely needed for mounting
75f41f
   to newer servers, this option is needed for mounting to some older
75f41f
   servers (such as OS/2 or Windows 98 and Windows ME) since when
75f41f
@@ -143,7 +149,8 @@ servernetbiosname=arg
75f41f
   characters long and is usually uppercased.
75f41f
 
75f41f
 servern=arg
75f41f
-  Synonym for ``servernetbiosname``
75f41f
+  Similarl to ``netbiosname`` except it specifies the netbios name of
75f41f
+  the server instead of the client.
75f41f
 
75f41f
 netbiosname=arg
75f41f
   When mounting to servers via port 139, specifies the RFC1001 source
75f41f
@@ -166,6 +173,10 @@ ip=arg|addr=arg
75f41f
 domain=arg|dom=arg|workgroup=arg
75f41f
   sets the domain (workgroup) of the user.
75f41f
 
75f41f
+domainauto
75f41f
+  When using NTLMv2 authentification and not providing a domain via
75f41f
+  ``domain``, guess the domain from the server NTLM challenge.
75f41f
+
75f41f
 guest
75f41f
   don't prompt for a password.
75f41f
 
75f41f
@@ -237,6 +248,9 @@ cache=arg
75f41f
   The default in kernels prior to 3.7 was ``loose``. As of kernel 3.7 the
75f41f
   default is ``strict``.
75f41f
 
75f41f
+nostrictsync
75f41f
+  Do not flush to the server on fsync().
75f41f
+
75f41f
 handlecache
75f41f
   (default) In SMB2 and above, the client often has to open the root
75f41f
   of the share (empty path) in various places during mount, path
75f41f
@@ -247,32 +261,6 @@ handlecache
75f41f
 nohandlecache
75f41f
   Disable caching of the share root directory handle.
75f41f
 
75f41f
-directio
75f41f
-  Do not do inode data caching on files opened on this mount. This
75f41f
-  precludes mmaping files on this mount. In some cases with fast
75f41f
-  networks and little or no caching benefits on the client (e.g. when
75f41f
-  the application is doing large sequential reads bigger than page size
75f41f
-  without rereading the same data) this can provide better performance
75f41f
-  than the default behavior which caches reads (readahead) and writes
75f41f
-  (writebehind) through the local Linux client pagecache if oplock
75f41f
-  (caching token) is granted and held. Note that direct allows write
75f41f
-  operations larger than page size to be sent to the server. On some
75f41f
-  kernels this requires the cifs.ko module to be built with the
75f41f
-  ``CIFS_EXPERIMENTAL`` configure option.
75f41f
-
75f41f
-  This option is will be deprecated in 3.7. Users should use
75f41f
-  ``cache=none`` instead on more recent kernels.
75f41f
-
75f41f
-strictcache
75f41f
-  Use for switching on strict cache mode. In this mode the client reads
75f41f
-  from the cache all the time it has *Oplock Level II* , otherwise -
75f41f
-  read from the server. As for write - the client stores a data in the
75f41f
-  cache in *Exclusive Oplock* case, otherwise - write directly to the
75f41f
-  server.
75f41f
-
75f41f
-  This option is will be deprecated in 3.7. Users should use
75f41f
-  ``cache=strict`` instead on more recent kernels.
75f41f
-
75f41f
 rwpidforward
75f41f
   Forward pid of a process who opened a file to any read or write
75f41f
   operation on that file. This prevent applications like wine(1) from
75f41f
@@ -283,7 +271,7 @@ mapchars
75f41f
   including the colon, question mark, pipe, asterik, greater than and
75f41f
   less than characters) to the remap range (above 0xF000), which also
75f41f
   allows the CIFS client to recognize files created with such characters
75f41f
-  by Windows's POSIX emulation. This can also be useful when mounting to
75f41f
+  by Windows's Services for Mac. This can also be useful when mounting to
75f41f
   most versions of Samba (which also forbids creating and opening files
75f41f
   whose names contain any of these seven characters). This has no effect
75f41f
   if the server does not support Unicode on the wire. Please note that
75f41f
@@ -293,6 +281,10 @@ mapchars
75f41f
 nomapchars
75f41f
   (default) Do not translate any of these seven characters.
75f41f
 
75f41f
+mapposix
75f41f
+  Translate reserved characters similarly to ``mapchars`` but use the
75f41f
+  mapping from Microsoft "Services For Unix".
75f41f
+
75f41f
 intr
75f41f
   currently unimplemented.
75f41f
 
75f41f
@@ -370,12 +362,42 @@ seal
75f41f
   Request encryption at the SMB layer. Encryption is only supported in
75f41f
   SMBv3 and above. The encryption algorithm used is AES-128-CCM.
75f41f
 
75f41f
+rdma
75f41f
+  Connect directly to the server using SMB Direct via a RDMA adapter.
75f41f
+
75f41f
+resilienthandles
75f41f
+  Enable resilient handles. If the server supports it, keep opened
75f41f
+  files across reconenctions. Requires SMB2.1.
75f41f
+
75f41f
+noresilienthandles
75f41f
+  (default) Disable resilient handles.
75f41f
+
75f41f
+persistenthandles
75f41f
+  Enable persistent handles. If the server supports it, keep opened
75f41f
+  files across reconnections. Persistent handles are also valid across
75f41f
+  servers in a cluser and have stronger guarantees than resilient
75f41f
+  handles. Requires SMB3 or above.
75f41f
+
75f41f
+nopersistenthandles
75f41f
+  (default) Disable persistent handles.
75f41f
+
75f41f
+snapshot=time
75f41f
+  Mount a specific snapshot of the remote share. ``time`` must be a
75f41f
+  positive integer identifying the snapshot requested.
75f41f
+
75f41f
 nobrl
75f41f
   Do not send byte range lock requests to the server. This is necessary
75f41f
   for certain applications that break with cifs style mandatory byte
75f41f
   range locks (and most cifs servers do not yet support requesting
75f41f
   advisory byte range locks).
75f41f
 
75f41f
+forcemandatorylock
75f41f
+  Do not use POSIX locks even when available via unix
75f41f
+  extensions. Always use cifs style mandatory locks.
75f41f
+
75f41f
+locallease
75f41f
+  Check cache leases locally instead of querying the server.
75f41f
+
75f41f
 sfu
75f41f
   When the CIFS Unix Extensions are not negotiated, attempt to create
75f41f
   device files and fifos in a format compatible with Services for Unix
75f41f
@@ -431,8 +453,12 @@ noserverino
75f41f
 
75f41f
   See section `INODE NUMBERS`_ for more information.
75f41f
 
75f41f
-nounix
75f41f
-  Disable the CIFS Unix Extensions for this mount. This can be useful in
75f41f
+unix|linux
75f41f
+  (default) Enable Unix Extensions for this mount. Requires CIFS
75f41f
+  (vers=1.0) or SMB3.1.1 (vers=3.1.1) and a server supporting them.
75f41f
+
75f41f
+nounix|nolinux
75f41f
+  Disable the Unix Extensions for this mount. This can be useful in
75f41f
   order to turn off multiple settings at once. This includes POSIX acls,
75f41f
   POSIX locks, POSIX paths, symlink support and retrieving
75f41f
   uids/gids/mode from the server. This can also be useful to work around
75f41f
@@ -444,6 +470,23 @@ nouser_xattr
75f41f
   Do not allow getfattr/setfattr to get/set xattrs, even if server would
75f41f
   support it otherwise. The default is for xattr support to be enabled.
75f41f
 
75f41f
+nodfs
75f41f
+  Do not follow Distributed FileSystem referals. IO on a file not
75f41f
+  stored on the server will fail instead of connecting to the target
75f41f
+  server transparently.
75f41f
+
75f41f
+noautotune
75f41f
+  Use fixed size for kernel recv/send socket buffers.
75f41f
+
75f41f
+nosharesock
75f41f
+  Do not try to reuse sockets if the system is already connected to
75f41f
+  the server via an existing mount point. This will make the client
75f41f
+  always make a new connection to the server no matter what he is
75f41f
+  already connected to.
75f41f
+
75f41f
+noblocksend
75f41f
+  Send data on the socket using non blocking operations (MSG_DONTWAIT flag).
75f41f
+
75f41f
 rsize=bytes
75f41f
   Maximum amount of data that the kernel will request in a read request
75f41f
   in bytes. Prior to kernel 3.2.0, the default was 16k, and the maximum
75f41f
@@ -472,6 +515,10 @@ wsize=bytes
75f41f
   this value isn't specified or it's greater or equal than the existing
75f41f
   one.
75f41f
 
75f41f
+max_credits=n
75f41f
+  Maximum credits the SMB2 client can have. Default is 32000. Must be
75f41f
+  set to a number between 20 and 60000.
75f41f
+
75f41f
 fsc
75f41f
   Enable local disk caching using FS-Cache for CIFS. This option could
75f41f
   be useful to improve performance on a slow link, heavily loaded server
75f41f
-- 
75f41f
1.8.3.1
75f41f