ctest_update

Выполнить этап обновления CTest в качестве клиента панели мониторинга.

ctest_update([SOURCE <source-dir>]
             [RETURN_VALUE <result-var>]
             [VERSION_ONLY]
             [VERSION_OVERRIDE <version>]
             [CAPTURE_CMAKE_ERROR <result-var>]
             [QUIET])

Обновить дерево исходного кода из системы контроля версий и записать результаты в Update.xml для отправки командой ctest_submit().

Доступны следующие параметры:

SOURCE <source-dir>

Указать каталог исходного кода. Если он не задан, используется переменная CTEST_SOURCE_DIRECTORY.

RETURN_VALUE <result-var>

Сохранить в переменной <result-var> количество обновлённых файлов или -1 в случае ошибки.

VERSION_ONLY

Добавлено в версии 4.4.

Записать текущую извлечённую ревизию, не обновляя дерево исходного кода до другой версии. Это эквивалентно установке переменной CTEST_UPDATE_VERSION_ONLY.

VERSION_OVERRIDE <version>

Добавлено в версии 4.4.

Сообщить <version> в качестве текущей ревизии, не запрашивая и не обновляя дерево исходного кода. Это эквивалентно установке переменной CTEST_UPDATE_VERSION_OVERRIDE и имеет приоритет над VERSION_ONLY.

CAPTURE_CMAKE_ERROR <result-var>

Добавлено в версии 3.13.

Сохранить в переменной <result-var> значение -1, если при выполнении команды возникли ошибки, и предотвратить возврат ненулевого кода завершения командой ctest(1) в случае ошибки.

QUIET

Добавлено в версии 3.3.

Подавить все специфичные для CTest сообщения, не являющиеся сообщениями об ошибках, которые в противном случае выводились бы в консоль. CTest по-прежнему сообщит новую ревизию репозитория и обнаруженные конфликтующие файлы.

По умолчанию обновление следует ветке системы контроля версий, выбранной в данный момент в каталоге исходного кода. Параметры VERSION_ONLY и VERSION_OVERRIDE вместо этого записывают сведения о ревизии, не изменяя дерево исходного кода. Сведения о дополнительных переменных, изменяющих поведение ctest_update(), см. в документации этапа обновления CTest.