CMP0075

New in version 3.12.

Include file check macros honor CMAKE_REQUIRED_LIBRARIES.

In CMake 3.12 and above, the

• check_include_file macro in the CheckIncludeFile module, the

• check_include_file_cxx macro in the CheckIncludeFileCXX module, and the

• check_include_files macro in the CheckIncludeFiles module

now prefer to link the check executable to the libraries listed in the CMAKE_REQUIRED_LIBRARIES variable. This policy provides compatibility with projects that have not been updated to expect this behavior.

The OLD behavior for this policy is to ignore CMAKE_REQUIRED_LIBRARIES in the include file check macros. The NEW behavior of this policy is to honor CMAKE_REQUIRED_LIBRARIES in the include file check macros.

This policy was introduced in CMake version 3.12. CMake version 3.28.0-rc1 warns when the policy is not set and uses OLD behavior. Use the cmake_policy() command to set it to OLD or NEW explicitly.

Note

The OLD behavior of a policy is deprecated by definition and may be removed in a future version of CMake.