You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
28 lines
1.2 KiB
28 lines
1.2 KiB
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 Ninja generator, setting this property to ``ON``, 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 ``ON``, ``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 be
|
|
not be enabled, in order to prevent possible race conditions.
|