Update WiFi failover example in advanced-networking.

Some wireless interfaces do not support changing their MAC address, so
explicitly instruct the reader to change the Ethernet MAC instead.

PR:             docs/211436
Submitted by:   pauamma@gundo.com
Reviewed by:    crees, bcr, jwb
Approved by:    crees
Differential Revision:  https://reviews.freebsd.org/D22708

1 files changed, 54 insertions, 38 deletions

diff --git a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
index 43fcc46858..576a2206e3 100644
--- a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
@@ -3719,51 +3719,66 @@ ifconfig_<literal>lagg<replaceable>0</replaceable></literal>="laggproto failover
 	  security reasons, while maintaining the ability to transfer
 	  data over the wireless connection.</para>
 
-	<para>This is achieved by overriding the physical wireless
-	  interface's <acronym>MAC</acronym> address with that of the
-	  Ethernet interface.</para>
+	<para>This is achieved by overriding the Ethernet interface's
+	  <acronym>MAC</acronym> address with that of the wireless
+	  interface.</para>
+
+	<note>
+	  <para>In theory, either the Ethernet or wireless MAC address can
+	    be changed to match the other.  However, some popular wireless
+	    interfaces lack support for overriding the MAC address.  We
+	    therefore recommend overriding the Ethernet MAC address for this
+	    purpose.</para>
+	</note>
 
 	<para>In this example, the Ethernet interface,
-	  <replaceable>bge0</replaceable>, is the master and the
+	  <replaceable>re0</replaceable>, is the master and the
 	  wireless interface, <replaceable>wlan0</replaceable>, is
-	  the failover.  The <replaceable>wlan0</replaceable> device
-	  was created from <replaceable>iwn0</replaceable> wireless
-	  interface, which will be configured with the
-	  <acronym>MAC</acronym> address of the Ethernet interface.
+	  the failover.  The <replaceable>wlan0</replaceable>
+	  interface was created from the
+	  <replaceable>ath0</replaceable> physical wireless interface,
+	  and the Ethernet interface will be configured with the
+	  <acronym>MAC</acronym> address of the wireless interface.
 	  First, determine the <acronym>MAC</acronym> address of the
-	  Ethernet interface:</para>
+	  wireless interface:</para>
 
-	<screen>&prompt.root; <userinput>ifconfig <replaceable>bge0</replaceable></userinput>
-bge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
-	options=19b&lt;RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,TSO4&gt;
-	ether 00:21:70:da:ae:37
-	inet6 fe80::221:70ff:feda:ae37%bge0 prefixlen 64 scopeid 0x2
-	nd6 options=29&lt;PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL&gt;
-	media: Ethernet autoselect (1000baseT &lt;full-duplex&gt;)
-	status: active</screen>
-
-	<para>Replace <replaceable>bge0</replaceable> to match the
-	  system's Ethernet interface name.  The
+	<screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput>
+wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
+	ether b8:ee:65:5b:32:59
+	groups: wlan
+	ssid Bbox-A3BD2403 channel 6 (2437 MHz 11g ht/20) bssid 00:37:b7:56:4b:60
+	regdomain ETSI country FR indoor ecm authmode WPA2/802.11i privacy ON
+	deftxkey UNDEF AES-CCM 2:128-bit txpower 30 bmiss 7 scanvalid 60
+	protmode CTS ampdulimit 64k ampdudensity 8 shortgi -stbctx stbcrx
+	-ldpc wme burst roaming MANUAL
+	media: IEEE 802.11 Wireless Ethernet MCS mode 11ng
+	status: associated
+	nd6 options=29&lt;PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL&gt;</screen>
+
+	<para>Replace <replaceable>wlan0</replaceable> to match the
+	  system's wireless interface name.  The
 	  <literal>ether</literal> line will contain the
 	  <acronym>MAC</acronym> address of the specified interface.
 	  Now, change the <acronym>MAC</acronym> address of the
-	  underlying wireless interface:</para>
+	  Ethernet interface:</para>
 
