upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-02-18 18:20:26 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

networking.7: Clarifications

Browse source 
+ 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

(cherry picked from commit 70b66cf804345902bb5baadd27448c4bf5251552)
This commit is contained in:
Alexander Ziaee 2025-02-19 11:46:04 -05:00
parent 41813f983d
commit 72f62f3367
No known key found for this signature in database
GPG key ID: 0A8F850BCDEF4511
1 changed files with 24 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
share/man/man7/networking.7
View file

@ -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.