mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
597e421ba3
In commit 5de1e21659 (ctest: Allow passing -j without value to choose a
contextual default, 2024-03-06, v3.29.0-rc4~10^2) I misdiagnosed the
reason that the test could not set an empty environment variable on
Windows. It is actually a limitation of `set(ENV{VAR})` inherited from
its implementation using `_wputenv`. Process environment blocks can
contain empty environment variables.
Issue: #27285
22 lines
742 B
ReStructuredText
22 lines
742 B
ReStructuredText
CTEST_PARALLEL_LEVEL
|
|
--------------------
|
|
|
|
.. include:: include/ENV_VAR.rst
|
|
|
|
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.
|
|
|
|
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.
|