CIDR-Sensei

CIDR-Sensei is a command-line tool that expands a comma-separated list of CIDR blocks into a list of IP addresses. It supports both sequential and parallel processing.

Implementation

CIDR-Sensei is a tool written in Go that helps you easily expand a list of CIDR blocks into a list of IP addresses. With the -concurrency flag, you can run the program in parallel to speed up the expansion process.

To use it, simply provide a comma-separated list of CIDR blocks to the -cidr flag, and CIDR-Sensei will do the rest. It first parses the list and stores the start and end IP addresses of each CIDR block in a slice of CIDRRange structs.

Next, it expands the CIDR blocks into a list of IP addresses. It can do this in two ways: either by using a binary search to find the CIDR block that contains each IP address, or by splitting the CIDR blocks into smaller chunks and processing each chunk in parallel. This release includes binary search and now interval tree as algorithms to choose from by using the -algorithm flag on the command line. The resulting list of IP addresses are directed to the terminal, CSV, or JSON with the 'output' option.

So whether you're a network administrator or just curious about IP addresses, CIDR-Sensei has got you covered!

Installation

Clone the repository and build the tool using the following commands:

git clone https://github.com/your_username/cidr-sensei.git
cd cidr-sensei
go build -o cidr-sensei cmd/cidr-sensei/main.go

Binary releases are available HERE for many platforms.

Usage

./cidr-sensei -output="json" -cidr="10.0.0.0/8,172.16.0.0/12,192.168.0.0/16" -parallel -concurrency=100 -algorithm="interval-tree"

You can use the following options:

• -output: Sets the output format ("json", "csv", or "terminal") (required).
• -cidr: A comma-separated list of CIDR blocks to expand into IP addresses (required).
• -parallel: Enables parallel processing (optional).
• -concurrency: Sets the number of workers for parallel processing (default=100, optional).
• -algorithm: Sets the algorithm to use when parallel processing. ("binary-search", "interval-tree") (default="binary-search" optional)

Example

./cidr-sensei -output="json" -cidr="10.0.0.0/8,172.16.0.0/12,192.168.0.0/16" -parallel -concurrency=100 -algorithm="interval-tree"
10.0.0.0
10.0.0.1
10.0.0.2
10.0.0.3
...
192.168.255.252
192.168.255.253
192.168.255.254
192.168.255.255
Took 0.372257 seconds to complete.

The above command will expand the CIDR blocks 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 into a list of IP addresses in a JSON file, using 100 workers for parallel processing and the interval-tree algorithm when -parallel is used.

Dependencies

• Go v1.16 or later