Received-SPF: pass (google.com: best guess record for domain of linux-nfs-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Subject: Re: [PATCH 2/2] manpage: Add a description of the 'softreval' /
 'nosoftreval' mount option
To:     Linux NFS Mailing list <linux-nfs@vger.kernel.org>
References: <20200129154703.6204-1-steved@redhat.com>
 <20200129154703.6204-2-steved@redhat.com>
From:   Steve Dickson <SteveD@RedHat.com>
Message-ID: <2747d2f9-037b-a4ba-7d9b-64dc3e303e08@RedHat.com>
Date:   Fri, 7 Feb 2020 11:08:23 -0500
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.4.1
MIME-Version: 1.0
In-Reply-To: <20200129154703.6204-2-steved@redhat.com>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Sender: linux-nfs-owner@vger.kernel.org
Precedence: bulk


On 1/29/20 10:47 AM, Steve Dickson wrote:
> From: Trond Myklebust <trond.myklebust@hammerspace.com>
> 
> Add a description of the 'softreval' / 'nosoftreval' mount options on
> the 'nfs' generic manpage.
> 
> Signed-off-by: Trond Myklebust <trond.myklebust@hammerspace.com>
> Signed-off-by: Steve Dickson <steved@redhat.com>
Committed... (tag: nfs-utils-2-4-3-rc7)

steved.

> ---
>  utils/mount/nfs.man | 30 ++++++++++++++++++++++++++++++
>  1 file changed, 30 insertions(+)
> 
> diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
> index 84462cd..6f79c63 100644
> --- a/utils/mount/nfs.man
> +++ b/utils/mount/nfs.man
> @@ -121,6 +121,36 @@ option may mitigate some of the risks of using the
>  .B soft
>  option.
>  .TP 1.5i
> +.BR softreval " / " nosoftreval
> +In cases where the NFS server is down, it may be useful to
> +allow the NFS client to continue to serve up paths and
> +attributes from cache after
> +.B retrans
> +attempts to revalidate that cache have timed out.
> +This may, for instance, be helpful when trying to unmount a
> +filesystem tree from a server that is permanently down.
> +.IP
> +It is possible to combine
> +.BR softreval
> +with the
> +.B soft
> +mount option, in which case operations that cannot be served up
> +from cache will time out and return an error after
> +.B retrans
> +attempts. The combination with the default
> +.B hard
> +mount option implies those uncached operations will continue to
> +retry until a response is received from the server.
> +.IP
> +Note: the default mount option is
> +.BR nosoftreval
> +which disallows fallback to cache when revalidation fails, and
> +instead follows the behavior dictated by the
> +.B hard
> +or
> +.B soft
> +mount option.
> +.TP 1.5i
>  .BR intr " / " nointr
>  This option is provided for backward compatibility.
>  It is ignored after kernel 2.6.25.
>