testsuite: add tests to modprobe --show-depends

test 1 - check whether modprobe outputs the right thing when
using --show-depends is used with already loaded modules.

test 2 - check whether modprobe outputs the right thing when
using --show-depends with modules not loaded yet

testsuite: update README file

- Tell about TESTSUITE_MAIN and DEFINE_TEST macros
- Align item bodies and break on 80 chars

testsuite: macronify test definitions

testsuite: macronify main function

testsuite: libtestsuite depends on individual components

Ensure this dependency is explicit in the Makefile so rebuilding just
one test works correctly. Also reduce some repetition in the test LDADD
bits by adding a new TESTSUITE_LDADD variable.

libkmod-module: probe: Fix ignore-loaded flag not being applied

kmod 5

modinfo: handle arguments more carefully

A simple case of breakage before this commit:

    $ touch aes
    $ modinfo aes
    filename:       /tmp/aes
    ERROR: could not get modinfo from 'aes': Invalid argument

Add a new is_module_filename() function that attempts to do more than
just check if the passed argument is a regular file. We look at the name
for a '.ko' string, and if that is found, ensure it is either at the end
of the string or followed by another '.' (for .gz and .xz modules, for
instance). We don't make this second option conditional on the way the
tools are built with compression support; the file is a module file
regardless and should always be treated that way.

When doing this, and noticed in the test suite output, we open the
system modules index unconditionally, even if it is never going to be
used during the modinfo call, which is the case when passing module
filenames directly. For only one module there's not much advantage in
pre-loading the index, so just remove the call to kmod_load_resources().

With-help-from: Dave Reisner <dreisner@archlinux.org>
[lucas.demarchi@profusion.mobi: remove call to kmod_load_resources()]

Add WARNING file for test dir and improve testsuite README

testsuite: add README

libkmod-module: probe: return -EEXIST if told to do so

Commit "af9572c lib/module: check initstate before inserting module"
removed the check for "we should return -EEXIST" and moved it back to
the start of the function. The problem with this is the following
scenario:

- We check if module is in kernel -> no
- We insert the dependencies
<-- External program loads
the module
- We check if module is in kernel -> yes
- We return 0, when we should return -EEXIST

libkmod-module: probe: rename flag to be more meaningful

test-conversion: remove test/test-{insmod,rmmod,rmmod2}

These are covered by the various test cases in testsuite/test-init.

test-conversion: remove test/test-init

This was already converted to testsuite/test-init.

test-conversion: remove test/test-loaded

This was already converted to testsuite/test-loaded.

Update .gitignore files

Add kmod-* prefixed tool names, add 'tags' in root directory (for ctags,
matches cscope.out ignore already in there), and prefix tools/ entries
with '/' so they are absolute ignores and don't apply to subdirectories.

Fix simple grammar issue

Fix unaligned memory access in hash function

Use a function to properly get an unsigned short from memory that is
possibly unaligned.

Note that it implicitly fixes a small bug in the hash function that
was introduced when modifying the eina code: the line "hash ^= key[2]
<< 18;" is supposed to be accessing the 3rd byte of the remainder of
the input, but when 'it' was introduced, 'key' ('data' in eina code)
was no longer incremented, so this ended up accessing the 3rd byte of
the input from the beginning. This is fixed by iterating over 'key',
like the eina code does.

Before this patch depmod was failing on ARMv5 and possibly others that
don't have unaligned access. They do not calculate correctly the
dependencies as shown below:

[root@alarm ~]# modinfo bridge
filename: /lib/modules/2.6.39.4/kernel/net/bridge/bridge.ko
version: 2.3
license: GPL
srcversion: 6B583530AE2B39C7E2317BF
depends: stp,llc
vermagic: 2.6.39.4 preempt mod_unload ARMv5
[root@alarm ~]# depmod
[root@alarm ~]# cat /lib/modules/2.6.39.4/modules.dep |grep bridge
kernel/net/bridge/bridge.ko:
[root@alarm ~]#

See how modinfo properly lists the dependencies, but modules.dep which
depmod generates does not contain them. As a result, most kernel
modules fail to load because their dependencies are not loaded by
modprobe.

TODO: add task to write testsuite/README

man: insmod: we don't handle modules from stdin

- Gah, kmod insmod can't load from stdin anymore. :/
- What's the use case?
- zcat module.ko.gz | insmod - (but the new insmod apparently can load .gz fine)
- yes... just insmod module.ko.gz
- and actually insmod(8) says it works. :)

Not anymore...

depmod: Dont use errno unconditionally

fopen() will not reset errno if it succeeds so we should
make sure that we only use errno in error cases.

Also fix the diagnostic messages to not use strerror
when there is no error since strerror will not return
anything useful in this case

fix building and cleaning of manpages

- add modules.dep as an explicit dependency of modules.dep.bin to ensure
  parallel builds don't fail
- add generated man pages to CLEANFILES

modprobe: avoid breaking on insertion failure

lib/module: check initstate before inserting module

This applies to both the high level probe_insert_module() and the
underlying insert_module() functions. By checking module initstate prior
to inserting a module, we can avoid a lot of needless work just to find
out that the init_module call fails with EEXIST.

This implements a helper function, module_is_inkernel, to return a
boolean value describing if a module is live, coming, or builtin.

whitespace fix -- no logical code changes

fix manpage build and install.

just build and install manpages if tools are enabled.

List stub modules.dep.bin in proper variable.

improve logging to mention context.

Just printing the errno string such as "%m\n" is not enough to help
debug or users understand the problem.

Change to provide more context on the failing operation.

improve log when debugging.

Some messages may happen more than once in the same function and
discovering the line is hard. Now we print the actual log priority
that exposed the message as well as filename and line.

NOTE: We should consider printing the log priority in the non-debug
version as well.

libkmod: organize public header

Prepare for API bump

modprobe: properly handle errors from init_module

Effectively catch and the zero and non-zero cases and error out
appropriately. Note that -EEXIST will only ever be returned when
KMOD_PROBE_STOP_ON_ALREADY_LOADED is set as a probe_insert_module flag.

libkmod-module: probe: remove useless KMOD_PROBE_STOP_ON_COMMAND

libkmod-module: probe: return -EEXIST if told to stop on already loaded

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