diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index b6df2617c868..30ec90f1ff04 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -4,7 +4,7 @@ MAN4= bpf.4 bridge.4 ccd.4 cd.4 ch.4 da.4 ddb.4 divert.4 drum.4 \ dummynet.4 fd.4 fpa.4 \ icmp.4 ifmib.4 iic.4 iicbb.4 iicbus.4 iicsmb.4 \ inet.4 intpm.4 intro.4 ip.4 ipfirewall.4 kld.4 \ - lkm.4 lo.4 lp.4 lpbb.4 lpt.4 natm.4 netintro.4 \ + lo.4 lp.4 lpbb.4 lpt.4 natm.4 netintro.4 \ null.4 od.4 pass.4 ppbus.4 ppi.4 ppp.4 pt.4 pty.4 \ route.4 sa.4 scsi.4 \ sd.4 sl.4 smb.4 smbus.4 smp.4 snp.4 sppp.4 ssc.4 st.4 su.4 tcp.4 \ diff --git a/share/man/man4/lkm.4 b/share/man/man4/lkm.4 deleted file mode 100644 index dbc7ad12e98d..000000000000 --- a/share/man/man4/lkm.4 +++ /dev/null @@ -1,167 +0,0 @@ -.\" Copyright (c) 1993 Christopher G. Demetriou -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. The name of the author may not be used to endorse or promote products -.\" derived from this software without specific prior written permission -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. -.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, -.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT -.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF -.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" -.\" $Id: lkm.4,v 1.9 1997/02/22 13:24:36 peter Exp $ -.\" -.Dd January 17, 1996 -.Dt LKM 4 -.Os FreeBSD 2.0 -.Sh NAME -.Nm lkm -.Nd loadable kernel module facility -.Sh DESCRIPTION -Loadable kernel modules allow the system administrator to -dynamically add and remove functionality from a running system. -This ability also helps software developers to develop -new parts of the kernel without constantly rebooting to -test their changes. -.Pp -Various types of modules can be loaded into the system. -There are several defined module types, listed below, which can -be added to the system in a predefined way. In addition, there -is a generic type, for which the module itself handles loading and -unloading. -.Pp -The -.Tn FreeBSD -system makes extensive use of loadable kernel modules, and provides -loadable versions of most filesystems, the -.Tn NFS -client and server, all the screen-savers, and the -.Tn iBCS2 -and -.Tn Linux -emulators. Modules distributed with the system are found in the -.Pa /lkm -directory. -.Pp -The -.Nm -interface is used by performing -.Xr ioctl 2 -calls on the -.Pa /dev/lkm -device. Normally all operations involving -Loadable Kernel Modules are handled by the -.Xr modload 8 , -.Xr modunload 8 , -and -.Xr modstat 8 -programs. Users should never have to interact with -.Pa /dev/lkm -directly. -.Sh "MODULE TYPES" -.Bl -ohang -.It Em "System Call modules" -System calls may be replaced by loading -new ones via the -.Nm -interface. All system calls may be -replaced, but special care should -be taken with the -.Xr ioctl 2 -system call, as it is used to load and -unload modules. -.Pp -When a system call module is unloaded, -the system call which -was replaced by the loadable module -is returned to its rightful place -in the system call table. -.It Em "Virtual File System modules" -Virtual file systems may be added -via the -.Nm -interface. -.It Em "Device Driver modules" -New block and character device -drivers may be loaded into the system with -.Nm LKM . -The major problem with loading -a device driver is that the driver's -device nodes must be exist for the -devices to be accessed. They are usually -created by instructing -.Xr modload 8 -to run an appropriate program when -the driver has been successfully loaded. -.It Em "Execution classes" -Also known as image activators, execution classes are the mechanisms -by which the -.Xr execve 2 -system call is able to recognize an executable file's format and load it -into memory. -.It Em "Miscellaneous modules" -Miscellaneous modules are modules -for which there are not currently -well-defined or well-used interfaces -for extension. Users are expected -to write their own loaders to manipulate -whatever kernel data structures necessary -to enable and disable the new module -when it is loaded and unloaded. -.El -.Sh FILES -.Bl -tag -width /usr/share/examples/lkm -compact -.It Pa /dev/lkm -.Nm -interface device -.It Pa /lkm -directory containing module binaries shipped with the system -.It Pa /usr/include/sys/lkm.h -file containing definitions of module types -.It Pa /usr/share/examples/lkm -example source code implementing two of the module types -.Sh SEE ALSO -.Xr modload 8 , -.Xr modstat 8 , -.Xr modunload 8 -.Sh BUGS -If a module fails to initialize itself correctly, and the system is -able to detect this failure, it will panic immediately. -.Pp -When system internal interfaces change, old modules often cannot -detect this, and such modules when loaded will often cause crashes or -mysterious failures. -.Sh AUTHORS -The -.Nm -facility was originally implemented by -.An Terrence R. Lambert . -Loadable filesystems were implemented by -.An Garrett Wollman , -and loadable -execution classes were implemented by -.An David Greenman , -.An Soren Schmidt , -and -.An Garrett Wollman . -.Sh HISTORY -The -.Nm -facility was designed to be similar in functionality -to the loadable kernel modules facility provided by -.Tn SunOS -4.1.3.