fastping-rs

ICMP ping library in Rust inspired by go-fastping and AnyEvent::FastPing Perl module

fastping-rs is a Rust ICMP ping library, inspired by go-fastping and the AnyEvent::FastPing Perl module, for quickly sending and measuring batches of ICMP ECHO REQUEST packets.

Usage

Pinger::new returns a tuple containing the actual pinger, and the channel to listen for ping results on. The ping results will either be a PingResult::Receive (if the ping response was received prior to the maximum allowed roud trip time) or a PingResult::Idle (if the response was not in time).

extern crate env_logger;

use fastping_rs::Pinger;
use fastping_rs::PingResult::{Idle, Receive};
#[macro_use]
extern crate log;

fn main() {
    env_logger::init();
    let (mut pinger, results) = match Pinger::new(None, None) {
        Ok((pinger, results)) => (pinger, results),
        Err(e) => panic!("Error creating pinger: {}", e)
    };
    
    pinger.add_ipaddr("8.8.8.8");
    pinger.add_ipaddr("1.1.1.1");
    pinger.add_ipaddr("7.7.7.7");
    pinger.add_ipaddr("2001:4860:4860::8888");
    pinger.run_pinger();

    loop {
        match results.recv() {
            Ok(result) => {
                match result {
                    Idle{addr} => {
                        error!("Idle Address {}.", addr);
                    },
                    Receive{addr, rtt} => {
                        info!("Receive from Address {} in {:?}.", addr, rtt);
                    }
                }
            },
            Err(_) => panic!("Worker threads disconnected before the solution was found!"),
        }
    }
}

Note a Pinger is initialized with two arguments: the maximum round trip time before an address is considered "idle" (2 seconds by default) and the size of the ping data packet (16 bytes by default). To explicitly set these values Pinger would be initialized like so: Pinger::new(Some(3000 as u64), Some(24 as i32))

The public functions stop_pinger() to stop the continuous pinger and ping_once() to only run one round of pinging are also available.