net-lattice 0.16.0

A modern, cross-platform Rust library for configuring and inspecting operating system networking through a single, strongly typed API.
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

//! Receive synchronous network-change events and handle receiver outcomes.
//!
//! Run with `cargo run -p net-lattice --example sync_monitor` and change a
//! route or address from another terminal. `ResyncRequired` means the affected
//! provider state must be read again before later events are interpreted.

use std::time::Duration;

use net_lattice::{Capability, Error, Event, EventFilter, Lattice, Result};

fn main() -> Result<()> {
    let lattice = Lattice::connect()?;
    // An all-domain `watch()` requires aggregate `MONITORING`. Select one
    // domain the connected backend actually advertises so this example also
    // works on Windows, whose IP Helper watcher has no neighbor callback.
    let filter = if lattice.supports(Capability::ROUTE_MONITORING) {
        EventFilter::none().routes()
    } else if lattice.supports(Capability::INTERFACE_MONITORING) {
        EventFilter::none().interfaces()
    } else if lattice.supports(Capability::ADDRESS_MONITORING) {
        EventFilter::none().addresses()
    } else if lattice.supports(Capability::NEIGHBOR_MONITORING) {
        EventFilter::none().neighbors()
    } else {
        return Err(Error::Unsupported);
    };
    let events = lattice.watch_filtered(filter)?;

    loop {
        match events.recv_timeout(Duration::from_secs(30))? {
            Some(Event::ResyncRequired { domain }) => {
                println!("events were lost for {domain:?}; re-read that domain");
            }
            Some(event) => println!("event: {event:?}"),
            None => println!("no event in the last 30 seconds"),
        }
    }
}