CMake/Help/prop_gbl/INSTALL_PARALLEL.rst

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.