kldstat(8)

Usage

kldstat [-h] [-q] [-v] [-d] [-i id] [-n filename]

kldstat [-q] [-d] [-m modname]

Overview

The kldstat utility displays the status of any files dynamically linked into the kernel.

The following options are available:

-d: Show the module specific data (as int, unsigned int and unsigned long)
-h: Display the size field in a human-readable form, using unit suffixes instead of hex values.
-i id: Display the status of only the file with this ID.
-m modname: Display the status of only the module with this modname.
-n filename: Display the status of only the file with this filename.
-q: Quietly check if file is loaded or compiled into the kernel.
-v: Be more verbose.

Exit status

The kldstat utility exits 0 on success, and >0 if an error occurs.

Examples

Show files dynamically linked into the kernel. Note the kernel itself is shown in the list. Refs shows the number of modules referenced by each file:

$ kldstat
Id Refs Address                Size Name
 1   38 0xffffffff80200000  2448f20 kernel
 2    3 0xffffffff82649000    b7bd8 linux.ko
 3    5 0xffffffff82701000     9698 linux_common.ko
 4    1 0xffffffff82b11000     1eae linsysfs.ko
 5    1 0xffffffff82b13000    f2af8 nvidia-modeset.ko
 6    1 0xffffffff82c06000  122b020 nvidia.ko
 7    1 0xffffffff83e32000     2668 intpm.ko
 8    1 0xffffffff83e35000      b50 smbus.ko
 9    1 0xffffffff83e36000     18a0 uhid.ko
10    1 0xffffffff83e38000     2928 ums.ko
11    1 0xffffffff83e3b000     1aa0 wmt.ko
12    1 0xffffffff83e3d000     cd70 snd_uaudio.ko

Show the verbose status of the linux file and show the size in a human readable fashion:

$ kldstat -h -v -n linux
Id Refs Address             Size Name
 2    3 0xffffffff82649000  735K linux.ko (/boot/kernel/linux.ko)
        Contains modules:
                 Id Name
                  2 linuxelf

Same as above using the id of the file:

$ kldstat -h -i 2 -v
Id Refs Address             Size Name
 2    3 0xffffffff82649000  735K linux.ko (/boot/kernel/linux.ko)
        Contains modules:
                 Id Name
                  2 linuxelf

Show the status of the linuxelf module obtained from the example above:

$ kldstat -v -m linuxelf
Id  Refs Name
  2    1 linuxelf

Show the module specific data for the g_raid module:

$ kldstat -d -m g_raid
Id  Refs Name data..(int, uint, ulong)
366    1 g_raid (0, 0, 0x0)

Check if the module fakefile is linked. Returns 0 if it is, 1 otherwise:

$ kldstat -q -n fakefile || echo file not linked
file not linked

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 45 times.

-d since FreeBSD 10.4-RELEASE; -h since FreeBSD 11.0-RELEASE; -m since FreeBSD 5.5-RELEASE; -q since FreeBSD 6.0-RELEASE.

Referred to by

hier(7) description of the filesystem hierarchy kldfind(2) returns the fileid of a kld file kldnext(2) return the fileid of the next kld file kldstat(2) get status of kld file modfind(2) returns the modid of a kernel module modnext(2) return the modid of the next kernel module modstat(2) get status of kernel module modfnext(2) return the modid of the next kernel module kldfirstmod(2) return first module id from the kld file specified gdb(4) external kernel debugger kld(4) dynamic kernel linker facility kldload(8) load a file into the kernel kldxref(8) generate hints for the kernel loader kldunload(8) unload a file from the kernel kldfind(2freebsd) returns the fileid of a kld file kldnext(2freebsd) return the fileid of the next kld file kldstat(2freebsd) get status of kld file modfind(2freebsd) returns the modid of a kernel module modnext(2freebsd) return the modid of the next kernel module modstat(2freebsd) get status of kernel module modfnext(2freebsd) return the modid of the next kernel module kldfirstmod(2freebsd) return first module id from the kld file specified stats(7) information about various and sundry statistics utilities gdb(4freebsd) external kernel debugger kld(4freebsd) dynamic kernel linker facility