** Description changed:

  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
  
+ There's another reason to distrust the man page: these config params
+ worked on Debian Lenny-baed distros:
+ 
+      ctrl_interface=/var/run/wpa_supplicant
+      ctrl_interface_group=netdev
+ 
+ Notice that ctrl_interface_group is a separate parameter.  Was that
+ parameter made obsolete, or is it simply undocumented?  It should be
+ documented in the man page, and if it's obsolete then the manpage should
+ still document it and mark it obsolete so users know to adapt their
+ configs.
+ 
  Please make the docs a bit less schitzophrenic.

-- 
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
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to