CMAKE_FIND_USE_INSTALL_PREFIX

.. versionadded:: 3.24

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

:command:find_program
:command:find_library
:command:find_file
:command:find_path
:command:find_package

This is useful in cross-compiling environments.

Due to backwards compatibility with :variable: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 :variable:CMAKE_FIND_USE_CMAKE_PATH, :variable:CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH, :variable:CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH, :variable:CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY, :variable:CMAKE_FIND_USE_PACKAGE_REGISTRY, and :variable:CMAKE_FIND_USE_PACKAGE_ROOT_PATH variables.