From nobody Mon Apr 28 16:18:08 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ZmTBm5Q7tz5vXkc; Mon, 28 Apr 2025 16:18:08 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ZmTBm2dv6z3Q99; Mon, 28 Apr 2025 16:18:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745857088; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=JZeOPnlQ4xNZ7Y4LxU8GZcONO6DjqNuZuXaJ1wAmnXw=; b=foBKqb6fK6QRp0WScHwNwppBSEQRDObVhDryAN4dyDX7BfznLEPvEXEGkwznn5AWOItEQx 7bRwET0Cxt3gm8vStN/+BRZqmiW8kQKlaLoWPb9dxPmvJccblta74wKRsB1p0ugQIwpZAM 2J3usvYkS5mC9Tf/ygzlSLyI4/gT9/64nLjTG1o9OGMrBbffdDzm1FiTdtJl8whGlL3QGd eziND9E7GOBtrWAXh/5j+R97q7PuEYvsAUa1N5bfWLWrPk5hBfeokFM3oVFHibyG1REKls JH6PJ7grZyO9ylXmfjqbyXVRYJoDc4v84Q3U7iN8Lfmj5/ERFigKbiFPm+KJGg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1745857088; a=rsa-sha256; cv=none; b=SMwo5Fi2DyrADIRqF7COftANW/6rlBT0AyFE7JD3k9jF9tH5J/cXsMss2RhBjqHk4mE5mA FmAdSdA9AKYnFSTit+8ba7MAgl8XNSHPwMFAtR8mcw+y8lQLN2xxyi68hcKhxSefpF9dZF QxbZJwyS89fbOifv3ayUBUSlFxejMi0IVa3mJ5/iAdQKFGNz4qpVQwschduiCz4+zpSA9p 5KdMR0YR1Q9zkIrseg/xYxL9GWkz0csaoIt6OAGHz/5PbopR4A9DyDMS+OlAadSBFVoFSE cFVTDwk9Xql/Icx56/Q7o86r1frw2xI348qgQhW43ojAISPOZHnfJgv3RbyB7Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745857088; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=JZeOPnlQ4xNZ7Y4LxU8GZcONO6DjqNuZuXaJ1wAmnXw=; b=hXQNzI2Vw8KcqrJK7hnsVi1Yi79CJH8Vnp0SlKcM8pt3iXbw3LllAWrUCSBdBOxUwOdHHG EfymmLe1M33K9bM0SyzBbAHU79d8Kv0PfzwjxxHxMhSjNC3I02115DNG3IP9kS/+0yiUFD dh1rBwJYqHOSEEKHoLJfaE+vJdoW+vx2NQBkowjnhgLBIs7MWf1HaDjPik1oNsA0JFuvXJ YrQJ7dfqfCC/Udi4vc4cVS3mm0IGGYVTnYAgX1+HWl6gfZM6l+Vigr1k5Qw2wSBKMvq1Xz dmJcouvvaAg8dKURV+4c7ooSsC8LezobEe2/s0ZaeGRO1kuxAjuoNUCq/vIV2g== 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 4ZmTBm25jRzjMK; Mon, 28 Apr 2025 16:18:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 53SGI8bS058794; Mon, 28 Apr 2025 16:18:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 53SGI8D3058791; Mon, 28 Apr 2025 16:18:08 GMT (envelope-from git) Date: Mon, 28 Apr 2025 16:18:08 GMT Message-Id: <202504281618.53SGI8D3058791@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 70b66cf80434 - main - networking.7: Clarifications List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 70b66cf804345902bb5baadd27448c4bf5251552 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=70b66cf804345902bb5baadd27448c4bf5251552 commit 70b66cf804345902bb5baadd27448c4bf5251552 Author: Alexander Ziaee AuthorDate: 2025-02-19 16:46:04 +0000 Commit: Alexander Ziaee 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.