kmod - Linux kernel module handling
Go to file
Lucas De Marchi d7293a1628 testsuite: Fix expected_fail parsing
If a test has expected_fail=true, it means the return code must be
different from 0 *and* the outputs must match. This way it's possible to
check if the error messages are printed as they should.
2014-05-30 10:23:05 -03:00
libkmod Fix use-after-free in hash implementation. 2014-05-18 16:04:50 -03:00
m4 build-sys: Append -Werror when testing flags 2012-09-14 11:37:29 -03:00
man man: fixup spacing/parens in modprobe.d(5) 2014-05-13 14:45:15 -03:00
shell-completion/bash Remove references to systemd from the bash completion file 2014-05-05 01:52:04 -03:00
testsuite testsuite: Fix expected_fail parsing 2014-05-30 10:23:05 -03:00
tools depmod: Add better error messages when facing loops 2014-05-30 09:43:30 -03:00
.gitignore build-sys: add small redirecting Makefiles 2014-03-06 01:59:58 -03:00
.travis.yml Update .travis.yml 2014-04-07 10:55:47 -03:00
autogen.sh build-sys: rename autogen.sh to bootstrap and keep a symlink 2012-01-12 18:23:32 -02:00
bootstrap build-sys: enable python in bootstrap-configure 2014-04-06 17:14:23 -03:00
bootstrap-configure build-sys: Remove -Werror from CFLAGS 2014-03-24 14:54:01 -03:00
CODING-STYLE libkmod-module: Don't pass NULL pointer to memcpy 2013-04-23 21:26:08 -03:00
configure.ac Add strndupa to missing.h 2014-04-07 11:00:24 -03:00
COPYING Change licenses 2011-12-12 18:24:35 -02:00
Makefile.am kmod 17 2014-04-06 17:52:44 -03:00
NEWS kmod 17 2014-04-06 17:52:44 -03:00
README README: Move items from TODO 2013-07-17 02:31:27 -03:00
TODO README: Move items from TODO 2013-07-17 02:31:27 -03:00

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.

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

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 'bootstrap' script before configure. If you want to accept the recommended
flags, you just need to run 'bootstrap-configure'.

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

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

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

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

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

Irc:
	#kmod on irc.freenode.org

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