JOB_POOLS — CMake 4.4.3-dirty Documentation

# 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:

    set_property(GLOBAL PROPERTY JOB_POOLS two_jobs=2 ten_jobs=10)

Defined pools can be used at different levels:

- Globally, by setting `CMAKE_JOB_POOL_COMPILE` and `CMAKE_JOB_POOL_LINK`.

- Per target, by setting the target properties `JOB_POOL_COMPILE` and `JOB_POOL_LINK`.

- `Custom commands` and `custom targets` can specify pools using the option `JOB_POOL`.

- Per-source, by setting the source file property `JOB_POOL_COMPILE`, in case some specific source files require to override their global or target assigned 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 `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.