git: b4f84b19b482 - stable/13 - bhyve: Document that MAC address has to be unicast

From: Michael Osipov <michaelo_at_FreeBSD.org>
Date: Mon, 29 Dec 2025 18:52:03 UTC
The branch stable/13 has been updated by michaelo:

URL: https://cgit.FreeBSD.org/src/commit/?id=b4f84b19b4826e8af2b20af95c5f2b63a826f40d

commit b4f84b19b4826e8af2b20af95c5f2b63a826f40d
Author:     Michael Osipov <michaelo@FreeBSD.org>
AuthorDate: 2025-12-26 13:40:37 +0000
Commit:     Michael Osipov <michaelo@FreeBSD.org>
CommitDate: 2025-12-29 18:51:50 +0000

    bhyve: Document that MAC address has to be unicast
    
    bhyve accepts any MAC address even foreign as long it is a unicast one.
    
    Reviewed by:    ziaee
    MFC after:      3 days
    Differential Revision:  https://reviews.freebsd.org/D54372
    
    (cherry picked from commit e1bfd541c7cdee1e184cacb2ea3bbebb3a500dfb)
---
 usr.sbin/bhyve/bhyve.8        |  3 ++-
 usr.sbin/bhyve/bhyve_config.5 | 12 ++++++++----
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/usr.sbin/bhyve/bhyve.8 b/usr.sbin/bhyve/bhyve.8
index f3cec8e121a5..aba7b1767e48 100644
--- a/usr.sbin/bhyve/bhyve.8
+++ b/usr.sbin/bhyve/bhyve.8
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 23, 2025
+.Dd December 26, 2025
 .Dt BHYVE 8
 .Os
 .Sh NAME
@@ -423,6 +423,7 @@ If
 is not specified, the MAC address is derived from a fixed OUI and the
 remaining bytes from an MD5 hash of the slot and function numbers and
 the device name.
+If specified, it must be a unicast MAC address.
 .Pp
 The MAC address is an ASCII string in
 .Xr ethers 5
diff --git a/usr.sbin/bhyve/bhyve_config.5 b/usr.sbin/bhyve/bhyve_config.5
index 26387da0d59e..5b77caa75726 100644
--- a/usr.sbin/bhyve/bhyve_config.5
+++ b/usr.sbin/bhyve/bhyve_config.5
@@ -465,8 +465,10 @@ Intel e82545 network interfaces support the following variables:
 .It Sy Name Ta Sy Format Ta Sy Default Ta Sy Description
 .It Va mac Ta MAC address Ta generated Ta
 MAC address.
-If an explicit address is not provided,
-a MAC address is generated from a hash of the device's PCI address.
+If not specified, the MAC address is derived from a fixed OUI, and the
+remaining bytes from an MD5 hash of the slot and function numbers and
+the device name.
+If specified, it must be a unicast MAC address.
 .El
 .Ss Frame Buffer Settings
 .Bl -column "password" "[IP:]port" "127.0.0.1:5900"
@@ -674,8 +676,10 @@ VirtIO network interfaces support the following variables:
 .It Sy Name Ta Sy Format Ta Sy Default Ta Sy Description
 .It Va mac Ta MAC address Ta generated Ta
 MAC address.
-If an explicit address is not provided,
-a MAC address is generated from a hash of the device's PCI address.
+If not specified, the MAC address is derived from a fixed OUI, and the
+remaining bytes from an MD5 hash of the slot and function numbers and
+the device name.
+If specified, it must be a unicast MAC address.
 .It Va mtu Ta integer Ta 1500 Ta
 The largest supported MTU advertised to the guest.
 .El