|
|
|
|
JOB_POOLS
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Ninja only: List of available pools.
|
|
|
|
|
|
|
|
|
|
A pool is a named integer property and defines the maximum number
|
|
|
|
|
of concurrent jobs which can be started by a rule assigned to the pool.
|
|
|
|
|
The ``JOB_POOLS`` property is a semicolon-separated list of
|
|
|
|
|
pairs using the syntax ``NAME=integer`` (without a space after the equality sign).
|
|
|
|
|
|
|
|
|
|
For instance:
|
|
|
|
|
|
|
|
|
|
.. code-block:: cmake
|
|
|
|
|
|
|
|
|
|
set_property(GLOBAL PROPERTY JOB_POOLS two_jobs=2 ten_jobs=10)
|
|
|
|
|
|
|
|
|
|
Defined pools could be used globally by setting
|
|
|
|
|
:variable:`CMAKE_JOB_POOL_COMPILE` and :variable:`CMAKE_JOB_POOL_LINK`
|
|
|
|
|
or per target by setting the target properties
|
|
|
|
|
:prop_tgt:`JOB_POOL_COMPILE` and :prop_tgt:`JOB_POOL_LINK`.
|
|
|
|
|
:command:`Custom commands <add_custom_command>` and
|
|
|
|
|
:command:`custom targets <add_custom_target>` can specify pools using the
|
|
|
|
|
option ``JOB_POOL``.
|
|
|
|
|
Using a pool that is not defined by ``JOB_POOLS`` causes
|
|
|
|
|
an error by ninja at build time.
|
|
|
|
|
|
|
|
|
|
If not set, this property uses the value of the :variable:`CMAKE_JOB_POOLS`
|
|
|
|
|
variable.
|
|
|
|
|
|
|
|
|
|
Build targets provided by CMake that are meant for individual interactive
|
|
|
|
|
use, such as ``install``, are placed in the ``console`` pool automatically.
|
