net

Documentation

Index

• Variables
• func HostportOrDefault(hostport string, defHostport string) string
• func IsLoopbackHost(host string) bool
• func ListenIP() (net.IP, error)
• func LoopbackListener(ports ...string) (net.Listener, error)
• func OnceCloseListener(l net.Listener) net.Listener
• func RandomPort(host string) (int, error)
• func ScoreAddr(iface net.Interface, addr net.Addr) (int, net.IP)
• func SplitHostPort(hostport string) (host, port string, err error)
• func TcpKeepAliveListener(l *net.TCPListener, d time.Duration) net.Listener
• type MultiListener
  • func NewMultiListener(listeners ...net.Listener) *MultiListener
  • func (l *MultiListener) Accept() (net.Conn, error)
  • func (l *MultiListener) Addr() net.Addr
  • func (l *MultiListener) Close() error
• type NotifyListener
  • func NewNotifyListener() *NotifyListener
  • func (l *NotifyListener) Accept() (net.Conn, error)
  • func (l *NotifyListener) Addr() net.Addr
  • func (l *NotifyListener) Close() error
  • func (l *NotifyListener) DoneC() <-chan struct{}

Variables

var ErrListenerClosed = errListenerClosed("net: listener closed")

ErrListenerClosed is returned from Listener.Accept when the underlying listener is closed.

var Ipv4LoopbackHosts = []string{"localhost", "127.0.0.1"}

var Ipv6LoopbackHosts = []string{"localhost", "[::1]", "::1"}

Functions

func HostportOrDefault

func HostportOrDefault(hostport string, defHostport string) string

func IsLoopbackHost

func IsLoopbackHost(host string) bool

func ListenIP

func ListenIP() (net.IP, error)

ListenIP returns the IP to bind to in Listen. It tries to find an IP that can be used by other machines to reach this machine.

func LoopbackListener

func LoopbackListener(ports ...string) (net.Listener, error)

LoopbackListener returns a loopback listener on a first usable port in ports or 0 if ports is empty

func OnceCloseListener

func OnceCloseListener(l net.Listener) net.Listener

OnceCloseListener wraps a net.Listener, protecting it from multiple Close calls.

func RandomPort

func RandomPort(host string) (int, error)

func ScoreAddr

func ScoreAddr(iface net.Interface, addr net.Addr) (int, net.IP)

ScoreAddr scores how likely the given addr is to be a remote address and returns the IP to use when listening. Any address which receives a negative score should not be used. Scores are calculated as: -1 for any unknown IP addreseses. +300 for IPv4 addresses +100 for non-local addresses, extra +100 for "up" interaces.

func SplitHostPort

func SplitHostPort(hostport string) (host, port string, err error)

SplitHostPort splits a network address of the form "host:port", "host%zone:port", "[host]:port" or "[host%zone]:port" into host or host%zone and port. Different to net.SplitHostPort, host or port can be not set

A literal IPv6 address in hostport must be enclosed in square brackets, as in "[::1]:80", "[::1%lo0]:80".

See func Dial for a description of the hostport parameter, and host and port results.

func TcpKeepAliveListener

func TcpKeepAliveListener(l *net.TCPListener, d time.Duration) net.Listener

TcpKeepAliveListener sets TCP keep-alive timeouts on accepted connections. It's used by ListenAndServe and ListenAndServeTLS so dead TCP connections (e.g. closing laptop mid-download) eventually go away.

Types

type MultiListener

type MultiListener struct {
	*NotifyListener

	// ErrorLog specifies an optional logger for errors accepting
	// connections, unexpected behavior from handlers, and
	// underlying FileSystem errors.
	// If nil, logging is done via the log package's standard logger.
	ErrorLog *log.Logger
	// contains filtered or unexported fields
}

MultiListener is a net.Listener that accepts all the connections from all listeners.

func NewMultiListener

func NewMultiListener(listeners ...net.Listener) *MultiListener

func (*MultiListener) Accept

func (l *MultiListener) Accept() (net.Conn, error)

func (*MultiListener) Addr

func (l *MultiListener) Addr() net.Addr

Addr returns the listener's network address.

func (*MultiListener) Close

func (l *MultiListener) Close() error

type NotifyListener

type NotifyListener struct {
	C chan net.Conn
	// contains filtered or unexported fields
}

func NewNotifyListener

func NewNotifyListener() *NotifyListener

NewNotifyListener creates a new Listener that will recv conns on its channel.

func (*NotifyListener) Accept

func (l *NotifyListener) Accept() (net.Conn, error)

func (*NotifyListener) Addr

func (l *NotifyListener) Addr() net.Addr

Addr returns the listener's network address.

func (*NotifyListener) Close

func (l *NotifyListener) Close() error

Stop prevents the NotifyListener from firing. To ensure the channel is empty after a call to Close, check the return value and drain the channel.

func (*NotifyListener) DoneC

func (l *NotifyListener) DoneC() <-chan struct{}

DoneC returns whether this listener has been closed for multi producers of C