#bgp

zettabgp

This is a BGP (parsing and composing) and BMP (only parsing) protocols driver library for Rust

12 releases

0.3.4 Oct 26, 2023
0.3.3 Jan 17, 2023
0.3.0 Oct 8, 2022
0.2.1 Aug 1, 2021
0.1.2 May 23, 2021

#311 in Network programming

Download history 31/week @ 2023-10-29 36/week @ 2023-11-05 36/week @ 2023-11-12 36/week @ 2023-11-19 69/week @ 2023-11-26 26/week @ 2023-12-03 28/week @ 2023-12-10 54/week @ 2023-12-17 57/week @ 2023-12-24 14/week @ 2023-12-31 17/week @ 2024-01-07 22/week @ 2024-01-14 34/week @ 2024-01-21 48/week @ 2024-01-28 23/week @ 2024-02-04 61/week @ 2024-02-11

166 downloads per month
Used in 3 crates

MIT/Apache

340KB
8K SLoC

zettabgp - BGP&BMP Rust library

This is a BGP and BMP protocols driver library for Rust.

BGP - Border Gateway Protocol version 4. BMP - BGP Monitoring Protocol version 3.

Supported BGP message types

  • Open
  • Notification
  • Keepalive
  • Update

Supported BMP message types

  • Initiation
  • Termination
  • PeerUpNotification
  • RouteMonitoring

Supported address families NLRI (network layer reachability information)

  • ipv4 unicast
  • ipv4 labeled-unicast
  • ipv4 multicast
  • ipv4 mvpn
  • ipv4 mdt
  • vpnv4 unicast
  • vpnv4 multicast
  • ipv6 unicast
  • ipv6 labeled-unicast
  • ipv6 multicast
  • ipv6 mdt
  • vpnv6 unicast
  • vpnv6 multicast
  • vpls
  • evpn
  • flowspec ipv4
  • flowspec ipv6

Supported path attributes

  • MED
  • Origin
  • Local preference
  • AS path
  • Communities
  • Extended communities
  • Aggregator AS
  • Atomic aggregate
  • Cluster list
  • Originator ID
  • Attribute set
  • Connector
  • some PMSI tunnels

Usage

Library allow you to parse protocol messages (as binary buffers) into Rust data structures to frther processing. Or generate valid protocol messages from Rust data structure. So it can be use in any environment (synrchronous or asynchronous) to make a BGP RR, monitoring system or BGP analytics.

use zettabgp::prelude::*;
use std::io::{Read,Write};
let mut socket = match std::net::TcpStream::connect("127.0.0.1:179") {
  Ok(sck) => sck,
  Err(e) => {eprintln!("Unable to connect to BGP neighbor: {}",e);return;}
};
let params=BgpSessionParams::new(64512,180,BgpTransportMode::IPv4,std::net::Ipv4Addr::new(1,1,1,1),vec![BgpCapability::SafiIPv4u].into_iter().collect());
let mut buf = [0 as u8; 32768];
let mut open_my = params.open_message();
let open_sz = open_my.encode_to(&params, &mut buf[19..]).unwrap();
let tosend = params.prepare_message_buf(&mut buf, BgpMessageType::Open, open_sz).unwrap();
socket.write_all(&buf[0..tosend]).unwrap();//send my open message
socket.read_exact(&mut buf[0..19]).unwrap();//read response message head
let messagehead=params.decode_message_head(&buf).unwrap();//decode message head
if messagehead.0 == BgpMessageType::Open {
   socket.read_exact(&mut buf[0..messagehead.1]).unwrap();//read message body
   let mut bom = BgpOpenMessage::new();
   bom.decode_from(&params, &buf[0..messagehead.1]).unwrap();//decode received message body
   eprintln!("BGP Open message received: {:?}", bom);
}

Crates.io

https://crates.io/crates/zettabgp

Documentation

https://docs.rs/zettabgp

License

MIT OR Apache-2.0

Dependencies

~41–250KB