Bug 2073476

Summary:	nfs.man update to involve new mount option 'softreval'
Product:	Red Hat Enterprise Linux 8	Reporter:	Yongcheng Yang <yoyang>
Component:	nfs-utils	Assignee:	Steve Dickson <steved>
Status:	CLOSED ERRATA	QA Contact:	Yongcheng Yang <yoyang>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	8.4	CC:	xzhou
Target Milestone:	rc	Keywords:	Triaged
Target Release:	---	Flags:	pm-rhel: mirror+
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	nfs-utils-2.3.3-52.el8	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-11-08 10:53:52 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Yongcheng Yang 2022-04-08 14:58:48 UTC

Description of problem:

The 8.4 Bug 1872310 introduced a new mount option 'softreval' but it cannot be found from current man pages.

We may need this upstream patch:
commit b5381c96298d75ba66625a007e2390e2b501850d
Author: Trond Myklebust <trond.myklebust>
Date:   Wed Jan 29 10:45:39 2020 -0500

    manpage: Add a description of the 'softreval' / 'nosoftreval' mount option


Btw after mounting with softreval, I can't see it from the mount options list. Don't know if this is as expected. 
E.g.
# mount localhost:/export_test/ /mnt_test8/ -o softreval
# nfsstat -m
/mnt_test8 from localhost:/export_test
 Flags: rw,relatime,vers=4.2,rsize=262144,wsize=262144,namlen=255,hard,proto=tcp6,timeo=600,retrans=2,sec=sys,clientaddr=::1,local_lock=none,addr=::1

# nfsstat -m | grep soft
# mountstats /mnt_test8/ | grep soft
# rpm -q nfs-utils
nfs-utils-2.3.3-51.el8.x86_64
#


Version-Release number of selected component (if applicable):
nfs-utils-2.3.3-51.el8

How reproducible:


Steps to Reproduce:
1. 
2.
3.

Actual results:


Expected results:


Additional info:

Comment 5 Yongcheng Yang 2022-06-01 02:03:00 UTC

Have verified this man page update.

[root@yoyang-rhel-860-updates-202205230 ~]# rpm -q nfs-utils
nfs-utils-2.3.3-51.el8.x86_64
[root@yoyang-rhel-860-updates-202205230 ~]# rpm -Uvh  nfs-utils-2.3.3-52.el8.x86_64.rpm
Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:nfs-utils-1:2.3.3-52.el8         ################################# [ 50%]
Cleaning up / removing...
   2:nfs-utils-1:2.3.3-51.el8         ################################# [100%]
[root@yoyang-rhel-860-updates-202205230 ~]# man nfs
[root@yoyang-rhel-860-updates-202205230 ~]# man nfs | grep softre
       softreval / nosoftreval
                      It is possible to combine softreval with the soft mount option, in which case operations that cannot be served up from cache will  time  out  and  return  an  error  after  retrans
                      Note: the default mount option is nosoftreval which disallows fallback to cache when revalidation fails, and instead follows the behavior dictated by the hard or soft mount option.
[root@yoyang-rhel-860-updates-202205230 ~]# rpm -q nfs-utils
nfs-utils-2.3.3-52.el8.x86_64
[root@yoyang-rhel-860-updates-202205230 ~]#

Comment 11 errata-xmlrpc 2022-11-08 10:53:52 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (nfs-utils bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2022:7768