You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
|
|
To pass options to the linker tool, each compiler driver has is own syntax.
|
|
|
|
|
The ``LINKER:`` prefix can be used to specify, in a portable way, options
|
|
|
|
|
to pass to the linker tool. The ``LINKER:`` prefix is replaced by the required
|
|
|
|
|
driver option and the rest of the option string defines linker arguments using
|
|
|
|
|
``,`` as separator. These arguments will be formatted according to the
|
|
|
|
|
:variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG` and
|
|
|
|
|
:variable:`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 can be specified as part of a ``SHELL:`` prefix
|
|
|
|
|
expression.
|
|
|
|
|
|
|
|
|
|
The ``LINKER:`` prefix supports, as alternate syntax, specification of
|
|
|
|
|
arguments using ``SHELL:`` prefix and space as separator. Previous example
|
|
|
|
|
becomes ``"LINKER:SHELL:-z defs"``.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
Specifying ``SHELL:`` prefix elsewhere than at the beginning of the
|
|
|
|
|
``LINKER:`` prefix is not supported.
|
