git: ea8d7263d93e - stable/14 - mount_nullfs(8): document -o cache and vfs.nullfs.cache_vnodes

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Thu, 14 Mar 2024 00:46:01 UTC
The branch stable/14 has been updated by kib:

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

commit ea8d7263d93e3e32d8123da5f711446a37cd1722
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-03-08 18:26:48 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-03-13 00:30:41 +0000

    mount_nullfs(8): document -o cache and vfs.nullfs.cache_vnodes
    
    (cherry picked from commit 4a2a69c4472cf677f8dfc026fff3dd33c83580cb)
---
 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 e3648a2fb2f2..b4b862b6c979 100644
--- a/sbin/mount_nullfs/mount_nullfs.8
+++ b/sbin/mount_nullfs/mount_nullfs.8
@@ -32,7 +32,7 @@
 .\"
 .\"     @(#)mount_null.8	8.6 (Berkeley) 5/1/95
 .\"
-.Dd June 11, 2023
+.Dd March 24, 2024
 .Dt MOUNT_NULLFS 8
 .Os
 .Sh NAME
@@ -92,15 +92,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.