distip

Documentation

Index

• func CheckRelayIP(sender, addr net.IP) error
• func IsLAN(ip net.IP) bool
• func IsSpecialNetwork(ip net.IP) bool
• type DistinctNetSet
  • func (s *DistinctNetSet) Add(ip net.IP) bool
  • func (s DistinctNetSet) Contains(ip net.IP) bool
  • func (s DistinctNetSet) Len() uint
  • func (s *DistinctNetSet) Remove(ip net.IP)
  • func (s DistinctNetSet) String() string
• type Netlist
  • func (l *Netlist) Add(cidr string)
  • func (l *Netlist) Contains(ip net.IP) bool

Functions

func CheckRelayIP

func CheckRelayIP(sender, addr net.IP) error

CheckRelayIP reports whether an IP relayed from the given sender IP is a valid connection target.

There are four rules:

• Special network addresses are never valid.
• Loopback addresses are OK if relayed by a loopback host.
• LAN addresses are OK if relayed by a LAN host.
• All other addresses are always acceptable.

func IsLAN

func IsLAN(ip net.IP) bool

IsLAN reports whether an IP is a local network address.

func IsSpecialNetwork

func IsSpecialNetwork(ip net.IP) bool

IsSpecialNetwork reports whether an IP is located in a special-use network range This includes broadcast, multicast and documentation addresses.

Types

type DistinctNetSet

type DistinctNetSet struct {
	Subnet uint // number of common prefix bits
	Limit  uint // maximum number of IPs in each subnet
	// contains filtered or unexported fields
}

DistinctNetSet tracks IPs, ensuring that at most N of them fall into the same network range.

func (*DistinctNetSet) Add

func (s *DistinctNetSet) Add(ip net.IP) bool

Add adds an IP address to the set. It returns false (and doesn't add the IP) if the number of existing IPs in the defined range exceeds the limit.

func (DistinctNetSet) Contains

func (s DistinctNetSet) Contains(ip net.IP) bool

Contains whether the given IP is contained in the set.

func (DistinctNetSet) Len

func (s DistinctNetSet) Len() uint

Len returns the number of tracked IPs.

func (*DistinctNetSet) Remove

func (s *DistinctNetSet) Remove(ip net.IP)

Remove removes an IP from the set.

func (DistinctNetSet) String

func (s DistinctNetSet) String() string

String implements fmt.Stringer

type Netlist

type Netlist []net.IPNet

Netlist is a list of IP networks.

func (*Netlist) Add

func (l *Netlist) Add(cidr string)

Add parses a CIDR mask and appends it to the list. It panics for invalid masks and is intended to be used for setting up static lists.

func (*Netlist) Contains

func (l *Netlist) Contains(ip net.IP) bool

Contains reports whether the given IP is contained in the list.