pub/scm/utils/kernel/kmod/kmod.git  about / heads / tags
kmod - module management
$ git log --pretty=format:'%h %s (%cs)%d'
5a8b16b libkmod: keep KMOD_FILE_COMPRESSION_NONE/load_reg in comp_types (2024-04-30)
	(HEAD -> master)
045fd57 libkmod: move load_reg() further up (2024-04-30)
61bf8e7 libkmod: tidy-up kmod_file_open() (2024-04-30)
7377443 libkmod: swap alloca usage for a few assert_cc (2024-04-30)
0c12738 libkmod: always detect the module compression (2024-04-30)
8cc475f libkmod: move kmod_file_load_contents as applicable (2024-04-30)
81e5c79 libkmod: propagate {zstd,xz,zlib}_load errors (2024-04-30)
ad15892 libkmod: nuke struct file_ops (2024-04-30)
90b271f libkmod: clear file->memory if map fails (2024-04-30)
03da2db libkmod: remove kmod_file::{zstd,xz}_used flags (2024-04-30)
...

$ git cat-file blob HEAD:README.md
## kmod - Linux kernel module handling

[![Coverity Scan Status](https://scan.coverity.com/projects/2096/badge.svg)](https://scan.coverity.com/projects/2096)


Information
===========

Mailing list:
	linux-modules@vger.kernel.org (no subscription needed)
	https://lore.kernel.org/linux-modules/

Signed packages:
	http://www.kernel.org/pub/linux/utils/kernel/kmod/

Git:
	git://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git
	http://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git
	https://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git

Gitweb:
	http://git.kernel.org/?p=utils/kernel/kmod/kmod.git
	https://github.com/kmod-project/kmod

Irc:
	#kmod on irc.freenode.org

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


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.

Compilation and installation
============================

In order to compiler the source code you need following software packages:
	- GCC compiler
	- GNU C library

Optional dependencies:
	- ZLIB library
	- LZMA library
	- ZSTD library
	- OPENSSL library (signature handling in modinfo)

Typical configuration:
	./configure CFLAGS="-g -O2" --prefix=/usr \
			--sysconfdir=/etc --libdir=/usr/lib

Configure automatically searches for all required components and packages.

To compile and install run:
	make && make install

Hacking
=======

Run 'autogen.sh' script before configure. If you want to accept the recommended
flags, you just need to run 'autogen.sh c'.

Make sure to read the CODING-STYLE file and the other READMEs: libkmod/README
and testsuite/README.

Compatibility with module-init-tools
====================================

kmod replaces module-init-tools, which is end-of-life. Most of its tools are
rewritten on top of libkmod so it can be used as a drop in replacements.
Somethings however were changed. Reasons vary from "the feature was already
long deprecated on module-init-tools" to "it would be too much trouble to
support it".

There are several features that are being added in kmod, but we don't
keep track of them here.

modprobe
--------

* 'modprobe -l' was marked as deprecated and does not exist anymore

* 'modprobe -t' is gone, together with 'modprobe -l'

* modprobe doesn't parse configuration files with names not ending in
  '.alias' or '.conf'. modprobe used to warn about these files.

* modprobe doesn't parse 'config' and 'include' commands in configuration
  files.

* modprobe from m-i-t does not honour softdeps for install commands. E.g.:
  config:

        install bli "echo bli"
	install bla "echo bla"
	softdep bla pre: bli

  With m-i-t, the output of 'modprobe --show-depends bla' will be:
        install "echo bla"

  While with kmod:
        install "echo bli"
        install "echo bla"

* kmod doesn't dump the configuration as is in the config files. Instead it
  dumps the configuration as it was parsed. Therefore, comments and file names
  are not dumped, but on the good side we know what the exact configuration
  kmod is using. We did this because if we only want to know the entire content
  of configuration files, it's enough to use find(1) in modprobe.d directories

depmod
------

* there's no 'depmod -m' option: legacy modules.*map files are gone

lsmod
-----

* module-init-tools used /proc/modules to parse module info. kmod uses
  /sys/module/*, but there's a fallback to /proc/modules if the latter isn't
  available

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       libkmod: keep KMOD_FILE_COMPRESSION_NONE/load_reg in comp_types (2024-04-30)
  tip-module-decompression libkmod: Use kernel decompression when available (2023-06-01)
  hash-stat2   benchmark hashfind (2013-09-25)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
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
v26          kmod 26 (2019-02-07) tar.gz
v25          kmod 25 (2018-01-08) tar.gz
v24          kmod 24 (2017-02-23) tar.gz
v23          kmod 23 (2016-07-20) tar.gz
...

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

git clone https://80x24.org/lore/pub/scm/utils/kernel/kmod/kmod.git