mirror of
https://github.com/taigrr/go-fastping
synced 2025-01-18 05:03:15 -08:00
57 lines
1.4 KiB
Markdown
57 lines
1.4 KiB
Markdown
go-fastping
|
|
===========
|
|
|
|
go-fastping is a Go language port of Marc Lehmann's AnyEvent::FastPing Perl
|
|
module to send ICMP ECHO REQUEST packets quickly. Original Perl module is
|
|
available at
|
|
http://search.cpan.org/~mlehmann/AnyEvent-FastPing-2.01/
|
|
|
|
It hasn't been fully implemented original functions yet and only for IPv4 now.
|
|
|
|
## Installation
|
|
|
|
Install and update this go package with `go get -u github.com/tatsushid/go-fastping`
|
|
|
|
## Examples
|
|
|
|
Import this package and write
|
|
|
|
```go
|
|
p := fastping.NewPinger()
|
|
ra, err := net.ResolveIPAddr("ip4:icmp", os.Args[1])
|
|
if err != nil {
|
|
fmt.Println(err)
|
|
os.Exit(1)
|
|
}
|
|
p.AddIPAddr(ra)
|
|
err = p.AddHandler("receive", func(addr *net.IPAddr, rtt time.Duration) {
|
|
fmt.Printf("IP Addr: %s receive, RTT: %v\n", addr.String(), rtt)
|
|
})
|
|
if err != nil {
|
|
fmt.Println(err)
|
|
os.Exit(1)
|
|
}
|
|
err = p.AddHandler("idle", func() {
|
|
fmt.Println("finish")
|
|
})
|
|
if err != nil {
|
|
fmt.Println(err)
|
|
os.Exit(1)
|
|
}
|
|
err = p.Run()
|
|
if err != nil {
|
|
fmt.Println(err)
|
|
}
|
|
```
|
|
|
|
It sends an ICMP packet and wait a response. If it receives a response, it
|
|
calls "receive" callback. After that, MaxRTT time passed, it calls "idle"
|
|
callback. For more detail, refer [godoc][godoc] and If you need more example,
|
|
please see "cmd/ping/ping.go".
|
|
|
|
## License
|
|
go-fastping is under MIT License. See the [LICENSE][license] file for details.
|
|
|
|
[godoc]: http://godoc.org/github.com/tatsushid/go-fastping
|
|
[license]: https://github.com/tatsushid/go-fastping/blob/master/LICENSE
|