netutil

Documentation

Overview

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 HostPortToIP(hostport string, ctx *net.TCPAddr) (hostaddr *net.TCPAddr, err error)
• func Localhost() (net.IP, 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 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 Localhost

func Localhost() (net.IP, error)

Localhost returns the first address found when doing a lookup of "localhost".