crafter 0.3.0

Packet-level network interaction for Rust tools and agents.
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
57
58
59
60
61
62
63
64
65
66

mod common;

use common::{arg_or, print_help_if_requested, ExampleResult, EXAMPLE_IFACE};
use crafter::prelude::*;

fn main() -> ExampleResult<()> {
    if print_help_if_requested(
        "usage: cargo run --example interface_helpers -- [--iface IFACE]\n\nInspect interface helper APIs without requiring the selected interface to exist.",
    ) {
        return Ok(());
    }

    let iface = arg_or("--iface", EXAMPLE_IFACE);
    let table = interfaces();

    println!("example: interface_helpers");
    println!("mode: offline");
    println!("selected interface: {iface}");
    println!("interfaces discovered: {}", table.len());
    for interface in table.iter().take(4) {
        println!(
            "interface: {} up={} loopback={} running={} ipv4={:?} ipv6={:?}",
            interface.name(),
            interface.is_up(),
            interface.is_loopback(),
            interface.is_running(),
            interface.first_ipv4(),
            interface.first_ipv6(false)
        );
    }

    print_result(
        "find_interface",
        find_interface(&iface).map(|info| {
            format!(
                "{} mac={:?} addresses={}",
                info.name(),
                info.mac_address(),
                info.addresses().len()
            )
        }),
    );
    print_result("default_interface_name", default_interface_name());
    print_result("get_my_mac", get_my_mac(&iface).map(|mac| mac.to_string()));
    print_result("get_my_ip", get_my_ip(&iface).map(|ip| ip.to_string()));
    print_result(
        "get_my_ipv6",
        get_my_ipv6(&iface, false).map(|ip| ip.to_string()),
    );

    let range = get_ip_strings("192.0.2.10-192.0.2.12")?;
    println!("get_ip_strings: {:?}", range);

    Ok(())
}

fn print_result<T, E>(label: &str, result: std::result::Result<T, E>)
where
    T: std::fmt::Display,
    E: std::fmt::Display,
{
    match result {
        Ok(value) => println!("{label}: {value}"),
        Err(err) => println!("{label} error: {err}"),
    }
}