835f34949e
Re-organize the section to explicitly describe target-specific commands, build properties, and usage requirement properties. Add builtin transitive properties that have been created since the document was first written.
69 lines
2.4 KiB
ReStructuredText
69 lines
2.4 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> [items1...]
|
|
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
|
|
|
|
The named ``<target>`` must have been created by a command such as
|
|
:command:`add_executable` or :command:`add_library` and must not be an
|
|
:ref:`ALIAS target <Alias Targets>`.
|
|
|
|
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:: GENEX_NOTE.txt
|
|
|
|
.. include:: DEVICE_LINK_OPTIONS.txt
|
|
|
|
.. include:: OPTIONS_SHELL.txt
|
|
|
|
.. include:: LINK_OPTIONS_LINKER.txt
|
|
|
|
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.
|