goping

README

Dependencies

gopingonly works on unixes & is only tested with golang 1.8 and 1.10

• golang.org/x/net/icmp
• golang.org/x/net/ipv4
• github.com/erriapo/stats
• golang.org/x/net/idna

Screencast

Quick install

$ go get -x gopkg.in/erriapo/goping.v1

Usage example

$ goping -c 2 8.8.4.4
.
PING 8.8.4.4 (8.8.4.4) 56(84) bytes of data.
64 bytes from google-public-dns-b.google.com. (8.8.4.4): icmp_seq=1 time=838.022µs
64 bytes from google-public-dns-b.google.com. (8.8.4.4): icmp_seq=2 time=978.804µs

--- 8.8.4.4 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss
rtt min/avg/max/mdev = 0.838/0.908/0.979/0.1 ms


$ goping -c 4 xn--bdk.ws
.                                                                                              
PING ツ.ws. (132.148.137.119) 56(84) bytes of data.                                            
64 bytes from ip-132-148-137-119.ip.secureserver.net. (132.148.137.119): icmp_seq=1 time=33.892283ms
64 bytes from ip-132-148-137-119.ip.secureserver.net. (132.148.137.119): icmp_seq=2 time=33.402274ms
64 bytes from ip-132-148-137-119.ip.secureserver.net. (132.148.137.119): icmp_seq=3 time=33.361368ms
64 bytes from ip-132-148-137-119.ip.secureserver.net. (132.148.137.119): icmp_seq=4 time=33.486581ms                                                                                          
--- ツ.ws. ping statistics ---
4 packets transmitted, 4 received, 0% packet loss
rtt min/avg/max/mdev = 33.361/33.536/33.892/0.243 ms


$ GODEBUG=netdns=cgo+2 goping -I eth1 -c 3 1.1
.
go package net: using cgo DNS resolver
go package net: hostLookupOrder(1.1) = cgo
go package net: hostLookupOrder() = cgo
go package net: hostLookupOrder() = cgo
PING 1.1. (1.0.0.1) 56(84) bytes of data.
64 bytes from 1dot1dot1dot1.cloudflare-dns.com. (1.0.0.1): icmp_seq=1 time=7.85096ms
64 bytes from 1dot1dot1dot1.cloudflare-dns.com. (1.0.0.1): icmp_seq=2 time=7.240956ms
64 bytes from 1dot1dot1dot1.cloudflare-dns.com. (1.0.0.1): icmp_seq=3 time=7.208994ms

--- 1.1. ping statistics ---
3 packets transmitted, 3 received, 0% packet loss
rtt min/avg/max/mdev = 7.209/7.434/7.851/0.362 ms

Additionally, the goping binary needs the CAP_NET_RAWIO capability. Or if you prefer, you can execute it set-uid root.

TODOs

• Better test code coverage.
• Support IPV6 addresses.
• Parse the ICMP Echo reply & add the reply TTLs.