ГРУППЫ_РЕСУРСОВ

Указывает ресурсы, необходимые для теста, сгруппированные таким образом, чтобы это имело смысл для теста. См. распределение ресурсов для получения дополнительной информации о том, как эта свойство интегрируется в функцию распределения ресурсов CTest.

Свойство RESOURCE_GROUPS представляет собой список, разделённый точкой с запятой описаний групп. Каждый элемент состоит из необязательного числа групп, использующих описание, за которым следует ряд требований к ресурсам для этих групп. Эти требования (и число групп) разделяются запятыми. Требования к ресурсам состоят из имени типа ресурса, за которым следует двоеточие и целое неотрицательное число, указывающее количество слотов, требуемых для одного ресурса данного типа.

Свойство RESOURCE_GROUPS сообщает CTest, какие ресурсы, сгруппированные таким образом, чтобы это имело смысл для теста, тест ожидает использовать. Сам тест должен прочитать переменные среды, чтобы определить, какие ресурсы были выделены для каждой группы. Например, каждая группа может соответствовать процессу, который тест запустит при выполнении.

Рассмотрим следующий пример:

add_test(NAME MyTest COMMAND MyExe)
set_property(TEST MyTest PROPERTY RESOURCE_GROUPS
  "2,gpus:2"
  "gpus:4,crypto_chips:2")

В этом примере есть два описания групп (неявным образом разделённые точкой с запятой). Содержимое первого описания — 2,gpus:2. Это описание указывает на 2 группы, каждая из которых требует 2 слота с одного графического процессора. Содержимое второго описания — gpus:4,crypto_chips:2. Это описание не указывает количество групп, поэтому предполагается значение по умолчанию 1. Эта единственная группа требует 4 слота с одного графического процессора и 2 слота с одного криптографического чипа. В общей сложности для этого теста указано 3 группы ресурсов, каждая со своими уникальными требованиями.

Обратите внимание, что количество слотов после типа ресурса указывает слоты с одного экземпляра ресурса. Если группа ресурсов может допускать получение слотов от разных экземпляров одного и того же ресурса, она может указать это, разделив спецификацию на несколько требований по одному слоту. Например:

add_test(NAME MyTest COMMAND MyExe)
set_property(TEST MyTest PROPERTY RESOURCE_GROUPS
  "gpus:1,gpus:1,gpus:1,gpus:1")

В этом случае единственная группа ресурсов указывает, что ей нужны четыре слота графического процессора, все из которых могут поступать из разных графических процессоров (хотя это не обязательно; CTest может всё ещё назначить слоты с одного графического процессора).

Когда CTest устанавливает переменные среды для теста, он назначает номер группы на основе описания группы, начиная с 0 слева и с номера групп минус 1 справа. Например, в приведённом выше примере две группы в первом описании будут иметь идентификаторы 0 и 1, а единственная группа во втором описании будет иметь идентификатор 2.

Как свойство RESOURCE_GROUPS, так и RESOURCE_LOCK служат схожим целям, но они различны и ортогональны. Ресурсы, указанные в RESOURCE_GROUPS, не влияют на RESOURCE_LOCK, и наоборот. В то время как RESOURCE_LOCK — это более простое свойство, используемое для блокировки одного глобального ресурса, RESOURCE_GROUPS — более продвинутое свойство, которое позволяет нескольким тестам одновременно использовать несколько ресурсов одного типа, указывая их потребности с высокой детализацией.