1*75eda009SAlexander Ziaee.\"- 2*75eda009SAlexander Ziaee.\" SPDX-License-Identifier: BSD-2-Clause 3*75eda009SAlexander Ziaee.\" 4*75eda009SAlexander Ziaee.\" Copyright (c) 2024 Alexander Ziaee <concussious@runbox.com> 5*75eda009SAlexander Ziaee.\" 6*75eda009SAlexander Ziaee.Dd April 17, 2024 7*75eda009SAlexander Ziaee.Dt "NETWORKING" 7 8*75eda009SAlexander Ziaee.Os 9*75eda009SAlexander Ziaee.Sh NAME 10*75eda009SAlexander Ziaee.Nm networking , 11*75eda009SAlexander Ziaee.Nm wifi 12*75eda009SAlexander Ziaee.Nd quickstart guide to connecting to a network 13*75eda009SAlexander Ziaee.Sh DESCRIPTION 14*75eda009SAlexander ZiaeeIn the following examples, it is assumed that we are connecting to Ethernet 15*75eda009SAlexander Ziaeewith the first interface found by the 16*75eda009SAlexander Ziaee.Xr em 4 17*75eda009SAlexander Ziaeedriver, and Wi-Fi with the first interface found by the 18*75eda009SAlexander Ziaee.Xr iwn 4 19*75eda009SAlexander Ziaeedriver, though your hardware will vary. 20*75eda009SAlexander Ziaee.Sh EXAMPLES 21*75eda009SAlexander Ziaee.Bl -tag -width 0n 22*75eda009SAlexander Ziaee.It Sy Connecting to an Ethernet network with DHCP: 23*75eda009SAlexander Ziaee.Bd -literal -offset 2n 24*75eda009SAlexander Ziaee.Ic # dhclient em0 25*75eda009SAlexander Ziaee.Ed 26*75eda009SAlexander Ziaee.It Sy Connecting to a cellular network with USB tethering: 27*75eda009SAlexander Ziaee.Pp 28*75eda009SAlexander ZiaeeLoad the USB tethering driver, 29*75eda009SAlexander Ziaee.Xr urndis 4 : 30*75eda009SAlexander Ziaee.Bd -literal -offset 2n 31*75eda009SAlexander Ziaee.Ic # kldload urndis 32*75eda009SAlexander Ziaee.Ed 33*75eda009SAlexander Ziaee.Pp 34*75eda009SAlexander ZiaeeAsk for a DHCP lease on the USB tethering interface: 35*75eda009SAlexander Ziaee.Bd -literal -offset 2n 36*75eda009SAlexander Ziaee.Ic # dhclient ue0 37*75eda009SAlexander Ziaee.Ed 38*75eda009SAlexander Ziaee.It Sy Connecting to a Wi-Fi network: 39*75eda009SAlexander Ziaee.Pp 40*75eda009SAlexander ZiaeeIdentify your Wi-Fi hardware: 41*75eda009SAlexander Ziaee.Bd -literal -offset 2n 42*75eda009SAlexander Ziaee.Ic % sysctl net.wlan.devices 43*75eda009SAlexander Ziaee.Ed 44*75eda009SAlexander Ziaee.Pp 45*75eda009SAlexander ZiaeeConfigure your Wi-Fi hardware as wlan0 interface: 46*75eda009SAlexander Ziaee.Ed 47*75eda009SAlexander Ziaee.Bd -literal -offset 2n 48*75eda009SAlexander Ziaee.Ic # sysrc wlans_iwn0="wlan0" 49*75eda009SAlexander Ziaee.Ed 50*75eda009SAlexander Ziaee.Pp 51*75eda009SAlexander ZiaeeSet that interface to negotiate a DHCP lease with 52*75eda009SAlexander Ziaee.Xr wpa_supplicant 8 : 53*75eda009SAlexander Ziaee.Bd -literal -offset 2n 54*75eda009SAlexander Ziaee.Ic # sysrc ifconfig_wlan0="WPA SYNCDHCP" 55*75eda009SAlexander Ziaee.Ed 56*75eda009SAlexander Ziaee.Pp 57*75eda009SAlexander ZiaeeEnter the details of the Wi-Fi network: 58*75eda009SAlexander Ziaee.Bd -literal -offset 2n 59*75eda009SAlexander Ziaee.Ic # wpa_passphrase \(dqmyssid\(dq \(dqmypassphrase\(dq >> wpa_supplicant.conf 60*75eda009SAlexander Ziaee.Ed 61*75eda009SAlexander Ziaee.Pp 62*75eda009SAlexander ZiaeeRestart the network interface daemon: 63*75eda009SAlexander Ziaee.Bd -literal -offset 2n 64*75eda009SAlexander Ziaee.Ic # service netif restart 65*75eda009SAlexander Ziaee.Ed 66*75eda009SAlexander Ziaee.Pp 67*75eda009SAlexander Ziaee.It Sy Scanning for Wi-Fi networks: 68*75eda009SAlexander Ziaee.Bd -literal -offset 2n 69*75eda009SAlexander Ziaee.Ic % ifconfig wlan0 scan 70*75eda009SAlexander Ziaee.Ed 71*75eda009SAlexander Ziaee.It Sy Airplane mode: 72*75eda009SAlexander Ziaee.Bd -literal -offset 2n 73*75eda009SAlexander Ziaee.Ic # service netif stop 74*75eda009SAlexander Ziaee.Ed 75*75eda009SAlexander Ziaee.El 76*75eda009SAlexander Ziaee.Sh SEE ALSO 77*75eda009SAlexander Ziaee.Xr bsdconfig 8 , 78*75eda009SAlexander Ziaee.Xr dhclient 8 , 79*75eda009SAlexander Ziaee.Xr ifconfig 8 , 80*75eda009SAlexander Ziaee.Xr wpa_passphrase 8 81*75eda009SAlexander Ziaee.Pp 82*75eda009SAlexander ZiaeeThe Advanced Networking chapter of the 83*75eda009SAlexander Ziaee.Fx 84*75eda009SAlexander ZiaeeHandbook. 85*75eda009SAlexander Ziaee.Sh CAVEATS 86*75eda009SAlexander ZiaeeShell Special Characters in the 87*75eda009SAlexander Ziaee.Ar SSID 88*75eda009SAlexander Ziaeeor 89*75eda009SAlexander Ziaee.Ar passphrase 90*75eda009SAlexander Ziaeewill need to be escaped for 91*75eda009SAlexander Ziaee.Xr wpa_passphrase 8 , 92*75eda009SAlexander Ziaeecommonly using 93*75eda009SAlexander Ziaee.Ql \e , 94*75eda009SAlexander Ziaeesee the manual page for your shell for more details. 95*75eda009SAlexander Ziaee.Pp 96*75eda009SAlexander ZiaeeCurrently 97*75eda009SAlexander Ziaee.Ql Ic service netif restart 98*75eda009SAlexander Ziaeedoes not restart routing. 99*75eda009SAlexander ZiaeeA common workaround is to issue 100*75eda009SAlexander Ziaee.Ql Ic service netif restart && service routing restart 101*75eda009SAlexander Ziaeeinstead. 102