modload(8) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
MODLOAD(8)              NetBSD System Manager's Manual              MODLOAD(8)


NAME

     modload -- load a kernel module


SYNOPSIS

     modload [-fP] [-b var=boolean] [-i var=integer] [-s var=string] module
     modload -p [-b var=boolean] [-d var] [-i var=integer] [-m plist]
             [-s var=string]


DESCRIPTION

     The modload utility loads a kernel module specified by the module parame-
     ter into the running system.

     Modules are loaded from the default system module areas unless the module
     parameter contains a path separator character (`/').

     The options to modload are as follows:

     -b var=boolean   Pass the module a boolean property with the name var.
                      boolean may be either true or false.

     -d var           When used in conjunction with -m, delete var from the
                      plist specified.

     -f               When a module is loaded, the kernel checks if the module
                      is compatible with the running kernel and will refuse to
                      load modules that are potentially incompatible.  This
                      option disables compatibility checks.  Note: an incom-
                      patible module can cause system instability, including
                      data loss or corruption.

                      This option is also required for re-enabling a builtin
                      module that was disabled using modunload(8).

     -i var=integer   Pass the module an integer property with the name var
                      and integral value integer.

     -m plist         When used in conjunction with -p, merge new options with
                      an existing property list contained in plist.

     -P               This option tells the kernel not to load an associated
                      property list.

     -p               Output a property list suitable for loading along with a
                      module.  When using this option, you do not need to
                      specify a module.  Use -m and -d to read and modify an
                      existing property list.

     -s var=string    Pass the module a string property with the name var and
                      string value string.


DIAGNOSTICS

     The modload utility exits with a status of 0 on success and with a
     nonzero status if an error occurs.


SEE ALSO

     modctl(2), module(7), modstat(8), modunload(8)


HISTORY

     A modload utility appeared in NetBSD 0.9.  The modload command was
     designed to be similar in functionality to the corresponding command in
     SunOS 4.1.3.  modload was switched to the module framework for
     NetBSD 5.0.


AUTHORS

     The original NetBSD implementation was written by Terrence R. Lambert
     <terry@cs.weber.edu>.  The switch to the module framework was by Andrew
     Doran <ad@NetBSD.org>.

NetBSD 8.3                    September 12, 2016                    NetBSD 8.3