231 lines
7.1 KiB
HTML
231 lines
7.1 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="MontaukOS manual page: wifi(1) - scan for wireless networks and inspect the Wi-Fi adapter">
|
|
<title>wifi(1) - MontaukOS Manual</title>
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;600&display=swap" rel="stylesheet">
|
|
<style>
|
|
body {
|
|
font-family: 'Open Sans', Arial, sans-serif;
|
|
max-width: 960px;
|
|
margin: 0 auto;
|
|
padding: 1em;
|
|
line-height: 1.5;
|
|
display: flex;
|
|
gap: 2em;
|
|
}
|
|
p { margin: 0 0 0.5em; }
|
|
h2 { margin: 0.5em 0; }
|
|
.sidebar {
|
|
width: 160px;
|
|
flex-shrink: 0;
|
|
}
|
|
.sidebar ul {
|
|
list-style: none;
|
|
padding: 0;
|
|
}
|
|
.sidebar li {
|
|
margin: 0.5em 0;
|
|
}
|
|
.sidebar a {
|
|
color: #0066CC;
|
|
text-decoration: none;
|
|
font-weight: 600;
|
|
}
|
|
.sidebar a:hover {
|
|
color: #004499;
|
|
text-decoration: underline;
|
|
}
|
|
.sidebar .current {
|
|
color: #004499;
|
|
}
|
|
.sidebar hr {
|
|
border: none;
|
|
border-top: 1px solid #999;
|
|
margin: 0.75em 0;
|
|
}
|
|
.main {
|
|
flex: 1;
|
|
min-width: 0;
|
|
}
|
|
a { color: #0000EE; }
|
|
a:visited { color: #0066CC; }
|
|
hr { border-style: solid; border-width: 1px 0 0 0; border-color: #999; }
|
|
pre { background: #f0f0f0; padding: 0.5em; overflow-x: auto; }
|
|
code { background: #f0f0f0; padding: 0 0.15em; }
|
|
pre code { padding: 0; }
|
|
.center { text-align: center; }
|
|
.box {
|
|
border: 1px solid #999;
|
|
padding: 0.5em;
|
|
margin: 0.5em 0;
|
|
}
|
|
@media (max-width: 700px) {
|
|
body {
|
|
flex-direction: column;
|
|
gap: 1em;
|
|
padding: 1em 0.75em;
|
|
}
|
|
.sidebar {
|
|
width: auto;
|
|
}
|
|
.sidebar ul {
|
|
display: flex;
|
|
flex-wrap: wrap;
|
|
gap: 0 1em;
|
|
}
|
|
.sidebar hr {
|
|
width: 100%;
|
|
}
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<div class="sidebar">
|
|
<ul>
|
|
<li><a href="../../index.html">Home</a></li>
|
|
<li><a href="../../downloads.html">Downloads</a></li>
|
|
<li><a href="../../history.html">History</a></li>
|
|
<li><a href="../index.html">Documentation</a></li>
|
|
<li><a href="https://git.montaukos.org/daniel/MontaukOS/issues">Issue tracker</a></li>
|
|
<li><a href="https://git.montaukos.org/daniel/MontaukOS">Git</a></li>
|
|
</ul>
|
|
<hr>
|
|
<ul>
|
|
<li><a href="index.html" class="current">Man Pages</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="main">
|
|
<div class="center">
|
|
<h1>wifi(1)</h1>
|
|
</div>
|
|
|
|
<hr>
|
|
|
|
<pre><code><strong>NAME</strong>
|
|
wifi - scan for wireless networks and inspect the Wi-Fi adapter
|
|
|
|
|
|
<strong>SYNOPSIS</strong>
|
|
wifi [scan [seconds]]
|
|
wifi info
|
|
wifi debug
|
|
wifi connect <ssid> [passphrase]
|
|
wifi status
|
|
wifi disconnect
|
|
wifi saved
|
|
wifi forget <ssid>
|
|
|
|
|
|
<strong>DESCRIPTION</strong>
|
|
Drives the Intel Wi-Fi adapter. With no arguments, runs a five
|
|
second scan and lists the networks found, strongest signal first.
|
|
|
|
The driver supports Intel AX210-family devices whose RF type is
|
|
GF (marketed as AX211), which is what the bundled firmware image
|
|
covers. Other Intel wireless parts are left unclaimed.
|
|
|
|
|
|
<strong>COMMANDS</strong>
|
|
scan [seconds]
|
|
Sweep every regulatory-permitted channel and report the
|
|
networks seen. The duration is clamped to 1-20 seconds and
|
|
defaults to 5.
|
|
|
|
info
|
|
Adapter status: MAC address, firmware version, supported
|
|
bands, usable channel count and whether a scan is running.
|
|
|
|
debug
|
|
Everything info prints, plus RX/error counters, a scan with
|
|
per-BSS detail (BSSID, channel, RSSI, security) and band and
|
|
security tallies. Use this when a scan finds nothing.
|
|
|
|
connect <ssid> [passphrase]
|
|
Joins a network from the last scan: open, or WPA2/WPA3-PSK
|
|
with CCMP or GCMP. Blocks until the link is up or the attempt
|
|
fails, and says which it was. A passphrase given here is
|
|
remembered in 0:/config/wifi.toml; given only an SSID, the
|
|
remembered one is used. Run <a href="dhcp.html">dhcp(1)</a> afterwards for an address.
|
|
|
|
status
|
|
The network currently joined, with signal and cipher.
|
|
|
|
disconnect
|
|
Leaves the network and tears the firmware contexts down.
|
|
|
|
saved
|
|
Lists the networks in 0:/config/wifi.toml and whether the
|
|
desktop rejoins them by itself at startup.
|
|
|
|
forget <ssid>
|
|
Removes a network from 0:/config/wifi.toml.
|
|
|
|
|
|
<strong>OUTPUT</strong>
|
|
SSID SIGNAL RSSI CH BAND SECURITY
|
|
-------------------------------------------------------------------
|
|
homenet [####] -42 6 2.4GHz WPA2
|
|
homenet-5g [###.] -61 44 5GHz WPA3
|
|
guest [##..] -74 11 2.4GHz open
|
|
|
|
|
|
<strong>FIRMWARE</strong>
|
|
The adapter needs firmware from the ramdisk:
|
|
|
|
0:/os/firmware/intel/iwlwifi-so-a0-gf-a0-<api>.ucode
|
|
0:/os/firmware/intel/iwlwifi-so-a0-gf-a0.pnvm
|
|
|
|
Loading happens shortly after boot, off the boot-critical path,
|
|
so "wifi info" may briefly report "detected (firmware not loaded
|
|
yet)". The PNVM file carries regulatory data; without it the
|
|
firmware falls back to conservative built-in limits.
|
|
|
|
|
|
<strong>SAVED NETWORKS</strong>
|
|
0:/config/wifi.toml holds the networks the system may rejoin
|
|
without being asked, as [network.<n>] tables of ssid and psk, and
|
|
a wifi.autoconnect flag. The desktop writes it when "Remember this
|
|
network" is ticked, and reads it after the automatic scan it runs
|
|
at startup. Passphrases are stored as typed; anyone who can read
|
|
0:/config can read them.
|
|
|
|
|
|
<strong>GRAPHICAL USE</strong>
|
|
The desktop panel carries a Wi-Fi icon whenever a supported
|
|
adapter is present, separate from the Ethernet one. Its menu lists
|
|
the networks in range, asks for a passphrase when one is needed,
|
|
and shows the address once the link is up. The Network app has the
|
|
same list under its Wi-Fi tab, along with Forget.
|
|
|
|
|
|
<strong>DIAGNOSTICS</strong>
|
|
no supported Wi-Fi adapter found
|
|
No matching device, or its RF type is not GF.
|
|
|
|
radio disabled (RF-kill)
|
|
The hardware kill switch is off. No scanning is possible.
|
|
|
|
error
|
|
Firmware load or configuration failed; klog(1) has the
|
|
detail under the WiFi and WiFi-FW tags.
|
|
|
|
|
|
<strong>SEE ALSO</strong>
|
|
ifconfig(1), klog(1), <a href="dhcp.html">dhcp(1)</a>, <a href="syscalls.html">syscalls(2)</a></code></pre>
|
|
<hr>
|
|
|
|
<div class="center">
|
|
<a href="../index.html">Back to Documentation Index</a>
|
|
</div>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|