From 08bc0097734824ff436769a95569e32575b51da3 Mon Sep 17 00:00:00 2001
From: Maxim Konovalov <maxim@FreeBSD.org>
Date: Tue, 3 Jun 2025 19:19:59 +0000
Subject: [PATCH] if_bridge.4: clarify how if_bridge assigns a MAC address

PR:		283400
MFC after:	1 week
---
 share/man/man4/bridge.4 | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/share/man/man4/bridge.4 b/share/man/man4/bridge.4
index 45dea82325b..7ce734ae87e 100644
--- a/share/man/man4/bridge.4
+++ b/share/man/man4/bridge.4
@@ -36,7 +36,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 13, 2025
+.Dd May 28, 2025
 .Dt IF_BRIDGE 4
 .Os
 .Sh NAME
@@ -79,10 +79,12 @@ command or using the
 variable in
 .Xr rc.conf 5 .
 .Pp
-The
+When it is created, the
 .Nm
-interface randomly chooses a link (MAC) address in the range reserved for
-locally administered addresses when it is created.
+interface gets assigned a link (MAC) address in the range of universally
+administered addresses reserved for the FreeBSD Foundation by hashing
+the host UUID, jail name, and the interface name.
+If this fails, a random, locally administered address is generated instead.
 This address is guaranteed to be unique
 .Em only
 across all