traceroute

README

go-traceroute

Installation

Please be aware that macOS doesn't support the setcap command.

go get github.com/vaegt/go-traceroute
cd $GOPATH/src/github.com/vaegt/go-traceroute/cmd
go build -o go-traceroute
sudo setcap 'cap_net_raw+p' ./go-traceroute

or

download the latest release

Documentation

Index

• type Hop
• type IPConn
• type TraceData
  • func Exec(dest net.IP, timeout time.Duration, tries int, maxTTL int, proto string, ...) (data TraceData)
  • func (data *TraceData) All() (err error)
  • func (data *TraceData) Next() (err error)

Types

type Hop

type Hop struct {
	TryNumber int
	TTL       int
	AddrIP    net.IP
	AddrDNS   []string //net.IPAddr
	Latency   time.Duration
	Err       error
}

Hop represents a path between a source and a destination.

type IPConn

type IPConn interface {
	Write([]byte)
}

type TraceData

type TraceData struct {
	Hops    [][]Hop
	Dest    net.IP
	Timeout time.Duration
	Tries   int
	MaxTTL  int
	Port    int
	Proto   string
	IPv     string
}

TraceData represents data received by executing traceroute.

func Exec

func Exec(dest net.IP, timeout time.Duration, tries int, maxTTL int, proto string, port int) (data TraceData)

Exec returns TraceData with initialized Hops and inserts the IP version into the protocol

func (*TraceData) All

func (data *TraceData) All() (err error)

All executes all doHops for all tries.

func (*TraceData) Next

func (data *TraceData) Next() (err error)

Next executes the doHop method for every try.