CMake/Help/release/dev/Linker-user-selection.rst at 79ce5ef4e0fe982f663ca4e4a4870ce8007ecba6 - CMake - Gitea - ZeroTwo

mirror/CMake

mirror of https://github.com/Kitware/CMake.git synced 2026-01-05 13:20:47 -06:00

Files

Marc Chevrier 96a953b1ed Add options to specify linker tool

Offer the capability, through variable `CMAKE_LINKER_TYPE`, as well as
the target property `LINKER_TYPE` to specify which linker must be used.

The implementation of this capability is specified by variables specific
to the language and linker type: `CMAKE_<LANG>_USING_LINKER_<TYPE>`.
Some definitions are provided as part of `CMake`.

For example, to select the `LLVM` linker rather than the standard one,
the type `LLD` should be specified through the variable `CMAKE_LINKER_TYPE`.
And, on `Apple`, `Linux` and some environments on `Windows`, the variable
`CMAKE_<LANG>_USING_LINKER_LLD` has value `-fuse-ld=lld`. And for `Windows`
environments  based on `MSVC`, where the linker is used directly, the tool
`lld-link.exe` will be used rather than `link.exe`.

Fixes: #19174, #24254, #24990

2023-10-13 11:52:35 +02:00

7 lines

221 B

ReStructuredText

Raw Blame History

 Linker-user-selection
 ---------------------
 * The linker tool can now be specified for a selection of compilers/platforms
   by setting :variable:`CMAKE_LINKER_TYPE` variable or :prop_tgt:`LINKER_TYPE`
   target property.