async-snmp 0.12.0

Modern async-first SNMP client library for Rust
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

//! Lightweight Runtime Configuration
//!
//! All async-snmp examples use #[tokio::main], which spawns a multi-threaded
//! runtime by default. This is overkill for simple tools that talk to one or
//! a few devices.
//!
//! This example shows how to use a single-threaded runtime instead, which
//! avoids spawning worker threads and reduces overhead for simple use cases.
//!
//! Run with: cargo run --example lightweight_runtime

use async_snmp::{Auth, Client, Retry, oid};
use std::time::Duration;

// current_thread: single-threaded runtime, no worker threads.
// All async work runs on the main thread. This is the lightest option
// and works well for CLI tools, scripts, and simple applications.
#[tokio::main(flavor = "current_thread")]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let target = ("127.0.0.1", 11161);

    let client = Client::builder(target, Auth::v2c("public"))
        .timeout(Duration::from_secs(5))
        .retry(Retry::fixed(2, Duration::ZERO))
        .connect()
        .await?;

    // GET
    let vb = client.get(&oid!(1, 3, 6, 1, 2, 1, 1, 1, 0)).await?;
    println!("sysDescr: {:?}", vb.value);

    // WALK
    let mut walk = client.walk(oid!(1, 3, 6, 1, 2, 1, 1))?;
    while let Some(result) = walk.next().await {
        let vb = result?;
        println!("  {}: {:?}", vb.oid, vb.value);
    }

    Ok(())
}