ROAFetchlib: A C repository from grundrauschen

Introduction

The ROAFetchlib is an open source C Implementation for live and historical Prefix Origin Validation of BGP Announcements.

It enables BGP measurement analysis tools to support BGP Prefix Origin Validation (RFC 6811). For the live validation the RPKI-RTR protocol (RFC 6810) is used. The general validation process is implemented by the RTRlib (http://rtrlib.realmv6.org/)

Requirements

RTRlib: http://rtrlib.realmv6.org
Libwandio: https://research.wand.net.nz/software/libwandio.php
Doxygen (optional)

Compilation

Install the RTRlib (optional with SSH) and Libwandio

If a library was not installed in the default path then add it to LD_LIBRARY_PATH and CPPFLAGS:

$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:"<path_to_librtr.so>"
$ export CPPFLAGS=$CPPFLAGS"<path_to_rtrlib_includes>"

Build and install the ROAFetchlib:

$ ./autobuild.sh
$ ./configure
$ make
$ (sudo) make install
$ make check

If a library or includes were not found then add -L -I flags:

$ ./configure CFLAGS='-L<path_to_librtr.so> -I<path_to_rtrlib_includes>'
$ make

To change the install path (optional):
```
$ ./configure --prefix=<install_path>
```
To activate debug mode (optional):
```
$ ./configure --enable-debug
```

Linking to ROAFetchlib

The name of the shared library is roafetch. To link programs to the ROAFetchlib, pass the following parameter to gcc:

-lroafetch

In case an error such as

-/usr/bin/ld: cannot find -lroafetch

occurs, the location of the library can be passed explicitly as a parameter

-L<path_to_roafetchlib.so>

e.g.,

-L/usr/local/lib/

API Documentation

The ROAFetchlib includes a man file documentation of the API.

$ man roafetchlib

Also a doxygen version of the API is available at: doc/doxygen

Contact

Mail: s.al-sheikh@fu-berlin.de