test-modprobe: share single function for kcmdline tests

[thirdparty/kmod.git] / README

diff --git a/README b/README
index 394e3bbff6865bc762041685ea2d06105adaf1ef..59eb301864a2beef7e6fff717db35a5ae4ad2253 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,32 @@
 kmod - Linux kernel module handling
 
+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
 ========
 
@@ -34,28 +61,66 @@ To compile and install run:
 Hacking
 =======
 
-Run 'bootstrap' script before configure. If you want to accept the recommended
-flags, you just need to run 'bootstrap-configure'.
+Run 'autogen.sh' script before configure. If you want to accept the recommended
+flags, you just need to run 'autogen.sh c'. Note that the recommended
+flags require cython be installed to compile successfully.
 
 Make sure to read the CODING-STYLE file and the other READMEs: libkmod/README
 and testsuite/README.
 
-Information
-===========
+Compatibility with module-init-tools
+====================================
 
-Signed packages:
-       http://www.kernel.org/pub/linux/utils/kernel/kmod/
+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".
 
-Mailing list:
-       linux-modules@vger.kernel.org
+There are several features that are being added in kmod, but we don't
+keep track of them here.
 
-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
+modprobe
+--------
 
-Gitweb:
-       http://git.kernel.org/?p=utils/kernel/kmod/kmod.git
+* 'modprobe -l' was marked as deprecated and does not exist anymore
 
-Irc:
-       #kmod on irc.freenode.org
+* '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