system/freebsd-src
system/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src synced 2024-10-16 05:13:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

lagg.4: update wireless example, document laggtype

Browse source 
The wireless example in lagg(4)'s manpage no longer works, so update.

laggtype is not documented in the manpage other than in the example,
so add a paragraph about it.

While here, move section on rc.conf somewhere it sits more logically.

Reviewed by:	pauamma
Differential Revision:	https://reviews.freebsd.org/D31315
This commit is contained in:
Ceri Davies 2023-01-16 18:53:30 +00:00
parent e8ce32bea3
commit 4a312c21fa
1 changed files with 32 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
share/man/man4/lagg.4
View file

@ -16,7 +16,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd October 21, 2020
.Dd January 16, 2023
.Dt LAGG 4
.Os
.Sh NAME
@ -43,6 +43,18 @@ interface allows aggregation of multiple network interfaces as one virtual
.Nm
interface for the purpose of providing fault-tolerance and high-speed links.
.Pp
Each
.Nm
interface is created at runtime using interface cloning.
This is
most easily done with the
.Xr ifconfig 8
.Cm create
command or using the
.Va cloned_interfaces
variable in
.Xr rc.conf 5 .
.Pp
A
.Nm
interface can be created using the
@ -79,7 +91,7 @@ the next active port is used.
The first interface added is the master port;
any interfaces added after that are used as failover devices.
.Pp
By default, received traffic is only accepted when they are received
By default, received traffic is only accepted when it is received
through the active port.
This constraint can be relaxed by setting the
.Va net.link.lagg.failover_rx_all
@ -123,18 +135,6 @@ disabling the
interface itself.
.El
.Pp
Each
.Nm
interface is created at runtime using interface cloning.
This is
most easily done with the
.Xr ifconfig 8
.Cm create
command or using the
.Va cloned_interfaces
variable in
.Xr rc.conf 5 .
.Pp
The MTU of the first interface to be added is used as the lagg MTU.
All additional interfaces are required to have exactly the same value.
.Pp
@ -152,6 +152,17 @@ flag.
The default for new interfaces is set via the
.Va net.link.lagg.default_use_flowid
.Xr sysctl 8 .
.Pp
When creating a
.Nm
interface, the
.Ic laggtype
can be specified as either
.Cm ethernet
or
.Cm infiniband .
If neither is specified then the default is
.Cm ethernet .
.Sh EXAMPLES
Create a link aggregation using LACP with two
.Xr bge 4
@ -182,16 +193,18 @@ between wired and wireless networks using two network devices.
Whenever the wired master interface is unplugged, the wireless failover
device will be used:
.Bd -literal -offset indent
# ifconfig em0 up
# ifconfig ath0 ether 00:11:22:33:44:55
# ifconfig create wlan0 wlandev ath0 ssid my_net up
# ifconfig em0 ether 00:11:22:33:44:55 up
# ifconfig wlan0 create wlandev ath0 ssid my_net up
# ifconfig lagg0 create
# ifconfig lagg0 laggproto failover laggport em0 laggport wlan0 \e
192.168.1.1 netmask 255.255.255.0
.Ed
.Pp
(Note the mac address of the wireless device is forced to match the wired
device as a workaround.)
(Note the MAC address of the wired device is forced to match that of the
wireless device,
.Sq 00:11:22:33:44:55
in this example, as some common wireless devices will not allow MAC
addresses to be changed.)
.Pp
The following example shows how to create an infiniband failover interface.
.Bd -literal -offset indent