aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCeri Davies <ceri@FreeBSD.org>2023-01-16 18:53:30 +0000
committerCeri Davies <ceri@FreeBSD.org>2023-01-16 18:56:13 +0000
commit4a312c21faebdbe68c7f99ad17130188e1e23657 (patch)
tree409fd16cad460de3f284dccbf838103659579823
parente8ce32bea30d599b481735a1d1b0a87ac06c5a66 (diff)
downloadsrc-4a312c21faebdbe68c7f99ad17130188e1e23657.tar.gz
src-4a312c21faebdbe68c7f99ad17130188e1e23657.zip
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
-rw-r--r--share/man/man4/lagg.451
1 files changed, 32 insertions, 19 deletions
diff --git a/share/man/man4/lagg.4 b/share/man/man4/lagg.4
index f7d8e1c5e1f5..b46566120050 100644
--- a/share/man/man4/lagg.4
+++ b/share/man/man4/lagg.4
@@ -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