net

Documentation

Overview

Package net implements a set of net types that are extensions to the built-in net package. The extensions provide additional function such as JSON marshaling and unmarshaling.

Index

• func ParseCIDR(c string) (*IP, *IPNet, error)
• func ParseCIDROrIP(c string) (*IP, *IPNet, error)
• type IP
  • func MustParseIP(i string) IP
  • func ParseIP(ip string) *IP
  • func (i IP) MarshalJSON() ([]byte, error)
  • func (i *IP) Network() *IPNet
  • func (i *IP) UnmarshalJSON(b []byte) error
  • func (i IP) Version() int
• type IPNet
  • func MustParseCIDR(c string) IPNet
  • func MustParseNetwork(c string) IPNet
  • func (i IPNet) IsNetOverlap(n net.IPNet) bool
  • func (i IPNet) MarshalJSON() ([]byte, error)
  • func (i *IPNet) Network() *IPNet
  • func (i IPNet) String() string
  • func (i *IPNet) UnmarshalJSON(b []byte) error
  • func (i *IPNet) Version() int
• type MAC
  • func (m MAC) MarshalJSON() ([]byte, error)
  • func (m *MAC) UnmarshalJSON(b []byte) error

Functions

func ParseCIDR

func ParseCIDR(c string) (*IP, *IPNet, error)

func ParseCIDROrIP

func ParseCIDROrIP(c string) (*IP, *IPNet, error)

Parse a CIDR or an IP address and return the IP, CIDR or error. If an IP address string is supplied, then the CIDR returned is the fully masked IP address (i.e /32 or /128)

Types

type IP

type IP struct {
	net.IP
}

Sub class net.IP so that we can add JSON marshalling and unmarshalling.

func MustParseIP

func MustParseIP(i string) IP

MustParseIP parses the string into a IP.

func ParseIP

func ParseIP(ip string) *IP

ParseIP returns an IP from a string

func (IP) MarshalJSON

func (i IP) MarshalJSON() ([]byte, error)

MarshalJSON interface for an IP

func (*IP) Network

func (i *IP) Network() *IPNet

Network returns the IP address as a fully masked IPNet type.

func (*IP) UnmarshalJSON

func (i *IP) UnmarshalJSON(b []byte) error

UnmarshalJSON interface for an IP

func (IP) Version

func (i IP) Version() int

Version returns the IP version for an IP, or 0 if the IP is not valid.

type IPNet

type IPNet struct {
	net.IPNet
}

Sub class net.IPNet so that we can add JSON marshalling and unmarshalling.

func MustParseCIDR

func MustParseCIDR(c string) IPNet

MustParseCIDR parses the string into a IPNet. The IP address in the IPNet is not masked.

func MustParseNetwork

func MustParseNetwork(c string) IPNet

MustParseNetwork parses the string into a IPNet. The IP address in the IPNet is masked.

func (IPNet) IsNetOverlap

func (i IPNet) IsNetOverlap(n net.IPNet) bool

IsNetOverlap is a utility function that returns true if the two subnet have an overlap.

func (IPNet) MarshalJSON

func (i IPNet) MarshalJSON() ([]byte, error)

MarshalJSON interface for an IPNet

func (*IPNet) Network

func (i *IPNet) Network() *IPNet

Network returns the masked IP network.

func (IPNet) String

func (i IPNet) String() string

String returns a friendly name for the network. The standard net package implements String() on the pointer, which means it will not be invoked on a struct type, so we re-implement on the struct type.

func (*IPNet) UnmarshalJSON

func (i *IPNet) UnmarshalJSON(b []byte) error

UnmarshalJSON interface for an IPNet

func (*IPNet) Version

func (i *IPNet) Version() int

Version returns the IP version for an IPNet, or 0 if not a valid IP net.

type MAC

type MAC struct {
	net.HardwareAddr
}

Sub class net.HardwareAddr so that we can add JSON marshalling and unmarshalling.

func (MAC) MarshalJSON

func (m MAC) MarshalJSON() ([]byte, error)

MarshalJSON interface for a MAC

func (*MAC) UnmarshalJSON

func (m *MAC) UnmarshalJSON(b []byte) error

UnmarshalJSON interface for a MAC