Man1 - wifi-menu.1

Table of Contents

NAME

wifi-menu - Interactively connect to a wireless network

SYNOPSIS

wifi-menu [-o | –obscure] [INTERFACE]

wifi-menu [-h | –help]

DESCRIPTION

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.

SEE ALSO

*netctl*(1), *netctl-auto*(1)

Author: dt

Created: 2022-02-22 Tue 17:12