| CMAKE_SYSTEM_NAME |
| ----------------- |
| |
| The name of the operating system for which CMake is to build. |
| See the :variable:`CMAKE_SYSTEM_VERSION` variable for the OS version. |
| |
| Note that ``CMAKE_SYSTEM_NAME`` is not set to anything by default when running |
| in script mode, since it's not building anything. |
| |
| 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. |
