golang ping go-ping库简介

受go-fastping启发，一个简单但功能强大的Go Go的ICMP回显（ping）库。

实例

这是一个非常简单的示例，该示例发送和接收三个数据包：

pinger, err := ping.NewPinger("www.google.com")
if err != nil {
	panic(err)
}
pinger.Count = 3
err = pinger.Run() // Blocks until finished.
if err != nil {
	panic(err)
}
stats := pinger.Statistics() // get send/receive/duplicate/rtt stats

这是一个模拟传统UNIX ping命令的示例：

pinger, err := ping.NewPinger("www.google.com")
if err != nil {
	panic(err)
}

// Listen for Ctrl-C.
c := make(chan os.Signal, 1)
signal.Notify(c, os.Interrupt)
go func() {
	for _ = range c {
		pinger.Stop()
	}
}()

pinger.OnRecv = func(pkt *ping.Packet) {
	fmt.Printf("%d bytes from %s: icmp_seq=%d time=%v\n",
		pkt.Nbytes, pkt.IPAddr, pkt.Seq, pkt.Rtt)
}

pinger.OnDuplicateRecv = func(pkt *ping.Packet) {
	fmt.Printf("%d bytes from %s: icmp_seq=%d time=%v ttl=%v (DUP!)\n",
		pkt.Nbytes, pkt.IPAddr, pkt.Seq, pkt.Rtt, pkt.Ttl)
}

pinger.OnFinish = func(stats *ping.Statistics) {
	fmt.Printf("\n--- %s ping statistics ---\n", stats.Addr)
	fmt.Printf("%d packets transmitted, %d packets received, %v%% packet loss\n",
		stats.PacketsSent, stats.PacketsRecv, stats.PacketLoss)
	fmt.Printf("round-trip min/avg/max/stddev = %v/%v/%v/%v\n",
		stats.MinRtt, stats.AvgRtt, stats.MaxRtt, stats.StdDevRtt)
}

fmt.Printf("PING %s (%s):\n", pinger.Addr(), pinger.IPAddr())
err = pinger.Run()
if err != nil {
	panic(err)
}

它发送ICMP Echo Request数据包，并等待Echo Reply作为响应。如果收到响应，它将调用OnRecv回调，除非已经接收到具有该序列号的数据包，在这种情况下，它将调用OnDuplicateRecv回调。完成后，它将调用OnFinish回调。

对于全平示例，请参阅 CMD /平/ ping.go。

安装

go get -u github.com/go-ping/ping

要安装本地Go ping可执行文件，请执行以下操作：

go get -u github.com/go-ping/ping/...
$GOPATH/bin/ping

支持的操作系统

Linux

该库尝试通过UDP发送“非特权” ping。在Linux上，必须使用以下sysctl命令启用它：

sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"

如果您不想这样做，则可以调用pinger.SetPrivileged(true) 代码，然后在二进制文件上使用setcap使其绑定到原始套接字（或仅以root身份运行）：

setcap cap_net_raw=+ep /path/to/your/compiled/binary

有关更多详细信息，请参见此博客和Go x / net / icmp软件包。

Windows

您必须使用pinger.SetPrivileged(true)，否则您将收到以下错误：

socket: The requested protocol has not been configured into the system, or no implementation for it exists.

尽管使用了方法名称，但该方法无需提升特权即可工作，并且已在Windows 10上进行了测试。请注意，由于Go x / net / ipv4和x / net / ipv6程序包中的限制，因此不支持访问数据包TTL值。。