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.

Documentation

Overview

Copyright 2017 Gavin Chun Jin. All rights reserved. Use of this source code is governed by the MIT license that can be found in the LICENSE file.