vnet.9: Remove references to non-existant macros and update how to virtualize sysctls

Approved by:	bcr, ziaee
MFC after:	1 week
MFC to:		stable/14, stable/15
Sponsored by:	Rubicon Communications, LLC ("Netgate")
Differential Revision:	https://reviews.freebsd.org/D52620
This commit is contained in:
Brad Davis
2025-09-19 08:38:20 -06:00
parent ba05cddcc6
commit 22886d3af0
+4 -48
View File
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd December 10, 2020 .Dd September 19, 2025
.Dt VNET 9 .Dt VNET 9
.Os .Os
.Sh NAME .Sh NAME
@@ -162,26 +162,6 @@
.Fa "int priority" .Fa "int priority"
.Fc .Fc
.\" ------------------------------------------------------------ .\" ------------------------------------------------------------
.Ss "Sysctl Handling"
.Fo SYSCTL_VNET_INT
.Fa parent nbr name access ptr val descr
.Fc
.Fo SYSCTL_VNET_PROC
.Fa parent nbr name access ptr arg handler fmt descr
.Fc
.Fo SYSCTL_VNET_STRING
.Fa parent nbr name access arg len descr
.Fc
.Fo SYSCTL_VNET_STRUCT
.Fa parent nbr name access ptr type descr
.Fc
.Fo SYSCTL_VNET_UINT
.Fa parent nbr name access ptr val descr
.Fc
.Fo VNET_SYSCTL_ARG
.Fa req arg1
.Fc
.\" ------------------------------------------------------------
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is the name of a technique to virtualize the network stack. is the name of a technique to virtualize the network stack.
@@ -250,9 +230,6 @@ The
.Fn VNET_NAME .Fn VNET_NAME
macro returns the offset within the memory region of the virtual network macro returns the offset within the memory region of the virtual network
stack instance. stack instance.
It is usually only used with
.Fn SYSCTL_VNET_*
macros.
.\" ------------------------------------------------------------ .\" ------------------------------------------------------------
.Ss "Virtual Instance Selection" .Ss "Virtual Instance Selection"
.\" .\"
@@ -459,30 +436,9 @@ call will be ignored.
.\" .\"
A A
.Xr sysctl 9 .Xr sysctl 9
can be virtualized by using one of the can be virtualized by adding the
.Fn SYSCTL_VNET_* .Dv CTLFLAG_VNET
macros. control flag to the ctlflags bitmask of the macros.
.Pp
They take the same arguments as the standard
.Xr sysctl 9
functions, with the only difference, that the
.Fa ptr
argument has to be passed as
.Ql &VNET_NAME(foo)
instead of
.Ql &foo
so that the variable can be selected from the correct memory
region of the virtual network stack instance of the caller.
.Pp
For the very rare case a sysctl handler function would want to
handle
.Fa arg1
itself the
.Fn VNET_SYSCTL_ARG req arg1
is provided that will translate the
.Fa arg1
argument to the correct memory address in the virtual network stack
context of the caller.
.\" ------------------------------------------------------------ .\" ------------------------------------------------------------
.Sh SEE ALSO .Sh SEE ALSO
.Xr jail 2 , .Xr jail 2 ,