testsuite: test libkmod initialization

testsuite: add skeleton

modprobe: fix build 'cause of excessive number of arguments

modprobe: remove code referring to -t, --type

This was only useful with the --list function, which isn't implemented.

README: add link to packages place

A lot of people trying to get latest package from cgit is not good.
They should get the package from the released versions instead.

build-sys: do not create symlinks by default

Distro packagers should create them instead. It's too much trouble to
create them in the build system and every distro wants a different path
for them.

modprobe: kill operations depending on path

It was not on module-init-tools and it doesn't make much sense. It will
deal with dependencies, but looking at modules in the index. This might
not be the module we want if we are loading another from outside of the
tree.

Dealing with paths causes this bug (supposing there's a module names
squashfs):

# cd /
# touch squashfs
# modprobe squashfs

That is because it detects that squashfs exists as a file and it will
try to load it instead of the alias "squashfs".

If you need to load a module from a path, use insmod.

Thanks to Silvan Calarco <silvan.calarco@mambasoft.it> who reported the
bug and helped debugging it.

TODO: system() should not be used inside a library

build-sys: forcefully create links

If link already existed we would fail. Really not important for
packagers (the link should not exist), but for those who manually install it.

build-sys: move modprobe to sbindir

Add program to calculate the shortest relative path for symlinks

libkmod-list: allow to append an empty list

build-sys: create symlinks if we are installing tools

WEXITSTATUS is defined in sys/wait.h

Fix compiling with dietlibc:

