CMAKE_<LANG>_LINK_FLAGS_<CONFIG>¶
Added in version 4.3.
Language-wide flags for language <LANG> used when linking for the
<CONFIG> configuration. These flags will be passed to all invocations of
the compiler which drive linking.
See CMAKE_<LANG>_LINK_FLAGS for the ordering of these flags with
respect to other variables. Notably, flags in
CMAKE_<LANG>_LINK_FLAGS_<CONFIG> are passed after those in
CMAKE_<LANG>_LINK_FLAGS.
Handling Compiler Driver Differences¶
Added in version 4.0.
To pass options to the linker tool, each compiler driver has its own syntax.
The LINKER: prefix and , separator can be used to specify, in a portable
way, options to pass to the linker tool. LINKER: is replaced by the
appropriate driver option and , by the appropriate driver separator.
The driver prefix and driver separator are given by the values of the
CMAKE_<LANG>_LINKER_WRAPPER_FLAG and
CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP variables.
For example, "LINKER:-z,defs" becomes -Xlinker -z -Xlinker defs for
Clang and -Wl,-z,defs for GNU GCC.
The LINKER: prefix supports, as an alternative syntax, specification of
arguments using the SHELL: prefix and space as separator. The previous
example then becomes "LINKER:SHELL:-z defs".
Note
Specifying the SHELL: prefix anywhere other than at the beginning of the
LINKER: prefix is not supported.
This support implies to parse and re-quote the content of the variable.