release - 0.2.0
This commit is contained in:
daniel committed
1 parent
a463834e0a
commit
0b0689a74e
5 files changed
+837
-2
No files matched your search
@@ -0,0 +1,230 @@
|
||||
<!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>
|
||||
Reference in new issue
Block a user