add_link_options

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.