surge-ping

rust ping libray based on tokio + socket2 + packet.

Example

```rust use std::time::Duration;

use surge_ping::Pinger;

[tokio::main]

async fn main() -> Result<(), Box> { let mut pinger = Pinger::new("114.114.114.114".parse()?)?; pinger.timeout(Duration::fromsecs(1)); for seqcnt in 0..10 { let (reply, dur) = pinger.ping(seqcnt).await?; println!( "{} bytes from {}: icmpseq={} ttl={} time={:?}", reply.size, reply.source, reply.sequence, reply.ttl, dur ); } Ok(()) }

```

You can send ICMP packets with custom interface rust pinger.bind_device(Some("eth0".as_bytes()))?;

There are two example programs that you can run on your own. ```shell $ git clone https://github.com/kolapapa/surge-ping.git $ cd surge-ping

$ cargo build --example simple sudo RUST_LOG=info ./target/debug/examples/simple -h www.baidu.com -s 56 INFO simple > Ok((EchoReply { ttl: 48, source: 220.181.38.148, sequence: 0, size: 56 }, 7.4106ms))

$ cargo build --example cmd sudo ./target/debug/examples/cmd -h www.baidu.com -c 5 PING www.baidu.com (220.181.38.149): 56 data bytes 56 bytes from 220.181.38.149: icmpseq=0 ttl=45 time=8.987 ms 56 bytes from 220.181.38.149: icmpseq=1 ttl=45 time=15.662 ms 56 bytes from 220.181.38.149: icmpseq=2 ttl=45 time=14.924 ms 56 bytes from 220.181.38.149: icmpseq=3 ttl=45 time=8.902 ms 56 bytes from 220.181.38.149: icmp_seq=4 ttl=45 time=11.281 ms

--- www.baidu.com ping statistics --- 5 packets transmitted, 5 packets received, 0.00% packet loss round-trip min/avg/max/stddev = 8.902/11.951/15.662/2.868 ms ```

Notice

If you are time sensitive, please do not use asynchronous ping program, because if there are a large number of asynchronous events waiting to wake up, it will cause inaccurate calculation time. You can directly use the ping command of the operating system.

License

This project is licensed under the [MIT license].