| INSTALL_PARALLEL |
| ---------------- |
| |
| .. versionadded:: 3.30 |
| |
| Enables parallel installation option for a project. The install code for each |
| subdirectory added with ``add_subdirectory`` can run independently. |
| |
| When using the :ref:`Ninja Generators`, enabling this property causes |
| ``install/local`` targets have the console pool disabled, allowing them to run |
| concurrently. |
| |
| This property also provides the target ``install/parallel``, which has an |
| explicit dependency on the ``install/local`` target for each subdirectory. |
| |
| .. versionadded:: 3.31 |
| |
| When this property is enabled, ``cmake --install`` can be given the ``-j <jobs>`` |
| or ``--parallel <jobs>`` option to specify a maximum number of jobs. |
| The :envvar:`CMAKE_INSTALL_PARALLEL_LEVEL` environment variable specifies a |
| default parallel level if this option is not provided. |
| |
| Calls to :command:`install(CODE)` or :command:`install(SCRIPT)` might depend |
| on actions performed by an earlier :command:`install` command in a different |
| directory such as files installed or variable settings. If the project has |
| such order-dependent installation logic, parallel installation should |
| not be enabled, in order to prevent possible race conditions. |
