vcpkg/docs/maintainers/vcpkg_find_acquire_program.md

# vcpkg_find_acquire_program

Download or find a well-known tool.

## Usage
```cmake
vcpkg_find_acquire_program(<VAR>)
```
## Parameters
### VAR
This variable specifies both the program to be acquired as well as the out parameter that will be set to the path of the program executable.

## Notes
The current list of programs includes:

* 7Z
* ARIA2 (Downloader)
* BISON
* CLANG
* DARK
* DOXYGEN
* FLEX
* GASPREPROCESSOR
* GPERF
* PERL
* PYTHON2
* PYTHON3
* GIT
* GN
* GO
* JOM
* MESON
* NASM
* NINJA
* NUGET
* SCONS
* SWIG
* YASM

Note that msys2 has a dedicated helper function: [`vcpkg_acquire_msys`](vcpkg_acquire_msys.md).

## 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)
* [qt5](https://github.com/Microsoft/vcpkg/blob/master/ports/qt5/portfile.cmake)

## Source
[scripts/cmake/vcpkg_find_acquire_program.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_find_acquire_program.cmake)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs. 2017-05-25 14:33:16 +08:00			`# vcpkg_find_acquire_program`

			`Download or find a well-known tool.`

			`## Usage`
			```cmake
			`vcpkg_find_acquire_program(<VAR>)`
			```
			`## Parameters`
			`### VAR`
			`This variable specifies both the program to be acquired as well as the out parameter that will be set to the path of the program executable.`

			`## Notes`
			`The current list of programs includes:`

[vcpkg docs] Check for documentation generation in CI (#14614) * [vcpkg docs] Change how documenting port functions works Instead of using `##`, use comment blocks for documentation. Also, add some minor docs and change RST -> MD so we actually get docs generated. * add CI stuff * regenerate docs * fix vcpkg_find_acquire_program to not use _execute_process 2020-12-02 05:37:26 +08:00			`* 7Z`
			`* ARIA2 (Downloader)`
			`* BISON`
			`* CLANG`
			`* DARK`
			`* DOXYGEN`
			`* FLEX`
			`* GASPREPROCESSOR`
			`* GPERF`
			`* PERL`
			`* PYTHON2`
			`* PYTHON3`
			`* GIT`
			`* GN`
			`* GO`
			`* JOM`
			`* MESON`
			`* NASM`
			`* NINJA`
			`* NUGET`
			`* SCONS`
			`* SWIG`
			`* YASM`
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs. 2017-05-25 14:33:16 +08:00
			Note that msys2 has a dedicated helper function: [`vcpkg_acquire_msys`](vcpkg_acquire_msys.md).

			`## 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)`
			`* [qt5](https://github.com/Microsoft/vcpkg/blob/master/ports/qt5/portfile.cmake)`

			`## Source`
[vcpkg] Track hashes of cmake script helpers in consuming portfiles (#12254) * [vcpkg] Track hashes of cmake script helpers in consuming portfiles * [vcpkg] Format * [vcpkg_find_acquire_program] Use cpkg_from_sourceforge for FLEX and BISON Co-authored-by: Robert Schumacher <roschuma@microsoft.com> 2020-07-14 04:43:39 +08:00			`[scripts/cmake/vcpkg_find_acquire_program.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_find_acquire_program.cmake)`