Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func IsPrivateAddress ¶
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.
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 RequirePublicIP ¶
func RequirePublicIP(ip net.IP) *ConnectionError
RequirePublicIP returns an error if the destination IP is not a standard public IP.
type DuplexConn ¶
type DuplexConn interface {
net.Conn
// Closes the Read end of the connection, allowing for the release of resources.
// No more reads should happen.
CloseRead() error
// Closes the Write end of the connection. An EOF or FIN signal may be
// sent to the connection target.
CloseWrite() error
}
DuplexConn is a net.Conn that allows for closing only the reader or writer end of it, supporting half-open state.
func WrapConn ¶
func WrapConn(c DuplexConn, r io.Reader, w io.Writer, fd int) DuplexConn
WrapDuplexConn wraps an existing DuplexConn with new Reader and Writer, but preserving the original CloseRead() and CloseWrite().
type TargetIPValidator ¶
type TargetIPValidator = func(net.IP) *ConnectionError
TargetIPValidator is a type alias for checking if an IP is allowed.
Source Files