MRTSharp 1.0.7

MRT#

MRT# is a fast multi-threaded MRT parser library written in C#.

It is freely available on NuGet.

Publication

• MRT#: a Fast Multi-Threaded MRT Parser (at IM 2021)
  • Paper
  • Presentation

Winner of the "IM 2021 Best Demonstration Award" (Link)

Example Usage

The entrypoint of the parser is the Run static method of the MRTParser class.

using MRTSharp;
using System.IO;

class Program
{
    static void Main()
    {
        FileInfo file = new FileInfo(@"path-to-mrt-file");

        MRTParser.Run(file, (mrtEntry) =>
        {
            // Do something with the mrtEntry
        });
    }
}

Other options

Input file options

MRTParser.Run method has different signatures. It accepts FileInfo, IEnumerable<FileInfo> or DirectoryInfo as parameter. Using the DirectoryInfo version, all files contained in the specified directory are processed, ignoring subdirectories and their files.

The file can be a plain MRT file or a compressed one. The compression format is automatically detected through the file extension. Accepted extensions for compressed files are .gz and .bz2.

Processing options

All the MRTParser.Run methods that accept more than one file (IEnumerable<FileInfo> or DirectoryInfo) have an optional boolean parameter multithreaded (default=true) that can be used to disable the multithreaded parsing.

Output options

MRTParser.Run method has two signatures. The first one, only takes a single parameter (FileInfo, IEnumerable<FileInfo> or DirectoryInfo) and returns a List. The second one, takes two parameters: FileInfo/IEnumerable<FileInfo>/DirectoryInfo, and a callback (like in the above example) that enables the user to further process MRT records.

Moreover, both the one and two parameter versions of the method can be invoked with the diamond operator <T>. Using <T>, it is possible to specify the type of the returned objects. All the objects that cannot be downcasted to T are automatically discarded. T can be one of the following: MRTEntry (default, if not specified), TableDumpRIBRecord, BGP4MPEntry, BGP4MPMessage, or BGP4MPStateChange.

Logging

MRT# logs on the DEBUG channel if an MRT file is corrupted or some fields cannot be parsed.

You can connect your own logger, that MUST be an instance of a Microsoft.Extensions.Logging.ILogger implementation, using the SetLogger static method of MRTParser before calling the Run method.

MRTParser.SetLogger(yourILoggerVariable);

MRTParser.Run(...);

Support

In the following, there is a list of what MRT# is currently supporting.

MRT Types

Defined here

TABLE_DUMP_V2 Subtype

Defined here

BGP4MP/BGP4MP_ET Subtype

Defined here and here

BGP Message Types

Defined here

BGP Path Attributes

Defined here

Address Family Identifiers (AFI) Values

Defined here

Subsequent Address Family Identifiers (SAFI) Values

Defined here

BGP Capabilities

Defined here