rs-aggregate

Crates.iors-aggregate
lib.rsrs-aggregate
version0.3.2
sourcesrc
created_at2023-03-23 20:17:35.826364
updated_at2023-12-12 12:39:28.803392
descriptionAggregate a list of IP prefixes into their minimum equivalent representation
homepage
repositoryhttps://github.com/ktims/rs-aggregate
max_upload_size
id818744
size80,351
Keenan Tims (ktims)

documentation

README

rs-aggregate

rs-aggregate will aggregate an unsorted list of IP prefixes

Intended to be a drop-in replacement for aggregate6 with better performance.

Takes a list of whitespace-separated IPs or IP networks and aggregates them to their minimal representation.

Installation

rs-aggregate is built statically. CI-built binaries can be found in the GitHub releases for most common platforms. Simply download the appropriate binary and place it in your path.

It can also be installed via some software management tools:

FreeBSD

pkg install rs-aggregate

Cargo

cargo install rs-aggregate

Known differences from aggregate6

  • -m/--max-prefixlen supports different maximums for each address family as ipv4,ipv6 format. A single value is also supported and has the same behaviour as aggregate6 (apply the same maximum to both address families).
  • -v verbose dump is not supported
  • Truncation errors (when host bits are set without the -t flag) are printed based on the parsed address, ie. always in CIDR format, whereas aggregate6 prints errors based on the input.

Performance

Performance comparison of rs-aggregate vs aggregate6. A speedup of >100x is achieved on DFZ data.

Full DFZ (1154968 total, 202729 aggregates):

dfz perf comparison

IPv4 DFZ (968520 total, 154061 aggregates):

ipv4 dfz perf comparison

1024 random prefixes (startup time):

startup time comparison

Commit count: 40

cargo fmt