[src/trunk]: src Document the fact that wpa_supplicant won't start properly u...

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/eb79b0b1a7eb
branches:  trunk
changeset: 747738:eb79b0b1a7eb
user:      apb <apb%NetBSD.org@localhost>
date:      Wed Sep 30 18:17:22 2009 +0000

description:
Document the fact that wpa_supplicant won't start properly unless
/usr is mounted by mountcritlocal.

diffstat:

 etc/rc.d/wpa_supplicant  |  10 +++++++++-
 share/man/man5/rc.conf.5 |  13 +++++++++++--
 2 files changed, 20 insertions(+), 3 deletions(-)

diffs (58 lines):

diff -r cf0fa2ed7355 -r eb79b0b1a7eb etc/rc.d/wpa_supplicant
--- a/etc/rc.d/wpa_supplicant   Wed Sep 30 15:22:11 2009 +0000
+++ b/etc/rc.d/wpa_supplicant   Wed Sep 30 18:17:22 2009 +0000
@@ -1,11 +1,19 @@
 #!/bin/sh
 #
-# $NetBSD: wpa_supplicant,v 1.2 2008/11/17 11:34:04 abs Exp $
+# $NetBSD: wpa_supplicant,v 1.3 2009/09/30 18:17:22 apb Exp $
 #
 
 # PROVIDE: wpa_supplicant
 # REQUIRE: network mountcritlocal
 # BEFORE:  NETWORKING dhclient
+#
+#      We need to run a command that resides in /usr/sbin, and the
+#      /usr file system is traditionally mounted by mountcritremote.
+#      However, we cannot depend on mountcritremote, because that
+#      would introduce a circular dependency.  Therefore, if you need
+#      wpa_supplicant to start during the boot process, you should
+#      ensure that the /usr file system is mounted by mountcritlocal,
+#      not by mountcritremote.
 
 $_rc_subr_loaded . /etc/rc.subr
 
diff -r cf0fa2ed7355 -r eb79b0b1a7eb share/man/man5/rc.conf.5
--- a/share/man/man5/rc.conf.5  Wed Sep 30 15:22:11 2009 +0000
+++ b/share/man/man5/rc.conf.5  Wed Sep 30 18:17:22 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rc.conf.5,v 1.136 2009/09/14 12:37:08 wiz Exp $
+.\"    $NetBSD: rc.conf.5,v 1.137 2009/09/30 18:17:22 apb Exp $
 .\"
 .\" Copyright (c) 1996 Matthew R. Green
 .\" All rights reserved.
@@ -55,7 +55,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd September 14, 2009
+.Dd September 30, 2009
 .Dt RC.CONF 5
 .Os
 .Sh NAME
@@ -829,6 +829,15 @@
 Run
 .Xr wpa_supplicant 8 ,
 WPA/802.11i Supplicant for wireless network devices.
+If you set
+.Sy wpa_suplicant
+true, then
+.Pa /usr
+must be in
+.Sy critical_filesystems_local ,
+or
+.Pa /usr
+must be on the root file system.
 .El
 .Ss Daemons required by other daemons
 .Bl -tag -width net_interfaces