async-arp 0.4.0

An async ARP client library for probing hosts and sending advanced ARP requests.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

#![allow(dead_code)]

use async_arp::{ProbeInput, ProbeInputBuilder};
use clap::Parser;
use ipnet::Ipv4Net;
use pnet::datalink::{self, NetworkInterface};
use std::net::IpAddr;

/// Simple example to show ARP probing capabilities
#[derive(Parser, Debug)]
#[command(version, about, long_about = None)]
pub(crate) struct Args {
    /// Network interface name to send and receive ARP messages
    #[arg(short, long)]
    pub(crate) iface: String,
}

pub(crate) fn generate_probe_inputs(net: Ipv4Net, interface: NetworkInterface) -> Vec<ProbeInput> {
    net.hosts()
        .map(|target_ip| {
            let sender_mac = interface
                .mac
                .ok_or("interface does not have mac address")
                .unwrap();
            ProbeInputBuilder::new()
                .with_sender_mac(sender_mac)
                .with_target_ip(target_ip)
                .build()
                .unwrap()
        })
        .collect()
}

pub(crate) fn interface_from(interface_name: &str) -> NetworkInterface {
    datalink::interfaces()
        .into_iter()
        .find(|iface| iface.name == interface_name)
        .ok_or_else(|| format!("interface {} not found", interface_name))
        .unwrap()
}

pub(crate) fn net_from(interface: &NetworkInterface) -> Option<Ipv4Net> {
    let net = interface
        .ips
        .iter()
        .filter(|net| net.is_ipv4())
        .take(1)
        .next()?;
    if let IpAddr::V4(ipv4) = net.ip() {
        Some(Ipv4Net::new(ipv4, net.prefix()).unwrap())
    } else {
        None
    }
}

fn main() {}