CMAKE_<LANG>_LINK_FLAGS_<CONFIG>

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

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".

This support implies to parse and re-quote the content of the variable.

See Also

• CMAKE_<LANG>_LINK_FLAGS
• CMAKE_<LANG>_FLAGS_<CONFIG>