CMAKE_<LANG>_LINKER_WRAPPER_FLAG

.. versionadded:: 3.13

Defines the syntax of compiler driver option to pass options to the linker tool. It will be used to translate the LINKER: prefix in the link options (see :command:add_link_options and :command:target_link_options).

This variable holds a :ref:semicolon-separated list <CMake Language Lists> of tokens. If a space (i.e. " ") is specified as last token, flag and LINKER: arguments will be specified as separate arguments to the compiler driver. The :variable:CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP variable can be specified to manage concatenation of arguments.

For example, for Clang we have:

.. code-block:: cmake

set (CMAKE_C_LINKER_WRAPPER_FLAG "-Xlinker" " ")

Specifying "LINKER:-z,defs" will be transformed in -Xlinker -z -Xlinker defs.

For GNU GCC:

.. code-block:: cmake

set (CMAKE_C_LINKER_WRAPPER_FLAG "-Wl,") set (CMAKE_C_LINKER_WRAPPER_FLAG_SEP ",")

Specifying "LINKER:-z,defs" will be transformed in -Wl,-z,defs.

And for SunPro:

.. code-block:: cmake

set (CMAKE_C_LINKER_WRAPPER_FLAG "-Qoption" "ld" " ") set (CMAKE_C_LINKER_WRAPPER_FLAG_SEP ",")

Specifying "LINKER:-z,defs" will be transformed in -Qoption ld -z,defs.