Use the following commands to run the whole test suite:
$ cd /usr/tests
$ atf-run | atf-report
The above will go through all test programs in
/usr/tests recursively, execute them, and, at the very end, show a report of the results of the test suite. These results include the count of tests that succeeded (passed), the names of the tests that failed, and the count of the tests that were not executed (skipped) because the system configuration did not meet their requirements.
If you are interested in saving the whole output of the test suite execution so that you can later investigate failures, use the following idiom instead:
$ cd /usr/tests
$ atf-run | tee ~/tests.log | atf-report
The above command will save the raw output of the test suite in
~/tests.log, which you can later inspect manually to look for failures. Note that the file contains a copy of the ‘stdout' and ‘stderr' of each test case, which becomes valuable during debugging.
It is also possible to restrict which tests to execute so that only a small subsystem is tested; see
atf-run(1) for details. Additionally, it is also possible to run the test programs themselves by hand; see
atf-test-program(1) for more details, but be aware that you should only be doing this if you are debugging failing tests.