kmod/testsuite
Martin Pitt 4281cee076 testsuite: path wrapper: Fix open() with 3 arguments
Properly return the original libc return value in the case that open() is
called with 3 arguments.
2012-07-10 10:31:40 -03:00
..
rootfs-pristine testsuite: add test for install-commands loop 2012-06-06 01:57:33 -03:00
.gitignore testsuite: check if rootfs dir is dirty before running 2012-06-05 00:54:47 -03:00
delete_module.c testsuite: add GPL license 2012-01-26 17:02:05 -02:00
init_module.c testsuite: use right offset for module name 2012-06-21 11:30:56 -03:00
mkdir.c testsuite: add mkdir_p implementation 2012-06-05 00:54:47 -03:00
mkdir.h testsuite: add mkdir_p implementation 2012-06-05 00:54:47 -03:00
path.c testsuite: path wrapper: Fix open() with 3 arguments 2012-07-10 10:31:40 -03:00
README build-sys: add rule to pack rootfs 2012-02-08 02:04:10 -02:00
stripped-module.h testsuite: use right offset for module name 2012-06-21 11:30:56 -03:00
test-alias.c testsuite: macronify test definitions 2012-02-07 10:46:46 -02:00
test-blacklist.c test-conversion: convert test-blacklist to new infrastructure 2012-05-11 08:44:55 -03:00
test-dependencies.c test-conversion: convert test-get-dependencies to new infrastructure 2012-05-11 08:44:55 -03:00
test-init.c testsuite: separate insert and delete rootfs from modinfo 2012-06-05 00:54:47 -03:00
test-loaded.c testsuite: macronify test definitions 2012-02-07 10:46:46 -02:00
test-modinfo.c Mark functions with attribute noreturn 2012-02-08 20:32:31 -02:00
test-modprobe.c testsuite: Fix test description 2012-06-11 11:57:55 -03:00
test-new-module.c testsuite: macronify test definitions 2012-02-07 10:46:46 -02:00
test-testsuite.c Mark functions with attribute noreturn 2012-02-08 20:32:31 -02:00
testsuite.c testsuite: allow to export custom env vars 2012-06-06 01:45:30 -03:00
testsuite.h testsuite: allow to export custom env vars 2012-06-06 01:45:30 -03:00
uname.c Use %zu for size_t 2012-01-30 13:49:40 -02:00

testsuite

OVERVIEW
========

Kmod's testsuite was designed to automate the process of running tests with
different scenarios, configurations and architectures. The idea is that once we
received a bug report, we reproduce it using the testsuite so we avoid
recurring on the same bug in future.


FEATURES
========

- Isolate each test by running them in separate processes;
- Exec a binary, so we can test the tools and not only the lib API
- Fake accesses to filesystem so we can provide a test rootfs with all the
  configuration, indexes, etc that test needs to be executed.
- Fake calls to init_module(), delete_module() and uname(), so we don't have to
  run tests as root and figure out how to deal with different architectures.

HOW TO ADD A TEST
=================

The simplest way to add a test is to copy and paste one already there. Most of
the options you can have are covered by another tests. This is what you need to
pay attention when writing a test:

1 - Look at testsuite.h, struct test, to see all the options available.

2 - Use TESTSUITE_MAIN and DEFINE_TEST to add new tests. Don't forget to fill
    its description.

3 - If you want testsuite to compare the stdout/stderr of your tests in order
    to check if it worked or not, fill in output.{stderr,stdout} the file with
    the expected output. Bare in mind the same file is used for all
    architectures, so don't print arch-dependent content if you are comparing
    the output.

4 - Fill in the config vector. Setting any of these configuration will make
    testsuite to export LD_PRELOAD with the necessary override libs before
    executing the test. If you are not exec'ing an external binary, you need to
    pass "need_spawn = true" below, otherwise it will not work (LD_PRELOAD is
    only applied when exec'ing a binary). See each config description in
    testsuite.h

5 - need_spawn: if testsuite will exec itself before running a test

6 - expected_fail: if that test is expected to fail, i.e. the return code is
    expected not to be 0.

7 - If you added files to the rootfs, be sure to compact it back to
    rootfs.tar.xz before sending patches: use 'make testsuite-pack-rootfs'

8 - Tests can be run individually, outside of 'make check'. strace and gdb work
    too, as long as you tell them to operate on child process.

9 - Make sure test passes when using "default" build flags, i.e. by running
    bootstrap-configure instead of simpler bootstrap/autogen.sh