[src/trunk]: src/share/man/man9 Update module_autoload to say that a .plist f...

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

details:   https://anonhg.NetBSD.org/src/rev/bf47868ea7cd
branches:  trunk
changeset: 760606:bf47868ea7cd
user:      jnemeth <jnemeth%NetBSD.org@localhost>
date:      Sun Jan 09 05:05:10 2011 +0000

description:
Update module_autoload to say that a .plist file will be loaded, and if
that .plist contains noautoload=true then the system will refuse to load
the module.

diffstat:

 share/man/man9/module.9 |  17 +++++++++++++++--
 1 files changed, 15 insertions(+), 2 deletions(-)

diffs (38 lines):

diff -r 03db2e64cbe8 -r bf47868ea7cd share/man/man9/module.9
--- a/share/man/man9/module.9   Sun Jan 09 04:59:00 2011 +0000
+++ b/share/man/man9/module.9   Sun Jan 09 05:05:10 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: module.9,v 1.25 2010/12/14 16:23:59 jruoho Exp $
+.\"    $NetBSD: module.9,v 1.26 2011/01/09 05:05:10 jnemeth Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 14, 2010
+.Dd January 8, 2011
 .Dt MODULE 9
 .Os
 .Sh NAME
@@ -277,6 +277,19 @@
 function is intended for use by kernel components to locate and load optional
 system components.
 The function is also used to load modules that are required by other modules.
+.Pp
+The directory from which the module is loaded will be searched for a file
+with the same name as the module file, but with the suffix
+.Dq Pa .plist .
+If this file is found, the prop_dictionary it contains will be loaded and
+passed to the module's
+.Fn modcmd
+routine.
+If this prop_dictionary contains a
+.Dq Pa noautoload
+property which is set to
+.Dq Pa true
+then the system will refuse to load the module.
 .It Fn module_unload "name"
 Unload a module.
 If the module's reference count is non-zero, the function returns