CMP0075 — CMake 4.3.0 Documentation

# CMP0075

Added in version 3.12.

Include file check macros honor `CMAKE_REQUIRED_LIBRARIES`.

In CMake 3.12 and above, the

- `check_include_file()` command in the `CheckIncludeFile` module, the

- `check_include_file_cxx()` command in the `CheckIncludeFileCXX` module, and the

- `check_include_files()` command 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 commands. The `NEW` behavior of this policy is to honor `CMAKE_REQUIRED_LIBRARIES` in the include file check commands.

This policy was introduced in CMake version 3.12. It may be set by `cmake_policy()` or `cmake_minimum_required()`. If it is not set, CMake warns, and uses `OLD` behavior.

Note

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