svn commit: r53718 - head/en_US.ISO8859-1/books/handbook/advanced-networking
Jason W. Bacon
jwb at FreeBSD.org
Sun Dec 29 15:13:41 UTC 2019
Author: jwb (ports committer)
Date: Sun Dec 29 15:13:40 2019
New Revision: 53718
URL: https://svnweb.freebsd.org/changeset/doc/53718
Log:
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 at gundo.com
Reviewed by: crees, bcr, jwb
Approved by: crees
Differential Revision: https://reviews.freebsd.org/D22708
Modified:
head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Sun Dec 29 14:13:50 2019 (r53717)
+++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Sun Dec 29 15:13:40 2019 (r53718)
@@ -3719,51 +3719,66 @@ ifconfig_<literal>lagg<replaceable>0</replaceable></li
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<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
- options=19b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,TSO4>
- ether 00:21:70:da:ae:37
- inet6 fe80::221:70ff:feda:ae37%bge0 prefixlen 64 scopeid 0x2
- nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL>
- media: Ethernet autoselect (1000baseT <full-duplex>)
- status: active</screen>
+ <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput>
+wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> 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<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL></screen>
- <para>Replace <replaceable>bge0</replaceable> to match the
- system's Ethernet interface name. The
+ <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<UP,BROADCAST,RUNNING,SIMPLEX,MULTI
<screen>&prompt.root; <userinput>ifconfig <literal>lagg<replaceable>0</replaceable></literal></userinput>
lagg0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500
options=8<VLAN_MTU>
- 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<MASTER,ACTIVE>
laggport: wlan0 flags=0<>
- laggport: bge0 flags=5<MASTER,ACTIVE></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<UP,BROADCAST,RUNNING,SIMPLEX,MULT
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>
More information about the svn-doc-head
mailing list