forked from proxypoke/wpa_config
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.txt
99 lines (80 loc) · 2.94 KB
/
README.txt
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
91
92
93
94
95
96
97
98
99
WPA_CONFIG(8)
=============
NAME
----
wpa_config - a small config manager for wpa_supplicant
DESCRIPTION
-----------
wpa_config makes configuration of wpa_supplicant - the only sane way to use
WLAN networks - a lot simpler. One of the only drawbacks of using bare
wpa_supplicant when compared to unwieldy bloatware like NetworkManager, is the
fact that mucking around in a single, large config file for all networks can
be quite cumbersome.
With wpa_config, every network is its own file in a folder, as are the options
for the wpa_supplicant. It simply merges all these files into a single file,
which then becomes your wpa_supplicant.conf. It also provides utility functions
for quickly generating new entries.
wpa_config does not manage the operation of wpa_supplicant. It's a config
manager, not a network manager. It might add a facility to restart
wpa_supplicant using your init system in the future.
FILES
-----
wpa_config uses three primary config files and a directory for network
configurations. All of these are located in the CONFIG_ROOT directory, which by
default is /etc/wpa_config.
wpa_config.conf
~~~~~~~~~~~~~~~
The configuration file for wpa_config itself. There are no settings so far, but
there might be some in the future (for example, choice of init system to
restart wpa_supplicant).
wpa_supplicant.conf.head
~~~~~~~~~~~~~~~~~~~~~~~~
This file contains settings for wpa_supplicant, for example the ctrl_interface
or the eapol_version.
wpa_supplicant.conf.tail
~~~~~~~~~~~~~~~~~~~~~~~~
This file is appended to the generated config. It's a great way to migrate your
currently configured networks, no need to reconfigure them.
networks.d/
~~~~~~~~~~~
This directory contains the configurations for the single networks. Every file
in it should be in the form "$\{SSID\}.conf".
COMMANDS
--------
wpa_config has severeal subcommands which do all the work.
add
~~~
Create a new file in the network directory. Currently, this only works for WPA
secured and open (unencrypted) networks. Specifying more options ( WEP, ad-hoc,
etc) will be added later.
del
~~~
Delete a network in the network directory, if it exists.
show
~~~~
Print the configuration of a network.
edit
~~~~
Open an editor (specified by the EDITOR environment variable) to change the
config of a network.
list
~~~~
List all networks configured through wpa_config. Note that this does not list
networks configured in wpa_supplicant.conf.tail.
make
~~~~
Merge all config and network files into wpa_supplicant.conf, writing it to
WPA_SUPPLICANT_CONFIG (usually /etc/wpa_supplicant/wpa_supplicant.conf).
migrate
~~~~~~~
Migrate your old wpa_supplicant.conf to wpa_config. This extracts all
configured (and uncommented) networks from wpa_supplicant.conf, and creates
single config files in the networks.d/ directory for them. This strips all
comments, so be careful.
help
~~~~
Show a help message. Same as specifying -h or --help.
SEE ALSO
--------
* wpa_supplicant(8)
* wpa_supplicant.conf(8)