kyua-test man page
test — Runs tests
|test|| [--build-root |
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:
- 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.
- Specifies the Kyuafile to process. Defaults to a
Kyuafilefile in the current directory.
- 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).