2 .\" Copyright (c) 1997 Doug Rabson
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
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.
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
33 .Nd display status of dynamic kernel linker
49 utility displays the status of any files dynamically linked into the
52 The following options are available:
53 .Bl -tag -width indentXX
55 Display the size field in a human-readable form, using unit suffixes
56 instead of hex values.
60 Show the module specific data (as int, unsigned int and unsigned long)
62 Display the status of only the file with this ID.
64 Display the status of only the file with this filename.
66 Only check if file is loaded or compiled into the kernel.
68 Display the status of only the module with this modname.
73 Show files dynamically linked into the kernel.
74 Note the kernel itself is shown in the list.
76 shows the number of modules referenced by each file:
77 .Bd -literal -offset indent
79 Id Refs Address Size Name
80 1 38 0xffffffff80200000 2448f20 kernel
81 2 3 0xffffffff82649000 b7bd8 linux.ko
82 3 5 0xffffffff82701000 9698 linux_common.ko
83 4 1 0xffffffff82b11000 1eae linsysfs.ko
84 5 1 0xffffffff82b13000 f2af8 nvidia-modeset.ko
85 6 1 0xffffffff82c06000 122b020 nvidia.ko
86 7 1 0xffffffff83e32000 2668 intpm.ko
87 8 1 0xffffffff83e35000 b50 smbus.ko
88 9 1 0xffffffff83e36000 18a0 uhid.ko
89 10 1 0xffffffff83e38000 2928 ums.ko
90 11 1 0xffffffff83e3b000 1aa0 wmt.ko
91 12 1 0xffffffff83e3d000 cd70 snd_uaudio.ko
94 Show the verbose status of the
96 file and show the size in a human readable fashion:
97 .Bd -literal -offset indent
98 $ kldstat -h -v -n linux
99 Id Refs Address Size Name
100 2 3 0xffffffff82649000 735K linux.ko (/boot/kernel/linux.ko)
106 Same as above using the
109 .Bd -literal -offset indent
111 Id Refs Address Size Name
112 2 3 0xffffffff82649000 735K linux.ko (/boot/kernel/linux.ko)
118 Show the status of the
120 module obtained from the example above:
121 .Bd -literal -offset indent
122 $ kldstat -v -m linuxelf
127 Show the module specific data for the
130 .Bd -literal -offset indent
131 $ kldstat -d -m g_raid
132 Id Refs Name data..(int, uint, ulong)
133 366 1 g_raid (0, 0, 0x0)
139 Returns 0 if it is, 1 otherwise:
140 .Bd -literal -offset indent
141 $ kldstat -q -n fakefile || echo file not linked
151 utility first appeared in
157 .An Doug Rabson Aq Mt dfr@FreeBSD.org