diff options
| author | Brad King <brad.king@kitware.com> | 2022-06-09 12:23:42 -0400 |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2022-06-10 09:12:43 -0400 |
| commit | ec08bc17526a7e22c1a18d5262ca0ca0c391ec6e (patch) | |
| tree | e33877fe390be5eb20055badeb8edd4b35a7c6d0 /Help/policy | |
| parent | 7d73e88d3a7490cf1047369da8292a57c0b60bce (diff) | |
| download | cmake-ec08bc17526a7e22c1a18d5262ca0ca0c391ec6e.tar.gz | |
CheckIPOSupported: Compile check using flags of calling project
Forward `CMAKE_<LANG>_FLAGS` and `CMAKE_<LANG>_FLAGS_DEBUG` from the
calling project into the test project. The set of flags may affect the
availability of IPO support. Since this may change the result of the
check for existing projects, add a policy for compatibility.
This was discovered after commit 5fcadc481e (MSVC: Default to -ZI
instead of /Zi for x86 and x64, 2022-05-24) introduced policy CMP0138 to
switch our default for MSVC's debug info flag. The `-ZI` flag is
incompatible with the `-GL` flag used for IPO, so CMP0138 was reverted
pending future work on an alternative solution. Re-use the CMP0138
policy number for this change to CheckIPOSupported instead.
Fixes: #23607
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0138.rst | 20 |
1 files changed, 19 insertions, 1 deletions
diff --git a/Help/policy/CMP0138.rst b/Help/policy/CMP0138.rst index c7f0e2d834..a86849d3be 100644 --- a/Help/policy/CMP0138.rst +++ b/Help/policy/CMP0138.rst @@ -3,7 +3,25 @@ CMP0138 .. versionadded:: 3.24 -Placeholder for reverted policy. +:module:`CheckIPOSupported` uses flags from calling project. + +The :module:`CheckIPOSupported` module :command:`check_ipo_supported` +command compiles a test project to determine whether the toolchain +supports :prop_tgt:`INTERPROCEDURAL_OPTIMIZATION`. CMake 3.23 and +below run the check with the default values of the +:variable:`CMAKE_<LANG>_FLAGS` and :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>` +variables for the current environment and toolchain settings. +However, some projects may modify these flag variables to add +flags that affect availability of the toolchain's IPO features. +CMake 3.24 and above prefer to honor the calling project's values +for these variables. This policy provides compatibility for projects +that have not been updated to expect this behavior. + +The ``OLD`` behavior for this policy is to ignore the calling +project's values of :variable:`CMAKE_<LANG>_FLAGS` and +:variable:`CMAKE_<LANG>_FLAGS_<CONFIG>`. The ``NEW`` behavior +for this policy is to use the values of those variables as +compiler flags in the test project. This policy was introduced in CMake version 3.24. Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly. |