kyua-test man page
test — Runs tests
|test||[--build-root path] [--kyuafile file] [--results-file file] [test_filter1 .. test_filterN]|
The test command runs the tests of a test suite and records the results into a new results file.
The optional arguments to test are used to select which test programs or test cases to run. These are filters and are explained in more detail in kyua-test-filters(7).
The following subcommand options are recognized:
- --build-root path
Specifies the build root in which to find the test programs referenced by the Kyuafile, if different from the Kyuafile's directory. See kyua-build-root(7) for more information.
- --kyuafile path, -k path
Specifies the Kyuafile to process. Defaults to a
Kyuafilefile in the current directory.
- --results-file path, -s path
Specifies the results file to create. Defaults to ‘LATEST’, which causes test to automatically generate a new results file for the test run. See kyua-results-files(7) for more information.
You can later inspect the results of the test run in more detail by using kyua-report(1) or you can execute a single test case with debugging functionality by using kyua-debug(1).
The test command returns 0 if all executed test cases pass or 1 if any of the executed test cases fails or if any of the given test case filters does not match any test case.
Additional exit codes may be returned as described in kyua(1).
kyua(1), kyua-atf-interface(7), kyua-build-root(7), kyua-db-exec(1), kyua-plain-interface(7), kyua-results-files(7), kyua-tap-interface(7), kyua-test-filters(7).