| Message ID | A89FDC8D-114F-4D0E-B898-EC0FB4D747E1@redhat.com (mailing list archive) |
|---|---|
| State | New |
| Headers | show |
| Series | nfs(5): Add new rdirplus functionality, clarify | expand |
On 3/24/25 1:47 PM, Benjamin Coddington wrote: > 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 <bcodding@redhat.com> Committed... (tag: nfs-utils-2-8-3-rc8) steved. > --- > 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 eab4692a87de..91fc508de280 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
diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man index eab4692a87de..91fc508de280 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
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 <bcodding@redhat.com> --- utils/mount/nfs.man | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-)