mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-12-10 07:03:32 +08:00
f5c732b40d
* [portfile functions] Override execute_process() to accept ALLOW_IN_DOWNLOAD_MODE option * [vcpkg install] Set VCPKG_DOWNLOAD_MODE when using --only-downloads option * [vcpkg_find_acquire_program] Allow in Download Mode * Don't stop when build fails for a package * Download sources for all packages in dependency graph * Improve output messages * Enable acquiring MSYS packages in download mode * Documentation * Update documentation * execute_process() always fails on Download Mode * Regenerate docs and fix formatting * Run clang-format * Use _execute_process on vcpkg_from_<source> helpers * Fix calls to _execute_process() when not in Download Mode
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# 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}> [<arguments>...]
|
|
WORKING_DIRECTORY <${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-dbg>
|
|
LOGNAME <build-${TARGET_TRIPLET}-dbg>
|
|
)
|
|
```
|
|
## 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)
|