You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
33 lines
1.5 KiB
33 lines
1.5 KiB
CMP0123
|
|
-------
|
|
|
|
.. versionadded:: 3.21
|
|
|
|
``ARMClang`` cpu/arch compile and link flags must be set explicitly.
|
|
|
|
CMake 3.20 and lower automatically maps the :variable:`CMAKE_SYSTEM_PROCESSOR`
|
|
variable and an undocumented ``CMAKE_SYSTEM_ARCH`` to compile and link options
|
|
for ``ARMClang``. For example, the ``-mcpu=cortex-m33`` flag is added when
|
|
:variable:`CMAKE_SYSTEM_PROCESSOR` equals ``cortex-m33``. CMake requires
|
|
projects to set either variable or it raises a fatal error. However, the
|
|
project may need to additionally specify CPU features using e.g.
|
|
``-mcpu=cortex-m33+nodsp``, conflicting with the ``-mcpu=cortex-m33`` added
|
|
by CMake. This results in either link errors or unusable binaries.
|
|
|
|
CMake 3.21 and above prefer instead to not add any cpu/arch compile and link
|
|
flags automatically. Instead, projects must specify them explicitly.
|
|
This policy provides compatibility for projects that have not been updated.
|
|
|
|
The ``OLD`` behavior of this policy requires projects that use ``ARMClang``
|
|
to set either :variable:`CMAKE_SYSTEM_PROCESSOR` or ``CMAKE_SYSTEM_ARCH``
|
|
and it automatically adds a compile option ``-mcpu=`` or ``-march=`` and
|
|
a link option ``--cpu=`` based on those variables. The ``NEW`` behavior
|
|
does not add compile or link options, and projects are responsible for
|
|
setting correct options.
|
|
|
|
This policy was introduced in CMake version 3.21. CMake version |release|
|
|
warns when the policy is not set and uses ``OLD`` behavior. Use the
|
|
:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
|
|
|
|
.. include:: DEPRECATED.txt
|