git: 46c06c29bc - main - handbook/advanced-networking: reorder the lagg(4) example for eth/wlan

[Ceri Davies]

The branch main has been updated by ceri:

URL: https://cgit.FreeBSD.org/doc/commit/?id=46c06c29bcc6c86cfefeb2396123d9b4993edd22

commit 46c06c29bcc6c86cfefeb2396123d9b4993edd22
Author:     Ceri Davies <ceri at FreeBSD.org>
AuthorDate: 2021-07-27 00:14:15 +0000
Commit:     Ceri Davies <ceri at FreeBSD.org>
CommitDate: 2021-07-27 00:14:15 +0000

    handbook/advanced-networking: reorder the lagg(4) example for eth/wlan
    
    Example 3, which describes failover mode between ethernet and wireless
    interfaces, has steps which require wlan0 to be created in advance
    of the example telling you to create it.  Reorder to avoid that.
---
 .../books/handbook/advanced-networking/_index.adoc   | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
index 9b02c75cfc..cce30cfc4a 100644
--- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
@@ -2444,7 +2444,15 @@ This is needed because otherwise the driver is not loaded yet at the time the ma
 
 In this example, the Ethernet interface, _re0_, is the master and the wireless interface, _wlan0_, is the failover.
 The _wlan0_ interface was created from the _ath0_ physical wireless interface, and the Ethernet interface will be configured with the MAC address of the wireless interface.
-First, determine the MAC address of the wireless interface:
+First, bring the wireless interface up (replacing _FR_ with your own 2-letter country code), but do not set an IP address.
+Replace _wlan0_ to match the system's wireless interface name:
+
+[source,shell]
+....
+# ifconfig wlan0 create wlandev ath0 country FR ssid my_router up
+....
+
+Now you can determine the MAC address of the wireless interface:
 
 [source,shell]
 ....
@@ -2462,22 +2470,14 @@ wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
 	nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL>
 ....
 
-Replace _wlan0_ to match the system's wireless interface name.
 The `ether` line will contain the MAC address of the specified interface.
-Now, change the MAC address of the Ethernet interface:
+Now, change the MAC address of the Ethernet interface to match:
 
 [source,shell]
 ....
 # ifconfig re0 ether b8:ee:65:5b:32:59
 ....
 
-Bring the wireless interface up (replacing _FR_ with your own 2-letter country code), but do not set an IP address:
-
-[source,shell]
-....
-# ifconfig wlan0 create wlandev ath0 country FR ssid my_router up
-....
-
 Make sure the _re0_ interface is up, then create the man:lagg[4] interface with _re0_ as master with failover to _wlan0_:
 
 [source,shell]