AuxXxilium/kmod
1
0
Fork 0
mirror of https://github.com/AuxXxilium/kmod.git synced 2024-11-23 15:00:52 +07:00
Code Issues Actions Packages Projects Releases Wiki Activity

README: update to a decade+ later

Browse Source 
- State support for clang and other libc's
- Fix typos
- Reword the compatibility with module-init-tools section,
  removing most of the specific examples as we didn't keep
  track of all of them, and they are not important anymore
  in year 2024

Reviewed-by: Emil Velikov <emil.l.velikov@gmail.com>
Link: https://lore.kernel.org/r/20240712132449.780421-1-lucas.de.marchi@gmail.com
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
This commit is contained in:
Lucas De Marchi 2024-07-12 08:24:49 -05:00
parent 8da7c1e088
commit 5cdd221d88
1 changed files with 8 additions and 57 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
README.md
View File

@ -44,9 +44,9 @@ module-init-tools project.
Compilation and installation Compilation and installation
============================ ============================
In order to compiler the source code you need following software packages: In order to compile the source code you need the following software packages:
- GCC compiler - GCC/CLANG compiler
- GNU C library - GNU C library / musl / uClibc
Optional dependencies: Optional dependencies:
- ZLIB library - ZLIB library
@ -67,7 +67,7 @@ Hacking
======= =======
Run 'autogen.sh' script before configure. If you want to accept the recommended Run 'autogen.sh' script before configure. If you want to accept the recommended
flags, you just need to run 'autogen.sh c'. flags, you just need to run `autogen.sh c`.
Make sure to read the CODING-STYLE file and the other READMEs: libkmod/README Make sure to read the CODING-STYLE file and the other READMEs: libkmod/README
and testsuite/README. and testsuite/README.
@ -75,56 +75,7 @@ and testsuite/README.
Compatibility with module-init-tools Compatibility with module-init-tools
==================================== ====================================
kmod replaces module-init-tools, which is end-of-life. Most of its tools are kmod replaced module-init-tools, which was EOL'ed in 2011. All the tools were
rewritten on top of libkmod so it can be used as a drop in replacements. rewritten on top of libkmod and they can be used as drop in replacements.
Somethings however were changed. Reasons vary from "the feature was already Along the years there were a few behavior changes and new features implemented,
long deprecated on module-init-tools" to "it would be too much trouble to following feedback from Linux kernel community and distros.
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