You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.7 KiB
41 lines
1.7 KiB
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.
|