portutil

package module
v0.0.0-...-3c372a3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 26, 2016 License: MIT Imports: 2 Imported by: 1

README

PortUtil

Quickly verify if a port is available or get a unique port (TCP/UDP).

Installation

go get -u github.com/forestgiant/portutil

or vendor with gv gv get github.com/forestgiant/portutil

Docs

http://godoc.org/github.com/forestgiant/portutil

Examples

Verify, VerifyTCP, VerifyUDP:

port, err := portutil.Verify("tcp", 8080)
if err != nil {
	log.Fatal(err)
}
port, err := portutil.VerifyUDP(8080)
if err != nil {
	log.Fatal(err)
}
port, err := portutil.VerifyTCP(8080)
if err != nil {
	log.Fatal(err)
}

Verify Port from a HostPort string

serviceHost, err := portutil.VerifyHostPort("tcp", "127.0.0.1:8080")
if err != nil {
	log.Fatal(err)
}

GetUnique, GetUniqueTCP, GetUniqueUDP:

port, err := portutil.GetUnique("tcp")
if err != nil {
	log.Fatal(err)
}
port, err := portutil.GetUniqueTCP
if err != nil {
	log.Fatal(err)
}
port, err := portutil.GetUniqueUDP
if err != nil {
	log.Fatal(err)
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func GetPortFromAddr

func GetPortFromAddr(addr string) (port int, err error)

GetPortFromAddr is a helper function to quickly get the port from an addr string

func GetUnique

func GetUnique(netProto string) (port int, err error)

GetUnique gets a unique port on "udp" or "tcp"

func GetUniqueTCP

func GetUniqueTCP() (port int, err error)

GetUniqueTCP gets a unique port TCP

func GetUniqueUDP

func GetUniqueUDP() (port int, err error)

GetUniqueUDP gets a unique port UDP

func JoinHostPort

func JoinHostPort(host string, port int) string

JoinHostPort wrapper function for net.JoinHostPort to easily pass port as an int instead of a string

func ReplacePortInAddr

func ReplacePortInAddr(addr, newPort string) (string, error)

ReplacePortInAddr takes an address string and replaces the port

func Verify

func Verify(netProto string, port int) (verifiedPort int, err error)

Verify verifies if a port is available on "udp" or "tcp"

func VerifyHostPort

func VerifyHostPort(netProto string, addr string) (verifiedAddr string, err error)

VerifyHostPort is a wrapper function for VerifyTCP to easily accept address string

func VerifyTCP

func VerifyTCP(port int) (verifiedPort int, err error)

VerifyTCP verifies if a port is available on TCP

func VerifyUDP

func VerifyUDP(port int) (verifiedPort int, err error)

VerifyUDP verifies if a port is available on UDP

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL