Installation

Install Ubuntu

Install dependencies:

sudo apt install -y libssl1.1 libncurses5 libjansson4

Download and install debian package: https://github.com/rtbrick/bngblaster/releases

sudo dpkg -i <package>

This command installs the BNG Blaster to /usr/sbin/bngblaster.

Build from Sources

Dependencies

The BNG Blaster has dependencies to the RtBrick libdict fork (https://github.com/rtbrick/libdict) and the following standard dependencies:

sudo apt install -y cmake \
    libcunit1-dev \
    libncurses5-dev \
    libssl-dev \
    libjansson-dev

Build

Per default cmake (cmake .) will build the BNG Blaster as release version with optimization and without debug symbols.

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make all

Alternative it is also possible to build a debug version for detailed troubleshooting using gdb.

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make all

There are also CPack files generated which allows to easily generate a debian package by just executing cpack from build directory.

It is also recommended to provide the GIT commit details to be included in the manually build version as shown below:

cmake -DGIT_REF=`git rev-parse --abbrev-ref HEAD` -DGIT_SHA=`git rev-parse HEAD` ..

Example:

$ bngblaster -v
GIT:
  REF: dev
  SHA: df453a5ee9dbf6440aefbfb9630fa0f06e326d44
IO Modes: packet_mmap_raw (default), packet_mmap, raw

Install

Then BNG Blaster can be installed using make install target.

sudo make install

This command installs the BNG Blaster to /usr/local/sbin/bngblaster.

An existing version installed from debian package in /usr/sbin is not automatically replaced or removed here and should be deleted manually before install. Otherwise it might be possible that two versions remain in parallel.

sudo rm /usr/sbin/bngblaster

Build and Run Unit Tests

Building and running unit tests requires CMocka to be installed:

sudo apt install libcmocka-dev

The option BNGBLASTER_TESTS enables to build unit tests.

cmake -DCMAKE_BUILD_TYPE=Debug -DBNGBLASTER_TESTS=ON .
make all
make test

Example

$ make test
Running tests...
Test project
    Start 1: TestProtocols
1/1 Test #1: TestProtocols ....................   Passed    0.00 sec

100% tests passed, 0 tests failed out of 1

Total Test time (real) =   0.00 sec

2.4 KiB Raw Blame History