From nobody Wed Sep 24 08:04:44 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cWqBj0rcQz68hTj; Wed, 24 Sep 2025 08:04:45 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cWqBj0LRCz3lpB; Wed, 24 Sep 2025 08:04:45 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758701085; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Vo7YsN5pFdFip3Q2/DaKhbIx9ROq5+AvQzK9HB7PZYg=; b=qlsef9ARJdr/rcmNh35ibW/JM1n07ykGNYgdXhl5mtRXqfGHyuFSlPmpbnOQh1xagptXzB eHTpR6UKfkapqz2XyG2IMsSv5SRaBgmiHZOcTvHYb9lUacmhQ3/Q3GbuHBQ0D5i8oerFd7 Tj1zazYoSduovvSBTLuVb40F9kyiY1Q8L3Cw1zH80zD30HSkmp4XF12WGXqHF0RBIoSAQN mxNtEjDVnlNhlQuv3n/jBcVJYm2/bZZqq6gw3qbidyatG2mck0/QpsUyVqOCS35NuOJ+1J 6RkgM07kyxqSzQswle2ZgOYbdsWZoLTzly3r9V1N+qdxR/NjPaF4QDyxjORn/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758701085; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Vo7YsN5pFdFip3Q2/DaKhbIx9ROq5+AvQzK9HB7PZYg=; b=mFvQ+rxxPQT2YsO9RrJd9DlZFBNJITR4Wkjmx+hiqTEiUiv8PIoXi5WP2s0A0zF23NN9eT D8jZYJ8Y/a6oF1Dhhu8h0CFlNPJghLtbcd7EWWh/xbGnbZ81PSreh692RIJyduLhoD11/O XoiBA1FuGrrDtRKHMwnHN34aogJzMVSjCF3Mz2mMQ++oR5DOwKwIiDJP+2N0/cx/zHqj6M 8Jg0B54loY61KPdVxaZgIL1g7hRVzRfdScQzvdpt4x4qkbHMcEWfS6NLgXoKkZgimRWMk9 YUriE3dxyHob13zM9UCZ0/p/No9Ct5ody5apHsaLs+swF8Cd4LO7df8J72mPww== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758701085; a=rsa-sha256; cv=none; b=SZoby+Tgm13jGOeJLhlKVsTeCS2m4T8GEwlOP71/TFIkqDW0vwyrqZ9yDnvAGFzNxRJUAI 8XC8i/w7Aab1sn1KlTpqNX/TDI7uRFMffznNBwb/EUWbIvUQiNYTeJYdlur3EQ/hlvHZum 8dVf0bs+CHroP4q5lE1lRBTSgh7HbnOVIKHB76rh2wMJGRXLN7ApygTziQT5BMOwNhOjeI zLdfFz1k5UZVUN92EgP4EOYONSwPU5NQ8YAjIaOfTq1I4WfOMkgcDQ+9BehPWH6bqEiq37 jGsubrBFsQ3ThTkp7xtmrJAThIYWJ90RCyO8/+2GND3cp/u2DRPvQtTlgFA1vQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cWqBh6zQfz7ZM; Wed, 24 Sep 2025 08:04:44 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 58O84iW0068570; Wed, 24 Sep 2025 08:04:44 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58O84i87068567; Wed, 24 Sep 2025 08:04:44 GMT (envelope-from git) Date: Wed, 24 Sep 2025 08:04:44 GMT Message-Id: <202509240804.58O84i87068567@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Brad Davis Subject: git: 22886d3af065 - main - vnet.9: Remove references to non-existant macros and update how to virtualize sysctls List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: brd X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 22886d3af0657dae3b547b21e612642bb47e0321 Auto-Submitted: auto-generated The branch main has been updated by brd: URL: https://cgit.FreeBSD.org/src/commit/?id=22886d3af0657dae3b547b21e612642bb47e0321 commit 22886d3af0657dae3b547b21e612642bb47e0321 Author: Brad Davis AuthorDate: 2025-09-19 14:38:20 +0000 Commit: Brad Davis CommitDate: 2025-09-24 08:04:08 +0000 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 --- share/man/man9/VNET.9 | 52 ++++----------------------------------------------- 1 file changed, 4 insertions(+), 48 deletions(-) diff --git a/share/man/man9/VNET.9 b/share/man/man9/VNET.9 index 28e28bfd3242..679ccc3f9a06 100644 --- a/share/man/man9/VNET.9 +++ b/share/man/man9/VNET.9 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd December 10, 2020 +.Dd September 19, 2025 .Dt VNET 9 .Os .Sh NAME @@ -162,26 +162,6 @@ .Fa "int priority" .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 .Nm is the name of a technique to virtualize the network stack. @@ -250,9 +230,6 @@ The .Fn VNET_NAME macro returns the offset within the memory region of the virtual network stack instance. -It is usually only used with -.Fn SYSCTL_VNET_* -macros. .\" ------------------------------------------------------------ .Ss "Virtual Instance Selection" .\" @@ -459,30 +436,9 @@ call will be ignored. .\" A .Xr sysctl 9 -can be virtualized by using one of the -.Fn SYSCTL_VNET_* -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. +can be virtualized by adding the +.Dv CTLFLAG_VNET +control flag to the ctlflags bitmask of the macros. .\" ------------------------------------------------------------ .Sh SEE ALSO .Xr jail 2 ,