From owner-dev-commits-doc-all@freebsd.org Tue Jul 27 00:16:38 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id CE0106777B8 for ; Tue, 27 Jul 2021 00:16:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4GYcm65G3Fz4SR5; Tue, 27 Jul 2021 00:16:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8BB8920650; Tue, 27 Jul 2021 00:16:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 16R0Gc6X048258; Tue, 27 Jul 2021 00:16:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 16R0GcJK048257; Tue, 27 Jul 2021 00:16:38 GMT (envelope-from git) Date: Tue, 27 Jul 2021 00:16:38 GMT Message-Id: <202107270016.16R0GcJK048257@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ceri Davies Subject: git: 46c06c29bc - main - handbook/advanced-networking: reorder the lagg(4) example for eth/wlan MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ceri X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 46c06c29bcc6c86cfefeb2396123d9b4993edd22 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 Jul 2021 00:16:38 -0000 The branch main has been updated by ceri: URL: https://cgit.FreeBSD.org/doc/commit/?id=46c06c29bcc6c86cfefeb2396123d9b4993edd22 commit 46c06c29bcc6c86cfefeb2396123d9b4993edd22 Author: Ceri Davies AuthorDate: 2021-07-27 00:14:15 +0000 Commit: Ceri Davies 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 metric 0 mtu 1500 nd6 options=29 .... -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]