mirror of
https://github.com/curl/curl.git
synced 2026-04-11 12:01:42 +08:00
Pass build options directly via `COMPILE_DEFINTIONS` and
`LINK_LIBRARIES`, instead of "tunneling" them through `CMAKE_FLAGS`.
The latter method breaks when passing `Threads::Threads` as library via
`CMAKE_REQUIRED_LIBRARIES`, while also being complex and fragile.
Example:
```
-- Performing Test HAVE_FSETXATTR_5
CMake Error at bld/CMakeFiles/CMakeTmp/CMakeLists.txt:27 (target_link_libraries):
Target "cmTC_3386e" links to:
Threads::Threads
but the target was not found. Possible reasons include:
* There is a typo in the target name.
* A find_package call is missing for an IMPORTED target.
* An ALIAS target is missing.
CMake Error at CMake/Macros.cmake:51 (try_compile):
Failed to generate test project build system.
Call Stack (most recent call first):
CMakeLists.txt:1684 (curl_internal_test)
```
Ref: https://github.com/curl/curl/actions/runs/23792043930/job/69329796592?pr=21168#step:38:318
Note: a side-effect is no longer passing C compiler flags (e.g.
`CMAKE_REQUIRED_FLAGS`) to the _linker_. This should not be an issue,
though CMake is passing them during its built-in detections.
Ref: https://cmake.org/cmake/help/v3.18/command/try_compile.html
Closes #21176
279 lines
9.8 KiB
CMake
279 lines
9.8 KiB
CMake
#***************************************************************************
|
|
# _ _ ____ _
|
|
# Project ___| | | | _ \| |
|
|
# / __| | | | |_) | |
|
|
# | (__| |_| | _ <| |___
|
|
# \___|\___/|_| \_\_____|
|
|
#
|
|
# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
#
|
|
# This software is licensed as described in the file COPYING, which
|
|
# you should have received as part of this distribution. The terms
|
|
# are also available at https://curl.se/docs/copyright.html.
|
|
#
|
|
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
# copies of the Software, and permit persons to whom the Software is
|
|
# furnished to do so, under the terms of the COPYING file.
|
|
#
|
|
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
# KIND, either express or implied.
|
|
#
|
|
# SPDX-License-Identifier: curl
|
|
#
|
|
###########################################################################
|
|
# File defines convenience macros for available feature testing
|
|
|
|
# Check if header file exists and add it to the list.
|
|
# This macro is intended to be called multiple times with a sequence of
|
|
# possibly dependent header files. Some headers depend on others to be
|
|
# compiled correctly.
|
|
macro(check_include_file_concat_curl _file _variable)
|
|
check_include_files("${CURL_INCLUDES};${_file}" ${_variable})
|
|
if(${_variable})
|
|
list(APPEND CURL_INCLUDES ${_file})
|
|
endif()
|
|
endmacro()
|
|
|
|
set(CURL_TEST_DEFINES "") # Initialize global variable
|
|
|
|
# For other curl specific tests, use this macro.
|
|
# Return result in variable: CURL_TEST_OUTPUT
|
|
macro(curl_internal_test _curl_test)
|
|
if(NOT DEFINED "${_curl_test}")
|
|
message(STATUS "Performing Test ${_curl_test}")
|
|
try_compile(${_curl_test}
|
|
${PROJECT_BINARY_DIR}
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/CMake/CurlTests.c"
|
|
COMPILE_DEFINITIONS "-D${_curl_test}" ${CURL_TEST_DEFINES} ${CMAKE_REQUIRED_FLAGS} ${CMAKE_REQUIRED_DEFINITIONS}
|
|
LINK_LIBRARIES "${CMAKE_REQUIRED_LIBRARIES}"
|
|
OUTPUT_VARIABLE CURL_TEST_OUTPUT)
|
|
if(${_curl_test})
|
|
set(${_curl_test} 1 CACHE INTERNAL "curl test")
|
|
message(STATUS "Performing Test ${_curl_test} - Success")
|
|
else()
|
|
set(${_curl_test} "" CACHE INTERNAL "curl test")
|
|
message(STATUS "Performing Test ${_curl_test} - Failed")
|
|
endif()
|
|
endif()
|
|
endmacro()
|
|
|
|
# Option for dependencies that accepts an 'AUTO' value, which enables the dependency if detected.
|
|
macro(curl_dependency_option _option_name _find_name _desc_name)
|
|
set(${_option_name} "AUTO" CACHE STRING "Build curl with ${_desc_name} support (AUTO, ON or OFF)")
|
|
set_property(CACHE ${_option_name} PROPERTY STRINGS "AUTO" "ON" "OFF")
|
|
|
|
if(${_option_name} STREQUAL "AUTO")
|
|
if(_find_name STREQUAL "ZLIB")
|
|
find_package(${_find_name})
|
|
else()
|
|
find_package(${_find_name} MODULE)
|
|
endif()
|
|
elseif(${_option_name})
|
|
if(_find_name STREQUAL "ZLIB")
|
|
find_package(${_find_name} REQUIRED)
|
|
else()
|
|
find_package(${_find_name} MODULE REQUIRED)
|
|
endif()
|
|
else()
|
|
string(TOUPPER "${_find_name}" _find_name_upper)
|
|
set(${_find_name}_FOUND OFF) # cmake-lint: disable=C0103
|
|
set(${_find_name_upper}_FOUND OFF) # cmake-lint: disable=C0103
|
|
endif()
|
|
endmacro()
|
|
|
|
# Convert the passed paths to libpath linker options and add them to CMAKE_REQUIRED_*.
|
|
macro(curl_required_libpaths _libpaths_arg)
|
|
if(CMAKE_VERSION VERSION_LESS 3.31)
|
|
set(_libpaths "${_libpaths_arg}")
|
|
foreach(_libpath IN LISTS _libpaths)
|
|
list(APPEND CMAKE_REQUIRED_LINK_OPTIONS "${CMAKE_LIBRARY_PATH_FLAG}${_libpath}")
|
|
endforeach()
|
|
else()
|
|
list(APPEND CMAKE_REQUIRED_LINK_DIRECTORIES "${_libpaths_arg}")
|
|
endif()
|
|
endmacro()
|
|
|
|
# Pre-fill variables set by a check_type_size() call.
|
|
macro(curl_prefill_type_size _type _size)
|
|
set(HAVE_SIZEOF_${_type} TRUE)
|
|
set(SIZEOF_${_type} ${_size})
|
|
set(SIZEOF_${_type}_CODE "#define SIZEOF_${_type} ${_size}")
|
|
endmacro()
|
|
|
|
# Internal: Recurse into target libraries and collect their include directories
|
|
# and macro definitions.
|
|
macro(curl_collect_target_compile_options _target)
|
|
get_target_property(_val ${_target} INTERFACE_COMPILE_DEFINITIONS)
|
|
if(_val)
|
|
list(APPEND _definitions ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} INTERFACE_INCLUDE_DIRECTORIES)
|
|
if(_val)
|
|
list(APPEND _incsys ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} INTERFACE_COMPILE_OPTIONS)
|
|
if(_val)
|
|
list(APPEND _options ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} LINK_LIBRARIES)
|
|
if(_val)
|
|
foreach(_lib IN LISTS _val)
|
|
if(TARGET "${_lib}")
|
|
curl_collect_target_compile_options(${_lib})
|
|
endif()
|
|
endforeach()
|
|
endif()
|
|
unset(_val)
|
|
endmacro()
|
|
|
|
# Create a clang-tidy target for test targets
|
|
function(curl_add_clang_tidy_test_target _target_clang_tidy _target)
|
|
if(CURL_CLANG_TIDY)
|
|
|
|
set(_definitions "")
|
|
set(_includes "")
|
|
set(_incsys "")
|
|
set(_options "")
|
|
|
|
# Make a list of known system include directories
|
|
set(_sys_incdirs "${CMAKE_C_IMPLICIT_INCLUDE_DIRECTORIES}")
|
|
foreach(_inc IN LISTS CMAKE_SYSTEM_PREFIX_PATH)
|
|
if(NOT _inc MATCHES "/$")
|
|
string(APPEND _inc "/")
|
|
endif()
|
|
string(APPEND _inc "include")
|
|
if(NOT _inc IN_LIST _sys_incdirs AND IS_DIRECTORY "${_inc}")
|
|
list(APPEND _sys_incdirs "${_inc}")
|
|
endif()
|
|
endforeach()
|
|
|
|
# Collect options applying to the directory
|
|
get_directory_property(_val COMPILE_DEFINITIONS)
|
|
if(_val)
|
|
list(APPEND _definitions ${_val})
|
|
endif()
|
|
get_directory_property(_val INCLUDE_DIRECTORIES)
|
|
if(_val)
|
|
list(APPEND _includes ${_val})
|
|
endif()
|
|
get_directory_property(_val COMPILE_OPTIONS)
|
|
if(_val)
|
|
list(APPEND _options ${_val})
|
|
endif()
|
|
|
|
# Collect options applying to the target
|
|
get_target_property(_val ${_target} COMPILE_DEFINITIONS)
|
|
if(_val)
|
|
list(APPEND _definitions ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} INCLUDE_DIRECTORIES)
|
|
if(_val)
|
|
list(APPEND _includes ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} COMPILE_OPTIONS)
|
|
if(_val)
|
|
list(APPEND _options ${_val})
|
|
endif()
|
|
|
|
# Collect header directories and macro definitions from lib dependencies
|
|
curl_collect_target_compile_options(${_target})
|
|
|
|
list(REMOVE_ITEM _definitions "")
|
|
string(REPLACE ";" ";-D" _definitions ";${_definitions}")
|
|
list(REMOVE_DUPLICATES _definitions)
|
|
list(SORT _definitions) # Sort like CMake does
|
|
|
|
list(REMOVE_ITEM _includes "")
|
|
string(REPLACE ";" ";-I" _includes ";${_includes}")
|
|
list(REMOVE_DUPLICATES _includes)
|
|
|
|
set(_incsys_tmp ${_incsys})
|
|
list(REMOVE_DUPLICATES _incsys_tmp)
|
|
set(_incsys "")
|
|
set(_incsystop "")
|
|
foreach(_inc IN LISTS _incsys_tmp)
|
|
if(_inc IN_LIST _sys_incdirs)
|
|
list(APPEND _incsystop "${_inc}") # Save system prefixes to re-add them later to the end of list
|
|
continue()
|
|
endif()
|
|
# Avoid empty and '$<INSTALL_INTERFACE:include>' items. The latter
|
|
# evaluates to an empty path in this context. Also skip
|
|
# '$<BUILD_INTERFACE:curl-include>', as already present in '_includes'.
|
|
if(_inc AND
|
|
NOT _inc MATCHES "INSTALL_INTERFACE:" AND
|
|
NOT _inc MATCHES "BUILD_INTERFACE:")
|
|
list(APPEND _incsys "-isystem" "${_inc}")
|
|
endif()
|
|
endforeach()
|
|
foreach(_inc IN LISTS _incsystop)
|
|
list(APPEND _incsys "-isystem" "${_inc}")
|
|
endforeach()
|
|
|
|
if(CMAKE_C_COMPILER_ID MATCHES "Clang")
|
|
list(REMOVE_DUPLICATES _options) # Keep the first of duplicates to imitate CMake
|
|
else()
|
|
set(_options)
|
|
endif()
|
|
|
|
# Assemble source list
|
|
set(_sources "")
|
|
foreach(_source IN ITEMS ${ARGN})
|
|
if(NOT EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/${_source}") # if not in source tree
|
|
set(_source "${CMAKE_CURRENT_BINARY_DIR}/${_source}") # look in the build tree, for generated files, e.g. lib1521.c
|
|
endif()
|
|
list(APPEND _sources "${_source}")
|
|
endforeach()
|
|
|
|
set(_cc "${CMAKE_C_COMPILER}")
|
|
if(CMAKE_C_COMPILER_TARGET AND CMAKE_C_COMPILE_OPTIONS_TARGET)
|
|
list(APPEND _cc "${CMAKE_C_COMPILE_OPTIONS_TARGET}${CMAKE_C_COMPILER_TARGET}")
|
|
endif()
|
|
if(APPLE AND CMAKE_OSX_SYSROOT)
|
|
list(APPEND _cc "-isysroot" "${CMAKE_OSX_SYSROOT}")
|
|
elseif(CMAKE_SYSROOT AND CMAKE_C_COMPILE_OPTIONS_SYSROOT)
|
|
list(APPEND _cc "${CMAKE_C_COMPILE_OPTIONS_SYSROOT}${CMAKE_SYSROOT}")
|
|
endif()
|
|
|
|
# Pass -clang-diagnostic-unused-function to disable -Wunused-function implied by -Wunused
|
|
add_custom_target(${_target_clang_tidy} USES_TERMINAL
|
|
WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
|
|
COMMAND ${CMAKE_C_CLANG_TIDY}
|
|
"--checks=-clang-diagnostic-unused-function"
|
|
${_sources} -- ${_cc} ${_definitions} ${_includes} ${_incsys} ${_options}
|
|
DEPENDS ${_sources})
|
|
add_dependencies(tests-clang-tidy ${_target_clang_tidy})
|
|
endif()
|
|
endfunction()
|
|
|
|
# Internal: Recurse into interface targets and collect their libraries
|
|
# and library paths.
|
|
macro(curl_collect_target_link_options _target)
|
|
get_target_property(_val ${_target} INTERFACE_LINK_DIRECTORIES)
|
|
if(_val)
|
|
list(APPEND _libdirs ${_val})
|
|
endif()
|
|
get_target_property(_val ${_target} IMPORTED)
|
|
if(_val)
|
|
# LOCATION is empty for interface library targets and safe to ignore.
|
|
# Explicitly skip this query to avoid CMake v3.18 and older erroring out.
|
|
get_target_property(_val ${_target} TYPE)
|
|
if(NOT "${_val}" STREQUAL "INTERFACE_LIBRARY")
|
|
get_target_property(_val ${_target} LOCATION)
|
|
if(_val)
|
|
list(APPEND _libs ${_val})
|
|
endif()
|
|
endif()
|
|
endif()
|
|
get_target_property(_val ${_target} INTERFACE_LINK_LIBRARIES)
|
|
if(_val)
|
|
foreach(_lib IN LISTS _val)
|
|
if(TARGET "${_lib}")
|
|
curl_collect_target_link_options(${_lib})
|
|
else()
|
|
list(APPEND _libs ${_lib})
|
|
endif()
|
|
endforeach()
|
|
endif()
|
|
unset(_val)
|
|
endmacro()
|