From 2f5ef904a7da3508b8a7649990d0d758236485dc Mon Sep 17 00:00:00 2001
From: bauthard <8293321+bauthard@users.noreply.github.com>
Date: Fri, 21 Aug 2020 20:29:36 +0530
Subject: [PATCH] Initial commit
---
.github/workflows/build.yaml | 27 +++
.github/workflows/dockerhub-push.yml | 17 ++
.github/workflows/release.yml | 28 +++
.goreleaser.yml | 21 ++
Dockerfile | 10 +
LICENSE.MD | 9 +
README.md | 171 ++++++++++++++++
cidr.go | 296 +++++++++++++++++++++++++++
cmd/mapcidr/main.go | 206 +++++++++++++++++++
go.mod | 5 +
go.sum | 10 +
static/mapCIDR-logo.png | Bin 0 -> 7221 bytes
static/mapCIDR-run.png | Bin 0 -> 211754 bytes
13 files changed, 800 insertions(+)
create mode 100644 .github/workflows/build.yaml
create mode 100644 .github/workflows/dockerhub-push.yml
create mode 100644 .github/workflows/release.yml
create mode 100644 .goreleaser.yml
create mode 100644 Dockerfile
create mode 100644 LICENSE.MD
create mode 100644 README.md
create mode 100644 cidr.go
create mode 100644 cmd/mapcidr/main.go
create mode 100644 go.mod
create mode 100644 go.sum
create mode 100644 static/mapCIDR-logo.png
create mode 100644 static/mapCIDR-run.png
diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml
new file mode 100644
index 00000000..529eec1b
--- /dev/null
+++ b/.github/workflows/build.yaml
@@ -0,0 +1,27 @@
+name: Build
+on:
+ push:
+ branches:
+ - master
+ pull_request:
+
+jobs:
+ build:
+ name: Build
+ runs-on: ubuntu-latest
+ steps:
+ - name: Set up Go
+ uses: actions/setup-go@v2
+ with:
+ go-version: 1.14
+
+ - name: Check out code
+ uses: actions/checkout@v2
+
+ - name: Test
+ run: go test .
+ working-directory: cmd/mapcidr/
+
+ - name: Build
+ run: go build .
+ working-directory: cmd/mapcidr/
\ No newline at end of file
diff --git a/.github/workflows/dockerhub-push.yml b/.github/workflows/dockerhub-push.yml
new file mode 100644
index 00000000..82f7b2c8
--- /dev/null
+++ b/.github/workflows/dockerhub-push.yml
@@ -0,0 +1,17 @@
+# dockerhub-push pushes docker build to dockerhub automatically
+# on the creation of a new release
+name: Publish to Dockerhub on creation of a new release
+on:
+ release:
+ types: [published]
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@master
+ - name: Publish to Dockerhub Registry
+ uses: elgohr/Publish-Docker-Github-Action@master
+ with:
+ name: projectdiscovery/mapcidr
+ username: ${{ secrets.DOCKER_USERNAME }}
+ password: ${{ secrets.DOCKER_PASSWORD }}
\ No newline at end of file
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 00000000..70cb60a9
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,28 @@
+name: Release
+on:
+ create:
+ tags:
+ - v*
+
+jobs:
+ release:
+ runs-on: ubuntu-latest
+ steps:
+ -
+ name: "Check out code"
+ uses: actions/checkout@v2
+ with:
+ fetch-depth: 0
+ -
+ name: "Set up Go"
+ uses: actions/setup-go@v2
+ with:
+ go-version: 1.14
+ -
+ env:
+ GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+ name: "Create release on GitHub"
+ uses: goreleaser/goreleaser-action@v2
+ with:
+ args: "release --rm-dist"
+ version: latest
\ No newline at end of file
diff --git a/.goreleaser.yml b/.goreleaser.yml
new file mode 100644
index 00000000..68b233c8
--- /dev/null
+++ b/.goreleaser.yml
@@ -0,0 +1,21 @@
+builds:
+ - binary: mapcidr
+ main: cmd/mapcidr/main.go
+ goos:
+ - linux
+ - windows
+ - darwin
+ goarch:
+ - amd64
+ - 386
+ - arm
+ - arm64
+
+archives:
+ - id: tgz
+ format: tar.gz
+ replacements:
+ darwin: macOS
+ format_overrides:
+ - goos: windows
+ format: zip
\ No newline at end of file
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 00000000..3f1a2e0b
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,10 @@
+FROM golang:1.14-alpine AS build-env
+
+RUN apk add --no-cache --upgrade git openssh-client ca-certificates
+RUN go get -u github.com/golang/dep/cmd/dep
+WORKDIR /go/src/app
+
+# Install
+RUN go get -u github.com/projectdiscovery/mapcidr/cmd/mapcidr
+
+ENTRYPOINT ["mapcidr"]
\ No newline at end of file
diff --git a/LICENSE.MD b/LICENSE.MD
new file mode 100644
index 00000000..2c830383
--- /dev/null
+++ b/LICENSE.MD
@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Exposed Atoms Pvt Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..dc0f9c61
--- /dev/null
+++ b/README.md
@@ -0,0 +1,171 @@
+
+ 
+
+
+
+[](https://opensource.org/licenses/MIT)
+[](https://goreportcard.com/report/github.com/projectdiscovery/mapcidr)
+[](https://github.com/projectdiscovery/mapcidr/issues)
+[](https://twitter.com/pdiscoveryio)
+[](https://discord.gg/KECAGdH)
+
+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
+
+```sh
+▶ GO111MODULE=auto go get -u github.com/projectdiscovery/mapcidr/cmd/mapcidr
+```
+
+### From Github
+
+```sh
+▶ git clone https://github.com/projectdiscovery/mapcidr.git; cd mapcidr/cmd/mapcidr; go build .; cp mapcidr /usr/local/bin
+```
+
+# Usage:-
+
+```sh
+▶ 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 chaos client | mapcidr -version |
+
+# Running mapCIDR
+
+In order to get list of IPs for a give CIDR, use the following command.
+
+```sh
+▶ mapcidr -cidr 173.0.84.0/24
+▶ echo 173.0.84.0/24 | mapcidr
+
+```
+
+```sh
+ ____________ ___
+ __ _ ___ ____ / ___/ _/ _ \/ _ \
+ / ' \/ _ '/ _ \/ /___/ // // / , _/
+/_/_/_/\_,_/ .__/\___/___/____/_/|_| 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.
+
+173.0.84.0
+173.0.84.1
+173.0.84.2
+173.0.84.3
+173.0.84.4
+173.0.84.5
+173.0.84.13
+173.0.84.14
+173.0.84.15
+173.0.84.16
+```
+
+## 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.
+
+
+```sh
+▶ mapcidr -cidr 173.0.84.0/24 -sbc 10 -silent
+▶ echo 173.0.84.0/24 | mapcidr -sbc 10 -silent
+```
+
+```
+173.0.84.0/27
+173.0.84.32/27
+173.0.84.64/27
+173.0.84.96/27
+173.0.84.128/27
+173.0.84.160/27
+173.0.84.208/28
+173.0.84.192/28
+173.0.84.240/28
+173.0.84.224/28
+```
+
+## Slice by HOST
+
+In order to slice given CIDR for equal number of host count in each CIDR, use the following command.
+
+```sh
+▶ mapcidr -cidr 173.0.84.0/16 -sbh 20000 -silent
+▶ echo 173.0.84.0/16 | mapcidr -sbh 20000 -silent
+```
+
+```
+173.0.0.0/18
+173.0.64.0/18
+173.0.128.0/18
+173.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.
+
+# 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
+
+```go
+package main
+
+import (
+ "fmt"
+ "github.com/projectdiscovery/mapcidr"
+)
+
+funf 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](https://projectdiscovery.io) team.
diff --git a/cidr.go b/cidr.go
new file mode 100644
index 00000000..340f258a
--- /dev/null
+++ b/cidr.go
@@ -0,0 +1,296 @@
+package mapcidr
+
+import (
+ "encoding/binary"
+ "fmt"
+ "math"
+ "math/big"
+ "net"
+ "reflect"
+)
+
+// Note: parts of the code comes from various sources including github, stackoverflow
+
+// AddressRange returns the first and last addresses in the given CIDR range.
+func AddressRange(network *net.IPNet) (net.IP, net.IP) {
+ firstIP := network.IP
+
+ prefixLen, bits := network.Mask.Size()
+ if prefixLen == bits {
+ lastIP := make([]byte, len(firstIP))
+ copy(lastIP, firstIP)
+ return firstIP, lastIP
+ }
+
+ firstIPInt, bits, _ := ipToInt(firstIP)
+ hostLen := uint(bits) - uint(prefixLen)
+ lastIPInt := big.NewInt(1)
+ lastIPInt.Lsh(lastIPInt, hostLen)
+ lastIPInt.Sub(lastIPInt, big.NewInt(1))
+ lastIPInt.Or(lastIPInt, firstIPInt)
+
+ return firstIP, intToIP(lastIPInt, bits)
+}
+
+// AddressCount ips in a CIDR range
+func AddressCount(cidr string) uint64 {
+ _, ipnet, _ := net.ParseCIDR(cidr)
+ return AddressCountIpnet(ipnet)
+}
+
+// AddressCountIpnet ips in a ipnet
+func AddressCountIpnet(network *net.IPNet) uint64 {
+ prefixLen, bits := network.Mask.Size()
+ return 1 << (uint64(bits) - uint64(prefixLen))
+}
+
+func inc(IP net.IP) net.IP {
+ incIP := make([]byte, len(IP))
+ copy(incIP, IP)
+ for j := len(incIP) - 1; j >= 0; j-- {
+ incIP[j]++
+ if incIP[j] > 0 {
+ break
+ }
+ }
+ return incIP
+}
+
+func dec(IP net.IP) net.IP {
+ decIP := make([]byte, len(IP))
+ copy(decIP, IP)
+ for j := len(decIP) - 1; j >= 0; j-- {
+ decIP[j]--
+ if decIP[j] < 255 {
+ break
+ }
+ }
+ return decIP
+}
+
+// SplitByNumber splits the given cidr into subnets with the closest number of hosts per subnet
+func SplitByNumber(iprange string, number int) []*net.IPNet {
+ _, ipnet, _ := net.ParseCIDR(iprange)
+ return SplitByNumberIpnet(ipnet, number)
+}
+
+// SplitByNumberIpnet splits ipnet into subnets with the closest number of hosts per subnet
+func SplitByNumberIpnet(ipnet *net.IPNet, number int) []*net.IPNet {
+ ipsNumber := AddressCountIpnet(ipnet)
+ // truncate result to nearest uint64
+ optimalSplit := int(ipsNumber / uint64(number))
+ return SplitNIpnet(ipnet, optimalSplit)
+}
+
+// SplitN attempts to split a cidr in the exact number of subnets
+func SplitN(iprange string, n int) (subnets []*net.IPNet) {
+ _, ipnet, _ := net.ParseCIDR(iprange)
+ return SplitNIpnet(ipnet, n)
+}
+
+// SplitNIpnet attempts to split a ipnet in the exact number of subnets
+func SplitNIpnet(iprange *net.IPNet, n int) (subnets []*net.IPNet) {
+ // Note: the code and logic aren't really optimized, it just works - any improvement is welcome
+
+ // invalid value
+ if n <= 1 || AddressCountIpnet(iprange) < uint64(n) {
+ subnets = append(subnets, iprange)
+ return
+ }
+ // power of two
+ if isPowerOfTwo(n) || isPowerOfTwoPlusOne(n) {
+ return splitIpnet(iprange, n)
+ }
+
+ var closestMinorPowerOfTwo int
+ // find the closest power of two in a stupid way
+ for i := n; i > 0; i-- {
+ if isPowerOfTwo(i) {
+ closestMinorPowerOfTwo = i
+ break
+ }
+ }
+
+ subnets = splitIpnet(iprange, closestMinorPowerOfTwo)
+ for len(subnets) < n {
+ var newSubnets []*net.IPNet
+ level := 1
+ for i := len(subnets) - 1; i >= 0; i-- {
+ newSubnets = append(newSubnets, divideIpNet(subnets[i])...)
+ if len(subnets)-level+len(newSubnets) == n {
+ reverseAny(newSubnets)
+ subnets = subnets[:len(subnets)-level]
+ subnets = append(subnets, newSubnets...)
+ return
+ }
+ level++
+ }
+ reverseAny(newSubnets)
+ subnets = newSubnets
+ }
+ return
+}
+
+func divide(iprange string) (subnets []*net.IPNet) {
+ _, ipnet, _ := net.ParseCIDR(iprange)
+ return divideIpNet(ipnet)
+}
+
+func divideIpNet(ipnet *net.IPNet) (subnets []*net.IPNet) {
+ maskBits, _ := ipnet.Mask.Size()
+ wantedMaskBits := maskBits + 1
+
+ currentSubnet := currentSubnet(ipnet, wantedMaskBits)
+ subnets = append(subnets, currentSubnet)
+ nextSubnet, _ := nextSubnet(currentSubnet, wantedMaskBits)
+ subnets = append(subnets, nextSubnet)
+
+ return subnets
+}
+
+func splitIpnet(ipnet *net.IPNet, n int) (subnets []*net.IPNet) {
+ maskBits, _ := ipnet.Mask.Size()
+
+ closestPow2 := int(closestPowerOfTwo(uint32(n)))
+
+ pow2 := int(math.Log2(float64(closestPow2)))
+
+ wantedMaskBits := maskBits + pow2
+
+ currentSubnet := currentSubnet(ipnet, wantedMaskBits)
+ subnets = append(subnets, currentSubnet)
+ nxtSubnet := currentSubnet
+ for i := 0; i < closestPow2-1; i++ {
+ nxtSubnet, _ = nextSubnet(nxtSubnet, wantedMaskBits)
+ subnets = append(subnets, nxtSubnet)
+ }
+
+ if len(subnets) < n {
+ lastSubnet := subnets[len(subnets)-1]
+ subnets = subnets[:len(subnets)-1]
+ subnets = append(subnets, divideIpNet(lastSubnet)...)
+ }
+
+ return subnets
+}
+
+func split(iprange string, n int) (subnets []*net.IPNet) {
+ _, ipnet, _ := net.ParseCIDR(iprange)
+ return splitIpnet(ipnet, n)
+}
+
+func ipToInt(ip net.IP) (*big.Int, int, error) {
+ val := &big.Int{}
+ val.SetBytes([]byte(ip))
+ if len(ip) == net.IPv4len {
+ return val, 32, nil
+ } else if len(ip) == net.IPv6len {
+ return val, 128, nil
+ } else {
+ return nil, 0, fmt.Errorf("Unsupported address length %d", len(ip))
+ }
+}
+
+func intToIP(ipInt *big.Int, bits int) net.IP {
+ ipBytes := ipInt.Bytes()
+ ret := make([]byte, bits/8)
+ for i := 1; i <= len(ipBytes); i++ {
+ ret[len(ret)-i] = ipBytes[len(ipBytes)-i]
+ }
+ return net.IP(ret)
+}
+
+func nextPowerOfTwo(v uint32) uint32 {
+ v--
+ v |= v >> 1
+ v |= v >> 2
+ v |= v >> 4
+ v |= v >> 8
+ v |= v >> 16
+ v++
+ return v
+}
+
+func closestPowerOfTwo(v uint32) uint32 {
+ next := nextPowerOfTwo(v)
+ if prev := next / 2; (v - prev) < (next - v) {
+ next = prev
+ }
+ return next
+}
+
+func currentSubnet(network *net.IPNet, prefixLen int) *net.IPNet {
+ currentFirst, _ := AddressRange(network)
+ mask := net.CIDRMask(prefixLen, 8*len(currentFirst))
+ return &net.IPNet{IP: currentFirst.Mask(mask), Mask: mask}
+}
+
+func previousSubnet(network *net.IPNet, prefixLen int) (*net.IPNet, bool) {
+ startIP := network.IP
+ previousIP := make(net.IP, len(startIP))
+ copy(previousIP, startIP)
+ cMask := net.CIDRMask(prefixLen, 8*len(previousIP))
+ previousIP = dec(previousIP)
+ previous := &net.IPNet{IP: previousIP.Mask(cMask), Mask: cMask}
+ if startIP.Equal(net.IPv4zero) || startIP.Equal(net.IPv6zero) {
+ return previous, true
+ }
+ return previous, false
+}
+
+func nextSubnet(network *net.IPNet, prefixLen int) (*net.IPNet, bool) {
+ _, currentLast := AddressRange(network)
+ mask := net.CIDRMask(prefixLen, 8*len(currentLast))
+ currentSubnet := &net.IPNet{IP: currentLast.Mask(mask), Mask: mask}
+ _, last := AddressRange(currentSubnet)
+ last = inc(last)
+ next := &net.IPNet{IP: last.Mask(mask), Mask: mask}
+ if last.Equal(net.IPv4zero) || last.Equal(net.IPv6zero) {
+ return next, true
+ }
+ return next, false
+}
+
+func isPowerOfTwoPlusOne(x int) bool {
+ return isPowerOfTwo(x - 1)
+}
+
+func isPowerOfTwo(x int) bool {
+ return x != 0 && (x&(x-1)) == 0
+}
+
+func reverseAny(s interface{}) {
+ n := reflect.ValueOf(s).Len()
+ swap := reflect.Swapper(s)
+ for i, j := 0, n-1; i < j; i, j = i+1, j-1 {
+ swap(i, j)
+ }
+}
+
+// Ips of a cidr
+func Ips(cidr string) ([]string, error) {
+ _, ipnet, err := net.ParseCIDR(cidr)
+ if err != nil {
+ return []string{}, err
+ }
+ return ipsIpnet(ipnet), nil
+}
+
+func ipsIpnet(ipv4Net *net.IPNet) (ips []string) {
+ // convert IPNet struct mask and address to uint32
+ mask := binary.BigEndian.Uint32(ipv4Net.Mask)
+ start := binary.BigEndian.Uint32(ipv4Net.IP)
+
+ // find the final address
+ finish := (start & mask) | (mask ^ 0xffffffff)
+
+ // loop through addresses as uint32
+ for i := start; i <= finish; i++ {
+ // convert back to net.IP
+ ip := make(net.IP, 4)
+ binary.BigEndian.PutUint32(ip, i)
+ ips = append(ips, ip.String())
+ }
+
+ return ips
+}
diff --git a/cmd/mapcidr/main.go b/cmd/mapcidr/main.go
new file mode 100644
index 00000000..b682557b
--- /dev/null
+++ b/cmd/mapcidr/main.go
@@ -0,0 +1,206 @@
+package main
+
+import (
+ "bufio"
+ "flag"
+ "net"
+ "os"
+ "sync"
+
+ "github.com/projectdiscovery/gologger"
+ "github.com/projectdiscovery/mapcidr"
+)
+
+// Options contains cli options
+type Options struct {
+ Slices int
+ HostCount int
+ Cidr string
+ FileCidr string
+ Silent bool
+ Version bool
+ Output string
+ // NoColor bool
+ // Verbose bool
+}
+
+const banner = `
+ ____________ ___
+ __ _ ___ ____ / ___/ _/ _ \/ _ \
+ / ' \/ _ '/ _ \/ /___/ // // / , _/
+/_/_/_/\_,_/ .__/\___/___/____/_/|_| v0.1
+ /_/
+`
+
+// Version is the current version of mapcidr
+const Version = `0.0.1`
+
+// showBanner is used to show the banner to the user
+func showBanner() {
+ gologger.Printf("%s\n", banner)
+ gologger.Printf("\t\tprojectdiscovery.io\n\n")
+
+ gologger.Labelf("Use with caution. You are responsible for your actions\n")
+ gologger.Labelf("Developers assume no liability and are not responsible for any misuse or damage.\n")
+}
+
+// ParseOptions parses the command line options for application
+func ParseOptions() *Options {
+ options := &Options{}
+
+ flag.IntVar(&options.Slices, "sbc", 0, "Slice by CIDR count")
+ flag.IntVar(&options.HostCount, "sbh", 0, "Slice by HOST count")
+ flag.StringVar(&options.Cidr, "cidr", "", "Single CIDR to process")
+ flag.StringVar(&options.FileCidr, "l", "", "File containing CIDR")
+ flag.StringVar(&options.Output, "o", "", "File to write output to (optional)")
+ flag.BoolVar(&options.Silent, "silent", false, "Silent mode")
+ flag.BoolVar(&options.Version, "version", false, "Show version")
+ flag.Parse()
+
+ // Read the inputs and configure the logging
+ options.configureOutput()
+
+ showBanner()
+
+ if options.Version {
+ gologger.Infof("Current Version: %s\n", Version)
+ os.Exit(0)
+ }
+
+ options.validateOptions()
+
+ return options
+}
+func (options *Options) validateOptions() {
+ if options.Cidr == "" && !hasStdin() && options.FileCidr == "" {
+ gologger.Fatalf("No input provided!\n")
+ }
+
+ if options.Slices > 0 && options.HostCount > 0 {
+ gologger.Fatalf("sbc and sbh cant be used together!\n")
+ }
+
+ if options.Cidr != "" && options.FileCidr != "" {
+ gologger.Fatalf("CIDR and List input cant be used together!\n")
+ }
+}
+
+// configureOutput configures the output on the screen
+func (options *Options) configureOutput() {
+ // If the user desires verbose output, show verbose output
+ // if options.Verbose {
+ // gologger.MaxLevel = gologger.Verbose
+ // }
+ // if options.NoColor {
+ // gologger.UseColors = false
+ // }
+ if options.Silent {
+ gologger.MaxLevel = gologger.Silent
+ }
+}
+
+var options *Options
+
+func main() {
+ options = ParseOptions()
+ chancidr := make(chan string)
+ outputchan := make(chan string)
+ var wg sync.WaitGroup
+
+ wg.Add(1)
+ go process(&wg, chancidr, outputchan)
+ wg.Add(1)
+ go output(&wg, outputchan)
+
+ if options.Cidr != "" {
+ chancidr <- options.Cidr
+ }
+
+ if hasStdin() {
+ scanner := bufio.NewScanner(os.Stdin)
+ for scanner.Scan() {
+ chancidr <- scanner.Text()
+ }
+ }
+
+ if options.FileCidr != "" {
+ file, err := os.Open(options.FileCidr)
+ if err != nil {
+ gologger.Fatalf("%s\n", err)
+ }
+ defer file.Close()
+ scanner := bufio.NewScanner(file)
+ for scanner.Scan() {
+ chancidr <- scanner.Text()
+ }
+ }
+
+ close(chancidr)
+
+ wg.Wait()
+}
+
+func process(wg *sync.WaitGroup, chancidr, outputchan chan string) {
+ defer wg.Done()
+ for cidr := range chancidr {
+ // test if we have a cidr
+ if _, _, err := net.ParseCIDR(cidr); err != nil {
+ gologger.Fatalf("%s\n", err)
+ }
+ if options.Slices > 0 {
+ subnets := mapcidr.SplitN(cidr, options.Slices)
+ for _, subnet := range subnets {
+ outputchan <- subnet.String()
+ }
+ } else if options.HostCount > 0 {
+ subnets := mapcidr.SplitByNumber(cidr, options.HostCount)
+ for _, subnet := range subnets {
+ outputchan <- subnet.String()
+ }
+ } else {
+ ips, err := mapcidr.Ips(cidr)
+ if err != nil {
+ gologger.Fatalf("%s\n", err)
+ }
+ for _, ip := range ips {
+ outputchan <- ip
+ }
+ }
+ }
+
+ close(outputchan)
+}
+
+func output(wg *sync.WaitGroup, outputchan chan string) {
+ defer wg.Done()
+
+ var f *os.File
+ if options.Output != "" {
+ var err error
+ f, err = os.Create(options.Output)
+ if err != nil {
+ gologger.Fatalf("Could not create output file '%s': %s\n", options.Output, err)
+ }
+ defer f.Close()
+ }
+ for o := range outputchan {
+ if o == "" {
+ continue
+ }
+ gologger.Silentf("%s\n", o)
+ if f != nil {
+ f.WriteString(o + "\n")
+ }
+ }
+}
+
+func hasStdin() bool {
+ fi, err := os.Stdin.Stat()
+ if err != nil {
+ return false
+ }
+ if fi.Mode()&os.ModeNamedPipe == 0 {
+ return false
+ }
+ return true
+}
diff --git a/go.mod b/go.mod
new file mode 100644
index 00000000..5bee2069
--- /dev/null
+++ b/go.mod
@@ -0,0 +1,5 @@
+module github.com/projectdiscovery/mapcidr
+
+go 1.14
+
+require github.com/projectdiscovery/gologger v1.0.1
diff --git a/go.sum b/go.sum
new file mode 100644
index 00000000..599e5258
--- /dev/null
+++ b/go.sum
@@ -0,0 +1,10 @@
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/logrusorgru/aurora v0.0.0-20200102142835-e9ef32dff381 h1:bqDmpDG49ZRnB5PcgP0RXtQvnMSgIF14M7CBd2shtXs=
+github.com/logrusorgru/aurora v0.0.0-20200102142835-e9ef32dff381/go.mod h1:7rIyQOR62GCctdiQpZ/zOJlFyk6y+94wXzv6RNZgaR4=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/projectdiscovery/gologger v1.0.1 h1:FzoYQZnxz9DCvSi/eg5A6+ET4CQ0CDUs27l6Exr8zMQ=
+github.com/projectdiscovery/gologger v1.0.1/go.mod h1:Ok+axMqK53bWNwDSU1nTNwITLYMXMdZtRc8/y1c7sWE=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
diff --git a/static/mapCIDR-logo.png b/static/mapCIDR-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..a5c503a11ccf52e37ede19f5d26ea201a63c1a8f
GIT binary patch
literal 7221
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�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