CMAKE_<LANG>_LINKER_WRAPPER_FLAG — CMake 4.3.0 Documentation

# CMAKE_<LANG>_LINKER_WRAPPER_FLAG

Added in version 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 `add_link_options()` and `target_link_options()`).

This variable holds a semicolon-separated list 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 `CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variable can be specified to manage concatenation of arguments.

For example, for `Clang` we have:

    set (CMAKE_C_LINKER_WRAPPER_FLAG "-Xlinker" " ")

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

For `GNU GCC`:

    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`:

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