nlink 0.13.0

Async netlink library for Linux network configuration
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! Connectivity Check Example
//!
//! Demonstrates how to check network connectivity to a destination
//! and diagnose routing issues.
//!
//! Run: cargo run -p nlink --example diagnostics_connectivity

use std::{env, net::IpAddr};

use nlink::netlink::{
    Connection, Route,
    diagnostics::{Diagnostics, Severity},
};

#[tokio::main]
async fn main() -> nlink::Result<()> {
    // Get destination from command line or use default
    let dest: IpAddr = env::args()
        .nth(1)
        .and_then(|s| s.parse().ok())
        .unwrap_or_else(|| "8.8.8.8".parse().unwrap());

    println!("=== Connectivity Check: {} ===\n", dest);

    let conn = Connection::<Route>::new()?;
    let diag = Diagnostics::new(conn);

    let report = diag.check_connectivity(dest).await?;

    // Route information
    if let Some(route) = &report.route {
        println!("Route found:");
        if let Some(dev) = &route.dev {
            println!("  Device: {}", dev);
        }
        if let Some(gateway) = &report.gateway {
            println!("  Gateway: {}", gateway);
        }
        if let Some(src) = &route.src {
            println!("  Source: {}", src);
        }
        println!();
    } else {
        println!("No route found to {}\n", dest);
    }

    // Gateway reachability
    if let Some(reachable) = report.gateway_reachable {
        if reachable {
            println!("Gateway is reachable (found in neighbor cache)");
        } else {
            println!("Gateway may be unreachable (not in neighbor cache)");
        }
        println!();
    }

    // Issues
    if !report.issues.is_empty() {
        println!("Issues detected:");
        for issue in &report.issues {
            let icon = match issue.severity {
                Severity::Critical => "!!",
                Severity::Error => "!",
                Severity::Warning => "?",
                Severity::Info => "i",
            };
            println!("  [{}] {}: {}", icon, issue.category, issue.message);
            if let Some(details) = &issue.details {
                println!("      {}", details);
            }
        }
    } else {
        println!("Connectivity looks good!");
    }

    println!("\n=== Usage ===\n");
    println!("Check connectivity to a specific IP:");
    println!("  cargo run -p nlink --example diagnostics_connectivity 1.1.1.1");
    println!("  cargo run -p nlink --example diagnostics_connectivity 2001:4860:4860::8888");

    Ok(())
}