README
¶
package extnetip
Package extnetip is an extension to net/netip with
a few missing but important auxiliary functions for
converting IP-prefixes to IP-ranges and vice versa.
With these extensions to net/netip, third-party IP-range libraries become easily possible.
API
import "github.com/gaissmai/extnetip"
func Range(p netip.Prefix) (first, last netip.Addr)
func Prefix(first, last netip.Addr) (prefix netip.Prefix, ok bool)
func Prefixes(first, last netip.Addr) []netip.Prefix
func PrefixesAppend(dst []netip.Prefix, first, last netip.Addr) []netip.Prefix
Future
Hopefully some day these tiny helper functions are added to netip by the stdlib maintainers, currently (2022)
they refused the proposal.
Documentation
¶
Overview ¶
Package extnetip is an extension to net/netip with a few missing but important auxiliary functions for converting IP-prefixes to IP-ranges and vice versa.
The functions are effectively performed in uint128 space, no conversions from/to bytes are performed.
With these extensions to net/netip, third-party IP-range libraries become easily possible.
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Prefix ¶
Prefix returns the netip.Prefix from first to last and ok=true, if it can be presented exactly as such.
If first or last are not valid, in the wrong order or not exactly equal to one prefix, ok is false.
Example ¶
package main
import (
"fmt"
"net/netip"
"github.com/gaissmai/extnetip"
)
func main() {
first := netip.MustParseAddr("fe80::")
last := netip.MustParseAddr("fe80::7")
pfx, ok := extnetip.Prefix(first, last)
fmt.Println("OK: ", ok)
fmt.Println("Prefix:", pfx)
}
Output: OK: true Prefix: fe80::/125
func Prefixes ¶
Prefixes returns the set of netip.Prefix entries that covers the IP range from first to last.
If first or last are invalid, in the wrong order, or if they're of different address families, then Prefixes returns nil.
Prefixes necessarily allocates. See PrefixesAppend for a version that uses memory you provide.
Example ¶
package main
import (
"fmt"
"net/netip"
"github.com/gaissmai/extnetip"
)
func main() {
first := netip.MustParseAddr("10.1.0.0")
last := netip.MustParseAddr("10.1.13.233")
pfxs := extnetip.Prefixes(first, last)
fmt.Println("Prefixes:")
for _, pfx := range pfxs {
fmt.Println(pfx)
}
}
Output: Prefixes: 10.1.0.0/21 10.1.8.0/22 10.1.12.0/24 10.1.13.0/25 10.1.13.128/26 10.1.13.192/27 10.1.13.224/29 10.1.13.232/31
func PrefixesAppend ¶ added in v0.3.0
PrefixesAppend is an append version of Prefixes. It appends the netip.Prefix entries to dst that covers the IP range from first to last.
func Range ¶
Range returns the inclusive range of IP addresses that p covers.
If p is invalid, Range returns the zero values.
Example ¶
package main
import (
"fmt"
"net/netip"
"github.com/gaissmai/extnetip"
)
func main() {
pfx := netip.MustParsePrefix("fe80::/10")
first, last := extnetip.Range(pfx)
fmt.Println("First:", first)
fmt.Println("Last: ", last)
}
Output: First: fe80:: Last: febf:ffff:ffff:ffff:ffff:ffff:ffff:ffff
Types ¶
This section is empty.
Source Files