2018-10-28 12:09:07 +01:00
|
|
|
LINK_OPTIONS
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
List of options to use for the link step of shared library, module
|
2020-08-30 11:54:41 +02:00
|
|
|
and executable targets as well as the device link step. Targets that are static
|
|
|
|
|
libraries need to use the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property.
|
2018-10-28 12:09:07 +01:00
|
|
|
|
2020-08-30 11:54:41 +02:00
|
|
|
These options are used for both normal linking and device linking
|
|
|
|
|
(see policy :policy:`CMP0105`). To control link options for normal and device
|
|
|
|
|
link steps, ``$<HOST_LINK>`` and ``$<DEVICE_LINK>``
|
|
|
|
|
:manual:`generator expressions <cmake-generator-expressions(7)>` can be used.
|
2018-10-28 12:09:07 +01:00
|
|
|
|
2020-08-30 11:54:41 +02:00
|
|
|
This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of
|
|
|
|
|
options specified so far for its target. Use the :command:`target_link_options`
|
2018-10-28 12:09:07 +01:00
|
|
|
command to append more options.
|
|
|
|
|
|
|
|
|
|
This property is initialized by the :prop_dir:`LINK_OPTIONS` directory
|
|
|
|
|
property when a target is created, and is used by the generators to set
|
|
|
|
|
the options for the compiler.
|
|
|
|
|
|
|
|
|
|
Contents of ``LINK_OPTIONS`` may use "generator expressions" with the
|
|
|
|
|
syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual
|
|
|
|
|
for available expressions. See the :manual:`cmake-buildsystem(7)` manual
|
|
|
|
|
for more on defining buildsystem properties.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
This property must be used in preference to :prop_tgt:`LINK_FLAGS` property.
|
