netutil

Documentation

Index

• func AllIPAddr() string
• func BidiCopy(conn1, conn2 io.ReadWriteCloser, isClient bool) error
• func IsIPDualStack() bool
• func LocalIPAddr() string
• func MaybeDecorateIPv6(addr string) string
• func ReuseAddrPort(network, address string, conn syscall.RawConn) error
• func SendReceive(ctx context.Context, conn net.Conn, req []byte) (resp []byte, err error)
• func UnusedTCPPort() (int, error)
• func UnusedUDPPort() (int, error)
• func WaitForClose(conn net.Conn)
• type HierarchyConn
  • func WrapHierarchyConn(conn net.Conn) HierarchyConn
• type IPVersion
  • func GetIPVersion(addr string) IPVersion
• type TransportProtocol

Functions

func AllIPAddr

func AllIPAddr() string

AllIPAddr returns a catch-all IP address to bind. If the machine supports IP dual stack, "::" is returned. Otherwise "0.0.0.0" is returned.

func BidiCopy

func BidiCopy(conn1, conn2 io.ReadWriteCloser, isClient bool) error

BidiCopy does bi-directional data copy.

func IsIPDualStack

func IsIPDualStack() bool

IsIPDualStack returns true if an IPv6 socket is able to send and receive both IPv4 and IPv6 packets.

This function only supports Linux. It always returns false if running other operating systems.

func LocalIPAddr

func LocalIPAddr() string

LocalIPAddr returns the localhost IP address.

func MaybeDecorateIPv6

func MaybeDecorateIPv6(addr string) string

MaybeDecorateIPv6 adds [ and ] before and after an IPv6 address. If the input string is a IPv4 address or not a valid IP address (e.g. is a domain), the same string is returned.

func ReuseAddrPort

func ReuseAddrPort(network, address string, conn syscall.RawConn) error

ReuseAddrPort sets SO_REUSEADDR and SO_REUSEPORT options to a given connection.

func SendReceive

func SendReceive(ctx context.Context, conn net.Conn, req []byte) (resp []byte, err error)

SendReceive sends a request to the connection and returns the response. The maxinum size of response is 4096 bytes.

func UnusedTCPPort

func UnusedTCPPort() (int, error)

UnusedTCPPort returns an unused TCP port.

func UnusedUDPPort

func UnusedUDPPort() (int, error)

UnusedUDPPort returns an unused UDP port.

func WaitForClose

func WaitForClose(conn net.Conn)

WaitForClose blocks the go routine. It returns when the peer closes the connection. In the meanwhile, everything send by the peer is discarded.

Types

type HierarchyConn

type HierarchyConn interface {
	net.Conn

	AddSubConnection(conn net.Conn)
}

HierarchyConn closes sub-connections when this connection is closed.

func WrapHierarchyConn

func WrapHierarchyConn(conn net.Conn) HierarchyConn

WrapHierarchyConn wraps an existing connection with HierarchyConn.

type IPVersion

type IPVersion int

const (
	IPVersionUnknown IPVersion = iota
	IPVersion4
	IPVersion6
)

func GetIPVersion

func GetIPVersion(addr string) IPVersion

GetIPVersion returns the IP version of the given network address.

type TransportProtocol

type TransportProtocol int

const (
	UnknownTransport TransportProtocol = iota
	UDPTransport
	TCPTransport
)