CMAKE_GENERATOR_PLATFORM

Generator-specific target platform specification provided by user.

Some CMake generators support a target platform name to be given to the native build system to choose a compiler toolchain. If the user specifies a platform name (e.g. via the cmake(1) -A option or via the CMAKE_GENERATOR_PLATFORM environment variable) the value will be available in this variable.

The value of this variable should never be modified by project code. A toolchain file specified by the CMAKE_TOOLCHAIN_FILE variable may initialize CMAKE_GENERATOR_PLATFORM. Once a given build tree has been initialized with a particular value for this variable, changing the value has undefined behavior.

Platform specification is supported only on specific generators:

• For Visual Studio Generators with VS 2005 and above this specifies the target architecture.
• For Green Hills MULTI this specifies the target architecture.

See native build system documentation for allowed platform names.

Visual Studio Platform Selection

On Visual Studio Generators the selected platform name is provided in the CMAKE_VS_PLATFORM_NAME variable.