MapCIDR is a 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.
Features
- Simple and modular code base making it easy to contribute.
- CIDR distribution for distributed scanning.
- Stdin and stdout support for integrating in workflows
Installation
- 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
Usage
▶ 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 173.0.84.0/24 |
| -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 mapcidr client | mapcidr -version |
Running mapCIDR
In order to get list of IPs for a give CIDR, use the following command.
▶ mapcidr -cidr 173.0.84.0/24
▶ echo 173.0.84.0/24 | mapcidr
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 173.0.84.0/24 -sbc 10 -silent
▶ echo 173.0.84.0/24 | 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 173.0.84.0/16 -sbh 20000 -silent
▶ echo 173.0.84.0/16 | 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 main
import (
“fmt”
“github.com/projectdiscovery/mapcidr”
)
func main() {
// Divide the CIDR into two subnets
subnets1 := mapcidr.SplitN(“192.168.1.0/24”, 2)
for , subnet := range subnets1 { fmt.Println(subnet) } // Divide the CIDR into two subnets containing 128 hosts each subnets2 := mapcidr.SplitByNumber(“192.168.1.0/24”, 128) for , subnet := range subnets2 {
fmt.Println(subnet)
}
// List all ips in the CIDR
ips, _ := mapcidr.Ips(“192.168.1.0/24”)
for _, ip := range ips {
fmt.Println(ip)
}
}
mapCDIR is made with ? by the projectdiscovery team.
