2021-07-25 09:55:31 +00:00
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
# file Copyright.txt or https://cmake.org/licensing for details.
# search for additional tools required for C/C++ (and other languages ?)
#
# If the internal cmake variable _CMAKE_TOOLCHAIN_PREFIX is set, this is used
# as prefix for the tools (e.g. arm-elf-gcc etc.)
# If the cmake variable _CMAKE_TOOLCHAIN_LOCATION is set, the compiler is
# searched only there. The other tools are at first searched there, then
# also in the default locations.
#
# Sets the following variables:
# CMAKE_AR
# CMAKE_RANLIB
# CMAKE_LINKER
# CMAKE_MT
# CMAKE_STRIP
# CMAKE_INSTALL_NAME_TOOL
# on UNIX, cygwin and mingw
2023-01-10 14:42:48 +00:00
cmake_policy ( PUSH )
cmake_policy ( SET CMP0057 NEW ) # if IN_LIST
2021-07-25 09:55:31 +00:00
# Resolve full path of CMAKE_TOOL from user-defined name and SEARCH_PATH.
function ( __resolve_tool_path CMAKE_TOOL SEARCH_PATH DOCSTRING )
if ( ${ CMAKE_TOOL } )
# We only get here if CMAKE_TOOL was
# specified using -D or a pre-made CMakeCache.txt (e.g. via ctest)
# or set in CMAKE_TOOLCHAIN_FILE.
get_filename_component ( _CMAKE_USER_TOOL_PATH "${${CMAKE_TOOL}}" DIRECTORY )
# Is CMAKE_TOOL a user-defined name instead of a full path?
if ( NOT _CMAKE_USER_TOOL_PATH )
# Find CMAKE_TOOL in the SEARCH_PATH directory by user-defined name.
2023-01-10 14:42:48 +00:00
find_program ( _CMAKE_TOOL_WITH_PATH NAMES ${ ${CMAKE_TOOL } } HINTS ${ SEARCH_PATH } NO_CMAKE_PATH NO_CMAKE_ENVIRONMENT_PATH )
2021-07-25 09:55:31 +00:00
if ( _CMAKE_TOOL_WITH_PATH )
# Overwrite CMAKE_TOOL with full path found in SEARCH_PATH.
set ( ${ CMAKE_TOOL } ${ _CMAKE_TOOL_WITH_PATH } PARENT_SCOPE )
get_property ( _CMAKE_TOOL_CACHED CACHE ${ CMAKE_TOOL } PROPERTY TYPE )
# If CMAKE_TOOL is present in the CMake Cache, then overwrit it as well.
if ( _CMAKE_TOOL_CACHED )
set ( ${ CMAKE_TOOL } "${_CMAKE_TOOL_WITH_PATH}" CACHE STRING ${ DOCSTRING } FORCE )
endif ( )
endif ( )
unset ( _CMAKE_TOOL_WITH_PATH CACHE )
endif ( )
endif ( )
endfunction ( )
__resolve_tool_path ( CMAKE_LINKER "${_CMAKE_TOOLCHAIN_LOCATION}" "Default Linker" )
__resolve_tool_path ( CMAKE_MT "${_CMAKE_TOOLCHAIN_LOCATION}" "Default Manifest Tool" )
set ( _CMAKE_TOOL_VARS "" )
# if it's the MS C/CXX compiler, search for link
if ( ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_SIMULATE_ID}" STREQUAL "xMSVC" AND
( " x $ { C M A K E _ $ { _ C M A K E _ P R O C E S S I N G _ L A N G U A G E } _ C O M P I L E R _ F R O N T E N D _ V A R I A N T } " S T R E Q U A L " x M S V C "
O R N O T " x $ { C M A K E _ $ { _ C M A K E _ P R O C E S S I N G _ L A N G U A G E } _ C O M P I L E R _ I D } " S T R E Q U A L " x C l a n g " ) )
O R " x $ { C M A K E _ $ { _ C M A K E _ P R O C E S S I N G _ L A N G U A G E } _ C O M P I L E R _ I D } " S T R E Q U A L " x M S V C "
OR ( CMAKE_HOST_WIN32 AND "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL "xPGI" )
OR ( CMAKE_HOST_WIN32 AND "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL "xNVIDIA" )
OR ( CMAKE_HOST_WIN32 AND "x${_CMAKE_PROCESSING_LANGUAGE}" STREQUAL "xISPC" )
OR ( CMAKE_GENERATOR MATCHES "Visual Studio"
A N D N O T C M A K E _ V S _ P L A T F O R M _ N A M E S T R E Q U A L " T e g r a - A n d r o i d " ) )
# Start with the canonical names.
set ( _CMAKE_LINKER_NAMES "link" )
set ( _CMAKE_AR_NAMES "lib" )
set ( _CMAKE_MT_NAMES "mt" )
# Prepend toolchain-specific names.
if ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL "xClang" )
set ( _CMAKE_NM_NAMES "llvm-nm" "nm" )
list ( PREPEND _CMAKE_AR_NAMES "llvm-lib" )
2023-01-10 14:42:48 +00:00
# llvm-mt does not support all flags we need in vs_link_exe
# list(PREPEND _CMAKE_MT_NAMES "llvm-mt")
2021-07-25 09:55:31 +00:00
list ( PREPEND _CMAKE_LINKER_NAMES "lld-link" )
list ( APPEND _CMAKE_TOOL_VARS NM )
2023-01-10 14:42:48 +00:00
elseif ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL "xIntel" )
2021-07-25 09:55:31 +00:00
list ( PREPEND _CMAKE_AR_NAMES "xilib" )
list ( PREPEND _CMAKE_LINKER_NAMES "xilink" )
endif ( )
list ( APPEND _CMAKE_TOOL_VARS LINKER MT AR )
elseif ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" MATCHES "^x(Open)?Watcom$" )
set ( _CMAKE_LINKER_NAMES "wlink" )
set ( _CMAKE_AR_NAMES "wlib" )
list ( APPEND _CMAKE_TOOL_VARS LINKER AR )
2021-07-31 09:12:25 +00:00
elseif ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" MATCHES "^xIAR$" )
# Small helper declaring an IAR tool (e.g. linker) to avoid repeating the same idiom every time
macro ( __append_IAR_tool TOOL_VAR NAME )
set ( _CMAKE_ ${ TOOL_VAR } _NAMES "${NAME}" "${NAME}.exe" )
list ( APPEND _CMAKE_TOOL_VARS ${ TOOL_VAR } )
endmacro ( )
# Resolve hint path from an IAR compiler
function ( __resolve_IAR_hints COMPILER RESULT )
get_filename_component ( _CMAKE_IAR_HINT "${COMPILER}" REALPATH )
get_filename_component ( _CMAKE_IAR_HINT "${_CMAKE_IAR_HINT}" DIRECTORY )
list ( APPEND _IAR_HINTS "${_CMAKE_IAR_HINT}" )
get_filename_component ( _CMAKE_IAR_HINT "${COMPILER}" DIRECTORY )
list ( APPEND _IAR_HINTS "${_CMAKE_IAR_HINT}" )
set ( ${ RESULT } "${_IAR_HINTS}" PARENT_SCOPE )
endfunction ( )
__resolve_IAR_hints ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER}" _CMAKE_TOOLCHAIN_LOCATION )
2023-01-10 14:42:48 +00:00
set ( _CMAKE_IAR_ITOOLS "ARM" "RX" "RH850" "RL78" "RISCV" "RISC-V" "STM8" )
2021-07-31 09:12:25 +00:00
set ( _CMAKE_IAR_XTOOLS "AVR" "MSP430" "V850" "8051" )
if ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ARCHITECTURE_ID}" IN_LIST _CMAKE_IAR_ITOOLS )
string ( TOLOWER "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ARCHITECTURE_ID}" _CMAKE_IAR_LOWER_ARCHITECTURE_ID )
__append_IAR_tool ( AR "iarchive" )
__append_IAR_tool ( LINKER "ilink${_CMAKE_IAR_LOWER_ARCHITECTURE_ID}" )
__append_IAR_tool ( IAR_ELFDUMP "ielfdump${_CMAKE_IAR_LOWER_ARCHITECTURE_ID}" )
__append_IAR_tool ( IAR_ELFTOOL "ielftool" )
__append_IAR_tool ( IAR_OBJMANIP "iobjmanip" )
__append_IAR_tool ( IAR_SYMEXPORT "isymexport" )
unset ( _CMAKE_IAR_LOWER_ARCHITECTURE_ID )
elseif ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ARCHITECTURE_ID}" IN_LIST _CMAKE_IAR_XTOOLS )
__append_IAR_tool ( AR "xar" )
__append_IAR_tool ( LINKER "xlink" )
else ( )
message ( FATAL_ERROR "Failed to find linker and librarian for ${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID} on ${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ARCHITECTURE_ID}." )
endif ( )
unset ( _CMAKE_IAR_ITOOLS )
unset ( _CMAKE_IAR_XTOOLS )
2021-07-25 09:55:31 +00:00
# in all other cases search for ar, ranlib, etc.
else ( )
if ( CMAKE_C_COMPILER_EXTERNAL_TOOLCHAIN )
set ( _CMAKE_TOOLCHAIN_LOCATION ${ _CMAKE_TOOLCHAIN_LOCATION } ${ CMAKE_C_COMPILER_EXTERNAL_TOOLCHAIN } /bin )
endif ( )
if ( CMAKE_CXX_COMPILER_EXTERNAL_TOOLCHAIN )
set ( _CMAKE_TOOLCHAIN_LOCATION ${ _CMAKE_TOOLCHAIN_LOCATION } ${ CMAKE_CXX_COMPILER_EXTERNAL_TOOLCHAIN } /bin )
endif ( )
# Start with the canonical names.
set ( _CMAKE_AR_NAMES "ar" )
set ( _CMAKE_RANLIB_NAMES "ranlib" )
set ( _CMAKE_STRIP_NAMES "strip" )
set ( _CMAKE_LINKER_NAMES "ld" )
set ( _CMAKE_NM_NAMES "nm" )
set ( _CMAKE_OBJDUMP_NAMES "objdump" )
set ( _CMAKE_OBJCOPY_NAMES "objcopy" )
set ( _CMAKE_READELF_NAMES "readelf" )
set ( _CMAKE_DLLTOOL_NAMES "dlltool" )
set ( _CMAKE_ADDR2LINE_NAMES "addr2line" )
# Prepend toolchain-specific names.
if ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL Clang )
if ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_SIMULATE_ID}" STREQUAL "xMSVC" )
2023-01-10 14:42:48 +00:00
list ( PREPEND _CMAKE_LINKER_NAMES "lld-link" )
elseif ( NOT APPLE )
list ( PREPEND _CMAKE_LINKER_NAMES "ld.lld" )
endif ( )
if ( APPLE )
# llvm-ar does not generate a symbol table that the Apple ld64 linker accepts.
# FIXME(#23333): We still need to consider 'llvm-ar' as a fallback because
# the 'APPLE' definition may be based on the host in this context, and a
# cross-compiling toolchain may not have 'ar'.
list ( APPEND _CMAKE_AR_NAMES "llvm-ar" )
2021-07-25 09:55:31 +00:00
else ( )
2023-01-10 14:42:48 +00:00
list ( PREPEND _CMAKE_AR_NAMES "llvm-ar" )
2021-07-25 09:55:31 +00:00
endif ( )
list ( PREPEND _CMAKE_RANLIB_NAMES "llvm-ranlib" )
2023-01-10 14:42:48 +00:00
if ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_VERSION}" VERSION_GREATER_EQUAL 11 )
# llvm-strip versions prior to 11 require additional flags we do not yet add.
list ( PREPEND _CMAKE_STRIP_NAMES "llvm-strip" )
endif ( )
2021-07-25 09:55:31 +00:00
list ( PREPEND _CMAKE_NM_NAMES "llvm-nm" )
if ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_VERSION}" VERSION_GREATER_EQUAL 9 )
# llvm-objdump versions prior to 9 did not support everything we need.
list ( PREPEND _CMAKE_OBJDUMP_NAMES "llvm-objdump" )
endif ( )
list ( PREPEND _CMAKE_OBJCOPY_NAMES "llvm-objcopy" )
list ( PREPEND _CMAKE_READELF_NAMES "llvm-readelf" )
list ( PREPEND _CMAKE_DLLTOOL_NAMES "llvm-dlltool" )
list ( PREPEND _CMAKE_ADDR2LINE_NAMES "llvm-addr2line" )
elseif ( "${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" STREQUAL ARMClang )
list ( PREPEND _CMAKE_AR_NAMES "armar" )
list ( PREPEND _CMAKE_LINKER_NAMES "armlink" )
endif ( )
list ( APPEND _CMAKE_TOOL_VARS AR RANLIB STRIP LINKER NM OBJDUMP OBJCOPY READELF DLLTOOL ADDR2LINE )
endif ( )
foreach ( _CMAKE_TOOL IN LISTS _CMAKE_TOOL_VARS )
# Build the final list of prefixed/suffixed names.
set ( _CMAKE_ ${ _CMAKE_TOOL } _FIND_NAMES "" )
foreach ( _CMAKE_TOOL_NAME IN LISTS _CMAKE_ ${ _CMAKE_TOOL } _NAMES )
list ( APPEND _CMAKE_ ${ _CMAKE_TOOL } _FIND_NAMES
$ { _ C M A K E _ T O O L C H A I N _ P R E F I X } $ { _ C M A K E _ T O O L _ N A M E } $ { _ C M A K E _ T O O L C H A I N _ S U F F I X }
$ { _ C M A K E _ T O O L C H A I N _ P R E F I X } $ { _ C M A K E _ T O O L _ N A M E }
$ { _ C M A K E _ T O O L _ N A M E } $ { _ C M A K E _ T O O L C H A I N _ S U F F I X }
$ { _ C M A K E _ T O O L _ N A M E }
)
endforeach ( )
list ( REMOVE_DUPLICATES _CMAKE_ ${ _CMAKE_TOOL } _FIND_NAMES )
2023-01-10 14:42:48 +00:00
find_program ( CMAKE_ ${ _CMAKE_TOOL } NAMES ${ _CMAKE_${_CMAKE_TOOL } _FIND_NAMES} HINTS ${ _CMAKE_TOOLCHAIN_LOCATION } NO_CMAKE_PATH NO_CMAKE_ENVIRONMENT_PATH )
2021-07-25 09:55:31 +00:00
unset ( _CMAKE_ ${ _CMAKE_TOOL } _FIND_NAMES )
endforeach ( )
if ( NOT CMAKE_RANLIB )
set ( CMAKE_RANLIB : CACHE INTERNAL "noop for ranlib" )
endif ( )
if ( CMAKE_PLATFORM_HAS_INSTALLNAME )
2023-01-10 14:42:48 +00:00
find_program ( CMAKE_INSTALL_NAME_TOOL NAMES ${ _CMAKE_TOOLCHAIN_PREFIX } install_name_tool HINTS ${ _CMAKE_TOOLCHAIN_LOCATION } NO_CMAKE_PATH NO_CMAKE_ENVIRONMENT_PATH )
2021-07-25 09:55:31 +00:00
if ( NOT CMAKE_INSTALL_NAME_TOOL )
message ( FATAL_ERROR "Could not find install_name_tool, please check your installation." )
endif ( )
list ( APPEND _CMAKE_TOOL_VARS INSTALL_NAME_TOOL )
endif ( )
# Mark any tool cache entries as advanced.
foreach ( _CMAKE_TOOL IN LISTS _CMAKE_TOOL_VARS )
get_property ( _CMAKE_TOOL_CACHED CACHE CMAKE_ ${ _CMAKE_TOOL } PROPERTY TYPE )
if ( _CMAKE_TOOL_CACHED )
mark_as_advanced ( CMAKE_ ${ _CMAKE_TOOL } )
endif ( )
unset ( _CMAKE_ ${ _CMAKE_TOOL } _NAMES )
endforeach ( )
unset ( _CMAKE_TOOL_VARS )
unset ( _CMAKE_TOOL_CACHED )
unset ( _CMAKE_TOOL_NAME )
unset ( _CMAKE_TOOL )
2021-07-31 09:12:25 +00:00
if ( "x${CMAKE_${_CMAKE_PROCESSING_LANGUAGE}_COMPILER_ID}" MATCHES "^xIAR$" )
# Set for backwards compatibility
set ( CMAKE_IAR_ARCHIVE "${CMAKE_AR}" CACHE FILEPATH "The IAR archiver" )
set ( CMAKE_IAR_LINKER "${CMAKE_LINKER}" CACHE FILEPATH "The IAR ILINK linker" )
mark_as_advanced ( CMAKE_IAR_LINKER CMAKE_IAR_AR )
endif ( )
2023-01-10 14:42:48 +00:00
cmake_policy ( POP )
