git: 70b66cf80434 - main - networking.7: Clarifications

The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=70b66cf804345902bb5baadd27448c4bf5251552

commit 70b66cf804345902bb5baadd27448c4bf5251552
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-02-19 16:46:04 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-04-28 16:16:41 +0000

    networking.7: Clarifications
    
    + standardize my license formatting with style guides
    + remove loading now-automatically loaded last-gen tethering driver
    + show contemporary internal hardware drivers for examples
    + tweak example language to hopefully improve clarity
    
    MFC after:              3 days
    Reviewed by:            adrian, mhorne, Quentin Thebault
    Approved by:            mhorne (mentor)
    Differential Revision:  https://reviews.freebsd.org/D49762
---
 share/man/man7/networking.7 | 48 ++++++++++++++++++++++-----------------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/share/man/man7/networking.7 b/share/man/man7/networking.7
index acd61f2864a7..2174577eb6a3 100644
--- a/share/man/man7/networking.7
+++ b/share/man/man7/networking.7
@@ -1,53 +1,51 @@
-.\"-
-.\" SPDX-License-Identifier: BSD-2-Clause
 .\"
 .\" Copyright (c) 2024 Alexander Ziaee. Ohio.
 .\"
-.Dd April 17, 2024
-.Dt "NETWORKING" 7
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.Dd March 21, 2025
+.Dt NETWORKING 7
 .Os
 .Sh NAME
 .Nm networking ,
 .Nm wifi
 .Nd quickstart guide to connecting to a network
 .Sh DESCRIPTION
-In the following examples, it is assumed that we are connecting to Ethernet
-with the first interface found by the
-.Xr em 4
+In the following examples, it is assumed that
+we are connecting to Ethernet with the first interface found by the
+.Xr ix 4
 driver, and Wi-Fi with the first interface found by the
-.Xr iwn 4
+.Xr iwlwifi 4
 driver, though your hardware will vary.
 .Sh EXAMPLES
 .Bl -tag -width 0n
-.It Sy Connecting to an Ethernet network with DHCP:
-.Bd -literal -offset 2n
-.Ic # dhclient em0
-.Ed
-.It Sy Connecting to a cellular network with USB tethering:
+.It Sy Example 1: Connecting to an Ethernet network with DHCP
 .Pp
-Load the USB tethering driver,
-.Xr urndis 4 :
+Ask for a DHCP lease on the first Intel 10Gb Ethernet interface:
 .Bd -literal -offset 2n
-.Ic # kldload urndis
+.Ic # dhclient ix0
 .Ed
+.It Sy Example 2: Connecting to a cellular network with USB tethering
 .Pp
-Ask for a DHCP lease on the USB tethering interface:
+Ask for a DHCP lease on the first USB tethering interface:
 .Bd -literal -offset 2n
 .Ic # dhclient ue0
 .Ed
-.It Sy Connecting to a Wi-Fi network:
+.It Sy Example 3: Connecting to a Wi-Fi network
 .Pp
 Identify your Wi-Fi hardware:
 .Bd -literal -offset 2n
 .Ic % sysctl net.wlan.devices
 .Ed
 .Pp
-Configure your Wi-Fi hardware as wlan0 interface:
+Create the
+.Sy wlan0
+interface with the first Intel Wi-Fi adapter:
 .Bd -literal -offset 2n
-.Ic # sysrc wlans_iwn0="wlan0"
+.Ic # sysrc wlans_iwlwifi0="wlan0"
 .Ed
 .Pp
-Set that interface to negotiate a DHCP lease with
+Set that interface to ask for a DHCP lease with
 .Xr wpa_supplicant 8 :
 .Bd -literal -offset 2n
 .Ic # sysrc ifconfig_wlan0="WPA SYNCDHCP"
@@ -55,6 +53,7 @@ Set that interface to negotiate a DHCP lease with
 .Pp
 Enter the details of the Wi-Fi network:
 .Bd -literal -offset 2n
+.Ic # cd /etc/
 .Ic # wpa_passphrase \(dqmyssid\(dq \(dqmypassphrase\(dq >> wpa_supplicant.conf
 .Ed
 .Pp
@@ -62,12 +61,11 @@ Restart the network interface daemon:
 .Bd -literal -offset 2n
 .Ic # service netif restart
 .Ed
-.Pp
-.It Sy Scanning for Wi-Fi networks:
+.It Sy Example 4: Scanning for Wi-Fi networks
 .Bd -literal -offset 2n
 .Ic % ifconfig wlan0 scan
 .Ed
-.It Sy Airplane mode:
+.It Sy Example 5: Airplane mode
 .Bd -literal -offset 2n
 .Ic # service netif stop
 .Ed
@@ -91,3 +89,5 @@ will need to be escaped for
 commonly using
 .Ql \e ,
 see the manual page for your shell for more details.
+.Pp
+Stopping the network interface service also stops internal networking.