xref: /freebsd/share/man/man7/networking.7 (revision 4f2ef756a404df70272b79c16fa7b1689cb0118b)
175eda009SAlexander Ziaee.\"-
275eda009SAlexander Ziaee.\" SPDX-License-Identifier: BSD-2-Clause
375eda009SAlexander Ziaee.\"
4*c55f56deSAlexander Ziaee.\" Copyright (c) 2024 Alexander Ziaee. Ohio.
575eda009SAlexander Ziaee.\"
675eda009SAlexander Ziaee.Dd April 17, 2024
775eda009SAlexander Ziaee.Dt "NETWORKING" 7
875eda009SAlexander Ziaee.Os
975eda009SAlexander Ziaee.Sh NAME
1075eda009SAlexander Ziaee.Nm networking ,
1175eda009SAlexander Ziaee.Nm wifi
1275eda009SAlexander Ziaee.Nd quickstart guide to connecting to a network
1375eda009SAlexander Ziaee.Sh DESCRIPTION
1475eda009SAlexander ZiaeeIn the following examples, it is assumed that we are connecting to Ethernet
1575eda009SAlexander Ziaeewith the first interface found by the
1675eda009SAlexander Ziaee.Xr em 4
1775eda009SAlexander Ziaeedriver, and Wi-Fi with the first interface found by the
1875eda009SAlexander Ziaee.Xr iwn 4
1975eda009SAlexander Ziaeedriver, though your hardware will vary.
2075eda009SAlexander Ziaee.Sh EXAMPLES
2175eda009SAlexander Ziaee.Bl -tag -width 0n
2275eda009SAlexander Ziaee.It Sy Connecting to an Ethernet network with DHCP:
2375eda009SAlexander Ziaee.Bd -literal -offset 2n
2475eda009SAlexander Ziaee.Ic # dhclient em0
2575eda009SAlexander Ziaee.Ed
2675eda009SAlexander Ziaee.It Sy Connecting to a cellular network with USB tethering:
2775eda009SAlexander Ziaee.Pp
2875eda009SAlexander ZiaeeLoad the USB tethering driver,
2975eda009SAlexander Ziaee.Xr urndis 4 :
3075eda009SAlexander Ziaee.Bd -literal -offset 2n
3175eda009SAlexander Ziaee.Ic # kldload urndis
3275eda009SAlexander Ziaee.Ed
3375eda009SAlexander Ziaee.Pp
3475eda009SAlexander ZiaeeAsk for a DHCP lease on the USB tethering interface:
3575eda009SAlexander Ziaee.Bd -literal -offset 2n
3675eda009SAlexander Ziaee.Ic # dhclient ue0
3775eda009SAlexander Ziaee.Ed
3875eda009SAlexander Ziaee.It Sy Connecting to a Wi-Fi network:
3975eda009SAlexander Ziaee.Pp
4075eda009SAlexander ZiaeeIdentify your Wi-Fi hardware:
4175eda009SAlexander Ziaee.Bd -literal -offset 2n
4275eda009SAlexander Ziaee.Ic % sysctl net.wlan.devices
4375eda009SAlexander Ziaee.Ed
4475eda009SAlexander Ziaee.Pp
4575eda009SAlexander ZiaeeConfigure your Wi-Fi hardware as wlan0 interface:
4675eda009SAlexander Ziaee.Bd -literal -offset 2n
4775eda009SAlexander Ziaee.Ic # sysrc wlans_iwn0="wlan0"
4875eda009SAlexander Ziaee.Ed
4975eda009SAlexander Ziaee.Pp
5075eda009SAlexander ZiaeeSet that interface to negotiate a DHCP lease with
5175eda009SAlexander Ziaee.Xr wpa_supplicant 8 :
5275eda009SAlexander Ziaee.Bd -literal -offset 2n
5375eda009SAlexander Ziaee.Ic # sysrc ifconfig_wlan0="WPA SYNCDHCP"
5475eda009SAlexander Ziaee.Ed
5575eda009SAlexander Ziaee.Pp
5675eda009SAlexander ZiaeeEnter the details of the Wi-Fi network:
5775eda009SAlexander Ziaee.Bd -literal -offset 2n
5875eda009SAlexander Ziaee.Ic # wpa_passphrase \(dqmyssid\(dq \(dqmypassphrase\(dq >> wpa_supplicant.conf
5975eda009SAlexander Ziaee.Ed
6075eda009SAlexander Ziaee.Pp
6175eda009SAlexander ZiaeeRestart the network interface daemon:
6275eda009SAlexander Ziaee.Bd -literal -offset 2n
6375eda009SAlexander Ziaee.Ic # service netif restart
6475eda009SAlexander Ziaee.Ed
6575eda009SAlexander Ziaee.Pp
6675eda009SAlexander Ziaee.It Sy Scanning for Wi-Fi networks:
6775eda009SAlexander Ziaee.Bd -literal -offset 2n
6875eda009SAlexander Ziaee.Ic % ifconfig wlan0 scan
6975eda009SAlexander Ziaee.Ed
7075eda009SAlexander Ziaee.It Sy Airplane mode:
7175eda009SAlexander Ziaee.Bd -literal -offset 2n
7275eda009SAlexander Ziaee.Ic # service netif stop
7375eda009SAlexander Ziaee.Ed
7475eda009SAlexander Ziaee.El
7575eda009SAlexander Ziaee.Sh SEE ALSO
7675eda009SAlexander Ziaee.Xr bsdconfig 8 ,
7775eda009SAlexander Ziaee.Xr dhclient 8 ,
7875eda009SAlexander Ziaee.Xr ifconfig 8 ,
7975eda009SAlexander Ziaee.Xr wpa_passphrase 8
8075eda009SAlexander Ziaee.Pp
8175eda009SAlexander ZiaeeThe Advanced Networking chapter of the
8275eda009SAlexander Ziaee.Fx
8375eda009SAlexander ZiaeeHandbook.
8475eda009SAlexander Ziaee.Sh CAVEATS
8575eda009SAlexander ZiaeeShell Special Characters in the
8675eda009SAlexander Ziaee.Ar SSID
8775eda009SAlexander Ziaeeor
8875eda009SAlexander Ziaee.Ar passphrase
8975eda009SAlexander Ziaeewill need to be escaped for
9075eda009SAlexander Ziaee.Xr wpa_passphrase 8 ,
9175eda009SAlexander Ziaeecommonly using
9275eda009SAlexander Ziaee.Ql \e ,
9375eda009SAlexander Ziaeesee the manual page for your shell for more details.
94