diff options
| author | Stephen Kelly <steveire@gmail.com> | 2013-04-13 12:46:57 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2013-11-19 17:39:39 (GMT) |
| commit | 7cd65c97fabd9f3249739a81dd1260a1e0b59ee1 (patch) | |
| tree | 27ba5ee0d30c9a59ed288806ca1ce40060dd4f0f /Help/command | |
| parent | 5096967ecd443f3d7477d823e7ffdffcc15a8ed1 (diff) | |
| download | CMake-7cd65c97fabd9f3249739a81dd1260a1e0b59ee1.zip CMake-7cd65c97fabd9f3249739a81dd1260a1e0b59ee1.tar.gz CMake-7cd65c97fabd9f3249739a81dd1260a1e0b59ee1.tar.bz2 | |
Add CMAKE_SYSROOT variable to set --sysroot when cross compiling.
As CMAKE_ROOT_FIND_PATH can be a list, a new CMAKE_SYSROOT is
introduced, which is never a list.
The contents of this variable is passed to supporting compilers
as --sysroot. It is also accounted for when processing implicit
link directories reported by the compiler, and when generating
RPATH information.
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/FIND_XXX_ROOT.txt | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/Help/command/FIND_XXX_ROOT.txt b/Help/command/FIND_XXX_ROOT.txt index 407375a..7f80dcb 100644 --- a/Help/command/FIND_XXX_ROOT.txt +++ b/Help/command/FIND_XXX_ROOT.txt @@ -1,10 +1,17 @@ The CMake 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. By -default it is empty. It is especially useful when cross-compiling to +default it 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 -CMAKE_FIND_ROOT_PATH and then the non-rooted directories will be +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. By using CMAKE_FIND_ROOT_PATH_BOTH |