Files
CMake/Help/variable/CMAKE_CROSSCOMPILING_EMULATOR.rst
Matt McCormick 7005dea005 CrossCompiling: Load CMAKE_CROSSCOMPILING_EMULATOR from environment
Read `CMAKE_CROSSCOMPILING_EMULATOR` from an environment variable of the
same name if not specified with `-D` or an initial cache value.

Along with existing environment variable settings such as
`CMAKE_TOOLCHAIN_FILE`, cross compilation configuration can be more
completely set via environment variables.

Suggested-by: Henry Schreiner <henryschreineriii@gmail.com>
2023-06-13 13:58:44 -04:00

24 lines
834 B
ReStructuredText

CMAKE_CROSSCOMPILING_EMULATOR
-----------------------------
.. versionadded:: 3.3
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.
.. versionadded:: 3.15
If this variable contains a :ref:`semicolon-separated list <CMake Language
Lists>`, then the first value is the command and remaining values are its
arguments.
.. versionadded:: 3.28
This variable can be initialized via an
:envvar:`CMAKE_CROSSCOMPILING_EMULATOR` environment variable.
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.