| CMAKE_TOOLCHAIN_FILE | |
| -------------------- | |
| Path to toolchain file supplied to :manual:`cmake(1)`. | |
| This variable is specified on the command line when cross-compiling with CMake. | |
| It is the path to a file which is read early in the CMake run and which | |
| specifies locations for compilers and toolchain utilities, and other target | |
| platform and compiler related information. Therefore it may not be changed by | |
| project code. Attempting to reconfigure with a new value will not use the new | |
| value. | |
| .. versionchanged:: 4.5 | |
| Attempting to reconfigure with a different value will cause CMake to first | |
| emit a message and reset the cache (as if by :cmake-option:`--fresh`). | |
| Relative paths are allowed and are interpreted first as relative to the | |
| build directory, and if not found, relative to the source directory. | |
| This is initialized by the :envvar:`CMAKE_TOOLCHAIN_FILE` environment | |
| variable if it is set when a new build tree is first created. | |
| See the :variable:`CMAKE_PROJECT_TOP_LEVEL_INCLUDES` variable for setting | |
| other things not directly related to the toolchain. |