From 798f167b87325473821c2b39f1814f49cb160bee Mon Sep 17 00:00:00 2001 From: Piping <12042284+Piping@users.noreply.github.com> Date: Fri, 23 Oct 2020 23:31:10 -0700 Subject: [PATCH 1/4] Update wpa_supplicant.md add details on how to use wpa_cli and wpa_supplicant based on my reading experience and real life experiment on this doc. --- src/config/network/wpa_supplicant.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/src/config/network/wpa_supplicant.md b/src/config/network/wpa_supplicant.md index d4e868ee8..11b45da3d 100644 --- a/src/config/network/wpa_supplicant.md +++ b/src/config/network/wpa_supplicant.md @@ -3,7 +3,10 @@ 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](#the-wpa_supplicant-service). + +`ln -s /etc/sv/wpa_supplicant /var/service` +`sv start wpa_supplicant` [wpa_supplicant(8)](https://man.voidlinux.org/wpa_supplicant.8) is a daemon that manages wireless interfaces based on @@ -81,6 +84,11 @@ to specify which network interface to use via the `-i` option, e.g.: ``` # 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 ``` Not doing so can result in various `wpa_cli` commands (for example, `scan` and From 5cccf71d54686646ee59215c4ae91a7207766a26 Mon Sep 17 00:00:00 2001 From: Piping <12042284+Piping@users.noreply.github.com> Date: Sat, 24 Oct 2020 13:28:39 -0500 Subject: [PATCH 2/4] Update wpa_supplicant.md Review the document flow and make changes based on review. --- src/config/network/wpa_supplicant.md | 41 +++++++++++++++++----------- 1 file changed, 25 insertions(+), 16 deletions(-) diff --git a/src/config/network/wpa_supplicant.md b/src/config/network/wpa_supplicant.md index 11b45da3d..825a24c71 100644 --- a/src/config/network/wpa_supplicant.md +++ b/src/config/network/wpa_supplicant.md @@ -1,4 +1,4 @@ -# wpa_supplicant +# Enabling wpa_supplicant The `wpa_supplicant` package is installed by default on the base system. It includes utilities to configure wireless interfaces and handle wireless security @@ -6,7 +6,30 @@ protocols. To use wpa_supplicant, you will need to enable [the wpa_supplicant service](#the-wpa_supplicant-service). `ln -s /etc/sv/wpa_supplicant /var/service` -`sv start wpa_supplicant` + +The wireless service will be automatically started once soft link is done. + +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. + +# 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: +``` +# 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 +``` + +# More on wpa_supplicant [wpa_supplicant(8)](https://man.voidlinux.org/wpa_supplicant.8) is a daemon that manages wireless interfaces based on @@ -77,19 +100,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 -(wpa)$ add_network 0 -(wpa)$ set_network 0 ssid "wifi_name" -(wpa)$ set_network 0 password abc123 -(wpa)$ enable_entwork 0 -(wpa)$ quit -``` - -Not doing so can result in various `wpa_cli` commands (for example, `scan` and -`scan_results`) not producing the expected output. From c97a3cc9ee4044c895a5dca9903d9dd1a3a37510 Mon Sep 17 00:00:00 2001 From: Piping <12042284+Piping@users.noreply.github.com> Date: Sat, 24 Oct 2020 13:59:37 -0500 Subject: [PATCH 3/4] Update wpa_supplicant.md Update the link to enabling service section. --- src/config/network/wpa_supplicant.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/config/network/wpa_supplicant.md b/src/config/network/wpa_supplicant.md index 825a24c71..8e61ef420 100644 --- a/src/config/network/wpa_supplicant.md +++ b/src/config/network/wpa_supplicant.md @@ -1,9 +1,9 @@ -# Enabling wpa_supplicant +# wpa_supplicant 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). `ln -s /etc/sv/wpa_supplicant /var/service` @@ -13,7 +13,7 @@ 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. -# Using wpa_cli +## 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 @@ -29,7 +29,7 @@ Sample Setup Commands: (wpa)$ quit ``` -# More on wpa_supplicant +## More on wpa_supplicant [wpa_supplicant(8)](https://man.voidlinux.org/wpa_supplicant.8) is a daemon that manages wireless interfaces based on From 933b309921dd9404fa385f7b2828a559419e53f7 Mon Sep 17 00:00:00 2001 From: Piping <12042284+Piping@users.noreply.github.com> Date: Sat, 24 Oct 2020 14:04:29 -0500 Subject: [PATCH 4/4] remove commands Update the link to enabling service section. --- src/config/network/wpa_supplicant.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/config/network/wpa_supplicant.md b/src/config/network/wpa_supplicant.md index 8e61ef420..b55417ef2 100644 --- a/src/config/network/wpa_supplicant.md +++ b/src/config/network/wpa_supplicant.md @@ -5,10 +5,6 @@ includes utilities to configure wireless interfaces and handle wireless security protocols. To use wpa_supplicant, you will need to enable [the wpa_supplicant service](../services/index.md#enabling-services). -`ln -s /etc/sv/wpa_supplicant /var/service` - -The wireless service will be automatically started once soft link is done. - 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.