-	<screen>&prompt.root; <userinput>ifconfig <replaceable>iwn0</replaceable> ether <replaceable>00:21:70:da:ae:37</replaceable></userinput></screen>
+	<screen>&prompt.root; <userinput>ifconfig <replaceable>re0</replaceable> ether <replaceable>b8:ee:65:5b:32:59</replaceable></userinput></screen>
 
-	<para>Bring the wireless interface up, but do not set an
-	  <acronym>IP</acronym> address:</para>
+	<para>Bring the wireless interface up (replacing
+	  <replaceable>FR</replaceable> with your own 2-letter country
+	  code), but do not set an <acronym>IP</acronym>
+	  address:</para>
 
-	<screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>iwn0</replaceable> ssid <replaceable>my_router</replaceable> up</userinput></screen>
+	<screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable> country <replaceable>FR</replaceable> ssid <replaceable>my_router</replaceable> up</userinput></screen>
 
-	<para>Make sure the <replaceable>bge0</replaceable> interface
+	<para>Make sure the <replaceable>re0</replaceable> interface
 	  is up, then create the &man.lagg.4; interface with
-	  <replaceable>bge0</replaceable> as master with failover to
+	  <replaceable>re0</replaceable> as master with failover to
 	  <replaceable>wlan0</replaceable>:</para>
 
-	<screen>&prompt.root; <userinput>ifconfig <replaceable>bge0</replaceable> up</userinput>
+	<screen>&prompt.root; <userinput>ifconfig <replaceable>re0</replaceable> up</userinput>
 &prompt.root; <userinput>ifconfig <literal>lagg<replaceable>0</replaceable></literal> create</userinput>
-&prompt.root; <userinput>ifconfig <literal>lagg<replaceable>0</replaceable></literal> up laggproto failover laggport <replaceable>bge0</replaceable> laggport <replaceable>wlan0</replaceable></userinput></screen>
+&prompt.root; <userinput>ifconfig <literal>lagg<replaceable>0</replaceable></literal> up laggproto failover laggport <replaceable>re0</replaceable> laggport <replaceable>wlan0</replaceable></userinput></screen>
 
 	<para>The virtual interface should look something like
 	  this:</para>
@@ -3771,12 +3786,13 @@ bge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	<screen>&prompt.root; <userinput>ifconfig <literal>lagg<replaceable>0</replaceable></literal></userinput>
 lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         options=8&lt;VLAN_MTU&gt;
-        ether 00:21:70:da:ae:37
-        media: Ethernet autoselect
-        status: active
-        laggproto failover
+        ether b8:ee:65:5b:32:59
+        laggproto failover lagghash l2,l3,l4
+        laggport: re0 flags=5&lt;MASTER,ACTIVE&gt;
         laggport: wlan0 flags=0&lt;&gt;
-        laggport: bge0 flags=5&lt;MASTER,ACTIVE&gt;</screen>
+        groups: lagg
+        media: Ethernet autoselect
+        status: active</screen>
 
 	<para>Then, start the <acronym>DHCP</acronym> client to
 	  obtain an <acronym>IP</acronym> address:</para>
@@ -3787,12 +3803,12 @@ lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 150
 	  following entries to
 	  <filename>/etc/rc.conf</filename>:</para>
 
-	<programlisting>ifconfig_bge0="up"
-wlans_<replaceable>iwn0</replaceable>="wlan0"
+	<programlisting>ifconfig_<replaceable>re0</replaceable>="ether <replaceable>b8:ee:65:5b:32:59</replaceable>"
+wlans_<replaceable>ath0</replaceable>="wlan0"
 ifconfig_wlan0="WPA"
-create_args_wlan0="<replaceable>wlanaddr 00:21:70:da:ae:37</replaceable>"
+create_args_wlan0="country <replaceable>FR</replaceable>"
 cloned_interfaces="<literal>lagg<replaceable>0</replaceable></literal>"
-ifconfig_<literal>lagg<replaceable>0</replaceable></literal>="up laggproto failover laggport bge0 laggport wlan0 DHCP"</programlisting>
+ifconfig_<literal>lagg<replaceable>0</replaceable></literal>="up laggproto failover laggport <replaceable>re0</replaceable> laggport wlan0 DHCP"</programlisting>
       </example>
     </sect2>
   </sect1>