git: 980c44df42fe - stable/15 - bhyve: Document that MAC address has to be unicast
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 29 Dec 2025 18:35:47 UTC
The branch stable/15 has been updated by michaelo:
URL: https://cgit.FreeBSD.org/src/commit/?id=980c44df42fe1fcb29a4ef24af5e4e5c27cc2370
commit 980c44df42fe1fcb29a4ef24af5e4e5c27cc2370
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:35:08 +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 483462e0b98b..1d81280b8f75 100644
--- a/usr.sbin/bhyve/bhyve.8
+++ b/usr.sbin/bhyve/bhyve.8
@@ -25,7 +25,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
@@ -542,6 +542,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 b511d5ef6bfd..4ead94690d91 100644
--- a/usr.sbin/bhyve/bhyve_config.5
+++ b/usr.sbin/bhyve/bhyve_config.5
@@ -517,8 +517,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"
@@ -746,8 +748,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