diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-09 13:08:37 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-09 13:08:37 +0000 |
| commit | 971e619d8602fa52b1bfcb3ea65b7ab96be85318 (patch) | |
| tree | 26feb2498c72b796e07b86349d17f544046de279 /tests/shell/README | |
| parent | Initial commit. (diff) | |
| download | nftables-upstream/1.0.9.tar.xz nftables-upstream/1.0.9.zip | |
Adding upstream version 1.0.9.upstream/1.0.9upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'tests/shell/README')
| -rw-r--r-- | tests/shell/README | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/tests/shell/README b/tests/shell/README new file mode 100644 index 0000000..3af17a9 --- /dev/null +++ b/tests/shell/README @@ -0,0 +1,35 @@ +This test suite is intended to perform tests on a higher level +than the other regression test suites. + +It can run arbitrary executables which can perform any test, not +limited to testing the nft syntax or netlink code (which is what +the regression tests do). + +To run the test suite (as root): + $ cd tests/shell + # ./run-tests.sh + +Test files are executable files matching the pattern <<name_N>>, +where N should be 0 in all new tests. All tests should return 0 on +success. + +Since they are located with `find', test files can be put in any +subdirectory. + +You can turn on a verbose execution by calling: + # ./run-tests.sh -v + +And generate missing dump files with: + # ./run-tests.sh -g <TESTFILE> + +Before each test file invocation, `nft flush ruleset' will be called. +Also, test file process environment will include the variable $NFT +which contains the nft command being tested. + +You can pass an arbitrary $NFT value as well: + # NFT=/usr/local/sbin/nft ./run-tests.sh + +Note that, to support usage such as NFT='valgrind nft', tests must +invoke $NFT unquoted. + +By default, the tests are run with the nft binary at '../../src/nft' |