kc3-lang/dlfcn-win32/README.md

• Show log

  Commit

• Hash : b30b758e
  Author :
  Date : 2017-08-24T21:50:51
  

  Mention the possibility of defining CMAKE_DL_LIBS

Download

...
find_package(dlfcn-win32 REQUIRED)
...
target_link_libraries(<target> dlfcn-win32::dl)
...

...
if (WIN32)
  find_package(dlfcn-win32 REQUIRED)
  set(CMAKE_DL_LIBS dlfcn-win32::dl)
endif ()  
...
target_link_libraries(<target> ${CMAKE_DL_LIBS})
...

Source

• README.md

• dlfcn-win32 [![Build status](https://ci.appveyor.com/api/projects/status/celmbkqj0k41fk04/branch/master?svg=true)](https://ci.appveyor.com/project/dlfcn-win32/dlfcn-win32/branch/master)
  ===========
  
  dlfcn-win32 is an implementation of dlfcn for Windows.
  
  dlfcn is a set of functions that allows runtime dynamic library loading. It is
  standardized in the POSIX. Windows also provide similar routines, but not in a
  POSIX-compatible way. This library attempts to implement a wrapper around the
  Windows functions to make programs written for POSIX that use dlfcn work in
  Windows without any modifications.
  
  It follows the standard as described here:
  
  http://www.opengroup.org/onlinepubs/009695399/basedefs/dlfcn.h.html
  http://www.opengroup.org/onlinepubs/009695399/functions/dlerror.html
  http://www.opengroup.org/onlinepubs/009695399/functions/dlsym.html
  http://www.opengroup.org/onlinepubs/009695399/functions/dlclose.html
  http://www.opengroup.org/onlinepubs/009695399/functions/dlopen.html
  
  Using This Library
  ------------------
  
  ### Using CMake 
  Once the library has been installed, add to your project `CMakeLists.txt` : 
  ~~~
  ...
  find_package(dlfcn-win32 REQUIRED)
  ...
  target_link_libraries(<target> dlfcn-win32::dl)
  ...
  ~~~
  If you want to use this library in a cross-platform project, a convenient way 
  to proceed is to define the CMake variable [`CMAKE_DL_LIBS`](https://cmake.org/cmake/help/latest/variable/CMAKE_DL_LIBS.html)
  (that is normally empty on Windows) and then use it for linking: 
  ~~~
  ...
  if (WIN32)
    find_package(dlfcn-win32 REQUIRED)
    set(CMAKE_DL_LIBS dlfcn-win32::dl)
  endif ()  
  ...
  target_link_libraries(<target> ${CMAKE_DL_LIBS})
  ...
  ~~~
  
  ### Linking caveat  
  This library uses the Process Status API in Windows (`psapi.lib`). If you are
  linking to the static `dl.lib` or `libdl.a`, then you would need to explicitly
  add `psapi.lib` or `-lpsapi` to your linking command, depending on if MinGW is
  used.
  
  Author
  ------
  
  Written by Ramiro Polla in 2007.
  Maintained by Tiancheng "Timothy" Gu from 2013.
  
  License
  -------
  
  dlfcn-win32 is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.
  
  dlfcn-win32 is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.
  
  You should have received a copy of the GNU Lesser General Public
  License along with dlfcn-win32; if not, write to the Free Software
  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  

Download