|
 |
ec890a |
commit b5381c96298d75ba66625a007e2390e2b501850d
|
|
|
ec890a |
Author: Trond Myklebust <trond.myklebust@hammerspace.com>
|
|
|
ec890a |
Date: Wed Jan 29 10:45:39 2020 -0500
|
|
|
ec890a |
|
|
|
ec890a |
manpage: Add a description of the 'softreval' / 'nosoftreval' mount option
|
|
|
ec890a |
|
|
|
ec890a |
Add a description of the 'softreval' / 'nosoftreval' mount options on
|
|
|
ec890a |
the 'nfs' generic manpage.
|
|
|
ec890a |
|
|
|
ec890a |
Signed-off-by: Trond Myklebust <trond.myklebust@hammerspace.com>
|
|
|
ec890a |
Signed-off-by: Steve Dickson <steved@redhat.com>
|
|
|
ec890a |
|
|
|
ec890a |
diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
|
|
|
ec890a |
index 84462cd7..6f79c63a 100644
|
|
|
ec890a |
--- a/utils/mount/nfs.man
|
|
|
ec890a |
+++ b/utils/mount/nfs.man
|
|
|
ec890a |
@@ -121,6 +121,36 @@ option may mitigate some of the risks of using the
|
|
|
ec890a |
.B soft
|
|
|
ec890a |
option.
|
|
|
ec890a |
.TP 1.5i
|
|
|
ec890a |
+.BR softreval " / " nosoftreval
|
|
|
ec890a |
+In cases where the NFS server is down, it may be useful to
|
|
|
ec890a |
+allow the NFS client to continue to serve up paths and
|
|
|
ec890a |
+attributes from cache after
|
|
|
ec890a |
+.B retrans
|
|
|
ec890a |
+attempts to revalidate that cache have timed out.
|
|
|
ec890a |
+This may, for instance, be helpful when trying to unmount a
|
|
|
ec890a |
+filesystem tree from a server that is permanently down.
|
|
|
ec890a |
+.IP
|
|
|
ec890a |
+It is possible to combine
|
|
|
ec890a |
+.BR softreval
|
|
|
ec890a |
+with the
|
|
|
ec890a |
+.B soft
|
|
|
ec890a |
+mount option, in which case operations that cannot be served up
|
|
|
ec890a |
+from cache will time out and return an error after
|
|
|
ec890a |
+.B retrans
|
|
|
ec890a |
+attempts. The combination with the default
|
|
|
ec890a |
+.B hard
|
|
|
ec890a |
+mount option implies those uncached operations will continue to
|
|
|
ec890a |
+retry until a response is received from the server.
|
|
|
ec890a |
+.IP
|
|
|
ec890a |
+Note: the default mount option is
|
|
|
ec890a |
+.BR nosoftreval
|
|
|
ec890a |
+which disallows fallback to cache when revalidation fails, and
|
|
|
ec890a |
+instead follows the behavior dictated by the
|
|
|
ec890a |
+.B hard
|
|
|
ec890a |
+or
|
|
|
ec890a |
+.B soft
|
|
|
ec890a |
+mount option.
|
|
|
ec890a |
+.TP 1.5i
|
|
|
ec890a |
.BR intr " / " nointr
|
|
|
ec890a |
This option is provided for backward compatibility.
|
|
|
ec890a |
It is ignored after kernel 2.6.25.
|