netutil

Documentation

Overview

Package netutil identifies the system userid responsible for localhost TCP connections.

Package netutil identifies the system userid responsible for localhost TCP connections.

Index

• Variables
• func AddrPairUserid(local, remote net.Addr) (uid int, err error)
• func AwaitReachable(addr string, maxWait time.Duration) error
• func ConnUserid(conn net.Conn) (uid int, err error)
• func HasPort(s string) bool
• func HostPort(urlStr string) (string, error)
• func HostPortToIP(hostport string, ctx *net.TCPAddr) (hostaddr *net.TCPAddr, err error)
• func IsFQDN(domain string) bool
• func ListenHostPort(listenAddr string) (string, error)
• func ListenOnLocalRandomPort() (net.Listener, error)
• func Localhost() (net.IP, error)
• func RandPort() (int, error)

Variables

var (
	ErrNotFound      = errors.New("netutil: connection not found")
	ErrUnsupportedOS = errors.New("netutil: not implemented on this operating system")
)

Functions

func AddrPairUserid

func AddrPairUserid(local, remote net.Addr) (uid int, err error)

AddrPairUserid returns the local userid who owns the TCP connection given by the local and remote ip:port (lipport and ripport, respectively). Returns ErrNotFound for the error if the TCP connection isn't found.

func AwaitReachable

func AwaitReachable(addr string, maxWait time.Duration) error

AwaitReachable tries to make a TCP connection to addr regularly. It returns an error if it's unable to make a connection before maxWait.

func ConnUserid

func ConnUserid(conn net.Conn) (uid int, err error)

ConnUserid returns the uid that owns the given localhost connection. The returned error is ErrNotFound if the connection wasn't found.

func HasPort

func HasPort(s string) bool

HasPort when given a string of the form "host", "host:port", or "[ipv6::address]:port", returns true if the string includes a port.

func HostPort

func HostPort(urlStr string) (string, error)

HostPort takes a urlStr string URL, and returns a host:port string suitable to passing to net.Dial, with the port set as the scheme's default port if absent.

func HostPortToIP

func HostPortToIP(hostport string, ctx *net.TCPAddr) (hostaddr *net.TCPAddr, err error)

HostPortToIP parses a host:port to a TCPAddr without resolving names. If given a context IP, it will resolve localhost to match the context's IP family.

func IsFQDN

func IsFQDN(domain string) bool

IsFQDN reports whether domain looks like a fully qualified domain name.

func ListenHostPort

func ListenHostPort(listenAddr string) (string, error)

ListenHostPort maps a listen address into a host:port string. If the host part in listenAddr is empty or 0.0.0.0, localhost is used instead.

func ListenOnLocalRandomPort

func ListenOnLocalRandomPort() (net.Listener, error)

ListenOnLocalRandomPort returns a TCP listener on a random localhost port.

func Localhost

func Localhost() (net.IP, error)

Localhost returns the first address found when doing a lookup of "localhost". If not successful, it looks for an ip on the loopback interfaces.

func RandPort

func RandPort() (int, error)

RandPort returns a random port to listen on.