cmake/Help/envvar/CTEST_PARALLEL_LEVEL.rst

23 lines
804 B
ReStructuredText
Raw Normal View History

2018-01-26 17:06:56 +01:00
CTEST_PARALLEL_LEVEL
--------------------
2019-11-11 23:01:05 +01:00
.. include:: ENV_VAR.txt
2024-04-14 22:45:38 +02:00
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.