- Notifications
You must be signed in to change notification settings - Fork99
Utility program to perform multiple operations for a given subnet/CIDR ranges.
License
projectdiscovery/mapcidr
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Features •Install •Usage •Library •Join Discord
mapCIDR is developed to ease load distribution for mass scanning operations, it can be used both as a library and as independent CLI tool.
- CIDR expansion support (default)
- CIDR slicing support (
sbh,sbc) - CIDR/IP aggregation support (
a,aa) - CIDR/IP matcher support (
match-ip) - CIDR/IP filter support (
filter-ip) - CIDR/IP sorting support (
s,sr) - CIDR host count support (
count) - MultipleIP Format support (
ip-format) - IP/PORT shuffling support (
si,sp) - IPv4/IPv6 Conversation support (
t4,t6) - CIDR STDIN (pipe) input support
go install -v github.com/projectdiscovery/mapcidr/cmd/mapcidr@latest
mapcidr -h
This will display help for the tool. Here are all the switches it supports.
INPUT:-cl, -cidr string[] CIDR/IP/File containing list of CIDR/IP to processPROCESS:-sbc int Slice CIDRs by given CIDR count-sbh int Slice CIDRs by given HOST count-a, -aggregate Aggregate IPs/CIDRs into minimum subnet-aa, -aggregate-approx Aggregate sparse IPs/CIDRs into minimum approximated subnet-c, -count Count number of IPs in given CIDR-t4, -to-ipv4 Convert IPs to IPv4 format-t6, -to-ipv6 Convert IPs to IPv6 format-ip-format, -if string[] IP formats (0,1,2,3,4,5,6,7,8,9,10,11)-zpn, -zero-pad-n int number of padded zero to use (default 3)-zpp, -zero-pad-permute enable permutations from 0 to zero-pad-n for each octetsFILTER:-f4, -filter-ipv4 Filter IPv4 IPs from input-f6, -filter-ipv6 Filter IPv6 IPs from input-skip-base Skip base IPs (ending in .0) in output-skip-broadcast Skip broadcast IPs (ending in .255) in output-mi, -match-ip string[] IP/CIDR/FILE containing list of IP/CIDR to match (comma-separated, file input)-fi, -filter-ip string[] IP/CIDR/FILE containing list of IP/CIDR to filter (comma-separated, file input)MISCELLANEOUS:-s, -sort Sort input IPs/CIDRs in ascending order-sr, -sort-reverse Sort input IPs/CIDRs in descending order-si, -shuffle-ip Shuffle Input IPs in random order-sp, -shuffle-port string Shuffle Input IP:Port in random orderUPDATE:-up, -update update mapcidr to latest version-duc, -disable-update-check disable automatic mapcidr update checkOUTPUT:-verbose Verbose mode-o, -output string File to write output to-silent Silent mode-version Show version of the project
In order to get list of IPs for a give CIDR, use the following command.
mapcidr -cidr 173.0.84.0/24____________ ___ __ _ ___ ____ / ___/ _/ _ \/ _ \ / ' \/ _ '/ _ \/ /___/ // // / , _//_/_/_/\_,_/ .__/\___/___/____/_/|_| v0.5 /_/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.173.0.84.0173.0.84.1173.0.84.2173.0.84.3173.0.84.4173.0.84.5173.0.84.13173.0.84.14173.0.84.15173.0.84.16
It is also possible to get list of IP's for a given IP range, use the following command
$echo"192.168.0.0-192.168.0.5"| mapcidr192.168.0.0192.168.0.1192.168.0.2192.168.0.3192.168.0.4192.168.0.5
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 -silent173.0.84.0/27173.0.84.32/27173.0.84.64/27173.0.84.96/27173.0.84.128/27173.0.84.160/27173.0.84.208/28173.0.84.192/28173.0.84.240/28173.0.84.224/28
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 -silent173.0.0.0/18173.0.64.0/18173.0.128.0/18173.0.192.0/18
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.
In order to merge multiple CIDR ranges into smaller subnet block, use the following command.
$mapcidr -cl cidrs.txt -aggregateIn order to list CIDR blocks for given list of IPs, use the following command.
$mapcidr -il ips.txt -aggregateIt's also possible to perform approximated aggregations for sparse ips groups (only version 4). The final interval will contain contiguous ips not belonging to the input:
$cat ips.txt1.1.1.11.1.1.161.1.1.31
$cat ips.txt| mapcidr -aggregate-approx1.1.1.0/27
In order to list CIDR blocks for given IP Range (IPv4 | IPv6), use the following command.
$ mapcidr -cl 192.168.0.1-192.168.0.255 -aggregate OR $ echo 192.168.0.1-192.168.0.255 | mapcidr -aggregate192.168.0.1/32192.168.0.2/31192.168.0.4/30192.168.0.8/29192.168.0.16/28192.168.0.32/27192.168.0.64/26192.168.0.128/25In order to match IPs from the given list of CIDR ranges, use the following command.
$mapcidr -cidr 192.168.1.0/24 -mi 192.168.1.253,192.168.1.252$mapcidr -cidr 192.168.1.0/24 -mi ip_list_to_match.txt
In order to match IPs from the given list of CIDR ranges, use the following command.
$mapcidr -cidr 192.168.1.224/28 -fi 192.168.1.233,192.168.1.234$mapcidr -cidr 192.168.1.224/28 -fi ip_list_to_filter.txt
In order to represent given IP into multiple formats,-if 0 flag can be used to display all the supported format values, and specific type of format can be displayed using specific index number as listedhere, currently10 unique formats are supported.
$echo 127.0.1.0| mapcidr -if 0 -silent127.0.1.0127.10177.0.01.00x7f.0x0.0x1.0x00x7f0001000xabfa659dfa7f0001002814728124500481111111111111111011111110000000000000001000000000x7f.0.01.0x0::ffff:7f00:0100%31%32%37%2E%30%2E%31%2E%30127.000.001.000
IPv4 | IPv6 addresses can be converted from either the v6 to v4 notation or IPv4-mapped notation into IPv4 addresses using-t4 and-t6 to IPv4 and IPv6 respectively.
$cat ips.txt1.1.1.12.2.2.2
$ mapcidr -cl ips.txt -t600:00:00:00:00:ffff:0101:010100:00:00:00:00:ffff:0202:0202Not all IPv6 address can be converted to IPv4. You can only convert valid IPv4 represented IPv6 addresses. |
In order to count number of hosts for a given CIDR or list of CIDR, use the following command.
$echo 173.0.84.0/16| mapcidr -count -silent65536
In order to get the IP address of ASN number, use the following command
echo AS15133 | mapcidr -silent5.104.64.05.104.64.15.104.64.25.104.64.35.104.64.4It'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")funcmain() {// Divide the CIDR into two subnetssubnets1:=mapcidr.SplitN("192.168.1.0/24",2)for_,subnet:=rangesubnets1 {fmt.Println(subnet)}// Divide the CIDR into two subnets containing 128 hosts eachsubnets2:=mapcidr.SplitByNumber("192.168.1.0/24",128)for_,subnet:=rangesubnets2 {fmt.Println(subnet)}// List all ips in the CIDRips,_:=mapcidr.IPAddresses("192.168.1.0/24")for_,ip:=rangeips {fmt.Println(ip)}}
mapCDIR is made with 🖤 by theprojectdiscovery team.
About
Utility program to perform multiple operations for a given subnet/CIDR ranges.