mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 02:08:27 +08:00
af9ed543b0
The `PROCESSES` test property name added for CMake 3.16 is too close to the existing `PROCESSORS` test property. Furthermore, the property in principle specifies groups of resources organized in a way that is meaningful to a particular test. The groups may often correspond to processes but they could have other meanings. Since the property name `PROCESSES` has not been in a final 3.16 release yet, simply rename it to `RESOURCE_GROUPS`. Fixes: #19914
19 lines
805 B
ReStructuredText
19 lines
805 B
ReStructuredText
RESOURCE_LOCK
|
|
-------------
|
|
|
|
Specify a list of resources that are locked by this test.
|
|
|
|
If multiple tests specify the same resource lock, they are guaranteed
|
|
not to run concurrently.
|
|
|
|
See also :prop_test:`FIXTURES_REQUIRED` if the resource requires any setup or
|
|
cleanup steps.
|
|
|
|
Both the :prop_test:`RESOURCE_GROUPS` and ``RESOURCE_LOCK`` properties serve
|
|
similar purposes, but they are distinct and orthogonal. Resources specified by
|
|
:prop_test:`RESOURCE_GROUPS` do not affect ``RESOURCE_LOCK``, and vice versa.
|
|
Whereas ``RESOURCE_LOCK`` is a simpler property that is used for locking one
|
|
global resource, :prop_test:`RESOURCE_GROUPS` is a more advanced property
|
|
that allows multiple tests to simultaneously use multiple resources of the
|
|
same type, specifying their requirements in a fine-grained manner.
|