Skip to content

Latest commit

 

History

History
107 lines (68 loc) · 3.15 KB

binaries_linux.rst

File metadata and controls

107 lines (68 loc) · 3.15 KB
Raw

Linux installation from binaries

The instructions for installing eProsima Fast DDS in a Linux environment from binaries are provided in this page.

Install

The latest release of eProsima Fast DDS for Linux is available at the eProsima website Downloads tab. Once downloaded, extract the contents in your preferred directory. Then, to install eProsima Fast DDS and all its dependencies in the system, execute the install.sh script with administrative privileges:

cd <extraction_directory>
sudo ./install.sh

Note

By default, eProsima Fast DDS does not compile tests. To activate them, please refer to the linux_sources page.

Contents

The 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 src directory.

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:

    export LD_LIBRARY_PATH=/usr/local/lib/

  • Add it permanently to the PATH by executing:

    echo 'export LD_LIBRARY_PATH=/usr/local/lib/' >> ~/.bashrc

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 FASTDDS_STATIC is possible to choose the desired linkage (dynamic or static library) in the CMake generator stage. If the variable is missing defaults to dynamic linking.

For example in order to build the examples statically linked to Fast-DDS do:

$ cmake -Bbuildexample -DFASTDDS_STATIC=ON .
$ cmake --build buildexample --target install

Uninstall

To uninstall all installed components, execute the uninstall.sh script (with administrative privileges):

cd <extraction_directory>
sudo ./uninstall.sh

Warning

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.