LINK_WHAT_YOU_USE | |
----------------- | |
.. versionadded:: 3.7 | |
This is a boolean option that, when set to ``TRUE``, will automatically run | |
contents of variable :variable:`CMAKE_LINK_WHAT_YOU_USE_CHECK` on the target | |
after it is linked. In addition, the linker flag specified by variable | |
:variable:`CMAKE_<LANG>_LINK_WHAT_YOU_USE_FLAG` will be passed to the target | |
with the link command so that all libraries specified on the command line will | |
be linked into the target. This will result in the link producing a list of | |
libraries that provide no symbols used by this target but are being linked to | |
it. | |
.. note:: | |
For now, it is only supported for ``ELF`` platforms and is only applicable to | |
executable and shared or module library targets. This property will be | |
ignored for any other targets and configurations. | |
This property is initialized by the value of | |
the :variable:`CMAKE_LINK_WHAT_YOU_USE` variable if it is set | |
when a target is created. |