README
¶
subnetmath
func main() {
aggregate := subnetmath.ParseNetworkCIDR("192.168.0.0/22")
subnets := []*net.IPNet{
subnetmath.ParseNetworkCIDR("192.168.1.0/24"),
subnetmath.ParseNetworkCIDR("192.168.2.32/30"),
}
unused := subnetmath.FindUnusedSubnets(aggregate, subnets)
// [ 192.168.0.0/24 192.168.2.0/27 192.168.2.36/30 192.168.2.40/29 192.168.2.48/28 192.168.2.64/26 192.168.2.128/25 192.168.3.0/24 ]
}
Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz
BenchmarkIntToAddr-8 30000000 56.1 ns/op 24 B/op 2 allocs/op
BenchmarkAddrToInt-8 20000000 80.5 ns/op 80 B/op 2 allocs/op
BenchmarkParseNetworkCIDR-8 10000000 167 ns/op 72 B/op 4 allocs/op
BenchmarkNetworkComesBefore-8 50000000 30.0 ns/op 0 B/op 0 allocs/op
BenchmarkIPv4ClassfulNetwork-8 20000000 89.1 ns/op 68 B/op 3 allocs/op
BenchmarkNextAddr-8 10000000 165 ns/op 104 B/op 4 allocs/op
BenchmarkShrinkNetwork-8 2000000 747 ns/op 104 B/op 26 allocs/op
BenchmarkNextNetwork-8 5000000 351 ns/op 256 B/op 9 allocs/op
BenchmarkFindInbetweenSubnets-8 200000 7118 ns/op 4336 B/op 133 allocs/op
BenchmarkFindInbetweenSubnetsBuffered-8 300000 4255 ns/op 168 B/op 9 allocs/op
BenchmarkFindUnusedSubnets-8 50000 31529 ns/op 6720 B/op 480 allocs/op
Documentation
¶
Index ¶
- func AddrToInt(address net.IP) *big.Int
- func AddressComesBefore(firstIP, secondIP net.IP) bool
- func BroadcastAddr(network *net.IPNet) net.IP
- func DuplicateAddr(addr net.IP) net.IP
- func DuplicateNetwork(network *net.IPNet) *net.IPNet
- func FindInbetweenSubnets(start, stop net.IP) []*net.IPNet
- func FindUnusedSubnets(aggregate *net.IPNet, subnets ...*net.IPNet) (unused []*net.IPNet)
- func IPv4ClassfulNetwork(address net.IP) *net.IPNet
- func IntToAddr(intAddress *big.Int) net.IP
- func NetworkComesBefore(first, second *net.IPNet) bool
- func NetworkContainsSubnet(network *net.IPNet, subnet *net.IPNet) bool
- func NetworksAreIdentical(first, second *net.IPNet) bool
- func NextAddr(addr net.IP) net.IP
- func NextNetwork(network *net.IPNet) *net.IPNet
- func ParseNetworkCIDR(cidr string) *net.IPNet
- func ShrinkNetwork(network *net.IPNet) *net.IPNet
- func SubnetZeroAddr(address net.IP, network *net.IPNet) net.IP
- type Buffer
- func (b *Buffer) AddressComesBefore(firstIP, secondIP net.IP) bool
- func (b *Buffer) FindInbetweenSubnets(start, stop net.IP) []*net.IPNet
- func (b *Buffer) NetworkComesBefore(first, second *net.IPNet) bool
- func (b *Buffer) NetworkContainsSubnet(network *net.IPNet, subnet *net.IPNet) bool
- func (b *Buffer) SubnetZeroAddr(address net.IP, network *net.IPNet) net.IP
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AddressComesBefore ¶
AddressComesBefore returns a bool with regards to numerical address order. Note that IPv4 addresses come before IPv6 addresses.
func BroadcastAddr ¶
BroadcastAddr returns the broadcast address
func DuplicateAddr ¶
DuplicateAddr creates a new copy of net.IP
func DuplicateNetwork ¶
DuplicateNetwork returns a new copy of *net.IPNet
func FindInbetweenSubnets ¶
FindInbetweenSubnets returns a slice of subnets given a range of IP addresses. Note that the delimiter 'stop' is inclusive. In other words, it will be included in the result.
func FindUnusedSubnets ¶
FindUnusedSubnets returns a slice of unused subnets given the aggregate and sibling subnets
func IPv4ClassfulNetwork ¶
IPv4ClassfulNetwork eithers return the classful network given an IPv4 address or returns nil if given a multicast address or IPv6 address
func NetworkComesBefore ¶
NetworkComesBefore returns a bool with regards to numerical network order. Note that IPv4 networks come before IPv6 networks.
func NetworkContainsSubnet ¶
NetworkContainsSubnet validates that the network is a valid supernet
func NetworksAreIdentical ¶
NetworksAreIdentical returns a bool with regards to the two networks being equal
func NextNetwork ¶
NextNetwork returns the next network of the same size
func ParseNetworkCIDR ¶
ParseNetworkCIDR is a convienence function that will return either the *net.IPNet or nil if the supplied cidr is invalid
func ShrinkNetwork ¶
ShrinkNetwork increases the mask size by one
Types ¶
type Buffer ¶
type Buffer struct {
// contains filtered or unexported fields
}
func (*Buffer) AddressComesBefore ¶
AddressComesBefore returns a bool with regards to numerical address order. Note that IPv4 addresses come before IPv6 addresses.
func (*Buffer) FindInbetweenSubnets ¶
FindInbetweenSubnets returns a slice of subnets given a range of IP addresses. Note that the delimiter 'stop' is inclusive. In other words, it will be included in the result.
func (*Buffer) NetworkComesBefore ¶
NetworkComesBefore returns a bool with regards to numerical network order. Note that IPv4 networks come before IPv6 networks.
func (*Buffer) NetworkContainsSubnet ¶
NetworkContainsSubnet validates that the network is a valid supernet
Source Files