Date: Sun, 29 Dec 2019 15:13:40 +0000 (UTC) From: "Jason W. Bacon" <jwb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53718 - head/en_US.ISO8859-1/books/handbook/advanced-networking Message-ID: <201912291513.xBTFDexm091740@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201912291513.xBTFDexm091740>