[cifs-utils,v1,2/2] mount.cifs.rst: document new (no)handlecache mount option

Message ID 20180515090503.11182-2-aaptel@suse.com
State New
Headers show
Series
  • [cifs-utils,v1,1/2] docs: cleanup rst formating
Related show

Commit Message

Aurélien Aptel May 15, 2018, 9:05 a.m.
Signed-off-by: Aurelien Aptel <aaptel@suse.com>
---
 mount.cifs.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

Comments

Pavel Shilovsky May 15, 2018, 8:41 p.m. | #1
2018-05-15 2:05 GMT-07:00 Aurelien Aptel <aaptel@suse.com>:
> Signed-off-by: Aurelien Aptel <aaptel@suse.com>
> ---
>  mount.cifs.rst | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>
> diff --git a/mount.cifs.rst b/mount.cifs.rst
> index c0f0bdb..405c459 100644
> --- a/mount.cifs.rst
> +++ b/mount.cifs.rst
> @@ -237,6 +237,16 @@ cache=arg
>    The default in kernels prior to 3.7 was ``loose``. As of kernel 3.7 the
>    default is ``strict``.
>
> +handlecache
> +  (default) In SMB2 and above, the client often has to open the root
> +  of the share (empty path) in various places during mount, path
> +  revalidation and the statfs(2) system call. This option cuts
> +  redundant round trip traffic (opens and closes) by simply keeping
> +  the directory handle for the root around once opened.
> +
> +nohandlecache
> +  Disable caching of the share root directory handle.
> +
>  directio
>    Do not do inode data caching on files opened on this mount. This
>    precludes mmaping files on this mount. In some cases with fast
> --
> 2.13.6
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-cifs" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html

Both patches look good. Thanks!

--
Best regards,
Pavel Shilovsky
--
To unsubscribe from this list: send the line "unsubscribe linux-cifs" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Patch

diff --git a/mount.cifs.rst b/mount.cifs.rst
index c0f0bdb..405c459 100644
--- a/mount.cifs.rst
+++ b/mount.cifs.rst
@@ -237,6 +237,16 @@  cache=arg
   The default in kernels prior to 3.7 was ``loose``. As of kernel 3.7 the
   default is ``strict``.
 
+handlecache
+  (default) In SMB2 and above, the client often has to open the root
+  of the share (empty path) in various places during mount, path
+  revalidation and the statfs(2) system call. This option cuts
+  redundant round trip traffic (opens and closes) by simply keeping
+  the directory handle for the root around once opened.
+
+nohandlecache
+  Disable caching of the share root directory handle.
+
 directio
   Do not do inode data caching on files opened on this mount. This
   precludes mmaping files on this mount. In some cases with fast