From cd7b005519ade8ab6c97fcb21590b71b7d1be6e3 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 28 Apr 2024 11:54:46 +0200 Subject: Adding upstream version 0.8.0. Signed-off-by: Daniel Baumann --- doxygen/mainpage.dox | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 doxygen/mainpage.dox (limited to 'doxygen/mainpage.dox') diff --git a/doxygen/mainpage.dox b/doxygen/mainpage.dox new file mode 100644 index 0000000..6830a56 --- /dev/null +++ b/doxygen/mainpage.dox @@ -0,0 +1,53 @@ +/** +@mainpage RTRlib +This is the API documentation of the RTRlib, a C implementation of the +RPKI/Router Protocol client. + +@section Overview + +@par +The RTRlib follows a flexible design. The software architecture includes +different layers to simplify the extension or exchange of individual +parts.\n + +\n +\image html components.png +\n + +@par +The lowest layer of the architecture is built by the @ref mod_transport_h. +It allows for the implementation of different transport channels that +provide a common interface to exchange PDUs with the cache (i.e., the +RPKI-RTR server). The current version of the library supports unprotected +TCP and SSH.\n + +@par +On the top of the transport layer the @ref mod_rtr_h uses a transport +socket for RTR-specific data exchange with the RTR server. The RTR socket +implements the RPKI-RTR protocol, i.e., fetches validation records and +stores them in a prefix table data structure.\n + +@par +The @ref mod_pfx_h stores validated prefix origin data. The abstract data +structure provides a common interface to add and delete entries as well as +to verify a specific prefix. The library implements a Trie, +but can be extended to other data structures.\n + +@par +On the top of the modular architecture the @ref +mod_rtr_mgr_h maintains the connection to multiple +RTR servers. This includes failover mechanisms. It represents the main +interface for users of the library. + +@section RfcDrafts RFCs and Drafts +The functionality of this library is described by the following IETF RFCs +and drafts: +\li The Resource Public Key +Infrastructure (RPKI) to Router Protocol (RFC 6810) +\li BGP Prefix Origin +Validation (RFC 6811) + +For a general overview of the topic have look at the homepage of the IETF SIDR working +group. +*/ -- cgit v1.2.3