netutil

Documentation

Overview

Package netutil contains extensions to the net package.

Index

• func CheckRelayIP(sender, addr net.IP) error
• func IsLAN(ip net.IP) bool
• func IsSpecialNetwork(ip net.IP) bool
• func IsTemporaryError(err error) bool
• type Netlist
  • func ParseNetlist(s string) (*Netlist, error)
  • func (l *Netlist) Add(cidr string)
  • func (l *Netlist) Contains(ip net.IP) bool
  • func (l Netlist) MarshalTOML() interface{}
  • func (l *Netlist) UnmarshalTOML(fn func(interface{}) error) error

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.

func IsTemporaryError

func IsTemporaryError(err error) bool

IsTemporaryError checks whether the given error should be considered temporary.

Types

type Netlist

type Netlist []net.IPNet

Netlist is a list of IP networks.

func ParseNetlist

func ParseNetlist(s string) (*Netlist, error)

ParseNetlist parses a comma-separated list of CIDR masks. Whitespace and extra commas are ignored.

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.

func (Netlist) MarshalTOML

func (l Netlist) MarshalTOML() interface{}

MarshalTOML implements toml.MarshalerRec.

func (*Netlist) UnmarshalTOML

func (l *Netlist) UnmarshalTOML(fn func(interface{}) error) error

UnmarshalTOML implements toml.UnmarshalerRec.