execute_process

Выполнение одного или нескольких дочерних процессов.

execute_process(COMMAND <cmd1> [args1...]]
                [COMMAND <cmd2> [args2...] [...]]
                [WORKING_DIRECTORY <directory>]
                [TIMEOUT <seconds>]
                [RESULT_VARIABLE <variable>]
                [OUTPUT_VARIABLE <variable>]
                [ERROR_VARIABLE <variable>]
                [INPUT_FILE <file>]
                [OUTPUT_FILE <file>]
                [ERROR_FILE <file>]
                [OUTPUT_QUIET]
                [ERROR_QUIET]
                [OUTPUT_STRIP_TRAILING_WHITESPACE]
                [ERROR_STRIP_TRAILING_WHITESPACE])

Выполняет заданную последовательность одного или нескольких команд, при этом стандартный вывод каждого процесса направляется в стандартный ввод следующего. Для всех процессов используется единственная труба стандартной ошибки.

Параметры:

COMMAND

Командная строка дочернего процесса.

CMake выполняет дочерний процесс, используя API операционной системы напрямую. Все аргументы передаются ДОСЛОВНО дочернему процессу. Не используется промежуточный оболочка, поэтому операторы оболочки, такие как > обрабатываются как обычные аргументы. (Используйте параметры INPUT_*, OUTPUT_*, и ERROR_* для перенаправления stdin, stdout и stderr.)

WORKING_DIRECTORY

Указанный каталог будет установлен как текущий рабочий каталог дочерних процессов.

TIMEOUT

Дочерние процессы будут завершены, если они не завершатся в течение указанного количества секунд (разрешены дроби).

RESULT_VARIABLE

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

OUTPUT_VARIABLE, ERROR_VARIABLE

Указанные переменные будут установлены с содержимым труб стандартного вывода и стандартной ошибки соответственно. Если одноимённые переменные указаны для обеих труб, их вывод будет объединён в порядке, определённом производительностью.

INPUT_FILE, OUTPUT_FILE, ERROR_FILE

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

OUTPUT_QUIET, ERROR_QUIET

Результаты стандартного вывода или стандартной ошибки будут проигнорированы.

Если для одной и той же трубы указано более одного параметра OUTPUT_* или ERROR_*, приоритет не определён. Если не указаны параметры OUTPUT_* или ERROR_*, вывод будет совместно использоваться с соответствующими трубами самого процесса CMake.

Команда execute_process() — это новая, более мощная версия команды exec_program(), но старая команда сохранена для совместимости. Обе команды выполняются во время обработки проекта CMake перед генерацией системы сборки. Используйте add_custom_target() и add_custom_command() для создания пользовательских команд, выполняемых во время сборки.