Rust 中的边界网关协议 (bgp-rs)

一个用于解析边界网关协议 (BGP) 格式化流的库。可以通过这种方式读取 UPDATE、OPEN、KEEPALIVE 和 NOTIFICATION 等消息。

示例 & 文档

读取包含 BGP4MP 消息的 MRT 文件

use std::fs::File;
use std::io::Cursor;
use std::io::Read;
use std::io::BufReader;
use mrt_rs::Record;
use mrt_rs::bgp4mp::BGP4MP;
use libflate::gzip::Decoder;
use bgp_rs::{Identifier, PathAttribute};

fn main() {
   // Download an update message.
   let file = File::open("res/updates.20190101.0000.gz").unwrap();

   // Decode the GZIP stream.
   let decoder = Decoder::new(BufReader::new(file)).unwrap();

   // Create a new MRTReader with a Cursor such that we can keep track of the position.
   let mut reader = mrt_rs::Reader { stream: decoder };

   // Keep reading MRT (Header, Record) tuples till the end of the file has been reached.
   while let Ok(Some((_, record))) = reader.read() {

       // Extract BGP4MP::MESSAGE_AS4 entries.
       if let Record::BGP4MP(BGP4MP::MESSAGE_AS4(x)) = record {

           // Read each BGP (Header, Message)
           let cursor = Cursor::new(x.message);
           let mut reader = bgp_rs::Reader::new(cursor);
           let (_, message) = reader.read().unwrap();

           // If this is an UPDATE message that contains announcements, extract its origin.
           if let bgp_rs::Message::Update(x) = message {
               if x.is_announcement() {
                   if let PathAttribute::AS_PATH(path) = x.get(Identifier::AS_PATH).unwrap()
                   {
                       // Test the path.origin() method.
                       let origin = path.origin();

                       // Do other stuff ...
                   }
               }
           }
       }
   }

读取包含 TABLE_DUMP_V2 消息的 MRT 文件

有关示例和文档，请参阅此处。

支持的路径属性

IANA 有一个官方的 BGP 路径属性数字分配列表。下表显示了每个路径属性的状态

最低支持的Rust版本

本crate最低支持的rustc版本是1.34.2。

Crate特性

默认特性集包括上述属性的BGP消息的编码和解码

启用Flowspec NLRI

要启用Flowspec NLRI（SAFI 133）解析（RFC5575），指定flowspec特性

[dependencies]
...
bgp-rs = { version = "*", features = ["flowspec"]}
...

注意：这将添加bitflags依赖