Skip to content

An Open-source C Implementation for Live and Historical Prefix Origin Validation of BGP Announcements

License

Notifications You must be signed in to change notification settings

RPKI/ROAFetchlib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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: [email protected]

/* vim: set tw=80 sts=2 sw=2 ts=2 expandtab: */

About

An Open-source C Implementation for Live and Historical Prefix Origin Validation of BGP Announcements

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published