pub/scm/utils/kernel/kmod/kmod.git  about / heads / tags
kmod - module management
$ git log --pretty=format:'%h %s (%cs)%d'
a403590 ci: swap bullseye for bookworm (2025-10-26)
	(HEAD -> master)
695fd08 testsuite: Fix build with gcc < 15 (2025-07-13)
5d845ab testsuite: simplify syscall number handling (2025-07-11)
84db2f9 testsuite/init_module: Handle __NR_riscv_hwprobe in syscall wrapper (2025-07-11)
1c304d9 testsuite: consolidate final exit() call (2025-07-08)
dd77977 testsuite: fixup argument handling (2025-07-08)
ffc165c testsuite: remove struct test alignment (2025-07-08)
bffe1a7 Remove _always_inline_ attribute (2025-07-08)
1155314 Globally silence all Wattribute warnings (2025-07-08)
3f8ec4d testsuite: Fix build warning on kernel 6.15 (2025-07-07)
...

$ git cat-file blob HEAD: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
=====
- 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:
    - Official: <https://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git>
    - Mirror: <https://github.com/kmod-project/kmod>
    - Mirror: <https://kernel.googlesource.com/pub/scm/utils/kernel/kmod/kmod.git>

- License:
    - LGPLv2.1+ for libkmod, testsuite and helper libraries
    - GPLv2+ for tools/*

- Irc: `#kmod` on irc.oftc.net

- Issues: <https://github.com/kmod-project/kmod/issues>


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](CONTRIBUTING.md) and the other
READMEs: [libkmod](libkmod/README) and [testsuite](testsuite/README).

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.

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       ci: swap bullseye for bookworm (2025-10-26)
  kmod-34.y    tools/modprobe: Fix odd --remove-holders behavior (2025-06-21)
  hash-stat2   benchmark hashfind (2013-09-25)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v34.2        kmod 34.2 (2025-03-27) tar.gz
v34.1        kmod 34.1 (2025-03-05) tar.gz
v34          kmod 34 (2025-02-21) tar.gz
v33          kmod 33 (2024-08-13) tar.gz
v32          kmod 32 (2024-03-05) tar.gz
v31          kmod 31 (2023-09-29) tar.gz
v30          kmod 30 (2022-06-30) tar.gz
v29          kmod 29 (2021-05-20) tar.gz
v28          kmod 28 (2021-01-07) tar.gz
v27          kmod 27 (2020-02-18) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
        513 linux-modules
         75 lkml
         30 linux-kbuild
         22 qemu-devel
         19 linux-devicetree
         19 netdev
         16 u-boot
         15 linux-arm-kernel
         14 xen-devel
         14 dpdk-dev
         12 dri-devel
         11 git
         11 intel-gfx
         11 openembedded-devel
         10 buildroot
         10 openembedded-core
          9 linux-mm
          9 kvm
          9 linux-doc
          9 b4-sent
          9 intel-xe
          8 linux-wireless
          8 linux-fsdevel
          8 linux-media
          8 linux-mips
          8 linux-gpio
          8 linuxppc-dev
          8 util-linux
          8 ltp
          8 yocto-meta-arm
          7 linux-riscv
          7 stable
          7 linux-kselftest
          7 selinux
          7 amd-gfx
          7 linux-perf-users
          6 bpf
          6 netfilter-devel
          6 linux-clk
          6 linux-iio
          6 linux-bluetooth
          6 yocto-meta-arago
          6 barebox
          5 linux-mtd
          5 linux-xfs
          5 linux-mediatek
          5 linux-crypto
          5 linux-arm-msm
          5 linux-pm
          5 linux-rtc
          5 linux-input
          5 alsa-devel
          5 linux-scsi
          5 linux-pci
          5 linux-mmc
          5 linux-omap
          5 linux-spi
          5 linux-arch
          5 linux-rockchip
          5 rust-for-linux
          5 linux-s390
          5 bitbake-devel
          5 imx
          5 linux-um
          5 qemu-riscv
          5 linux-sound
          4 linux-samsung-soc
          4 linux-block
          4 linux-acpi
          4 linux-amlogic
          4 linux-iommu
          4 fstests
          4 kvmarm
          4 linux-usb
          4 linux-renesas-soc
          4 dmaengine
          4 linux-rdma
          4 linux-leds
          4 linux-security-module
          4 linux-f2fs-devel
          4 linux-csky
          4 cip-dev
          4 linux-i2c
          4 linux-pwm
          4 virtualization
          4 ceph-devel
          4 linux-can
          4 openbmc
          4 linux-fbdev
          4 linux-cxl
          4 linux-sh
          4 sparclinux
          4 linux-staging
          4 nvdimm
          4 yocto-meta-virtualization
          4 yocto-meta-ti
          4 intel-wired-lan
          4 linux-hexagon
          4 linux-hotplug
          4 igt-dev
          3 linux-fscrypt
          3 linux-nvme
          3 linux-nfs
          3 linux-efi
          3 linux-snps-arc
          3 linux-hwmon
          3 linux-btrfs
          3 driverdev-devel
          3 linux-parisc
          3 linux-ext4
          3 linux-ide
          3 linux-serial
          3 linux-watchdog
          3 linux-hyperv
          3 linux-m68k
          3 linux-kernel-mentees
          3 linux-remoteproc
          3 linux-tegra
          3 lttng-dev
          3 linux-raid
          3 platform-driver-x86
          3 dm-devel
          3 nouveau
          3 linux-phy
          3 kernel-janitors
          3 iwd
          3 linux-patches
          3 chrome-platform
          3 openrisc
          3 loongarch
          3 linux-trace-kernel
          3 poky
          3 grub-devel
          3 kdevops
          3 u-boot-amlogic
          3 lvm-devel
          2 cocci
          2 live-patching
          2 linux-integrity
          2 linux-edac
          2 linux-cifs
          2 linux-erofs
          2 linux-nvdimm
          2 linux-rt-users
          2 linux-sgx
          2 linux-trace-devel
          2 workflows
          2 backports
          2 io-uring
          2 linux-man
          2 linux-firmware
          2 linux-api
          2 linux-audit
          2 linux-sparse
          2 linux-fpga
          2 containers
          2 phone-devel
          2 linux-hardening
          2 lustre-devel
          2 soc
          2 linux-sunxi
          2 linux-coco
          2 b43-dev
          2 llvm
          2 yocto
          2 yocto-meta-freescale
          2 yocto-toaster
          2 yocto-docs
          2 ntb
          2 outreachy
          2 xenomai
          2 damon
          2 kexec
          2 batman
          2 virtio-comment
          2 cluster-devel
          2 cgroups
          2 devicetree-compiler
          2 kvm-ppc
          2 linux-alpha
          2 reiserfs-devel
          2 linux-nilfs
          2 virtio-fs
          2 fuego
          2 dtrace
          2 yocto-patches
          1 kernel-hardening
          1 linux-next
          1 kernelnewbies
          1 rcu
          1 selinux-refpolicy
          1 linux-i3c
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 wireguard
          1 tpmdd-devel
          1 linux-unionfs
          1 linux-dash
          1 linux-bcache
          1 mm-commits
          1 xdp-newbies
          1 dash
          1 keyrings
          1 linux-sctp
          1 target-devel
          1 ocfs2-devel
          1 ath10k
          1 ath11k
          1 mptcp
          1 regressions
          1 ksummit
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 fio
          1 ell
          1 ofono
          1 asahi
          1 ath12k
          1 oe-linux-nfc
          1 oe-kbuild-all
          1 oe-chipsec
          1 virtio-dev
          1 v9fs
          1 ecryptfs
          1 linux-ia64
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 devicetree-spec
          1 initramfs
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-laptop
          1 trinity
          1 linux-metag
          1 linux-x25
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 lm-sensors
          1 acpica-devel
          1 bridge
          1 perfbook
          1 smatch
          1 wireless-regdb
          1 powertop
          1 lkmm
          1 linux-aspeed
          1 kvm-riscv
          1 qemu-arm

git clone https://yhbt.net/lore/pub/scm/utils/kernel/kmod/kmod.git