git: 448de00de556 - main - mount_nfs: update man page description for oneopenown

[Rick Macklem]

The branch main has been updated by rmacklem:

URL: https://cgit.FreeBSD.org/src/commit/?id=448de00de556753575ec0a2e705712e7c606e680

commit 448de00de556753575ec0a2e705712e7c606e680
Author:     Rick Macklem <rmacklem at FreeBSD.org>
AuthorDate: 2021-01-18 03:00:41 +0000
Commit:     Rick Macklem <rmacklem at FreeBSD.org>
CommitDate: 2021-01-18 03:00:41 +0000

    mount_nfs: update man page description for oneopenown
    
    A recent email discussion indicated that a large
    accumulation of NFSv4 Opens was occurring on
    a mount. This appears to have been caused by a
    shared library within the mount being used by
    several processes, such that there is always at
    least one of these processes running.
    A new Open was created by each process and
    were not closed, since all the Opens were never
    closed. This is alleviated by using the
    "oneopenown" mount option.
    
    This man page update attempts to indicate the
    use of "oneopenown" for this case.
    
    This is a content change.
    
    Reported by:    j.david.lists at gmail.com
    Reviewed by:    0mp
    MFC:    1 month
    Differential Revision:  https://reviews.freebsd.org/D28215
---
 sbin/mount_nfs/mount_nfs.8 | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/sbin/mount_nfs/mount_nfs.8 b/sbin/mount_nfs/mount_nfs.8
index b2c561bc5cc8..76e009817d8b 100644
--- a/sbin/mount_nfs/mount_nfs.8
+++ b/sbin/mount_nfs/mount_nfs.8
@@ -28,7 +28,7 @@
 .\"	@(#)mount_nfs.8	8.3 (Berkeley) 3/29/95
 .\" $FreeBSD$
 .\"
-.Dd December 21, 2020
+.Dd January 17, 2021
 .Dt MOUNT_NFS 8
 .Os
 .Sh NAME
@@ -217,6 +217,19 @@ Make a minor version 1 or 2 of the NFS Version 4 protocol mount use a single
 OpenOwner for all Opens.
 This may be useful for a server with a very low limit on OpenOwners, such as
 AmazonEFS.
+It may be required when an accumulation of NFS version 4 Opens occurs,
+as indicated by the
+.Dq Opens
+count displayed by
+.Xr nfsstat 8
+with the
+.Fl c
+and
+.Fl E
+command-line options.
+A common case for an accumulation of Opens is a shared library within
+the NFS mount that is used by several
+processes, where at least one of these processes is always running.
 This option cannot be used for an NFS Version 4, minor version 0 mount.
 As such, this option requires the
 .Cm minorversion