cmake/Help/variable/CMAKE_SYSTEM_NAME.rst

24 lines
818 B
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
CMAKE_SYSTEM_NAME
-----------------
2015-11-17 17:22:37 +01:00
The name of the operating system for which CMake is to build.
See the :variable:`CMAKE_SYSTEM_VERSION` variable for the OS version.
2014-08-03 19:52:23 +02:00
2018-04-23 21:13:27 +02:00
Note that ``CMAKE_SYSTEM_NAME`` is not set to anything by default when running
in script mode, since it's not building anything.
2015-11-17 17:22:37 +01:00
System Name for Host Builds
^^^^^^^^^^^^^^^^^^^^^^^^^^^
``CMAKE_SYSTEM_NAME`` is by default set to the same value as the
:variable:`CMAKE_HOST_SYSTEM_NAME` variable so that the build
targets the host system.
System Name for Cross Compiling
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
``CMAKE_SYSTEM_NAME`` may be set explicitly when first configuring a new build
tree in order to enable :ref:`cross compiling <Cross Compiling Toolchain>`.
In this case the :variable:`CMAKE_SYSTEM_VERSION` variable must also be
set explicitly.