Dependencies¶

Warning

xsimd is linked publicly, and the detected SIMD flags (SIMD_CXX_FLAGS, typically -march=native) are applied publicly to anything linking ipc::toolkit. This is a requirement rather than a convenience: ipc/utils/simd.hpp exposes ipc::SimdBatch<T> in the public API, and xsimd::default_arch is resolved from each translation unit’s own compiler flags. A consumer compiled without these flags therefore names a different batch type than the one instantiated inside the library, and the link fails.

The practical consequence is that your binaries are compiled for the machine that built them and will not run on hardware lacking those instructions. If you need portable binaries, set IPC_TOOLKIT_WITH_SIMD to OFF; the library then builds without xsimd and without the architecture flags.

Warning

filib is licensed under LGPL-2.1 and as such it is required to be dynamically linked. Doing so automatically is a challenge, so by default we use static linkage. Enabling dynamic linkage requires copying the .so/.dylib/.dll file to the binary directory or system path. To enable this, set the CMake option FILIB_BUILD_SHARED_LIBS to ON and add this CMake code to copy the shared library object to the binary directory:

# Copy shared lib to the output directory
add_custom_command(
    TARGET ${MY_EXE_TARGET} POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_RUNTIME_DLLS:${MY_EXE_TARGET}> $<TARGET_FILE_DIR:${MY_EXE_TARGET}>
    COMMAND_EXPAND_LISTS
)

where ${MY_EXE_TARGET} is the name of your executable target. If you know a better way to handle this, please let us know!

If you would rather avoid LGPL code entirely, you can disable filib by setting IPC_TOOLKIT_WITH_FILIB to OFF. With this option disabled, CMake will not download or use any of filib’s code.