WUTIL(8) System Manager's Manual WUTIL(8) NAME wutil -- WiFi utility CLI SYNOPSIS wutil [-h] wutil interfaces wutil interface interface wutil [-c wpa-ctrl-path] known-networks wutil [-c wpa-ctrl-path] known-network SSID wutil [-c wpa-ctrl-path] forget SSID wutil [-c wpa-ctrl-path] set [-p priority] [-a {y | n}] known-SSID wutil [-c wpa-ctrl-path] scan wutil [-c wpa-ctrl-path] networks wutil [-c wpa-ctrl-path] status wutil [-c wpa-ctrl-path] disconnect wutil [-c wpa-ctrl-path] connect [-i username] [-p password] [-h] [-f frequency] SSID [password] DESCRIPTION wutil is a WiFi management CLI. It supports station-mode operations like querying connection status, scanning access points, listing available networks, connecting and disconnecting from access points. It interacts with wpa-supplicant(8) over its control interface and automatically updates the wpa-supplicant.conf(5) and provides commands to forget and set options on known-networks. The utility also supports listing wireless interfaces and displaying details about a specific wireless interface. The TUI inter- face is wutui(8). Supported Subcommands and Flags -h --help Print usage information and exit. -c wpa-ctrl-path subcommand --ctrl-interface wpa-ctrl-path subcommand Path to wpa_supplicant(8) control interface to use for subcommand. interfaces List wireless interfaces. interface interface Display details about the interface. known-networks List all previously connected known-networks. known-network SSID Display information about the known-network with the specified SSID. forget SSID Forget and remove the known-network with the specified SSID. set [-p priority] [-a {y | n}] known-SSID set [--priority priority] [--autoconnect {yes | no}] SSID Set the priority and autoconnect on a known-network with the speci- fied SSID. scan Starts scan for available access points. networks List available WiFi access points. status Display current connection status information. disconnect Disconnect from currently connected access point. connect [-i username] [-p password] [-h] [-f frequency] SSID [password] connect [--identity username] [--password password] [--hidden] [--frequency frequency] SSID [password] Connect to the SSID. The -p flag or argument can be used to spec- ify the password for a WPA-PSK network. The -i and -p flags can be used to specify the username and password for a WPA-EAP network. To connect to a hidden network, the --hidden flag is used. The -f flag can be used to specify the frequency (in MHz) of the WiFi channel to use. EXAMPLES Trigger scan for available WiFi access points: # wutil scan Trigger scan for available WiFi access points with wpa-supplicant(8) con- trol interface path, /var/run/wpa_supplicant/wlan0: # wutil -c /var/run/wpa_supplicant/wlan0 scan List scan results: # wutil networks Connect to an open network, Beastie-WiFi: # wutil connect Beastie-WiFi Connect to a WPA-PSK network, Beastie-WiFi with password, psswrd: # wutil connect Beastie-WiFi psswrd Connect to a WPA-EAP network, Beastie-WiFi with identity, beastie: and password, psswrd: # wutil connect -i beastie -p psswrd Beastie-WiFi Change priority and enable autoconnect on a known-network, Beastie-WiFi: # wutil set -p 1 -a y Beastie-WiFi Forget a known-network, Beastie-WiFi: # wutil forget Beastie-WiFi Disconnect from WiFi: # wutil disconnect SEE ALSO wutui(8), wpa_supplicant(8), ifconfig(8) AUTHORS Muhammad Saheed <saheed@FreeBSD.org> FreeBSD 15.1 August 24, 2025 WUTIL(8)
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wutil&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>