mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-07 13:14:51 +00:00
lagg.4: update wireless example, document laggtype
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:
parent
e8ce32bea3
commit
4a312c21fa
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user