git: 31179643a9 - main - 15.x relnotes: note stable MAC address changes

The branch main has been updated by kevans:

URL: https://cgit.FreeBSD.org/doc/commit/?id=31179643a9d61f46788516ab8270366cdb536078

commit 31179643a9d61f46788516ab8270366cdb536078
Author:     Kyle Evans <kevans@FreeBSD.org>
AuthorDate: 2026-06-18 19:37:06 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2026-06-18 19:37:06 +0000

    15.x relnotes: note stable MAC address changes
    
    src 604d34c23f77 was tagged for relnotes, but we indavertently missed
    it.  Rectify the mistake now and note it in both 15.0/15.1 relnotes,
    because 15.1 is a very attractive upgrade target right now and it'd be
    nice if we didn't bury it just back in the 15.0 release notes.
    
    PR:             296129
    Reviewed by:    ziaee
    Differential Revision:  https://reviews.freebsd.org/D57647
---
 website/content/en/releases/15.0R/relnotes.adoc | 4 ++++
 website/content/en/releases/15.1R/relnotes.adoc | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc
index 14611ba001..d175b2f5b2 100644
--- a/website/content/en/releases/15.0R/relnotes.adoc
+++ b/website/content/en/releases/15.0R/relnotes.adoc
@@ -1485,6 +1485,10 @@ Kernel compatibility code supporting man:ipfw[8] binaries from FreeBSD 7 and 8 h
 gitref:660255be1ed9[repository=src]
 {{< sponsored "The FreeBSD Foundation" >}}
 
+The stable MAC address generated for man:if_bridge[4], man:if_epair[4], and other interfaces will change as of 15.0 due to a critical flaw in the implementation that resulted in a high chance of collisions and some generated addresses outside of the expected OUI.
+If the previous MAC address needs to be retained for, e.g., DHCP leases, then care must be taken to persist the existing MAC address, such as with `ifconfig_bridgeN="... ether aa:bb:cc:dd:ee:ff"` in man:rc.conf[5].
+gitref:604d34c23f77[repository=src]
+
 [[network-protocols]]
 === Network Protocols
 
diff --git a/website/content/en/releases/15.1R/relnotes.adoc b/website/content/en/releases/15.1R/relnotes.adoc
index 25a0efc504..b90562d17c 100644
--- a/website/content/en/releases/15.1R/relnotes.adoc
+++ b/website/content/en/releases/15.1R/relnotes.adoc
@@ -774,6 +774,10 @@ gitref:9657c50cdd77[repository=src].
 The support for RFC 7217 stable IPv6 address generation via a new ifconfig 'stableaddr' flag and associated sysctls has been added. The feature is disabled by default, preserving existing behavior. The man:ifconfig[8] manual page is updated with documentation.
 gitref:865e0b20ca3c[repository=src].
 
+The stable MAC address generated for man:if_bridge[4], man:if_epair[4], and other interfaces will change as of 15.0 due to a critical flaw in the implementation that resulted in a high chance of collisions and some generated addresses outside of the expected OUI.
+If the previous MAC address needs to be retained for, e.g., DHCP leases, then care must be taken to persist the existing MAC address, such as with `ifconfig_bridgeN="... ether aa:bb:cc:dd:ee:ff"` in man:rc.conf[5].
+gitref:604d34c23f77[repository=src]
+
 [[wireless-networking]]
 === Wireless Networking