btrfs-progs: tests: document exported testsuite

Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2018-02-08 18:44:41 +01:00
parent dbb8c9d19e
commit 9aa0c422b8
1 changed files with 25 additions and 0 deletions

View File

@ -201,6 +201,31 @@ the fuzz tests always succeed when run on random checked out. This helps
bisectability.
# Exported testsuite
The tests are typically run from git on binaries built from the git sources. It
is possible to extract only the testsuite files and run it independently. Use
```shell
$ make testsuite
```
This will gather scripts and generate `tests/btrfs-progs-tests.tar.gz`. The
files inside the tar are in the top level directory, make sure you extract
the contents to an empty directory. From there you can start the tests as
described above (the non-make variant).
By default the binaries found in `$PATH` are used, this will normally mean the
system binaries. You can also override the `$TOP` shell variable and this
path will be used as prefix for all btrfs binaries inside the tests.
There are some utilities that are not distributed but are necessary for the
tests. They are in the top level directory of the testsuite and their path
cannot be set.
The tests assume write acesss to their directories.
# Coding style, best practices
## do