testsuite: allow for expected failure of tests

Adds a bool to the test struct called 'expected_fail' which can be set
to flip the logic used to determine success and failure. Messaging is
also changed to reflect an unexpected pass or expected fail. This can be
used to write tests which may represent functionality desirable for a
future release.

modprobe: post-remove module deps with 0 refcnt

This commit looks shockingly similar to 0e9bd2d1 because SOMEONE decided
to remove it in a872bba in a glorious frenzy of refactoring.

kmod-modprobe: migrate to kmod_module_probe_insert_module()

libkmod-module: probe: add flag to dry-run

libkmod-module: probe: add flag to ignore loaded modules

We need a way to tell libkmod to ignore loaded modules, so modprobe can
tell it to dry-run and show dependencies. However there's a conflict
with two flags. KMOD_PROBE_STOP_ON_ALREADY_LOADED prevails if passed
together with KMOD_PROBE_IGNORE_LOADED.

libkmod-module: probe: add print_action callback

This allows to implement dry-run in modprobe without exporting
kmod_module_get_probe_list().

libkmod-module: probe: add room in flags for future extension

Breaking flags is one of the reasons next version will need to bump ABI.
In future we don't want to bump it just because of this.

libkmod-module: probe: ignore-command flag can't be used in return

libkmod-module: probe: remove useless flag to stop on failure

We always want to stop if module failed to loaded due to unknown reason.

libkmod-module: probe: add flag to stop loading on already loaded

It's not as simple as tell user to check if the module is loaded before
calling this function. Due to race conditions, module might not be
loaded before the function call, but fail later because another process
inserted it.

testsuite: check if dots are allowed in aliases

testsuite: add test for kmod_module_new_from_name()

Check if module names are being correctly normalized.

libkmod-module: split creation of new modules to share code

Share code of module creation among the several new functions. With this
we let the alias/modname/path parsing to the separate functions, and the
rest with the common one.

This fixes the issue of alias names not being able to contain dots.

Partially fix parsing of alias with dots

Alias names may contain dots. However since kmod_module_from_alias()
still calls kmod_module_new_from_name(), the bug is not entirely fixed,
and will be completely corrected in a later patch.

libkmod-module: probe: add flag to ignore commands

libkmod-module: probe: change insertion to cover more use cases

Split kmod_module_probe_insert_module() in 2:
1) Get list of modules to be loaded
2) Iterate the list, loading the module

With this in future we will be able to cover use cases of modprobe,
that has a logic a bit more complicated.

With this we also change the logic to detect dependency loops: instead
of checking the recursion every STEP times, we now keep a field in
kmod_module, marking it as visited. We simply ignore already visited
modules and thus we break loops.

libkmod-module: add visited field

This field can be used to iterate the modules, controlling whether we
are revisiting a certain module. A function to clear the values in all
modules is needed since when we are iterating, we don't know if the
module is created anew or if it's picked from the pool. Therefore we
can't know if the field is true because of a previous iteration or if
the module was indeed already visited.

build-sys: fix make dist

build-sys: declare rootfs.tar.xz as dep of rootfs/

This forces make to re-extract the tarball when it's changed

testsuite: let stat.h take care of stat64

This fixes testsuite build in 32 bits machines.

Use %zu for size_t

Remove warning on 32 bits systems.

testsuite: remove unneeded call to memset()

libkmod: Fix handling of square brackets expressions in function alias_normalize

testsuite: add test for function alias_normalize

modprobe: print end of configuration files

build-sys: extract rootfs for make check

Commit "d2c2b8b build-sys: autotoolify build of check libraries" removed
rootfs extraction. Add it back.

testsuite: add GPL license

testsuite: trap calls to delete_module() including simple test

build-sys: autotoolify build of check libraries

Many thanks to Iván Briano (sachieru@gmail.com) for pointing out this
thread in libtool mailing list:
http://www.mail-archive.com/libtool@gnu.org/msg09627.html

Passing '-rpath /nowhere' in LDFLAGS we are able to create shared libs
that are not installed.

testsuite: add trap to init_module() including simple test

elf: privately export kmod_elf_get_section()

This function is used to find a certain section in ELF file. It will be
used to get the modname from an ELF file.

testsuite: add test for modinfo

These ext4 modules were sent by Jon Master so we can test the result of
modinfo with modules generated for different architectures.

They are now added to testsuite and their output tested automatically.

testsuite: remind users to build tools

testsuite: add colors to test output

testsuite: add simple test for list of loaded modules

testsuite: match outputs of test with a known correct one

Tests may put the correct output in a file and tell testsuite to check
if it matches the output from the test running.

Testsuite compares the outputs while running the test: it creates a pipe
between parent and child; parent reads both stdout and stderr from child
and compares with the correct output.

testsuite: separate child from parent

testsuite: allow to run tests outside of top_buildir

In order to locate where the shared libs to be preloaded are we need to
reference them using abs_top_buildir. Otherwise we are limited to
running tests from there.

testsuite: add trap to opendir() including tests

testsuite: add trap to stat() and friends including tests

Add trap to stat(): we need to trap other functions too, depending on
stat.h, the function from glibc that is actually called may be stat64 or
__xstat() too.

testsuite: add trap to open() including tests

testsuite: add trap to fopen() including tests

testsuite: fake kernel 4.0.20-kmod is out

Go get it while it's fresh :-). Test fake results of "uname -r" by
LD_PRELOAD'ing uname.so.

testsuite: export environment with flags and LD_PRELOAD

A certain config can add flags and each flag may be associated with a
lib to LD_PRELOAD. It's now done for uname(2), which requires uname.so
in order to trap the calls.

Other trap will be added in later commits.

testsuite: move oneshot to inside the test struct

testsuite: trap calls to uname

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