archive mirror
 help / color / mirror / Atom feed
* [PATCH] README: make github mirror official
@ 2021-01-21  2:53 Lucas De Marchi
  0 siblings, 0 replies; only message in thread
From: Lucas De Marchi @ 2021-01-21  2:53 UTC (permalink / raw)
  To: linux-modules

For some time I've been maintaining a read-only mirror on github.
I think it's time to allow patches flowing from there besides the
mailing list: I created a new org to host the project:
 README    |   4 +- | 126 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 126 insertions(+), 4 deletions(-)

diff --git a/README b/README
index b541db9..59eb301 100644
--- a/README
+++ b/README
@@ -7,9 +7,6 @@ Mailing list: (no subscription needed)
 Signed packages:
@@ -20,6 +17,7 @@ Git:
 	#kmod on
diff --git a/ b/
index d3b84bd..a83b4ac 100644
--- a/
+++ b/
@@ -2,4 +2,128 @@
 [![Coverity Scan Status](](
-This is a ***mirror only***. Please see [README](../master/README) file for more information.
+Mailing list:
+ (no subscription needed)
+Signed packages:
+	git://
+	#kmod on
+	LGPLv2.1+ for libkmod, testsuite and helper libraries
+	GPLv2+ for tools/*
+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
+Run '' script before configure. If you want to accept the recommended
+flags, you just need to run ' 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.
+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 -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
+* there's no 'depmod -m' option: legacy modules.*map files are gone
+* 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

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2021-01-21  4:42 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-01-21  2:53 [PATCH] README: make github mirror official Lucas De Marchi

This is a public inbox, see mirroring instructions
on how to clone and mirror all data and code used for this inbox