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 Kyuafile file 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).

Exit Status

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).

See Also

kyua(1), kyua-report(1)

Referenced By

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).

July 28, 2014