snippetbashTip

ctest — CMake test driver program. More information: <https://gitlab.kitware.com/cmake/community/-/wikis/doc

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandclictesttestprogramdrivermorecmake

Problem

How to use the ctest command: CMake test driver program. More information: <https://gitlab.kitware.com/cmake/community/-/wikis/doc/ctest/Testing-With-CTest>.

Solution

ctest — CMake test driver program. More information: <https://gitlab.kitware.com/cmake/community/-/wikis/doc/ctest/Testing-With-CTest>.

Run all tests defined in the CMake project, executing 4 [j]obs at a time in parallel:

ctest {{[-j|--parallel]}} {{4}} --output-on-failure

List available tests:

ctest {{[-N|--show-only]}}

Run a single test based on its name, or filter on a regex:

ctest --output-on-failure {{[-R|--tests-regex]}} '^{{test_name}}

Code Snippets

Run all tests defined in the CMake project, executing 4 [j]obs at a time in parallel

ctest {{[-j|--parallel]}} {{4}} --output-on-failure

List available tests

ctest {{[-N|--show-only]}}

Run a single test based on its name, or filter on a `regex`

ctest --output-on-failure {{[-R|--tests-regex]}} '^{{test_name}}$'

Context

tldr-pages: common/ctest

Revisions (0)

No revisions yet.