Skip to content

Latest commit

 

History

History
79 lines (63 loc) · 6.47 KB

README.md

File metadata and controls

79 lines (63 loc) · 6.47 KB
Raw

RustyBGP: BGP implementation in Rust

The mission is to develop a high-performance and safe BGP implementation; an experiment to implement aged and rusty BGP protocol in a modern language. RustyBGP is much faster than other OSS implementations. One reason of the high performance is that RustyBGP is designed to exploit multicore processors. Here is a CPU usage comparison with FRR 7.5 during processing 32 peers with 800K prefixes each; RustyBGP (left) uses all the cores while FRR uses only few.

RustyBGP supports the gRPC APIs same as GoBGP; your code to manage GoBGP via the APIs should work with RustyBGP. If you need CLI, GoBGP CLI tool allows you to manage RustyBGP. RustyBGP also supports the same configuration file format as GoBGP (only toml and yaml for now).

Get Started

You can easily build RusyBGP on any system that has Docker running. You don't need Rust development environment. You can build the x86_64 statically-linked binary as follows:

$ git clone https://github.com/osrg/rustybgp.git
$ cd rustybgp
$ docker pull ghcr.io/rust-cross/rust-musl-cross:x86_64-unknown-linux-musl
$ docker run --rm -it -v "$(pwd)":/home/rust/src ghcr.io/rust-cross/rust-musl-cross:x86_64-unknown-linux-musl cargo build --release
$ ls target/x86_64-unknown-linux-musl/release/rustybgpd
target/x86_64-unknown-linux-musl/release/rustybgpd
$ sudo ./target/x86_64-unknown-linux-musl/release/rustybgpd -f gobgpd.conf
Hello, RustyBGP (32 cpus)!

Then you can manage the daemon on a different terminal with GoBGP's CLI command.

$ gobgp neighbor
Peer            AS Up/Down State       |#Received  Accepted
198.51.100.2 65002   never Idle        |        0         0

If you just want to check out the performance, start the daemon with --any-peers option. The daemon accepts any peers without configuration.

$ sudo ./target/x86_64-unknown-linux-musl/release/rustybgpd --as-number 65001 --router-id 203.0.113.1 --any-peers
Hello, RustyBGP (32 cpus)!

Supported Features

Currently, the very basic BGP features are supported; eBGP and iBGP, active/passive connection, RPKI, BMP (BGP monitoring protocol), MRT, etc with the following gRPC APIs.

API Relevant CLI Note
start_bgp gobgp global as <VALUE> router-id <IP>
get_bgp gobgp global
add_peer gobgp neighbor add <IP> as <VALUE> router-id <IP> v4/v6 families and addpath (rx) supported
delete_peer gobgp neighbor del <IP>
list_peer gobgp neighbor/gobgp neighbor <IP>
enable_peer gobgp neighbor <IP> enable
disable_peer gobgp neighbor <IP> disable
add_peer_group
add_dynamic_neighbor
add_path gobgp global rib add <PREFIX>
delete_path gobgp global rib del <PREFIX>
list_path gobgp global rib/gobgp neighbor <IP> [adj-in|adj-out]
add_path_stream gobgp mrt global inject [FILE]
get_table gobgp global rib summary
add_policy
list_policy
add_defined_set
list_defined_set
add_statement
list_statement
add_policy_assignment
list_policy_assignment
add_rpki gobgp rpki server <IP> add
list_rpki gobgp rpki server
list_rpki_table gobgp rpki table
enable_mrt
add_bmp gobgp bmp add routemonitoring is supported only with adjin
list_bmp gobgp bmp

Community, discussion and support

You have code or documentation for RustyBGP? Awesome! Send a pull request. No CLA, board members, governance, or other mess. See BUILD.md for info on code contributing.