FreeBSD Manual Pages
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 avail- able networks, connecting and disconnecting from access points. It in- teracts with wpa-supplicant(8) over its control interface and automati- cally 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 interface 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 specified 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 specify 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) control 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.0 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.0-RELEASE+and+Ports.quarterly>