diff options
| author | Matt McCormick <matt.mccormick@kitware.com> | 2015-03-28 18:18:38 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2015-04-08 13:06:22 (GMT) |
| commit | e942526b3d9e886da4ce832d9d3adb99cc5ede2f (patch) | |
| tree | 92eb25f78e80acf587c3066750f3eafce13202a9 /Help | |
| parent | 579c4bec6e2352448f78d9333f7382ff34a08e5a (diff) | |
| download | CMake-e942526b3d9e886da4ce832d9d3adb99cc5ede2f.zip CMake-e942526b3d9e886da4ce832d9d3adb99cc5ede2f.tar.gz CMake-e942526b3d9e886da4ce832d9d3adb99cc5ede2f.tar.bz2 | |
try_run: Use CMAKE_CROSSCOMPILING_EMULATOR.
If the CMAKE_CROSSCOMPILING_EMULATOR variable is defined, and
CMAKE_CROSSCOMPILING is TRUE, then use CMAKE_CROSSCOMPILING_EMULATOR to run
the try_run executables. This prevents the need to populate
TryRunResults.cmake when cross compiling.
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/command/try_run.rst | 3 | ||||
| -rw-r--r-- | Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst | 11 |
2 files changed, 11 insertions, 3 deletions
diff --git a/Help/command/try_run.rst b/Help/command/try_run.rst index 43ee219..e3bd57d 100644 --- a/Help/command/try_run.rst +++ b/Help/command/try_run.rst @@ -73,7 +73,8 @@ When cross compiling, the executable compiled in the first step usually cannot be run on the build host. The ``try_run`` command checks the :variable:`CMAKE_CROSSCOMPILING` variable to detect whether CMake is in cross-compiling mode. If that is the case, it will still try to compile -the executable, but it will not try to run the executable. Instead it +the executable, but it will not try to run the executable unless the +:variable:`CMAKE_CROSSCOMPILING_EMULATOR` variable is set. Instead it will create cache variables which must be filled by the user or by presetting them in some CMake script file to the values the executable would have produced if it had been run on its actual target platform. diff --git a/Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst b/Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst index fa6f1b7..95d2c7f 100644 --- a/Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst +++ b/Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst @@ -1,5 +1,12 @@ CMAKE_CROSSCOMPILING_EMULATOR ----------------------------- -Default value for the :prop_tgt:`CROSSCOMPILING_EMULATOR` target property of -executables. See that target property for additional information. +This variable is only used when :variable:`CMAKE_CROSSCOMPILING` is on. It +should point to a command on the host system that can run executable built +for the target system. + +The command will be used to run :command:`try_run` generated executables, +which avoids manual population of the TryRunResults.cmake file. + +It is also used as the default value for the +:prop_tgt:`CROSSCOMPILING_EMULATOR` target property of executables. |