IMPORTED_LIBNAME.rst 1.0 KB

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