punix

Documentation

Overview

punix has functions to examine unix.Errno errors

Index

• func Errno(err error) (errnoValue unix.Errno)
• func ErrnoError(err error, includeError ...bool) (errnoString string)
• func IsConnectionRefused(err error) (isConnectionRefused bool)
• func IsENOENT(err error) (isENOENT bool)

Functions

func Errno

func Errno(err error) (errnoValue unix.Errno)

Errno scans an error chain for a unix.Errno type. Errno returns unix.Errno 0x0 if none exists. Note: unix.Errno.Error has value receiver. Errno checks:

Errno(nil) == 0 → true.
if errno != 0 {…
int(errno) provides the numeric value.
 if errno == unix.ENOENT…
 fmt.Printf("%v", errno) → state not recoverable
 fmt.Printf("0x%x", int(errno)) → 0x68

func ErrnoError

func ErrnoError(err error, includeError ...bool) (errnoString string)

ErrnoError gets the errno interpretation if the error chain does contain a unix.Errno type. if includeError is true, the error chain’s error message is prepended. if includeError is true and err is nil "OK" is returned if includeError is false or missing and no errno exists, the empty string is returned

func IsConnectionRefused

func IsConnectionRefused(err error) (isConnectionRefused bool)

IsConnectionRefused searches the error chsin of err for unix.ECONNREFUSED net.Dialer errors for closed socket

func IsENOENT

func IsENOENT(err error) (isENOENT bool)

IsENOENT returns true if the root cause of err is file not found. Can be used with os.Open* file not found