git: 4a2a69c4472c - main - mount_nullfs(8): document -o cache and vfs.nullfs.cache_vnodes

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Fri, 08 Mar 2024 18:44:53 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=4a2a69c4472cf677f8dfc026fff3dd33c83580cb

commit 4a2a69c4472cf677f8dfc026fff3dd33c83580cb
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-03-08 18:26:48 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-03-08 18:44:21 +0000

    mount_nullfs(8): document -o cache and vfs.nullfs.cache_vnodes
    
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
---
 sbin/mount_nullfs/mount_nullfs.8 | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/sbin/mount_nullfs/mount_nullfs.8 b/sbin/mount_nullfs/mount_nullfs.8
index 940cb1650a31..da7eb8f3d58b 100644
--- a/sbin/mount_nullfs/mount_nullfs.8
+++ b/sbin/mount_nullfs/mount_nullfs.8
@@ -30,7 +30,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd June 11, 2023
+.Dd March 24, 2024
 .Dt MOUNT_NULLFS 8
 .Os
 .Sh NAME
@@ -90,15 +90,21 @@ See the
 .Xr mount 8
 man page for possible options and their meanings.
 Additionally the following option is supported:
-.Bl -tag -width indent
+.Bl -tag -width nocache
 .It Cm nocache
 Disable metadata caching in the null layer.
 Some lower-layer file systems may force this option.
 Depending on the access pattern,
 this may result in increased lock contention.
+.It Cm cache
+Force enable metadate caching.
 .El
 .El
 .Pp
+The
+.Dv vfs.nullfs.cache_vnodes
+sysctl specifies global default for mount-specific cache/nocache option.
+.Pp
 The null layer has two purposes.
 First, it serves as a demonstration of layering by providing a layer
 which does nothing.