Google Git
Sign in
kernel / pub / scm / utils / kernel / kmod / kmod.git / HEAD
commita403590f6e9f25216480abdb7e038257d706f17f[log] [tgz]
authorEmil Velikov <emil.l.velikov@gmail.com>Sun Oct 26 12:27:48 2025 +0000
committerLucas De Marchi <demarchi@kernel.org>Sun Oct 26 22:37:54 2025 -0500
tree9205093431425109dff14d3cfdddb290c3482c1b
parent695fd084a727cf76f51b129b67d5a4be1d6db32e [diff]
ci: swap bullseye for bookworm

The former has been EOL for a bit now and somewhat recently has been
(re)moved from the repos -> our CI was failing.

Swap for bookworm, which gives us the "try a slightly older distro"
coverage, while still being green in CI.

Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Link: https://github.com/kmod-project/kmod/pull/395
Signed-off-by: Lucas De Marchi <demarchi@kernel.org>
2 files changed
tree: 9205093431425109dff14d3cfdddb290c3482c1b
  1. .github/
  2. libkmod/
  3. man/
  4. scripts/
  5. shared/
  6. shell-completion/
  7. testsuite/
  8. tools/
  9. .clang-format
  10. .codespellignore
  11. .editorconfig
  12. .gitignore
  13. .mailmap
  14. build-dev.ini
  15. CODING-STYLE
  16. CONTRIBUTING.md
  17. COPYING
  18. DCO.txt
  19. meson.build
  20. meson_options.txt
  21. NEWS
  22. README.md
README.md

kmod - Linux kernel module handling

OVERVIEW

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.

Links

Compilation and installation

In order to compile the source code you need:

  • C11 compiler, supporting a range of GNU extensions - GCC 8+, Clang 6+
  • POSIX.1-2008 C runtime library - Bionic, GNU C library, musl

Optional dependencies, required with the default build configuration:

  • ZLIB library
  • LZMA library
  • ZSTD library
  • OPENSSL library (signature handling in modinfo)

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/

Hacking

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.

Compatibility with module-init-tools

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.