mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-08 13:28:05 +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$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd October 21, 2020
|
.Dd January 16, 2023
|
||||||
.Dt LAGG 4
|
.Dt LAGG 4
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -43,6 +43,18 @@ interface allows aggregation of multiple network interfaces as one virtual
|
|||||||
.Nm
|
.Nm
|
||||||
interface for the purpose of providing fault-tolerance and high-speed links.
|
interface for the purpose of providing fault-tolerance and high-speed links.
|
||||||
.Pp
|
.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
|
A
|
||||||
.Nm
|
.Nm
|
||||||
interface can be created using the
|
interface can be created using the
|
||||||
@ -79,7 +91,7 @@ the next active port is used.
|
|||||||
The first interface added is the master port;
|
The first interface added is the master port;
|
||||||
any interfaces added after that are used as failover devices.
|
any interfaces added after that are used as failover devices.
|
||||||
.Pp
|
.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.
|
through the active port.
|
||||||
This constraint can be relaxed by setting the
|
This constraint can be relaxed by setting the
|
||||||
.Va net.link.lagg.failover_rx_all
|
.Va net.link.lagg.failover_rx_all
|
||||||
@ -123,18 +135,6 @@ disabling the
|
|||||||
interface itself.
|
interface itself.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.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.
|
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.
|
All additional interfaces are required to have exactly the same value.
|
||||||
.Pp
|
.Pp
|
||||||
@ -152,6 +152,17 @@ flag.
|
|||||||
The default for new interfaces is set via the
|
The default for new interfaces is set via the
|
||||||
.Va net.link.lagg.default_use_flowid
|
.Va net.link.lagg.default_use_flowid
|
||||||
.Xr sysctl 8 .
|
.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
|
.Sh EXAMPLES
|
||||||
Create a link aggregation using LACP with two
|
Create a link aggregation using LACP with two
|
||||||
.Xr bge 4
|
.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
|
Whenever the wired master interface is unplugged, the wireless failover
|
||||||
device will be used:
|
device will be used:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
# ifconfig em0 up
|
# ifconfig em0 ether 00:11:22:33:44:55 up
|
||||||
# ifconfig ath0 ether 00:11:22:33:44:55
|
# ifconfig wlan0 create wlandev ath0 ssid my_net up
|
||||||
# ifconfig create wlan0 wlandev ath0 ssid my_net up
|
|
||||||
# ifconfig lagg0 create
|
# ifconfig lagg0 create
|
||||||
# ifconfig lagg0 laggproto failover laggport em0 laggport wlan0 \e
|
# ifconfig lagg0 laggproto failover laggport em0 laggport wlan0 \e
|
||||||
192.168.1.1 netmask 255.255.255.0
|
192.168.1.1 netmask 255.255.255.0
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
(Note the mac address of the wireless device is forced to match the wired
|
(Note the MAC address of the wired device is forced to match that of the
|
||||||
device as a workaround.)
|
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
|
.Pp
|
||||||
The following example shows how to create an infiniband failover interface.
|
The following example shows how to create an infiniband failover interface.
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
|
Loading…
Reference in New Issue
Block a user