From f701927118c7c0833751e610c3fd45504c47ef08 Mon Sep 17 00:00:00 2001
From: Aurelien Aptel <aaptel@suse.com>
Date: Tue, 15 May 2018 10:40:48 +0200
Subject: [PATCH 02/36] mount.cifs.rst: document new (no)handlecache mount
 option

Signed-off-by: Aurelien Aptel <aaptel@suse.com>
Reviewed-by: Steve French <smfrench@gmail.com>
Reviewed-by: Pavel Shilovsky <piastryyy@gmail.com>
(cherry picked from commit bfcbfaa27a6bcfea3d463e793feff5a983f344a5)
Signed-off-by: Sachin Prabhu <sprabhu@redhat.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
-- 
1.8.3.1