# vcpkg_execute_required_process Execute a process with logging and fail the build if the command fails. ## Usage ```cmake vcpkg_execute_required_process( COMMAND <${PERL}> [...] WORKING_DIRECTORY <${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-dbg> LOGNAME ) ``` ## Parameters ### ALLOW_IN_DOWNLOAD_MODE Allows the command to execute in Download Mode. [See execute_process() override](../../scripts/cmake/execute_process.cmake). ### COMMAND The command to be executed, along with its arguments. ### WORKING_DIRECTORY The directory to execute the command in. ### LOGNAME The prefix to use for the log files. This should be a unique name for different triplets so that the logs don't conflict when building multiple at once. ## Examples * [ffmpeg](https://github.com/Microsoft/vcpkg/blob/master/ports/ffmpeg/portfile.cmake) * [openssl](https://github.com/Microsoft/vcpkg/blob/master/ports/openssl/portfile.cmake) * [boost](https://github.com/Microsoft/vcpkg/blob/master/ports/boost/portfile.cmake) * [qt5](https://github.com/Microsoft/vcpkg/blob/master/ports/qt5/portfile.cmake) ## Source [scripts/cmake/vcpkg_execute_required_process.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_execute_required_process.cmake)