Public bug reported:

Linux systems are typically configured with either a "wheel" group or a
"sudo" group to specify users that get sudo privs.  In the case of
Debian's default config, a "sudo" group exists in /etc/group and also
the /etc/sudoers file assumes a "sudo" group.  Yet the latest
wpa_supplicant.conf man page gives all examples using the non-existent
"wheel" group:

https://manpages.debian.org/testing/wpasupplicant/wpa_supplicant.conf.5.en.html

The wiki:

https://wiki.debian.org/WiFi/HowToUse#wpa_supplicant

is incomplete, because it neglects the setting that enables users to
configure the wifi APs.  The wiki assumes:

ctrl_interface=/run/wpa_supplicant

while the man page not only shows a different directory, it shows a
different syntax:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel

Debian-independant docs out in the wild are all over map on this which
exacerbates confusion.  In attempt to get a grasp on sanity, you would
think users could simply check which directory was created by the
wpasupplicant installer.  The answer: it created both
/var/run/wpa_supplicant and /run/wpa_supplicant -- which obviously
perpetuates confusion.

Considering /var is short for "variable", and a wifi config is naturally
quite variable, it's tempting to go with /var/run/wpa_supplicant/.
Normally the man page would also be the first port of call, but because
it uses "wheel", it's hard to trust the man page.  At the same time this
apparently well-written distro-agnostic guide demonstrates using
/run/wpa_supplicant/:

https://shapeshed.com/linux-wifi

Please make the docs a bit less schitzophrenic.

** Affects: wpasupplicant (Ubuntu)
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/1933037

Title:
  (bad docs) man page is inconsistent with wiki, & also inconsistent
  with system defaults

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/wpasupplicant/+bug/1933037/+subscriptions

-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to