CMake/Help/prop_tgt/IMPORTED_LIBNAME.rst

24 lines
1.0 KiB
ReStructuredText
Raw Normal View History

IMPORTED_LIBNAME
----------------
Specify the link library name for an :ref:`imported <Imported Targets>`
:ref:`Interface Library <Interface Libraries>`.
An interface library builds no library file itself but does specify
usage requirements for its consumers. The ``IMPORTED_LIBNAME``
property may be set to specify a single library name to be placed
on the link line in place of the interface library target name as
a requirement for using the interface.
This property is intended for use in naming libraries provided by
a platform SDK for which the full path to a library file may not
be known. The value may be a plain library name such as ``foo``
but may *not* be a path (e.g. ``/usr/lib/libfoo.so``) or a flag
(e.g. ``-Wl,...``). The name is never treated as a library target
name even if it happens to name one.
The ``IMPORTED_LIBNAME`` property is allowed only on
:ref:`imported <Imported Targets>` :ref:`Interface Libraries`
and is rejected on targets of other types (for which
the :prop_tgt:`IMPORTED_LOCATION` target property may be used).