mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 10:47:59 +08:00
5f882f6ce5
Since commit b6c60f14b6 (macOS: Default to arm64 architecture on Apple
Silicon hosts, 2020-09-28, v3.19.0-rc1~63^2) we use `sysctl` to detect
that we are running on Apple Silicon in a way that pierces Rosetta.
This always sets `CMAKE_HOST_SYSTEM_PROCESSOR` to be `arm64` on such
hosts. However, macOS offers strong support for running processes under
an emulated `x86_64` architecture.
Teach CMake to select either `arm64` or `x86_64` as the host
architecture on Apple Silicon based on the architecture of its own
process. When CMake is built as a universal binary, macOS will select
whichever slice (architecture) is appropriate under the user's shell,
and `CMAKE_HOST_SYSTEM_PROCESSOR` will match.
Also offer a `CMAKE_APPLE_SILICON_PROCESSOR` variable and environment
variable to provide users with explicit control over the host
architecture selection regardless of CMake's own architecture.
Finally, if `CMAKE_OSX_ARCHITECTURES` is not set, pass explicit flags to
the toolchain to use selected host architecture instead of letting the
toolchain pick.
Fixes: #21554
96 lines
2.1 KiB
ReStructuredText
96 lines
2.1 KiB
ReStructuredText
.. cmake-manual-description: CMake Environment Variables Reference
|
|
|
|
cmake-env-variables(7)
|
|
**********************
|
|
|
|
.. only:: html
|
|
|
|
.. contents::
|
|
|
|
This page lists environment variables that have special
|
|
meaning to CMake.
|
|
|
|
For general information on environment variables, see the
|
|
:ref:`Environment Variables <CMake Language Environment Variables>`
|
|
section in the cmake-language manual.
|
|
|
|
Environment Variables that Change Behavior
|
|
==========================================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/envvar/CMAKE_PREFIX_PATH
|
|
|
|
Environment Variables that Control the Build
|
|
============================================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/envvar/CMAKE_APPLE_SILICON_PROCESSOR
|
|
/envvar/CMAKE_BUILD_PARALLEL_LEVEL
|
|
/envvar/CMAKE_CONFIG_TYPE
|
|
/envvar/CMAKE_EXPORT_COMPILE_COMMANDS
|
|
/envvar/CMAKE_GENERATOR
|
|
/envvar/CMAKE_GENERATOR_INSTANCE
|
|
/envvar/CMAKE_GENERATOR_PLATFORM
|
|
/envvar/CMAKE_GENERATOR_TOOLSET
|
|
/envvar/CMAKE_LANG_COMPILER_LAUNCHER
|
|
/envvar/CMAKE_MSVCIDE_RUN_PATH
|
|
/envvar/CMAKE_NO_VERBOSE
|
|
/envvar/CMAKE_OSX_ARCHITECTURES
|
|
/envvar/DESTDIR
|
|
/envvar/LDFLAGS
|
|
/envvar/MACOSX_DEPLOYMENT_TARGET
|
|
/envvar/PackageName_ROOT
|
|
/envvar/VERBOSE
|
|
|
|
Environment Variables for Languages
|
|
===================================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/envvar/ASM_DIALECT
|
|
/envvar/ASM_DIALECTFLAGS
|
|
/envvar/CC
|
|
/envvar/CFLAGS
|
|
/envvar/CSFLAGS
|
|
/envvar/CUDACXX
|
|
/envvar/CUDAFLAGS
|
|
/envvar/CUDAHOSTCXX
|
|
/envvar/CXX
|
|
/envvar/CXXFLAGS
|
|
/envvar/FC
|
|
/envvar/FFLAGS
|
|
/envvar/ISPC
|
|
/envvar/ISPCFLAGS
|
|
/envvar/OBJC
|
|
/envvar/OBJCXX
|
|
/envvar/RC
|
|
/envvar/RCFLAGS
|
|
/envvar/SWIFTC
|
|
|
|
Environment Variables for CTest
|
|
===============================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/envvar/CMAKE_CONFIG_TYPE
|
|
/envvar/CTEST_INTERACTIVE_DEBUG_MODE
|
|
/envvar/CTEST_OUTPUT_ON_FAILURE
|
|
/envvar/CTEST_PARALLEL_LEVEL
|
|
/envvar/CTEST_PROGRESS_OUTPUT
|
|
/envvar/CTEST_USE_LAUNCHERS_DEFAULT
|
|
/envvar/DASHBOARD_TEST_FROM_CTEST
|
|
|
|
Environment Variables for the CMake curses interface
|
|
====================================================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
/envvar/CCMAKE_COLORS
|