mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-23 14:48:19 -05:00
Peter Kokot
50 lines
1.2 KiB
ReStructuredText
50 lines
1.2 KiB
ReStructuredText
CMAKE_DL_LIBS
|
|
-------------
|
|
|
|
This variable contains a name of the dynamic loading library, or a list of
|
|
system libraries needed to use the ``dlopen()`` and ``dlclose()`` functions.
|
|
|
|
Few examples of the values this variable is set to:
|
|
|
|
``dl``
|
|
On most Unix-like systems.
|
|
|
|
``-lld``
|
|
On AIX.
|
|
|
|
``dld``
|
|
On HP-UX.
|
|
|
|
""
|
|
Empty string value or not set on systems that have ``dl*()`` functions
|
|
either in the default library that is implicitly linked (e.g., BSD-like
|
|
systems, Haiku, macOS, SunOS, etc.), or on systems that don't provide these
|
|
functions (e.g., Windows).
|
|
|
|
Examples
|
|
^^^^^^^^
|
|
|
|
Example: Linking Dynamic Loading Library
|
|
""""""""""""""""""""""""""""""""""""""""
|
|
|
|
Using this variable in a project that uses dynamic loading functionality:
|
|
|
|
.. code-block:: cmake
|
|
|
|
target_link_libraries(example PRIVATE ${CMAKE_DL_LIBS})
|
|
|
|
Example: Checking Symbols
|
|
"""""""""""""""""""""""""
|
|
|
|
Checking for symbols with the dynamic loading library linked during the check:
|
|
|
|
.. code-block:: cmake
|
|
|
|
include(CheckSymbolExists)
|
|
include(CMakePushCheckState)
|
|
|
|
cmake_push_check_state(RESET)
|
|
set(CMAKE_REQUIRED_LIBRARIES ${CMAKE_DL_LIBS})
|
|
check_symbol_exists(dlopen "dlfcn.h" HAVE_DLOPEN)
|
|
cmake_pop_check_state()
|