| CMAKE_SYSTEM_PROCESSOR |
| ---------------------- |
| |
| When not cross-compiling, this variable has the same value as the |
| :variable:`CMAKE_HOST_SYSTEM_PROCESSOR` variable. In many cases, |
| this will correspond to the target architecture for the build, but |
| this is not guaranteed. (E.g. on Windows, the host may be ``AMD64`` |
| even when using a MSVC ``cl`` compiler with a 32-bit target.) |
| |
| When cross-compiling, a :variable:`CMAKE_TOOLCHAIN_FILE` should set |
| the ``CMAKE_SYSTEM_PROCESSOR`` variable to match target architecture |
| that it specifies (via :variable:`CMAKE_<LANG>_COMPILER` and perhaps |
| :variable:`CMAKE_<LANG>_COMPILER_TARGET`). |
