| INTERFACE_LINK_DEPENDS |
| ---------------------- |
| |
| Additional public interface files on which a target binary depends for linking. |
| |
| This property is supported only by :generator:`Ninja` and |
| :ref:`Makefile Generators`. |
| It is intended to specify dependencies on "linker scripts" for |
| custom Makefile link rules. |
| |
| When target dependencies are specified using :command:`target_link_libraries`, |
| CMake will read this property from all target dependencies to determine the |
| build properties of the consumer. |
| |
| Contents of ``INTERFACE_LINK_DEPENDS`` may use "generator expressions" |
| with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` |
| manual for available expressions. See the :manual:`cmake-buildsystem(7)` |
| -manual for more on defining buildsystem properties. |
| |
| Link dependency files usage requirements commonly differ between the build-tree |
| and the install-tree. The ``BUILD_INTERFACE`` and ``INSTALL_INTERFACE`` |
| generator expressions can be used to describe separate usage requirements |
| based on the usage location. Relative paths are allowed within the |
| ``INSTALL_INTERFACE`` expression and are interpreted relative to the |
| installation prefix. For example: |
| |
| .. code-block:: cmake |
| |
| set_property(TARGET mylib PROPERTY INTERFACE_LINK_DEPENDS |
| $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/mylinkscript> |
| $<INSTALL_INTERFACE:mylinkscript> # <prefix>/mylinkscript |
| ) |