| commit | ca9a7f4c5caa228d9af889ecad7dcbe41bd43f2d | [log] [tgz] |
|---|---|---|
| author | Tobias Stoeckmann <tobias@stoeckmann.org> | Tue Jan 13 18:16:38 2026 +0100 |
| committer | Lucas De Marchi <demarchi@kernel.org> | Fri Jan 16 01:31:55 2026 -0600 |
| tree | 4a3eaa27adfa14ec00c80ec2bb14246898b7e0fb | |
| parent | dad351539ae06bc6a275fe90fd03c7416d6139f0 [diff] |
build: Fix license specification The kmod project actually uses LGPL 2.1 or later for libkmod. Clarify this and use proper SPDX license identifier as done in source files. Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org> Reviewed-by: Lucas De Marchi <demarchi@kernel.org> Signed-off-by: Lucas De Marchi <demarchi@kernel.org>
kmod is a set of tools to handle common tasks with Linux kernel modules like insert, remove, list, check properties, resolve dependencies and aliases.
These tools are designed on top of libkmod, a library that is shipped with kmod. See libkmod/README for more details on this library and how to use it. The aim is to be compatible with tools, configurations and indexes from module-init-tools project.
Mailing list (no subscription needed): linux-modules@vger.kernel.org
Mailing list archives: https://lore.kernel.org/linux-modules/
Signed packages: http://www.kernel.org/pub/linux/utils/kernel/kmod/
Git:
License:
Irc: #kmod on irc.oftc.net
In order to compile the source code you need:
Optional dependencies, required with the default build configuration:
Typical configuration and installation
meson setup builddir/ meson compile -C builddir/ sudo meson install -C builddir/
For end-user and distributions builds, it's recommended to use:
meson setup --buildtype release builddir/
When working on kmod, use the included build-dev.ini file, as:
meson setup --native-file build-dev.ini builddir/
The testsuite can be executed with:
meson test -C builddir
It builds test kernel modules, so kernel headers need to be pre-installed. By default it tries to use the kernel header for the currently running kernel. KDIR=any environment variable can be used to tell it to use any installed kernel header or KDIR=/path/to/specific/headers when a specific one is needed. Example:
KDIR=any meson test -C builddir
Make sure to read our contributing guide and the other READMEs: libkmod and testsuite.
kmod replaced module-init-tools, which was EOL'ed in 2011. All the tools were rewritten on top of libkmod and they can be used as drop in replacements. Along the years there were a few behavior changes and new features implemented, following feedback from Linux kernel community and distros.