git: 033587a985a4 - main - mount_nullfs.8: document unixbypass and nounixbypass

The branch main has been updated by kib:

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

commit 033587a985a46e9d45fc3fb48a78754d81f0d50d
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2025-10-09 20:55:01 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-10-09 22:48:01 +0000

    mount_nullfs.8: document unixbypass and nounixbypass
    
    Reviewed by:    markj
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D52983
---
 sbin/mount_nullfs/mount_nullfs.8 | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/sbin/mount_nullfs/mount_nullfs.8 b/sbin/mount_nullfs/mount_nullfs.8
index 17b1f45f5e42..b3cf57fd9dea 100644
--- a/sbin/mount_nullfs/mount_nullfs.8
+++ b/sbin/mount_nullfs/mount_nullfs.8
@@ -90,7 +90,7 @@ See the
 .Xr mount 8
 man page for possible options and their meanings.
 Additionally the following option is supported:
-.Bl -tag -width nocache
+.Bl -tag -width nounixbypass
 .It Cm nocache
 Disable metadata caching in the null layer.
 Some lower-layer file systems may force this option.
@@ -98,6 +98,32 @@ Depending on the access pattern,
 this may result in increased lock contention.
 .It Cm cache
 Force enable metadata caching.
+.It Cm nounixbypass
+Disable bypassing
+.Xr unix 4
+socket files used for
+.Xr bind 2
+and
+.Xr connect 2 ,
+to the lower (mounted-from) filesystem layer.
+.Pp
+The effect is that lower and upper (bypassed) unix sockets
+are separate.
+.It Cm unixbypass
+Enable the bypass of unix socket file to lower filesystem layer.
+This is default.
+.Pp
+The effect is that
+.Xr bind 2
+and
+.Xr connect 2
+operations on a unix socket done from either the upper (nullfs) or lower
+layer path are performed on same unix socket.
+For instance, if a server
+.Xr bind 2
+is done on a socket in the lower layer, then
+.Xr connect 2
+on the socket file accessed via the nullfs mount, connects to the server.
 .El
 .El
 .Pp