summaryrefslogtreecommitdiffstats
path: root/Help/envvar/CTEST_PARALLEL_LEVEL.rst
blob: 0ef01d5667c4b0232d34e0fa0bf6d4b0d570850f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
CTEST_PARALLEL_LEVEL
--------------------

.. include:: ENV_VAR.txt

Specify the number of tests for CTest to run in parallel.
For example, if ``CTEST_PARALLEL_LEVEL`` is set to 8, CTest will run
up to 8 tests concurrently as if ``ctest`` were invoked with the
:option:`--parallel 8 <ctest --parallel>` option.

.. versionchanged:: 3.29

  The value may be empty, or ``0``, to let ctest use a default level of
  parallelism, or unbounded parallelism, respectively, as documented by
  the :option:`ctest --parallel` option.

  On Windows, environment variables cannot be set to an empty string.
  CTest will interpret a whitespace-only string as empty.

  In CMake 3.28 and earlier, an empty or ``0`` value was equivalent to ``1``.

See :manual:`ctest(1)` for more information on parallel test execution.