upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-06-13 02:30:51 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Document tunable net.link.epair.ether_gen_addr

Browse source 
Approved by:	hrs
Fixes:	590493c141 ("if_epair(4): use ether_gen_addr(9) for stable MAC address")
MFC after:	1 week (together with the tunable)
Differential Revision: https://reviews.freebsd.org/D51861
This commit is contained in:
Ronald Klop 2025-08-11 15:51:16 +02:00
parent 463b5aed0d
commit 78537728ef
1 changed files with 17 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
share/man/man4/epair.4
View file

@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd March 18, 2015
.Dd August 12, 2025
.Dt EPAIR 4
.Os
.Sh NAME
@ -79,12 +79,24 @@ and
Like any other Ethernet interface, an
.Nm
needs to have a network address.
Each
If the tunable
.Va net.link.epair.ether_gen_addr Ns
=0, each
.Nm
will be assigned a locally administered address by default,
will be assigned a random locally administered address,
that is only guaranteed to be unique within one network stack.
To change the default addresses one may use the SIOCSIFADDR ioctl(2) or
ifconfig(8) utility.
The tunable
.Va net.link.epair.ether_gen_addr Ns
=1 will generate a stable MAC address with
.Fx
OUI using
.Xr ether_gen_addr 9 .
This tunable defaults to 1 in
.Fx 15.0 and might be removed in
.Fx 16.0 .
To change the default addresses one may use the SIOCSIFADDR
.Xr ioctl 2 or
.Xr ifconfig 8 utility.
.Pp
The basic intent is to provide connectivity between two virtual
network stack instances.