mirror of
https://github.com/Kitware/CMake.git
synced 2026-08-10 17:14:10 +00:00
c8b6725977
Also, correct the documentation added in commit 98f9874703 (cmake:
Add per-language link flags for all target types, 2025-12-17) by
placing the variables in the proper section of cmake-variables(7).
Issue: #21934
50 lines
1.5 KiB
ReStructuredText
50 lines
1.5 KiB
ReStructuredText
add_link_options
|
|
----------------
|
|
|
|
.. versionadded:: 3.13
|
|
|
|
Add options to the link step for executable, shared library or module
|
|
library targets in the current directory and below that are added after
|
|
this command is invoked.
|
|
|
|
.. code-block:: cmake
|
|
|
|
add_link_options(<option> ...)
|
|
|
|
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.
|
|
|
|
.. |command_name| replace:: ``add_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:`link_libraries`
|
|
* :command:`target_link_libraries`
|
|
* :command:`target_link_options`
|
|
|
|
* :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.
|