net

Documentation

Index

• Variables
• func HostportOrDefault(hostport string, defHostport string) string
• func IP4toUInt32(ip net.IP) uint32
• func IPtoBigInt(ip net.IP) *big.Int
• func IsLoopbackHost(host string) bool
• func LoopbackListener(ports ...string) (net.Listener, error)
• func OnceCloseListener(l net.Listener) net.Listener
• func ParseIP(s string) net.IP
• func ParseIPV4(i uint32) net.IP
• func ParseIPV6(s string, base int) net.IP
• 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 IPFormat
  • func (ip IPFormat) Format(s fmt.State, verb rune)
• 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 INet6AToN = IPtoBigInt

INet6AToN returns the numeric value of an IPv6 address

var INet6NToA = ParseIPV6

INet6NToA returns the IPv6 address from a numeric value

var INetAToN = IP4toUInt32

INetAToN returns the numeric value of an IP address

var INetNToA = ParseIPV4

INetNToA returns the IP address from a numeric value

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 IP4toUInt32

func IP4toUInt32(ip net.IP) uint32

func IPtoBigInt

func IPtoBigInt(ip net.IP) *big.Int

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 ParseIP

func ParseIP(s string) net.IP

func ParseIPV4

func ParseIPV4(i uint32) net.IP

ParseIPV4 parses i as an IP address, returning the result. If i is not a valid integer representation of an IP address, ParseIP returns nil.

func ParseIPV6

func ParseIPV6(s string, base int) net.IP

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 IPFormat

type IPFormat net.IP

func (IPFormat) Format

func (ip IPFormat) Format(s fmt.State, verb rune)

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