wifi-menu1
Interactively connect to a wireless network
Usage
wifi-menu [{-o | --obscure}]
[INTERFACE]
wifi-menu [{-h | --help}]
Overview
wifi-menu allows to interactively connect to a wireless network on INTERFACE using a netctl profile. In case no netctl profile is available, one can be generated. If only one wireless interface is available, INTERFACE can be omitted.
wifi-menu is only able to generate netctl profiles for simple network configurations. Profiles for more complex configurations must be set up manually. See netctl.profile(5) for more information.
Options
-
-h, --help -
Print a short help text and exit.
-
-o, --obscure -
Show asterisks for the characters of the password and store the password as a hexadecimal pre-shared key.
INTERFACE
The wireless network interface to use for connecting.
Exit status
0
The interface connected to the wireless network successfully.
1
The connection attempt was canceled.
2
The connection attempt failed.
3
No wireless networks were found.
4
Invalid passphrase length (WEP keys must be between 8 and 63 characters in length).
7
An unexpected error code was received.
255
The command was invalid or the connection attempt was aborted.
Notes
Establishing a connection may take a minute. While establishing a connection, nothing is shown on screen.
Starting a connection on an interface that is controlled by netctl-auto will cause wifi-menu to switch to the selected network. The interface will continue to be controlled by netctl-auto.
Environment
$NETCTL_DEBUG
If set to "yes", debugging output is generated.
Files
/etc/netctl
Directory where generated profiles are stored.
Releases
3 releases since Debian 11 (Bullseye); the text changed 1 time.