Page MenuHomeFreeBSD
Files F139430138

No OneTemporary
Actions

View Options

diff --git a/share/man/man7/Makefile b/share/man/man7/Makefile
index e410067a40ab..f163d4e0a0d8 100644
--- a/share/man/man7/Makefile
+++ b/share/man/man7/Makefile
@@ -1,60 +1,65 @@
.include <src.opts.mk>
#MISSING: eqnchar.7 ms.7 term.7
MAN= arch.7 \
ascii.7 \
bsd.snmpmod.mk.7 \
build.7 \
c.7 \
clocks.7 \
crypto.7 \
development.7 \
environ.7 \
ffs.7 \
firewall.7 \
growfs.7 \
hier.7 \
hostname.7 \
intro.7 \
maclabel.7 \
mitigations.7 \
operator.7 \
orders.7 \
ports.7 \
release.7 \
sdoc.7 \
security.7 \
simd.7 \
sizeof.7 \
sprog.7 \
stats.7 \
stdint.7 \
sticky.7 \
tests.7 \
tuning.7
MLINKS= intro.7 miscellaneous.7
MLINKS+= growfs.7 growfs_fstab.7
MLINKS+= security.7 securelevel.7
MLINKS+= c.7 c78.7
MLINKS+= c.7 c89.7
MLINKS+= c.7 c90.7
MLINKS+= c.7 c95.7
MLINKS+= c.7 c99.7
MLINKS+= c.7 c11.7
MLINKS+= c.7 c17.7
MLINKS+= c.7 c2x.7
+.if ${MK_INET} != "no"
+MAN+= networking.7
+MLINKS+= networking.7 wifi.7
+.endif
+
.if ${MK_TESTS} != "no"
ATF= ${SRCTOP}/contrib/atf
.PATH: ${ATF}/doc
MAN+= atf.7
CLEANFILES+= atf.7
atf.7: atf.7.in
sed -e 's,__DOCDIR__,/usr/share/doc/atf,g' \
<"${ATF}/doc/atf.7.in" >atf.7
.endif
.include <bsd.prog.mk>
diff --git a/share/man/man7/networking.7 b/share/man/man7/networking.7
new file mode 100644
index 000000000000..869812c05a9b
--- /dev/null
+++ b/share/man/man7/networking.7
@@ -0,0 +1,101 @@
+.\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.\" Copyright (c) 2024 Alexander Ziaee <concussious@runbox.com>
+.\"
+.Dd April 17, 2024
+.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
+driver, and Wi-Fi with the first interface found by the
+.Xr iwn 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:
+.Pp
+Load the USB tethering driver,
+.Xr urndis 4 :
+.Bd -literal -offset 2n
+.Ic # kldload urndis
+.Ed
+.Pp
+Ask for a DHCP lease on the USB tethering interface:
+.Bd -literal -offset 2n
+.Ic # dhclient ue0
+.Ed
+.It Sy 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:
+.Ed
+.Bd -literal -offset 2n
+.Ic # sysrc wlans_iwn0="wlan0"
+.Ed
+.Pp
+Set that interface to negotiate a DHCP lease with
+.Xr wpa_supplicant 8 :
+.Bd -literal -offset 2n
+.Ic # sysrc ifconfig_wlan0="WPA SYNCDHCP"
+.Ed
+.Pp
+Enter the details of the Wi-Fi network:
+.Bd -literal -offset 2n
+.Ic # wpa_passphrase \(dqmyssid\(dq \(dqmypassphrase\(dq >> wpa_supplicant.conf
+.Ed
+.Pp
+Restart the network interface daemon:
+.Bd -literal -offset 2n
+.Ic # service netif restart
+.Ed
+.Pp
+.It Sy Scanning for Wi-Fi networks:
+.Bd -literal -offset 2n
+.Ic % ifconfig wlan0 scan
+.Ed
+.It Sy Airplane mode:
+.Bd -literal -offset 2n
+.Ic # service netif stop
+.Ed
+.El
+.Sh SEE ALSO
+.Xr bsdconfig 8 ,
+.Xr dhclient 8 ,
+.Xr ifconfig 8 ,
+.Xr wpa_passphrase 8
+.Pp
+The Advanced Networking chapter of the
+.Fx
+Handbook.
+.Sh CAVEATS
+Shell Special Characters in the
+.Ar SSID
+or
+.Ar passphrase
+will need to be escaped for
+.Xr wpa_passphrase 8 ,
+commonly using
+.Ql \e ,
+see the manual page for your shell for more details.
+.Pp
+Currently
+.Ql Ic service netif restart
+does not restart routing.
+A common workaround is to issue
+.Ql Ic service netif restart && service routing restart
+instead.

File Metadata

Mime Type
text/x-diff
Expires
Sun, Dec 14, 12:16 AM (1 d, 22 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
26916308
Default Alt Text
(3 KB)

Event Timeline