From nobody Wed Aug 13 07:18:42 2025 X-Original-To: dev-commits-doc-all@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 4c208z0tYwz64BSJ for ; Wed, 13 Aug 2025 07:18:43 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4c208z0K81z3XFY; Wed, 13 Aug 2025 07:18:43 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1755069523; 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=pJMJsCL7Eb1YcFeDIoW77dwnPSqzs9MKesg3QoRfSQA=; b=FrMW98bRzIi5X/J1rKaJKqVMshimrg9FccW65feJqXiHSbFJ01LwkCF9NcQ+NkILxLUcEt 1UL9Nu6+5e1HAhGguxFcrUv+Otwbb9bEK0EoC9qX6+4vrxIlAc6iBRGZTvdLAafCrEnewq kNIR/c5pMtHpjPucnxbZHB/BIfGDHAMsZe/dmR1ifkGD0oHxKfRbjyFEFe46pxmUG/t5Uq Gu5+pf6RSJtRWx6mzz6GYx0G5G+wRS5Neq6aqNTKTV7Kku9EE0ZvXtpdHstYkuQlXIqt2U UuqSs1s5x7/VKkIkZPlFvyNPscO6X9OyWdAMrmFpXHEpL5jy1Ui/2i+28s1aTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1755069523; 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=pJMJsCL7Eb1YcFeDIoW77dwnPSqzs9MKesg3QoRfSQA=; b=PkJYU9PttrwhozIrLyHMnX+QnbWb/kfKYjdZgt4bzYSRDCmUaPbQKTz23miI7QGL96RrFa zHcYvT0lIXYyrdigm2UwCA9y1Etyou7WfJcIlt6bnTxEIMVm2f+lQFRn8MBR/J/xeo+Syk 1fAPw6x08bJyjHYQ9T1zA7vSZw+FZtqG+f2um1S+P9eO1nMyUQ6LDjbId4gMSS9qD5g6sx Y0pH9L/0jGcJjCKLzoqqEOaxCq0zY7gtzyxYSPRdVaf7aBtWTKmON1g5r3I4ztsYeba8fj tUrsH/HeNOcxn8t7k/yTX1BxgUExDadDSGQJcxQKu/mpc7LYeXlOIntreYyRPA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1755069523; a=rsa-sha256; cv=none; b=GjwOLOvrE+8BYGp4l+iwFsH+5v6feXZXA8dLk0GrmLBNIlWbAxhSD3xCjgec88FClEwcM9 qD8cSbGyH6gjZMzGTp1cTI512Oep7foSxciWqJ9XOG9CZqXTBPFAgZ3jEHz9t4T5bVHGFD qOiWujrT6QdDtLYSX8HRoNIdycmbNn4ZETM1XTjlweAzehwvWb3yeJ9vZnXX5eWBThg5EK KmoKauLXzYX339AYNseIY5Dn6b1Fvvm5qbz6E408EWf+Pg/0zBg1hZhCLwtJa0DJ7xc0RT C9Kebl+kO3Nq+D+MTzasUYcgrQSIl6KmCKGP6Gx0uo//m5YMP8bxCFhpXQT6xg== 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 4c208y6jLvz1Cfv; Wed, 13 Aug 2025 07:18:42 +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 57D7IgQ5068943; Wed, 13 Aug 2025 07:18:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57D7Ig6n068940; Wed, 13 Aug 2025 07:18:42 GMT (envelope-from git) Date: Wed, 13 Aug 2025 07:18:42 GMT Message-Id: <202508130718.57D7Ig6n068940@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: f6d5b57b00 - main - Handbook-Network: Clarifying Identi. of Wireless Device for WiFi Setup List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f6d5b57b005213d676aa958f48ea1315ee682aff Auto-Submitted: auto-generated The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=f6d5b57b005213d676aa958f48ea1315ee682aff commit f6d5b57b005213d676aa958f48ea1315ee682aff Author: Jim Brown AuthorDate: 2025-08-13 07:16:15 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2025-08-13 07:16:15 +0000 Handbook-Network: Clarifying Identi. of Wireless Device for WiFi Setup Reviewed by: ziaee@, Pau Amma Differential Revision: D47158 --- .../content/en/books/handbook/network/_index.adoc | 38 +++++++++++++++++----- 1 file changed, 30 insertions(+), 8 deletions(-) diff --git a/documentation/content/en/books/handbook/network/_index.adoc b/documentation/content/en/books/handbook/network/_index.adoc index 5d54ddd5e8..bb49981b31 100644 --- a/documentation/content/en/books/handbook/network/_index.adoc +++ b/documentation/content/en/books/handbook/network/_index.adoc @@ -577,11 +577,15 @@ The following sections discuss each step. Connecting FreeBSD to an existing wireless network is a very common situation. -This procedure shows the steps required: +This Quick Start procedure shows the steps required to connect to a network using basic authentication. +A more detailed procedure is given in the next section. -* The first step will be to obtain the SSID (Service Set Identifier) and PSK (Pre-Shared Key) for the wireless network from the network administrator. +The first step is to obtain the Service Set Identifier (SSID) and Pre-Shared Key (PSK) for the wireless network from the network administrator. -* The second step will be to add default configuration paramaters and an entry for this network to [.filename]#/etc/wpa_supplicant.conf#. If the file does not exist, create it: +The second step is to add an entry for this network to [.filename]#/etc/wpa_supplicant.conf#. + +If the file does not exist, create it. +Consult man:wpa_supplicant.conf[5] for details on formatting entries in this file. [.programlisting] .... @@ -596,10 +600,28 @@ network={ } .... -<.> Is the SSID of the wireless network. Replace it with the name of the wireless network. -<.> Is the PSK of the wireless network. Replace it with the password of the wireless network. +<.> Is the SSID of the wireless network. +Replace it with the name of the wireless network. +<.> Is the PSK of the wireless network. +Replace it with the password of the wireless network. + +The third step is to add the network interface entry to configure the network on startup. +Obtain the network device interface by using the sysctl `net.wlan.devices`. +In the listing below, the output of this sysctl shows the network device interface is "iwn0". + +[source,shell] +.... +# sysctl net.wlan.devices +.... + +The output should be similar to the following: + +[.programlisting] +.... +net.wlan.devices: iwm0 +.... -* The third step will be to add the network entry to configure the network on startup: +In the sysrc line that follows, replace "iwn0" with the output of the sysctl command if needed. [source,shell] .... @@ -607,7 +629,7 @@ network={ # sysrc ifconfig_wlan0="WPA DHCP" .... -* And the last step will be the restart `netif` service executing the following command: +* And the last step is to restart the `netif` service executing the following command: [source,shell] .... @@ -617,7 +639,7 @@ network={ [[basic-wireless-configuration]] === Basic Wireless Configuration -The first step will be to configure the wireless network card to an interface. +This section provides a more detailed example of configuring a wireless network card. To find out what wireless network cards are in the system check the section crossref:network[config-identify-network-adapter, Identify Network Adapters].