CMAKE_FIND_USE_INSTALL_PREFIX — CMake 4.4.0 Documentation

# CMAKE_FIND_USE_INSTALL_PREFIX

Added in version 3.24.

Controls the default behavior of the following commands for whether or not to search the locations in the `CMAKE_INSTALL_PREFIX` and `CMAKE_STAGING_PREFIX` variables.

- `find_program()`

- `find_library()`

- `find_file()`

- `find_path()`

- `find_package()`

This is useful in cross-compiling environments.

Due to backwards compatibility with `CMAKE_FIND_NO_INSTALL_PREFIX`, the behavior of the find command change based on if this variable exists.

CMAKE_FIND_USE_INSTALL_PREFIX | CMAKE_FIND_NO_INSTALL_PREFIX | Search
--- | --- | ---
Not Defined | On | NO
Not Defined | Off || Not Defined | YES
Off | On | NO
Off | Off || Not Defined | NO
On | On | YES
On | Off || Not Defined | YES

By default this variable is not defined. Explicit options given to the above commands take precedence over this variable.

See also the `CMAKE_FIND_USE_CMAKE_PATH`, `CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`, `CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`, `CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`, `CMAKE_FIND_USE_PACKAGE_REGISTRY`, and `CMAKE_FIND_USE_PACKAGE_ROOT_PATH` variables.