From 9f4884f92caff6fb55912002f3dfd11212963152 Mon Sep 17 00:00:00 2001 From: Scott Mayhew Date: Tue, 20 May 2025 08:48:01 -0400 Subject: [PATCH] Update rdirplus documentation on nfs(5) man page Resolves: RHEL-91253 Signed-off-by: Scott Mayhew --- nfs-utils-2.3.3-nfs-man-rdirplus.patch | 47 ++++++++++++++++++++++++++ nfs-utils.spec | 6 +++- 2 files changed, 52 insertions(+), 1 deletion(-) create mode 100644 nfs-utils-2.3.3-nfs-man-rdirplus.patch diff --git a/nfs-utils-2.3.3-nfs-man-rdirplus.patch b/nfs-utils-2.3.3-nfs-man-rdirplus.patch new file mode 100644 index 0000000..e217890 --- /dev/null +++ b/nfs-utils-2.3.3-nfs-man-rdirplus.patch @@ -0,0 +1,47 @@ +From 3cca9dbeab3b159c27c1dc48e791139744baf6d0 Mon Sep 17 00:00:00 2001 +From: Benjamin Coddington +Date: Mon, 24 Mar 2025 15:47:43 -0400 +Subject: [nfs-utils PATCH] nfs(5): Add new rdirplus functionality, clarify + +The proposed kernel [patch][1] will modify the rdirplus mount option to +accept optional string values of "none" and "force". Update the man page +to reflect these changes and clarify the current client's behavior for the +default. + +[1]: https://lore.kernel.org/linux-nfs/8c33cd92be52255b0dd0a7489c9e5cc35434ec95.1741876784.git.bcodding@redhat.com/T/#u + +Signed-off-by: Benjamin Coddington +Signed-off-by: Steve Dickson +--- + utils/mount/nfs.man | 15 ++++++++++----- + 1 file changed, 10 insertions(+), 5 deletions(-) + +diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man +index b5c5913b..94dc29d4 100644 +--- a/utils/mount/nfs.man ++++ b/utils/mount/nfs.man +@@ -434,11 +434,16 @@ option may also be used by some pNFS drivers to decide how many + connections to set up to the data servers. + .TP 1.5i + .BR rdirplus " / " nordirplus +-Selects whether to use NFS v3 or v4 READDIRPLUS requests. +-If this option is not specified, the NFS client uses READDIRPLUS requests +-on NFS v3 or v4 mounts to read small directories. +-Some applications perform better if the client uses only READDIR requests +-for all directories. ++Selects whether to use NFS v3 or v4 READDIRPLUS requests. If this option is ++not specified, the NFS client uses a heuristic to optimize performance by ++choosing READDIR vs READDIRPLUS based on how often the calling process uses ++the additional attributes returned from READDIRPLUS. Some applications ++perform better if the client uses only READDIR requests for all directories. ++.TP 1.5i ++.BR rdirplus={none|force} ++If set to "force", the NFS client always attempts to use READDIRPLUS ++requests. If set to "none", the behavior is the same as ++.B nordirplus. + .TP 1.5i + .BI retry= n + The number of minutes that the +-- +2.48.1 + diff --git a/nfs-utils.spec b/nfs-utils.spec index 18b8b0a..62d3691 100644 --- a/nfs-utils.spec +++ b/nfs-utils.spec @@ -2,7 +2,7 @@ Summary: NFS utilities and supporting clients and daemons for the kernel NFS ser Name: nfs-utils URL: http://linux-nfs.org/ Version: 2.3.3 -Release: 63%{?dist} +Release: 64%{?dist} Epoch: 1 # group all 32bit related archs @@ -117,6 +117,7 @@ Patch059: nfs-utils-2.3.3-gssd-unconditionally-use-krb5_get_init_creds_opt_all.p Patch060: nfs-utils-2.3.3-gssd-do-not-use-krb5_cc_initialize.patch Patch061: nfs-utils-2.3.3-nfsiostat-fixes.patch Patch062: nfs-utils-2.3.3-mountstats-fixes.patch +Patch063: nfs-utils-2.3.3-nfs-man-rdirplus.patch Patch100: nfs-utils-1.2.1-statdpath-man.patch Patch101: nfs-utils-1.2.1-exp-subtree-warn-off.patch @@ -395,6 +396,9 @@ fi %{_libdir}/libnfsidmap.so %changelog +* Tue May 20 2025 Scott Mayhew 2.3.3-64 +- update rdirplus documentation on nfs(5) man page (RHEL-91253) + * Fri May 9 2025 Scott Mayhew 2.3.3-63 - mountstats fixes (RHEL-90242)