xref: /freebsd/sbin/kldload/kldload.8 (revision 5ab2dec31ea7fe9dd9125d547c32907733ed9f12)
1a79fe607SDoug Rabson.\"
2a79fe607SDoug Rabson.\" Copyright (c) 1997 Doug Rabson
3a79fe607SDoug Rabson.\" All rights reserved.
4a79fe607SDoug Rabson.\"
5a79fe607SDoug Rabson.\" Redistribution and use in source and binary forms, with or without
6a79fe607SDoug Rabson.\" modification, are permitted provided that the following conditions
7a79fe607SDoug Rabson.\" are met:
8a79fe607SDoug Rabson.\" 1. Redistributions of source code must retain the above copyright
9a79fe607SDoug Rabson.\"    notice, this list of conditions and the following disclaimer.
10a79fe607SDoug Rabson.\" 2. Redistributions in binary form must reproduce the above copyright
11a79fe607SDoug Rabson.\"    notice, this list of conditions and the following disclaimer in the
12a79fe607SDoug Rabson.\"    documentation and/or other materials provided with the distribution.
13a79fe607SDoug Rabson.\"
14a79fe607SDoug Rabson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15a79fe607SDoug Rabson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16a79fe607SDoug Rabson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17a79fe607SDoug Rabson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18a79fe607SDoug Rabson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19a79fe607SDoug Rabson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20a79fe607SDoug Rabson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21a79fe607SDoug Rabson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22a79fe607SDoug Rabson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23a79fe607SDoug Rabson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24a79fe607SDoug Rabson.\" SUCH DAMAGE.
25a79fe607SDoug Rabson.\"
267f3dea24SPeter Wemm.\" $FreeBSD$
27a79fe607SDoug Rabson.\"
2865fe4c0bSTom Rhodes.Dd October 13, 2006
29a79fe607SDoug Rabson.Dt KLDLOAD 8
309fe48c6eSRuslan Ermilov.Os
31a79fe607SDoug Rabson.Sh NAME
32a79fe607SDoug Rabson.Nm kldload
33a79fe607SDoug Rabson.Nd load a file into the kernel
34a79fe607SDoug Rabson.Sh SYNOPSIS
357c7fb079SRuslan Ermilov.Nm
36a79fe607SDoug Rabson.Op Fl v
3794c61219SJuli Mallett.Ar
38a79fe607SDoug Rabson.Sh DESCRIPTION
39a79fe607SDoug RabsonThe
40a79fe607SDoug Rabson.Nm
4194c61219SJuli Mallettutility loads
4294c61219SJuli Mallett.Ar file Ns Pa .ko
43a87c2a93SDavid E. O'Brieninto the kernel using the kernel linker.
4494c61219SJuli MallettNote that if multiple modules are specified then an attempt will
4594c61219SJuli Mallettbe made to load them all, even if some fail.
46fc3643bbSGiorgos KeramidasThe
47fc3643bbSGiorgos Keramidas.Pa .ko
48fc3643bbSGiorgos Keramidasextension name is not mandatory when loading a given module
49fc3643bbSGiorgos Keramidasusing
50fc3643bbSGiorgos Keramidas.Nm .
514e9e907dSRuslan ErmilovIt does not hurt to specify it though.
52a79fe607SDoug Rabson.Pp
5349fea209SPhilippe CharnierThe following option is available:
5449fea209SPhilippe Charnier.Bl -tag -width indent
55a79fe607SDoug Rabson.It Fl v
56a79fe607SDoug RabsonBe more verbose.
57a79fe607SDoug Rabson.El
58a87c2a93SDavid E. O'Brien.Sh FILES
59b1d5d887SAndrey A. Chernov.Bl -tag -width /boot/kernel -compact
60b1d5d887SAndrey A. Chernov.It Pa /boot/kernel
615bfebe7bSRuslan Ermilovdirectory containing loadable modules.
625bfebe7bSRuslan ErmilovModules must have an extension of
635bfebe7bSRuslan Ermilov.Pa .ko .
641252c1bbSRuslan Ermilov.El
65a866e170SRuslan Ermilov.Sh EXIT STATUS
661f78c0cbSRuslan Ermilov.Ex -std
6745943e22SMike Silbersack.Sh AUTOMATICALLY LOADING MODULES
6865fe4c0bSTom RhodesSome modules (pf, ipfw, ipf, etc.) may be automatically loaded at boot
69fc3643bbSGiorgos Keramidastime when the corresponding
70fc3643bbSGiorgos Keramidas.Xr rc.conf 5
71fc3643bbSGiorgos Keramidasstatement is used.
7245943e22SMike SilbersackModules may also be auto-loaded through their addition to
7345943e22SMike Silbersack.Xr loader.conf 5 .
74a79fe607SDoug Rabson.Sh SEE ALSO
75fa8b1c61SChris Costello.Xr kldload 2 ,
7645943e22SMike Silbersack.Xr loader.conf 5 ,
771f78c0cbSRuslan Ermilov.Xr rc.conf 5 ,
78bdb963f9SRuslan Ermilov.Xr kldconfig 8 ,
791f78c0cbSRuslan Ermilov.Xr kldstat 8 ,
801f78c0cbSRuslan Ermilov.Xr kldunload 8
812830148aSJohn-Mark Gurney.Sh HISTORY
822830148aSJohn-Mark GurneyThe
832830148aSJohn-Mark Gurney.Nm
84e1205e80SPhilippe Charnierutility first appeared in
85a87c2a93SDavid E. O'Brien.Fx 3.0 ,
86a87c2a93SDavid E. O'Brienreplacing the
875ab2dec3SChristian Brueffer.Nm lkm
88a87c2a93SDavid E. O'Brieninterface.
8968085a0eSPhilippe Charnier.Sh AUTHORS
9068085a0eSPhilippe Charnier.An Doug Rabson Aq dfr@FreeBSD.org
91