File: wifi-menu.1.txt

package info (click to toggle)
netctl 1.29-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 596 kB
  • sloc: sh: 814; makefile: 72
file content (90 lines) | stat: -rw-r--r-- 1,935 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
WIFI-MENU(1)
============

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)