mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-09-25 04:09:36 +03:00
Arha Gatram
79e421b053
Now that set_property and set_target_properties support ALIAS targets, we need to extend support to all the target_* type commands that modify target properties. Relaxes target_compile_definitions, target_compile_features, target_compile_options, target_include_directories, target_link_directories, target_link_libraries, target_link_options, target_precompile_headers, and target_sources to now accept ALIAS targets. These commands set properties on the target which the alias references.
80 lines
2.8 KiB
ReStructuredText
80 lines
2.8 KiB
ReStructuredText
target_link_options
|
|
-------------------
|
|
|
|
.. versionadded:: 3.13
|
|
|
|
Add options to the link step for an executable, shared library or module
|
|
library target.
|
|
|
|
.. code-block:: cmake
|
|
|
|
target_link_options(<target> [BEFORE]
|
|
{INTERFACE|PUBLIC|PRIVATE} <item>...
|
|
[{INTERFACE|PUBLIC|PRIVATE} <item>...]...)
|
|
|
|
The named ``<target>`` must have been created by a command such as
|
|
:command:`add_executable` or :command:`add_library`.
|
|
|
|
.. versionchanged:: 4.5
|
|
If ``<target>`` is an :ref:`Alias Target <Alias Targets>`, the command
|
|
operates on the target which the alias references.
|
|
|
|
This command can be used to add any link options, but alternative commands
|
|
exist to add libraries (:command:`target_link_libraries` or
|
|
:command:`link_libraries`). See documentation of the
|
|
:prop_dir:`directory <LINK_OPTIONS>` and
|
|
:prop_tgt:`target <LINK_OPTIONS>` ``LINK_OPTIONS`` properties.
|
|
|
|
.. note::
|
|
|
|
This command cannot be used to add options for static library targets,
|
|
since they do not use a linker. To add archiver or MSVC librarian flags,
|
|
see the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property.
|
|
|
|
If ``BEFORE`` is specified, the content will be prepended to the property
|
|
instead of being appended.
|
|
|
|
The ``INTERFACE``, ``PUBLIC`` and ``PRIVATE`` keywords are required to
|
|
specify the :ref:`scope <Target Command Scope>` of the following arguments.
|
|
``PRIVATE`` and ``PUBLIC`` items will populate the :prop_tgt:`LINK_OPTIONS`
|
|
property of ``<target>``. ``PUBLIC`` and ``INTERFACE`` items will populate the
|
|
:prop_tgt:`INTERFACE_LINK_OPTIONS` property of ``<target>``.
|
|
The following arguments specify link options. Repeated calls for the same
|
|
``<target>`` append items in the order called.
|
|
|
|
.. note::
|
|
:ref:`IMPORTED targets <Imported Targets>` only support ``INTERFACE`` items.
|
|
|
|
.. |command_name| replace:: ``target_link_options``
|
|
.. include:: include/GENEX_NOTE.rst
|
|
|
|
.. include:: include/DEVICE_LINK_OPTIONS.rst
|
|
|
|
.. include:: include/OPTIONS_SHELL.rst
|
|
|
|
.. include:: include/LINK_OPTIONS_LINKER.rst
|
|
|
|
See Also
|
|
^^^^^^^^
|
|
|
|
* :command:`target_compile_definitions`
|
|
* :command:`target_compile_features`
|
|
* :command:`target_compile_options`
|
|
* :command:`target_include_directories`
|
|
* :command:`target_link_libraries`
|
|
* :command:`target_link_directories`
|
|
* :command:`target_precompile_headers`
|
|
* :command:`target_sources`
|
|
|
|
* :variable:`CMAKE_<LANG>_FLAGS` and :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>`
|
|
add language-wide flags passed to all invocations of the compiler.
|
|
This includes invocations that drive compiling and those that drive linking.
|
|
|
|
* .. versionadded:: 4.3
|
|
:variable:`CMAKE_<LANG>_LINK_FLAGS` and
|
|
:variable:`CMAKE_<LANG>_LINK_FLAGS_<CONFIG>` add language-wide flags passed
|
|
to all invocations of the compiler which drive linking.
|
|
|
|
* The :module:`CheckLinkerFlag` module to check whether a linker flag is
|
|
supported by the compiler.
|