netutils

Documentation

Index

• Variables
• func CheckNameserverOverlaps(nameservers []string, toCheck *net.IPNet) error
• func CheckRouteOverlaps(toCheck *net.IPNet) error
• func FindAvailableNetwork(list []*net.IPNet) (*net.IPNet, error)
• func GenerateIfaceName(nlh *netlink.Handle, prefix string, len int) (string, error)
• func GenerateMACFromIP(ip net.IP) net.HardwareAddr
• func GenerateRandomMAC() net.HardwareAddr
• func GenerateRandomName(prefix string, length int) (string, error)
• func GetIfaceAddr(name string) (net.Addr, []net.Addr, error)
• func NetworkOverlaps(netX *net.IPNet, netY *net.IPNet) bool
• func NetworkRange(network *net.IPNet) (net.IP, net.IP)
• func ParseAlias(val string) (string, string, error)
• func ReverseIP(IP string) string
• func ValidateAlias(val string) (string, error)

Variables

var (
	// ErrNetworkOverlapsWithNameservers preformatted error
	ErrNetworkOverlapsWithNameservers = errors.New("requested network overlaps with nameserver")
	// ErrNetworkOverlaps preformatted error
	ErrNetworkOverlaps = errors.New("requested network overlaps with existing network")
)

Functions

func CheckNameserverOverlaps

func CheckNameserverOverlaps(nameservers []string, toCheck *net.IPNet) error

CheckNameserverOverlaps checks whether the passed network overlaps with any of the nameservers

func CheckRouteOverlaps

func CheckRouteOverlaps(toCheck *net.IPNet) error

CheckRouteOverlaps checks whether the passed network overlaps with any existing routes

func FindAvailableNetwork

func FindAvailableNetwork(list []*net.IPNet) (*net.IPNet, error)

FindAvailableNetwork returns a network from the passed list which does not overlap with existing interfaces in the system

func GenerateIfaceName

func GenerateIfaceName(nlh *netlink.Handle, prefix string, len int) (string, error)

GenerateIfaceName returns an interface name using the passed in prefix and the length of random bytes. The api ensures that the there are is no interface which exists with that name.

func GenerateMACFromIP

func GenerateMACFromIP(ip net.IP) net.HardwareAddr

GenerateMACFromIP returns a locally administered MAC address where the 4 least significant bytes are derived from the IPv4 address.

func GenerateRandomMAC

func GenerateRandomMAC() net.HardwareAddr

GenerateRandomMAC returns a new 6-byte(48-bit) hardware address (MAC)

func GenerateRandomName

func GenerateRandomName(prefix string, length int) (string, error)

GenerateRandomName returns a string of the specified length, created by joining the prefix to random hex characters. The length must be strictly larger than len(prefix), or an error will be returned.

func GetIfaceAddr

func GetIfaceAddr(name string) (net.Addr, []net.Addr, error)

GetIfaceAddr returns the first IPv4 address and slice of IPv6 addresses for the specified network interface

func NetworkOverlaps

func NetworkOverlaps(netX *net.IPNet, netY *net.IPNet) bool

NetworkOverlaps detects overlap between one IPNet and another

func NetworkRange

func NetworkRange(network *net.IPNet) (net.IP, net.IP)

NetworkRange calculates the first and last IP addresses in an IPNet

func ParseAlias

func ParseAlias(val string) (string, string, error)

ParseAlias parses and validates the specified string as an alias format (name:alias)

func ReverseIP

func ReverseIP(IP string) string

ReverseIP accepts a V4 or V6 IP string in the canonical form and returns a reversed IP in the dotted decimal form . This is used to setup the IP to service name mapping in the optimal way for the DNS PTR queries.

func ValidateAlias

func ValidateAlias(val string) (string, error)

ValidateAlias validates that the specified string has a valid alias format (containerName:alias).