ctest

Run all tests

$ ctest

$ ctest -V

$ ctest -R [test_name_pattern]

$ ctest -E [exclude_pattern]

$ ctest -j [4]

$ ctest --timeout [60]

$ ctest -N

$ ctest --rerun-failed

ctest [options]

ctest is CMake's test driver program that discovers and runs tests defined in CMake projects. It executes tests defined via CMake's add_test() command and provides detailed reporting of pass/fail status.
The tool supports parallel test execution, filtering by name or label, timeout enforcement, and rerunning failed tests. It integrates with CMake's build system and can be run from build directories after compilation.
ctest is commonly used in CI/CD pipelines for automated testing, and its output can be formatted for various continuous integration systems. It handles test dependencies, fixture setup/teardown, and can export results to various formats including JUnit XML.

-V, --verbose

Verbose output.

Run tests matching regex.

Exclude tests matching regex.

Run tests in parallel.

Per-test timeout.

List tests without running.

Only run previously failed tests.

Run tests with specific label.

Show output only for failed tests.

Must be run from a CMake build directory containing CTestTestfile.cmake. Tests must be defined in CMakeLists.txt using add_test(). Resource limits and timeouts apply per-test, not globally.

ctest was introduced as part of CMake by Kitware and has been part of the CMake suite since the early 2000s. It evolved alongside CMake to provide comprehensive testing infrastructure for cross-platform builds.

cmake(1), make(1)