sbin/kldload/kldload.8

   1 .\"
   2 .\" Copyright (c) 1997 Doug Rabson
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD: src/sbin/kldload/kldload.8,v 1.7.2.10 2002/12/07 08:44:02 jmallett Exp $
  27 .\"
  28 .Dd October 27, 2017
  29 .Dt KLDLOAD 8
  30 .Os
  31 .Sh NAME
  32 .Nm kldload
  33 .Nd load a file into the kernel
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl nv
  37 .Ar
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 utility loads
  42 .Ar file Ns Pa .ko
  43 into the kernel using the kernel linker.
  44 Note that if multiple modules are specified then an attempt will
  45 be made to load them all, even if some fail.
  46 List of search directories is provided by
  47 .Va kern.module_path
  48 variable.
  49 .Pp
  50 The following options are available:
  51 .Bl -tag -width indent
  52 .It Fl n
  53 Do not try to load module if already loaded.
  54 .It Fl v
  55 Be more verbose.
  56 .El
  57 .Sh FILES
  58 .Bl -tag -width /boot/modules.local -compact
  59 .It Pa /boot/kernel
  60 directory containing loadable modules.
  61 Modules must have an extension of
  62 .Pa .ko .
  63 .It Pa /boot/modules.local
  64 directory for local loadable kernel modules
  65 and wrapped external firmware images; see
  66 .Xr firmware 9
  67 .El
  68 .Sh EXIT STATUS
  69 .Ex -std
  70 .Sh AUTOMATICALLY LOADING MODULES
  71 Some modules (ipfw, etc.) may be automatically loaded at boot
  72 time by having their operation enabled in
  73 .Xr rc.conf 5 .
  74 Modules may also be auto-loaded through their addition to
  75 .Xr loader.conf 5 .
  76 .Sh SEE ALSO
  77 .Xr kldload 2 ,
  78 .Xr loader.conf 5 ,
  79 .Xr rc.conf 5 ,
  80 .Xr kldstat 8 ,
  81 .Xr kldunload 8
  82 .Sh HISTORY
  83 The
  84 .Nm
  85 utility first appeared in
  86 .Fx 3.0 ,
  87 replacing the
  88 .Xr lkm 4
  89 interface.
  90 .Sh AUTHORS
  91 .An Doug Rabson Aq Mt dfr@FreeBSD.org