../libkmod/libkmod-module.c:858:2: warning: implicit declaration of function 'WEXITSTATUS' [-Wimplicit-function-declaration]
../libkmod/libkmod-module.c:858:2: warning: nested extern declaration of 'WEXITSTATUS' [-Wnested-externs]
(...)
kmod-modprobe.c:(.text.command_do+0x157): undefined reference to `WEXITSTATUS'

Check if struct stat has mtim member

Not all libc's have a mtim member in struct stat (dietlibc doesn't).
Change ts_usec() to receive a struct stat as parameter and implement it
accordingly for both cases.

modprobe: flush stdout before dumping indexes

Index dump doesn't use stdio.h function and instead call write()
directly on STDOUT_FILENO file descriptor. Therefore we need to flush
stdio buffers before calling it, to be sure the configuration dump will
appear before index's.

Fix common misspelling with codespell

-------8<-------
SUMMARY:
ommitted      1

man: spelling fixes

kmod 4

build-sys: add release helpers

Add doc to kmod_dump_index

modprobe: dump indexes as well

libkmod: dump index files

Provide a function to dump the index files to a certain fd. It could be
more optimized (particularly the functions to dump the index that were
copied and pasted from m-i-t), but it seems like the only user of it is
'modprobe -c', used for debugging purposes. So, keep it as is.

libkmod-util: add helper function to write to fd

libkmod-util: adhere to coding style

libkmod: export enum kmod_index and rename members

libkmod: store prefix of each index

Prefix is useful when dumping the index (to be added later).

Update documentation with recent changes

depmod: deal with relative root dir

module paths coming from libkmod are absolute. Make sure we store the
absolute dirname to compare later.

kmod_new(): deal with relative paths for dirname

depmod: fix idx calculation after postponed array creation

We need to set up each module's idx when the array is created. So,
postpone its initialization as well.

Reduce scope of counter variable

depmod: adhere to coding style

modprobe: dump configuration

config: let softdeps dump their data

config: add exported iterator functions

Config iterators are useful to get each configuration list, remember its
type and how to get their key/value pair.

softdeps don't have the value yet, because they are stored as string
vectors.

libkmod-private: allow to get aliases from config

build-sys: add script to bootstrap and configure

build-sys: rename autogen.sh to bootstrap and keep a symlink

TODO: add code unification to list of tasks

modprobe: abort on dependency loop that cannot be broken

modprobe: fix leak on error path

TODO: update tasks

modprobe: rework module removal without tree traversing

Just like the module insertion, module removal is remade.

The dependencies line that comes from modules.dep already contains all
the dependencies necessary to remove that module. Therefore modprobe
doesn't have to do the recursion between the modules in order to remove
it. All we have to do is to remove in order:

For the module being removed:
----------------------------

1. softdeps (in reverse order)
2. deps (in reverse order)
3. module
4. postdeps (in reverse order)

For any of the dependencies:
----------------------------

1. softdeps (in reverse order)
2. module
3. softdeps (in reverse order)

TODO: update differences with m-i-t

modprobe: rework module insertion without tree traversing

The dependencies line that comes from modules.dep already contains all
the dependencies necessary to insert that module. Therefore modprobe
doesn't have to do the recursion between the modules in order to load a
module. All we have to do is to load in order:

For the module being loaded:
----------------------------

1. softdeps
2. deps
3. module
4. postdeps

For any of the dependencies:
----------------------------

1. softdeps
2. module
3. softdeps

man: build modinfo man page

man: build modprobe man page

man: build rmmod man page

man: build lsmod man page

man: build insmod man page

man: build depmod man page

man: build modules.dep{,.bin} man pages

man: build modprobe.d man page

build-sys: build man pages

man: convert depmod.d.sgml to xml and update it

build-sys: fix clean rule removing tracked files

rename doc dir to man

doc/modprobe.sgml: Various updates wrt inclusion with kmod

* TODO: document "--remove-dependencies" flag

doc/depmod.sgml: Remove references to legacy map files

doc/depmod.sgml: Remove refs to depmod.conf

doc/depmod.d.sgml: Various touchups; mostly s/depmod.conf/depmod.d/g

doc/modprobe.d.sgml: Various touchups

* change references to "kmod" instead of "module-init-tools"
* remove references to modprobe.conf

doc: Import sgml manpages from module-init-tools repo

modprobe: show if module is in kernel

Now with './tools/modprobe --show-depends ahci' (ahci is builtin) we have the following
output:

$ ./tools/modprobe --show-depends ahci
builtin ahci

Just like modprobe from m-i-t. Previously we had:

$ ./tools/modprobe --show-depends ahci
FATAL: Module ahci not found.

test: add check of module's state

depmod: Postpone creation of module array

Deleting modules (we have found replacements) invalidates the indices
because the array collapses removed elements, hitting the assertion.

Since we don't make use of the array until the sorting step, build it from
the modules_by_name hash instead.

modprobe: break dependency loop by checking if module is loaded

modprobe doesn't have support for handling dependency loop. That happens
with poorly written softdeps that can introduce a loop. We must deal
with them like it's being done in libkmod.

However, we can break a dependency loop when the dependency was already
inserted. This commit fixes this issue, that happens in the following
scenario:

dependencies:
-------------

modA:
modB: modA
modC: modA

config:

softdep modA post: modB modC

This creates the following loop:

modA
    inserted ok
    handle post-soft-deps of modA -> modB modC
        modB
            handle dependencies of modB -> modA
                modA is already inserted
                    handle post-soft-deps of modA -> modB modC

And so on and so forth.

Now we break the loop by checking if module is already inserted, before
handling it. Thus this gives us:

modA
    inserted ok
    handle post-soft-deps of modA -> modB modC
        modB
            handle dependencies of modB -> modA
                modA is already inserted
            inserted ok
        modC
            handle dependencies of modC -> modA
                modA is already inserted
            inserted ok

autogen.sh: configure with 3-clicks + paste

modprobe: adhere do coding style

rmmod: behavior more like m-i-t's rmmod

In line with m-i-t's behavior, we should check to see if each module is:

- loaded
- has any holders
- has a 0 refcnt

Detecting any of these lets us provide a more useful message than the
kernel's EPERM response to delete_module(2).

Additionally, alter the main loop behavior to avoid exiting early on the
first error.

modprobe: check for EPERM on insertion

Throw an appropriate error when an unprivileged user attempts to load a
module.

config: deprecate 'include' and 'config' commands

Fix error code returned on module removal

build-sys: fix build with zlib/xz after private lib

TODO: add task to modprobe

build-sys: workaround libtool issue with argv[0]

Symlinking tools to kmod doesn't work because argv[0] is not the name of
the symlink, but rather 'kmod' (since libtool's wrapper script calls the
tools/.libs/kmod directly)

Now we create another binary kmod-nolib that is statically linked to
libkmod so we can call the binary directly and do not worry about
LD_LIBRARY_PATH.

build-sys: build tests as part of check phase

Do not unconditionally compile tests, make them as target of 'make
check'. Only those listed in TESTS var are run.

build-sys: create symlinks instead of building separate tools

build-sys: allow building without having gtk-doc installed

config: be reliable againt syntax errors in configs

TODO: add tasks to modprobe

doc: fix out of tree build

build-sys: give recommended configure options for hacking

README: add more information

build-sys: do not run configure in autogen.sh

doc: organize sections

doc: add gtk-doc to generate documentation

Current limitation is horrible no support to sections: we have to to
have separate header files or to maintain the libkmod-sections.txt file.
We are doing the latter.

doc: fix broken links to other functions

doc: fix order of param descriptions

Match param names on header and source code

This is needed by gtk-doc (to be added later) to be able to properly
document the function.

doc: fix comments format

Update copyright

modprobe: fix error path when loading dependencies

demarchi> scenario is the following:
demarchi> modA depends on modB and modC
demarchi> if there's a race when trying to insert a dependency of a module, say
          modB, it will stop loading all the modules
demarchi> it should check by "module already loaded error"
demarchi> like it does for modA

modprobe: show is independent from verbose level.

"modprobe --quiet --show-depends" now works.

Replace NAME_MAX with PATH_MAX for module aliases

Module aliases can be bigger than NAME_MAX. So, replace with PATH_MAX
that is bigger enough to hold them.

Technically in some places NAME_MAX would be sufficient (those using
module names only), but they use functions that can be called with
alias. So increase the buffers in these cases to PATH_MAX too.

config: check if opening /proc/cmdline succeeded

tools/kmod-depmod: fix aliasing warning

Revert "tools/kmod-depmod: fix aliasing warning"

This reverts commit f63fc9e606449a36d26cc9a99431229e4efacdad. Wrong
author name. I'll apply it again later.

tools/kmod-depmod: fix aliasing warning