mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-25 07:58:59 -06:00
We represent stub libraries, e.g., for CUDA, using imported `SHARED` library targets with only `IMPORTED_IMPLIB`, and no `IMPORTED_LOCATION`, to indicate that the stub file is meant only for linkers and not dynamic loaders. See commit7351d590ee(cmTarget: Add a way to represent imported shared library stubs, 2023-07-17, v3.28.0-rc1~344^2) and commitfc6508921c(cmComputeLinkInformation: Restore soname lookup for non-imported targets, 2023-12-05, v3.28.0~4^2). If a shared library is linked to a stub, it has a `NEEDED` field populated with the `SONAME` found in the stub. When a dependent target links to such a shared library, some linkers want to find a library file on disk and load it to see what symbols it provides. This is necessary for linkers that enforce `--no-allow-shlib-undefined`. On hosts with only the stub library installed, e.g., with only the CUDA toolkit development package, the real runtime library corresponding to the stub's `SONAME` may not even exist, so no `-rpath-link` flag can help linkers find it. Pass the stub library to linkers explicitly so they can find it without searching.
26 lines
807 B
CMake
26 lines
807 B
CMake
enable_language(C)
|
|
|
|
add_library(Stub SHARED Stub.c)
|
|
set_target_properties(Stub PROPERTIES
|
|
SOVERSION 1
|
|
LIBRARY_OUTPUT_DIRECTORY lib
|
|
)
|
|
|
|
set(StubDir ${CMAKE_CURRENT_BINARY_DIR}/lib/stubs)
|
|
set(Stub "${StubDir}/${CMAKE_SHARED_LIBRARY_PREFIX}Stub${CMAKE_SHARED_LIBRARY_SUFFIX}")
|
|
add_custom_target(StubCopy
|
|
COMMAND ${CMAKE_COMMAND} -E make_directory "${StubDir}"
|
|
COMMAND ${CMAKE_COMMAND} -E copy "$<TARGET_SONAME_FILE:Stub>" "${Stub}"
|
|
BYPRODUCTS ${Stub}
|
|
)
|
|
add_dependencies(StubCopy Stub)
|
|
add_library(Imp::Stub SHARED IMPORTED)
|
|
set_property(TARGET Imp::Stub PROPERTY IMPORTED_IMPLIB "${Stub}")
|
|
add_dependencies(Imp::Stub StubCopy)
|
|
|
|
add_library(StubUse SHARED StubUse.c)
|
|
target_link_libraries(StubUse PRIVATE Imp::Stub)
|
|
|
|
add_executable(StubExe StubExe.c)
|
|
target_link_libraries(StubExe PRIVATE StubUse)
|