Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update wpa_supplicant.md #523

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Update wpa_supplicant.md #523

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
798f167
Update wpa_supplicant.md
Piping Oct 24, 2020
5cccf71
Update wpa_supplicant.md
Piping Oct 24, 2020
c97a3cc
Update wpa_supplicant.md
Piping Oct 24, 2020
933b309
remove commands
Piping Oct 24, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 23 additions & 10 deletions src/config/network/wpa_supplicant.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,29 @@
The `wpa_supplicant` package is installed by default on the base system. It
includes utilities to configure wireless interfaces and handle wireless security
protocols. To use wpa_supplicant, you will need to enable [the wpa_supplicant
service](#the-wpa_supplicant-service).
service](../services/index.md#enabling-services).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://docs.voidlinux.org/config/network/wpa_supplicant.html#the-wpa_supplicant-service has a link to the part about enabling services...


Then you need to run `rfkill` to make sure your radio device is not blocked.

Run `rfkill unblock id|type` if it is shown blocked.
Comment on lines +8 to +10
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Information about rfkill should be added to the general network page, because it applies to wpa_supplicant and IWD, as well as any other daemon we decide to add.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is already in, but we can perhaps expand it. https://docs.voidlinux.org/config/network/index.html


## Using wpa_cli

`wpa_cli` is a tool comes with base system. You can use `wpa_cli` to manage `wpa_supplicant` from the command line, be sure
to specify which network interface to use via the `-i` option. Not doing so can result in various `wpa_cli` commands (for example, `scan` and
`scan_results`) not producing the expected output.

Sample Setup Commands:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"An example of the procedure to connect to an access point called wifi_name can be seen below:"

```
# wpa_cli -i wlp2s0
(wpa)$ add_network 0
(wpa)$ set_network 0 ssid "wifi_name"
(wpa)$ set_network 0 password abc123
(wpa)$ enable_entwork 0
(wpa)$ quit
```
Comment on lines +19 to +26
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wow, their man page fails to even mention these *_network commands... It would be nice if we could get them added to the upstream man page.


## More on wpa_supplicant
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't love this title. I think the page could be reorganized to not require it.


[wpa_supplicant(8)](https://man.voidlinux.org/wpa_supplicant.8) is a daemon that
manages wireless interfaces based on
Expand Down Expand Up @@ -74,14 +96,5 @@ If no `conf` file is found, the service searches for the following files in
Once you are satisfied with your configuration,
[enable](../services/index.md#enabling-services) the `wpa_supplicant` service.

### Using wpa_cli

When using `wpa_cli` to manage `wpa_supplicant` from the command line, be sure
to specify which network interface to use via the `-i` option, e.g.:

```
# wpa_cli -i wlp2s0
```

Not doing so can result in various `wpa_cli` commands (for example, `scan` and
`scan_results`) not producing the expected output.