MRTSharp 1.0.0

MRT#

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

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.

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(...);