CLI that maintains ROA table in BIRD using RTRlib
C CMake
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cmake/modules add cmake modules to find deps Jun 20, 2016
CMakeLists.txt Fix build for Ubuntu/Debian Jun 22, 2018
COPYING Added copyright notices and LGPL May 1, 2014
README README: fix spelling of Requirements Jan 8, 2017
bird-rtrlib-cli.c added daemon and pidfile support Jun 23, 2018
bird.c handle sigpipe error Jun 22, 2016
bird.h
cli.c added daemon and pidfile support Jun 23, 2018
cli.h Added copyright notices and LGPL May 1, 2014
config.c handle sigpipe error Jun 22, 2016
config.h added daemon and pidfile support Jun 23, 2018
rtr.c
rtr.h update to new rtrlib api Jun 20, 2016

README

BIRD RTRlib CLI Integration
===========================

Introduction
------------

This tool maintains the ROA table of the BIRD Internet Routing Daemon
(http://bird.network.cz). It automatically adds and deletes ROA
information using the RTRlib (http://rpki.realmv6.org/).

This tool brings RPKI functionality to BIRD but does not require any
changes to the BIRD code base. The program runs in parallel to the BIRD
daemon and communicates with the daemon via the BIRD control socket.


Requirements
------------

To build the command line interface, (1) the CMake build system, (2)
RTRlib with SSH support, and (3) BIRD must be installed.


Compilation
-----------

* Generate Makefile

  RTRlib was installed in default paths

    cmake .

  RTRlib was installed in a non-default directory <rtrlib>

    cmake -DRTRLIB_INCLUDE=<rtrlib> -DRTRLIB_LIBRARY=</path/to/rtrlib.[a|so|dylib]> .


* Build the command line interface

    make


Using
-----

* Create a ROA table in the bird.conf

* Start BIRD RTRLIB CLI, i.e., connect to a BIRD control socket and RPKI
  cache server, for example

    ./bird-rtrlib-cli -b /var/run/bird.ctl -r rpki-validator.realmv6.org:8282

* Help

   ./bird-rtrlib-cli --help


Contact
-------

Mailing List: rtrlib@googlegroups.com