net

Documentation

Index

• func IsPrivateAddress(ip net.IP) bool
• func Relay(leftConn, rightConn DuplexConn) (int64, int64, error)
• func RequirePublicIP(ip net.IP) error
• type ConnectionError
  • func NewConnectionError(status, message string, cause error) *ConnectionError
  • func (e *ConnectionError) Error() string
  • func (e *ConnectionError) Unwrap() error
• type DuplexConn
• type TargetIPValidator

Functions

func IsPrivateAddress

func IsPrivateAddress(ip net.IP) bool

IsPrivateAddress returns whether an IP address belongs to the LAN.

func Relay

func Relay(leftConn, rightConn DuplexConn) (int64, int64, error)

Relay copies between left and right bidirectionally. Returns number of bytes copied from right to left, from left to right, and any error occurred. Relay allows for half-closed connections: if one side is done writing, it can still read all remaining data from its peer.

func RequirePublicIP

func RequirePublicIP(ip net.IP) error

RequirePublicIP returns an error if the destination IP is not a standard public IP.

Types

type ConnectionError

type ConnectionError struct {
	// TODO: create status enums and move to metrics.go
	Status  string
	Message string
	Cause   error
}

func NewConnectionError

func NewConnectionError(status, message string, cause error) *ConnectionError

func (*ConnectionError) Error

func (e *ConnectionError) Error() string

func (*ConnectionError) Unwrap

func (e *ConnectionError) Unwrap() error

type DuplexConn

type DuplexConn = transport.StreamConn

type TargetIPValidator

type TargetIPValidator = func(net.IP) error

TargetIPValidator is a type alias for checking if an IP is allowed.