mapCIDR - Small Utility Program To Perform Multiple Operations For A Given subnet/CIDR Ranges

Small utility program to perform multiple operations for a given subnet/CIDR ranges.

The tool was developed to ease load distribution for mass scanning operations, it can be used both as a library and as independent CLI tool.

  • Simple and modular code base making it easy to contribute.
  • CIDR distribution for distributed scanning.
  • Stdin and stdout support for integrating in workflows


From Source
▶ GO111MODULE=auto go get -u github.com/projectdiscovery/mapcidr/cmd/mapcidr

From Github
▶ git clone https://github.com/projectdiscovery/mapcidr.git; cd mapcidr/cmd/mapcidr; go build .; cp mapcidr /usr/local/bin

▶ mapcidr -h

This will display help for the tool. Here are all the switches it supports.

Flag Description Example
-cidr Single CIDR to process mapcidr -cidr
-sbc Slice by CIDR count mapcidr -sbc 10
-sbh Slice by HOST count mapcidr -sbh 10000
-l File containing list of CIDRs mapcidr -l cidr.txt
-o File to write output to (optional) mapcidr -o output.txt
-silent Make the output silent mapcidr -silent
-version Print current version of chaos client mapcidr -version

Running mapCIDR

In order to get list of IPs for a give CIDR, use the following command.

▶ mapcidr -cidr▶ echo | mapcidr
                   ____________  ___      __ _  ___ ____  / ___/  _/ _ \/ _ \ /  ' \/ _ '/ _ \/ /___/ // // / , _/   /_/_/_/\_,_/ .__/\___/___/____/_/|_| v0.1          /_/                                                     	 		projectdiscovery.io[WRN] Use with caution. You are responsible for your actions[WRN] Developers assume no liability and are not responsible for any misuse or damage.

Slice by CIDR

In order to slice given CIDR or list of CIDR by CIDR count or slice into multiple and equal smaller subnets, use the following command.

▶ mapcidr -cidr -sbc 10 -silent▶ echo | mapcidr -sbc 10 -silent

Slice by HOST

In order to slice given CIDR for equal number of host count in each CIDR, use the following command.

▶ mapcidr -cidr -sbh 20000 -silent▶ echo | mapcidr -sbh 20000 -silent

Note: it's possible to obtain a perfect split only when the desired amount of slices or hosts per subnet is a powers of two. Otherwise the tool will attempt to automatically find the best split strategy to obtain the desired outcome.

Use mapCIDR as a library

It's possible to use the library directly in your go programs. The following code snippets outline how to divide a cidr into subnets, and how to divide the same into subnets containing a certain number of hosts

package mainimport (	"fmt"	"github.com/projectdiscovery/mapcidr")func main() {	// Divide the CIDR into two subnets	subnets1 := mapcidr.SplitN("", 2)	for _, subnet := range subnets1 {		fmt.Println(subnet)	}	// Divide the CIDR into two subnets containing 128 hosts each	subnets2 := mapcidr.SplitByNumber("", 128)	for _, subnet := range subnets2 {		fmt.Println(subnet)	}	// List all ips in the CIDR	ips, _ := mapcidr.Ips("")	for _, ip := range ips {		fmt.Println(ip)	}}

mapCDIR is made with by the projectdiscovery team.

Disqus Comments