| 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. |