net

Documentation

Index

• Variables
• func HostportOrDefault(hostport string, defHostport string) string
• func IsLoopbackHost(host string) bool
• func LoopbackListener(ports ...string) (net.Listener, error)
• func OnceCloseListener(l net.Listener) net.Listener
• func RandomPort(host string) (int, error)
• 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 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 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