[src/trunk]: src/share/man/man9 Document the arguments to the MODULE() macro

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

details:   https://anonhg.NetBSD.org/src/rev/ab2fac085186
branches:  trunk
changeset: 828491:ab2fac085186
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Sat Dec 16 12:40:30 2017 +0000

description:
Document the arguments to the MODULE() macro

diffstat:

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

diffs (65 lines):

diff -r 509bb2495b39 -r ab2fac085186 share/man/man9/module.9
--- a/share/man/man9/module.9   Sat Dec 16 10:15:12 2017 +0000
+++ b/share/man/man9/module.9   Sat Dec 16 12:40:30 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: module.9,v 1.38 2015/10/04 22:51:19 pgoyette Exp $
+.\"    $NetBSD: module.9,v 1.39 2017/12/16 12:40:30 pgoyette 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 October 5, 2015
+.Dd December 16, 2017
 .Dt MODULE 9
 .Os
 .Sh NAME
@@ -100,6 +100,46 @@
 macro creates and initializes a
 .Vt modinfo_t
 structure.
+The
+.Fa class
+argument identifies the class of module, and must be one of the following:
+.Bl -tag -width XXX -offset indent
+.It Dv MODULE_CLASS_VFS
+The module provide a virtual file system - see
+.Xr vfs 9
+.It Dv MODULE_CLASS_DRIVER
+The module is a device driver - see
+.Xr driver 9
+.It Dv MODULE_CLASS_EXEC
+The module provides an alternate execution environment - see the various
+.Dv COMPAT_xxx
+options in
+.Xr options 9
+.It Dv MODULE_CLASS_SECMODEL
+The module provides a security model - see
+.Xr secmodel 9
+.It Dv MODULE_CLASS_BUFQ
+The module provides a buffer queue strategy - see
+.Xr bufq 9
+.It Dv MODULE_CLASS_MISC
+The module provides miscellaneous kernel services
+.El
+.Pp
+The
+.Fa name
+argument provides the name of the module.
+Loaded modules, including those that are built-in to the kernel, must all
+have unique names.
+.Pp
+The
+.Fa required
+argument contains a comma-separated list of module names that are required
+by this module.
+The list must not contain any white-space.
+When a module is loaded, all of its required modules are auto-loaded and
+initialized before the module itself is loaded.
+Loading of required modules is a recursive operation.
+.Pp
 In addition to the explicit arguments, the
 .Fn MODULE
 macro creates a reference to the module's