| 1234567891011121314151617181920212223242526272829 |
- The CMake variable :variable:`CMAKE_FIND_ROOT_PATH` specifies one or more
- directories to be prepended to all other search directories. This
- effectively "re-roots" the entire search under given locations.
- Paths which are descendants of the :variable:`CMAKE_STAGING_PREFIX` are excluded
- from this re-rooting, because that variable is always a path on the host system.
- By default the :variable:`CMAKE_FIND_ROOT_PATH` is empty.
- The :variable:`CMAKE_SYSROOT` variable can also be used to specify exactly one
- directory to use as a prefix. Setting :variable:`CMAKE_SYSROOT` also has other
- effects. See the documentation for that variable for more.
- These variables are especially useful when cross-compiling to
- point to the root directory of the target environment and CMake will
- search there too. By default at first the directories listed in
- :variable:`CMAKE_FIND_ROOT_PATH` are searched, then the :variable:`CMAKE_SYSROOT`
- directory is searched, and then the non-rooted directories will be
- searched. The default behavior can be adjusted by setting
- |CMAKE_FIND_ROOT_PATH_MODE_XXX|. This behavior can be manually
- overridden on a per-call basis using options:
- ``CMAKE_FIND_ROOT_PATH_BOTH``
- Search in the order described above.
- ``NO_CMAKE_FIND_ROOT_PATH``
- Do not use the :variable:`CMAKE_FIND_ROOT_PATH` variable.
- ``ONLY_CMAKE_FIND_ROOT_PATH``
- Search only the re-rooted directories and directories below
- :variable:`CMAKE_STAGING_PREFIX`.
|
