modunload

- unload a module

Synopsis

modunload -i module_id [-e exec_file]

Description

modunload unloads a loadable module from the running system. The module_id is the ID of the module as shown by modinfo(1M). If ID is 0, all modules that were autoloaded which are unloadable, are unloaded. Modules loaded by modload(1M) are not affected.

Options

The following options are supported:

-e exec_file

Specify the name of a shell script or executable image file to be executed before the module is unloaded. The first argument passed is the module id (in decimal). There are two additional arguments that are module specific. For loadable drivers, the second argument is the driver major number. For loadable system calls, the second argument is the system call number. For loadable exec classes, the second argument is the index into the execsw table. For loadable filesystems, the second argument is the index into the vfssw table. For loadable streams modules, the second argument is the index into the fmodsw table. For loadable scheduling classes, the second argument is the index into the class array. Minus one is passed for an argument that does not apply.

-i module_id

Specify the module to be unloaded.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

modinfo(1M), modload(1M), update_drv(1M), attributes(5)

Notes

The modunload command is often used on driver modules to force the system to reread the associated driver configuration file. While this works in the current Solaris release, it is not the supported way to reread the configuration file and is not guaranteed to work in future releases. The supported way for rereading driver configuration file is through the update_drv(1M) command.