myaddr

README

Overview

myaddr is a golang module for IPv4/IPv6 address, hardware(MAC) address and VLAN ID manipulation

Documentation

Overview

Package myaddr is Go module that provides varies functions to processing address, include IP address, MAC address and VLAN ID.

Index

• Constants
• func AddrtoBig(addr net.IP) *big.Int
• func BigtoAddr(n *big.Int, ipv4 bool) (net.IP, error)
• func BigtoHWAddr(n *big.Int, alen int) (net.HardwareAddr, error)
• func BigtoMACAddr(n *big.Int) (net.HardwareAddr, error)
• func GenAddrWithIPNet(prefix *net.IPNet, hostn *big.Int) (net.IP, error)
• func GenConnectionAddrStr(prefix string, ip net.IP, port int) string
• func GenPrefixWithPrefix(prefix netip.Prefix, hostn *big.Int) (netip.Prefix, error)
• func GetLLAFromMac(mac net.HardwareAddr) net.IP
• func HWAddrtoBig(addr net.HardwareAddr) *big.Int
• func IncAddr(addr net.IP, step *big.Int) (net.IP, error)
• func IncMACAddr(macaddr net.HardwareAddr, step *big.Int) (net.HardwareAddr, error)
• func IncreaseVLANIDs(ids []uint16, step int) ([]uint16, error)

Constants

const (
	MaxIPv4AddrN   = 4294967295
	MaxMACAddrN    = 281474976710655
	MaxIPv6AddrStr = "340282366920938463463374607431768211455"
)

MAX Values

Functions

func AddrtoBig

func AddrtoBig(addr net.IP) *big.Int

AddrtoBig convert IP address to *big.Int

func BigtoAddr

func BigtoAddr(n *big.Int, ipv4 bool) (net.IP, error)

BigtoAddr convert n to IPv4 address if ipv4 is true, IPv6 address otherwise

func BigtoHWAddr

func BigtoHWAddr(n *big.Int, alen int) (net.HardwareAddr, error)

BigtoHWAddr convert n to a hardware address, with specified alen

func BigtoMACAddr

func BigtoMACAddr(n *big.Int) (net.HardwareAddr, error)

BigtoMACAddr convert n to a MAC address

func GenAddrWithIPNet

func GenAddrWithIPNet(prefix *net.IPNet, hostn *big.Int) (net.IP, error)

GenAddrWithIPNet geneate an address = prefix + hostn. hostn must>=0

func GenConnectionAddrStr

func GenConnectionAddrStr(prefix string, ip net.IP, port int) string

GenConnectionAddrStr return a string with following format: IPv4: <prefix><ip>:<port> IPv6: <prefix>[<ip>]:<port>

func GenPrefixWithPrefix

func GenPrefixWithPrefix(prefix netip.Prefix, hostn *big.Int) (netip.Prefix, error)

GenPrefixWithPrefix geneate an prefix = prefix + hostn. hostn must>=0

func GetLLAFromMac

func GetLLAFromMac(mac net.HardwareAddr) net.IP

GetLLAFromMac return an IPv6 link local address from mac, based on Appendix A of RFC4291

func HWAddrtoBig

func HWAddrtoBig(addr net.HardwareAddr) *big.Int

HWAddrtoBig convert hardware address to *big.Int

func IncAddr

func IncAddr(addr net.IP, step *big.Int) (net.IP, error)

IncAddr increase addr by step (could be negative), return the result

func IncMACAddr

func IncMACAddr(macaddr net.HardwareAddr, step *big.Int) (net.HardwareAddr, error)

IncMACAddr increase macaddr by step (could be negative), return the result

func IncreaseVLANIDs

func IncreaseVLANIDs(ids []uint16, step int) ([]uint16, error)

IncreaseVLANIDs increase a slice of VLAN Id (12 bit long) with specified step