F7qJCr2DBxvpyDpV4DdYArvdunnvvhpBCK9grtuw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1785756518; 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=qJaesysZMCv2JMSZE/o0H2hJDImMWPfFeeCSXGnzocI=; b=fPAK/QOl9meCCrsthC6epKPFXH9Jd4i3QolaqG3eVOpMtYyvLnO+VXy312Tjv97wFI9iqj Wu4ZgYWtFHzygN1jRE+lwo0kuvS36A2/4E2UnokkCfOGGgMf/OwioAfK40TIXOwglaeLNi BjjHCaHU6H8mxLchIIKwWYgzPspGz97qRlvtBN6e6PntAjjHbeeUaIbv5qhVuqIXG6/CFv M48DV91+XP0OkssQ2DF/NN/AvbkJb+QOnHRHSgVagXPCJyuKuXu9i1lCiVQjWeYIFrIyfc JiiuV0mc3SAoPP59oirOdKXxPwKaUjcmEDKbdV2mhfw0WcVZ2js1aE4W6sFFFQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hDDvT5cbZzyGS for ; Mon, 03 Aug 2026 11:28:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 194b0 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 03 Aug 2026 11:28:37 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Bruce M Simpson Subject: git: 0e80d9c15deb - main - netinet6: Document IPv4-mapped extension to IPV6_JOIN_GROUP et al. List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bms X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0e80d9c15debb7438de839aabaa4b6da5c7a3936 Auto-Submitted: auto-generated Date: Mon, 03 Aug 2026 11:28:37 +0000 Message-Id: <6a707b65.194b0.2ec6ba1d@gitrepo.freebsd.org> The branch main has been updated by bms: URL: https://cgit.FreeBSD.org/src/commit/?id=0e80d9c15debb7438de839aabaa4b6da5c7a3936 commit 0e80d9c15debb7438de839aabaa4b6da5c7a3936 Author: Bruce M Simpson AuthorDate: 2026-08-01 08:51:28 +0000 Commit: Bruce M Simpson CommitDate: 2026-08-03 11:27:45 +0000 netinet6: Document IPv4-mapped extension to IPV6_JOIN_GROUP et al. The IPv6 socket options IPV6_JOIN_GROUP and IPV6_LEAVE_GROUP socket options are being extended to accept IPv4 multicast group addresses in the RFC 3493 IPv4-mapped address format as a convenience to application developers. Caveat this addition carefully in the newly added HISTORY section, addressing all previous review comments. Approved by: ziaee Reviewed by: ziaee, glebius PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=193246 Differential Revision: https://reviews.freebsd.org/D55382 --- share/man/man4/ip6.4 | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/share/man/man4/ip6.4 b/share/man/man4/ip6.4 index ce756854a47d..fa393e6227ba 100644 --- a/share/man/man4/ip6.4 +++ b/share/man/man4/ip6.4 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd July 24, 2022 +.Dd August 1, 2026 .Dt IP6 4 .Os .Sh NAME @@ -502,6 +502,16 @@ multicast groups and other multicast options include .Dv IPV6_LEAVE_GROUP , and .Dv IPV6_JOIN_GROUP . +.Pp +In addition, the +.Dv IPV6_JOIN_GROUP , +and +.Dv IPV6_LEAVE_GROUP +socket options will accept IPv4-mapped multicast group +addresses for Any-Source Memberships (ASM) only. +This is an extension to the behaviour for unicast IPv4-mapped +address support described in Section 3.7 of RFC 3493, +which has been adopted by many network applications. .Ss Raw Sockets Raw IPv6 sockets are connectionless and are normally used with the .Xr sendto 2 @@ -729,3 +739,12 @@ The .Dv IPV6_PORTRANGE socket option and the conflict resolution rule are not defined in the RFCs and should be considered implementation dependent. +.Sh HISTORY +The extensions for +.Dv IPV6_JOIN_GROUP +and +.Dv IPV6_LEAVE_GROUP +to accept IPv4 group addresses in RFC 4291 IPv4-mapped format were added in +.Fx 16.0 . +These extensions were never formally defined in RFC 3493, and RFC 4038 did not +define any migration mechanism for multicast groups specified in this way.