1. Linux installation from binaries¶
The instructions for installing eProsima Fast DDS in a Linux environment from binaries are provided in this page.
The latest release of eProsima Fast DDS for Linux is available at the eProsima website
Once downloaded, extract the contents in your preferred directory.
Then, to install eProsima Fast DDS and all its dependencies in the system, execute
install.sh script with administrative privileges:
cd <extraction_directory> sudo ./install.sh
By default, eProsima Fast DDS does not compile tests. To activate them, please refer to the Linux installation from sources page.
src folder contains the following packages:
foonathan_memory_vendor, an STL compatible C++ memory allocator library.
fastcdr, a C++ library for data serialization according to the CDR standard (Section 10.2.1.2 OMG CDR).
fastrtps, the core library of eProsima Fast DDS library.
fastddsgen, a Java application that generates source code using the data types defined in an IDL file.
In case any of these components is unwanted, it can be simply renamed or removed from the
1.1.2. Run an application¶
When running an instance of an application using eProsima Fast DDS, it must be linked with the library where the
packages have been installed,
/usr/local/lib/. There are two possibilities:
Prepare the environment locally by typing in the console used for running the eProsima Fast DDS instance the command:
Add it permanently to the
echo 'export LD_LIBRARY_PATH=/usr/local/lib/' >> ~/.bashrc
1.1.3. Including Fast-DDS in a CMake project¶
The installer deploys CMake config files that simplify to incorporate Fast-DDS to any CMake project via the find_package CMake API.
By setting the CMake variable BUILD_SHARED_LIBS is possible to choose the desired linkage (dynamic or static library) in the CMake generator stage. If the variable is missing build process will default to static linking.
For example in order to build the examples dynamically linked to Fast-DDS do:
$ cmake -Bbuildexample -DBUILD_SHARED_LIBS=ON . $ cmake --build buildexample --target install
To uninstall all installed components, execute the uninstall.sh script (with administrative privileges):
cd <extraction_directory> sudo ./uninstall.sh
If any of the other components were already installed in some other way in the system, they will be removed as well. To avoid it, edit the script before executing it.