7521da2852
This variable can be useful in cross-compiling contexts where the sysroot is read-only or where the sysroot should otherwise remain pristine. If the new CMAKE_STAGING_PREFIX variable is set, it is used instead of CMAKE_INSTALL_PREFIX when generating the installation rules in cmake_install.cmake. This way, the CMAKE_INSTALL_PREFIX variable always refers to the installation prefix on the target device, regardless of whether host==target. If any -rpath paths passed to the linker contain the CMAKE_STAGING_PREFIX, the matching path fragments are replaced with the CMAKE_INSTALL_PREFIX. Matching paths in the -rpath-link are not transformed. The cross-prefix usr-move workaround is assumed not to require extension regarding CMAKE_STAGING_PREFIX. The staging area is a single prefix, so there is no scope for cross-prefix symlinks. The CMAKE_INSTALL_PREFIX is still used to determine the workaround path, and that variable remains the relevant one even if CMAKE_STAGING_PREFIX is used. If the generated export files are deployed to the target, the workaround will still be in place, and still be employed if required.
16 lines
692 B
ReStructuredText
16 lines
692 B
ReStructuredText
CMAKE_FIND_NO_INSTALL_PREFIX
|
|
----------------------------
|
|
|
|
Ignore the :variable:`CMAKE_INSTALL_PREFIX` when searching for assets.
|
|
|
|
CMake adds the :variable:`CMAKE_INSTALL_PREFIX` and the
|
|
:variable:`CMAKE_STAGING_PREFIX` variable to the
|
|
:variable:`CMAKE_SYSTEM_PREFIX_PATH` by default. This variable may be set
|
|
on the command line to control that behavior.
|
|
|
|
Set :variable:`CMAKE_FIND_NO_INSTALL_PREFIX` to TRUE to tell find_package not
|
|
to search in the :variable:`CMAKE_INSTALL_PREFIX` or
|
|
:variable:`CMAKE_STAGING_PREFIX` by default. Note that the
|
|
prefix may still be searched for other reasons, such as being the same prefix
|
|
as the CMake installation, or for being a built-in system prefix.
|